Pokretanje ONLYOFFICE Apps u Docker-u

Uvod

ONLYOFFICE Apps je centar za dokumente u kojem možete povezati korisnike i dokumente na jednom mestu radi bolje saradnje.

Ovaj vodič će vam pokazati kako da pokrenete ONLYOFFICE Apps na vašem računaru pomoću Docker-a.

note

Ovaj vodič postavlja razvojnu/test verziju ONLYOFFICE Apps i nije namenjen za produkciono korišćenje. Ova verzija radi samo preko običnog HTTP-a, isporučuje se bez servisa za identitet/OAuth i ima smanjen skup funkcija. Za produkcione instalacije koristite produkcionu verziju ONLYOFFICE Apps.

Pregled

Za razliku od standardne instalacije sa više kontejnera, ova verzija pokreće sve ONLYOFFICE Apps servise unutar jednog kontejnera umesto u zasebnim kontejnerima za svaki servis. Kompletan stek se sastoji od sledećih kontejnera:

Kontejner	Uloga
onlyoffice-apps	Svi ONLYOFFICE Apps servisi (objedinjeni)
onlyoffice-document-server	Document Server (uređivači)
onlyoffice-mysql-server	MySQL baza podataka
onlyoffice-opensearch	OpenSearch

U poređenju sa standardnom instalacijom sa više kontejnera, ova verzija ima sledeće razlike:

• Svi ONLYOFFICE Apps servisi su objedinjeni u jednom kontejneru.
• Pojednostavljena pretraga.
• Bez generisanja sličica.
• Samo HTTP, bez podrške za TLS/HTTPS po podrazumevanim podešavanjima.
• Bez servisa za identitet/OAuth.

Sistemski zahtevi

• CPU: najmanje 6 jezgara (preporučeno 8 jezgara)
• RAM: najmanje 12 GB (preporučeno 16 GB)
• HDD: najmanje 40 GB slobodnog prostora
• OS: amd64 Linux distribucija sa verzijom jezgra 3.10 ili novijom
• Dodatni zahtevi:
  • najmanje 6 GB swap prostora
  • Docker Engine sa Compose dodatkom (komanda docker compose)

Kloniranje repozitorijuma

Klonirajte repozitorijum DocSpace-buildtools pomoću sledeće komande:

git clone https://github.com/ONLYOFFICE/DocSpace-buildtools.git

Kada se repozitorijum klonira, pređite u Compose direktorijum:

cd DocSpace-buildtools/install/docker/community

Pokretanje unapred izgrađenih slika

Da biste pokrenuli ONLYOFFICE Apps u odvojenom režimu pomoću unapred izgrađenih slika, pokrenite sledeću komandu:

docker compose up -d

Kada kontejneri budu pokrenuti, otvorite pregledač i unesite http://localhost ili http://your-ip-address u adresnu traku da biste pristupili ONLYOFFICE Apps.

Izgradnja slika iz izvornog koda

Koristite ovu opciju ako želite sami da izgradite slike ONLYOFFICE Apps ili da testirate izmene iz određene grane.

Izgradite i pokrenite kontejnere pomoću sledeće komande:

docker compose up -d --build

note

Podrazumevano se slike grade iz grane master. Da biste gradili iz druge grane, navedite argument izgradnje GIT_BRANCH: GIT_BRANCH=your-branch docker compose up -d --build.

Kada se izgradnja završi i kontejneri budu pokrenuti, otvorite http://localhost ili http://your-ip-address u pregledaču da biste pristupili ONLYOFFICE Apps.

Pokretanje sa SSL-om

ONLYOFFICE Apps podržava i Let's Encrypt i prilagođene SSL sertifikate.

Korišćenje Let's Encrypt sertifikata

Da biste pokrenuli ONLYOFFICE Apps sa Let's Encrypt sertifikatom, pokrenite sledeću komandu i navedite sopstveni domen, e-poštu i URL radnog prostora:

SSL_MODE="letsencrypt" \
SSL_DOMAIN="example.com,portal.example.com,api.example.com" \
SSL_EMAIL="admin@example.com" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

Koriste se sledeći parametri:

• SSL_MODE – režim SSL sertifikata.
• SSL_DOMAIN – jedan ili više domena razdvojenih zarezima.
• SSL_EMAIL – adresa e-pošte koja se koristi za registraciju kod Let's Encrypt.
• APP_URL_PORTAL – javni HTTPS URL vašeg radnog prostora.

Korišćenje prilagođenog sertifikata ili sertifikata privatnog CA

Ako koristite samopotpisani sertifikat ili sertifikat koji je izdalo privatno sertifikaciono telo (CA), ONLYOFFICE Document Server takođe mora da veruje ovom sertifikatu.

Uklonite komentar sa sledećeg volumena u datoteci docker-compose.yml:

services:
   onlyoffice-document-server:
     volumes:
       - ${CERTIFICATE_PATH}:/var/www/onlyoffice/Data/certs/extra-ca-certs.pem

Zatim navedite putanju do sertifikata na hostu i pokrenite sledeću komandu:

SSL_MODE="custom" \
SSL_DOMAIN="example.com" \
SSL_CERT_PATH="/etc/nginx/certs/fullchain.crt" \
SSL_KEY_PATH="/etc/nginx/certs/private.key" \
CERTIFICATE_PATH="./config/nginx/certs/fullchain.crt" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

note

CERTIFICATE_PATH mora da pokazuje na datoteku sertifikata na Docker hostu, a ne na putanju unutar kontejnera. Ova opcija je obično potrebna samo za samopotpisane sertifikate ili sertifikate koje je izdao privatni CA. Sertifikati koje izdaju javni CA (na primer, Let's Encrypt, DigiCert ili GoDaddy) obično ne zahtevaju ovu dodatnu konfiguraciju.

Koriste se sledeći parametri:

• SSL_MODE – režim SSL sertifikata (custom).
• SSL_DOMAIN – ime domena radnog prostora.
• SSL_CERT_PATH – putanja do SSL sertifikata.
• SSL_KEY_PATH – putanja do privatnog ključa.
• APP_URL_PORTAL – javni HTTPS URL vašeg radnog prostora.

note

Podrazumevano, konfiguracija ssl.yml montira lokalni direktorijum ./config/nginx/certs na /etc/nginx/certs unutar kontejnera.

Kada kontejneri budu pokrenuti, otvorite adresu vašeg radnog prostora, na primer https://example.com/, u pregledaču da biste pristupili ONLYOFFICE Apps.