Instalacija ONLYOFFICE Docs Enterprise izdanja za Docker na lokalnom serveru

Uvod

Enterprise izdanje omogućava vam da instalirate ONLYOFFICE Docs na vaš lokalni server i integrišete online urednike sa ONLYOFFICE platformom za saradnju ili drugim popularnim sistemima.

ONLYOFFICE Docs je online kancelarijski paket koji uključuje preglednike i urednike za tekstove, tabele i prezentacije, potpuno kompatibilan sa Office Open XML formatima: .docx, .xlsx, .pptx i omogućava kolaborativno uređivanje u realnom vremenu.

Funkcionalnosti

• Urednik dokumenata
• Urednik tabela
• Urednik prezentacija
• Preglednici za mobilni web
• Urednici za mobilni web
• Kolaborativno uređivanje
• Podrška za hijeroglife
• Podrška za sve popularne formate: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Pogledajte detaljnu listu funkcionalnosti dostupnih za ONLYOFFICE Docs Enterprise izdanje.

Korišćenjem unutar ONLYOFFICE Workspace, moći ćete da:

• delite fajlove;
• upravljate pravima pristupa dokumentima;
• ugrađujete dokumente na web sajt;
• pregledate i uređujete fajlove sačuvane na Drive, Box, Dropbox, OneDrive, OwnCloud povezanim sa ONLYOFFICE.

Ovaj vodič će vam pokazati kako da instalirate ONLYOFFICE Docs Enterprise izdanje Docker verziju na vašu mašinu.

Instalacija ONLYOFFICE Docs

docker_OPTS="--dns 8.8.8.8"

Nakon što instalirate Docker, pokrenite ga i izvršite sledeću komandu:

sudo docker run -i -t -d -p 80:80 --restart=always -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee

sudo docker run -i -t -d -p <PORT_NUMBER>:80 --restart=always -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee

Ovo će instalirati ONLYOFFICE Docs i sve zavisnosti koje su mu potrebne (lista onoga što skripta radi može se pronaći ovde).

Čuvanje podataka van kontejnera

Svi podaci se čuvaju u posebno određenim direktorijumima, data volumes, na sledećoj lokaciji:

• /var/log/onlyoffice za logove ONLYOFFICE Docs
• /var/www/onlyoffice/Data za sertifikate
• /var/lib/onlyoffice za keš fajlova
• /var/lib/postgresql za bazu podataka

Da biste dobili pristup vašim podacima koji se nalaze van kontejnera, potrebno je da montirate volumene. To se može uraditi specificiranjem opcije -v u komandi docker run.

sudo docker run -i -t -d -p 80:80 --restart=always \
    -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice  \
    -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/
  
Podaci  \
    -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
    -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee

Obično nije potrebno čuvati podatke kontejnera jer rad kontejnera ne zavisi od njegovog stanja. Čuvanje podataka će biti korisno:

• za lak pristup podacima kontejnera, kao što su logovi;
• za uklanjanje ograničenja veličine podataka unutar kontejnera;
• kada koristite servise pokrenute izvan kontejnera kao što su PostgreSQL, Redis, RabbitMQ.

Pokretanje ONLYOFFICE Docs koristeći HTTPS

sudo docker run -i -t -d -p 443:443 --restart=always \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee

Pristup ONLYOFFICE aplikaciji može biti osiguran korišćenjem SSL-a kako bi se sprečio neovlašćen pristup. Dok CA sertifikovani SSL sertifikat omogućava verifikaciju poverenja putem CA, samopotpisani sertifikati takođe mogu pružiti jednak nivo verifikacije poverenja sve dok svaki klijent preduzme dodatne korake da verifikuje identitet vaše veb stranice. Uputstva za postizanje ovoga su data u nastavku.

Da biste osigurali aplikaciju putem SSL-a, u osnovi su potrebne dve stvari:

• Privatni ključ (.key)
• SSL sertifikat (.crt)

Potrebno je da kreirate i instalirate sledeće fajlove:

/app/onlyoffice/DocumentServer/data/certs/onlyoffice.key
/app/onlyoffice/DocumentServer/data/certs/onlyoffice.crt

Kada koristite CA sertifikovane sertifikate (npr. Let's Encrypt), ove fajlove vam obezbeđuje CA. Ako koristite samopotpisane sertifikate, potrebno je da generišete ove fajlove sami.

Prebacivanje ONLYOFFICE Docs na HTTPS koristeći certbot

Najlakši način da prebacite ONLYOFFICE Docs na HTTPS je da automatski dobijete Let's Encrypt SSL sertifikate koristeći certbot.

Pokrenite ONLYOFFICE Docs Docker kontejner, navodeći portove 80 i 443 i postavljajući svoje vrednosti za promenljive:

sudo docker run -i -t -d -p 80:80 -p 443:443 --restart=always \
    -e LETS_ENCRYPT_DOMAIN=yourdomain.com -e LETS_ENCRYPT_MAIL=email@example.com -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee

Gde:

• LETS_ENCRYPT_DOMAIN - naziv domena koji će se koristiti za sertifikat.
• LETS_ENCRYPT_MAIL - email koji se koristi za registraciju i kontakt za oporavak.

CA-signed sertifikat sa letsencrypt.org će biti automatski generisan i instaliran na vaš server. Sada bi vaš ONLYOFFICE Docs trebao biti dostupan na adresi https://yourdomain.com.

openssl genrsa -out onlyoffice.key 2048

openssl req -new -key onlyoffice.key -out onlyoffice.csr

openssl x509 -req -days 365 -in onlyoffice.csr -signkey onlyoffice.key -out onlyoffice.crt

Jačanje sigurnosti servera

Ovaj deo vam pruža uputstva za jačanje sigurnosti vašeg servera.

Da biste to postigli, potrebno je generisati jače DHE parametre.

openssl dhparam -out dhparam.pem 2048

Instalacija SSL sertifikata

Od četiri generisana fajla, potrebno je instalirati fajlove onlyoffice.key, onlyoffice.crt i dhparam.pem na ONLYOFFICE server. CSR fajl nije potreban, ali obavezno napravite sigurnosnu kopiju fajla (u slučaju da vam ponovo zatreba).

Podrazumevani put koji je ONLYOFFICE aplikacija konfigurisana da traži SSL sertifikate je /var/www/onlyoffice/Data/certs, međutim, ovo se može promeniti korišćenjem konfiguracionih opcija SSL_KEY_PATH, SSL_CERTIFICATE_PATH i SSL_DHPARAM_PATH.

Putanja /var/www/onlyoffice/Data/ je putanja skladišta podataka, što znači da morate kreirati folder pod nazivom certs unutar /app/onlyoffice/DocumentServer/data/ i kopirati fajlove u njega, a kao meru sigurnosti ažuriraćete dozvole na fajlu onlyoffice.key da bude čitljiv samo od strane vlasnika.

mkdir -p /app/onlyoffice/DocumentServer/data/certs
cp onlyoffice.key /app/onlyoffice/
  
DocumentServer/data/certs/
cp onlyoffice.crt /app/onlyoffice/DocumentServer/data/certs/
cp dhparam.pem /app/onlyoffice/DocumentServer/data/certs/
chmod 400 /app/onlyoffice/DocumentServer/data/certs/onlyoffice.key

I ponovo pokrenite Docker container:

sudo docker restart {{DOCUMENT_SERVER_ID}}

Sada ste samo jedan korak udaljeni od osiguravanja naše aplikacije.

Dostupni parametri konfiguracije

U nastavku je kompletna lista parametara koji se mogu postaviti pomoću promenljivih okruženja.

• ONLYOFFICE_HTTPS_HSTS_ENABLED: Napredna opcija konfiguracije za isključivanje HSTS konfiguracije. Primjenjivo samo kada se koristi SSL. Podrazumevano je true.
• ONLYOFFICE_HTTPS_HSTS_MAXAGE: Napredna opcija konfiguracije za postavljanje maksimalnog trajanja HSTS u onlyoffice NGINX vHost konfiguraciji. Primjenjivo samo kada se koristi SSL. Podrazumevano je 31536000.
• SSL_CERTIFICATE_PATH: Putanja do SSL sertifikata koji se koristi. Podrazumevana vrednost je /var/www/onlyoffice/Data/certs/tls.crt.
• SSL_KEY_PATH: Putanja do privatnog ključa SSL sertifikata. Podrazumevana vrednost je /var/www/onlyoffice/Data/certs/tls.key.
• SSL_DHPARAM_PATH: Putanja do Diffie-Hellman parametra. Podrazumevana vrednost je /var/www/onlyoffice/Data/certs/dhparam.pem.
• SSL_VERIFY_CLIENT: Omogućava verifikaciju klijentskih sertifikata pomoću datoteke CA_CERTIFICATES_PATH file. Podrazumevano je false.
• DB_TYPE: Tip baze podataka. Podržane vrednosti su postgres, mariadb ili mysql. Podrazumevano je postgres.
• DB_HOST: IP adresa ili ime hosta gde se pokreće server baze podataka.
• DB_PORT: Broj porta servera baze podataka.
• DB_NAME: Ime baze podataka koja će biti kreirana pri pokretanju slike.
• DB_USER: Novi korisnički naziv sa superuser dozvolama za nalog baze podataka.
• DB_PWD: Lozinka postavljena za nalog baze podataka.
• AMQP_URI: AMQP URI za povezivanje sa serverom poruka.
• AMQP_TYPE: Tip servera poruka. Podržane vrednosti su rabbitmq ili activemq. Podrazumevano je rabbitmq.
• REDIS_SERVER_HOST: IP adresa ili ime hosta gde se pokreće Redis server.
• REDIS_SERVER_PORT: Broj porta Redis servera.
• REDIS_SERVER_PASS: Lozinka za Redis server. Lozinka nije postavljena po podrazumevanoj vrednosti.
• NGINX_WORKER_PROCESSES: Definiše broj NGINX radnih procesa.
• NGINX_WORKER_CONNECTIONS: Postavlja maksimalan broj istovremenih veza koje NGINX radni proces može otvoriti.
• SECURE_LINK_SECRET: Definiše tajnu za nginx konfiguracionu direktivu secure_link_md5. Podrazumevano je random string.
• JWT_ENABLED: Specifikuje omogućavanje validacije JSON web tokena od strane ONLYOFFICE Docs. Podrazumevano je true.
• JWT_SECRET: Definiše tajni ključ za validaciju JSON web tokena u zahtevu za ONLYOFFICE Docs. Podrazumevano je nasumična vrednost.
• JWT_HEADER: Definiše HTTP zaglavlje koje će se koristiti za slanje JSON web tokena. Podrazumevano je Authorization.
• JWT_IN_BODY: Specifikuje omogućavanje validacije tokena u telu zahteva za ONLYOFFICE Docs. Podrazumevano je false.
• ALLOW_META_IP_ADDRESS: Definiše da li je dozvoljeno povezivanje sa meta IP adresom ili ne. Podrazumevano je false.
• ALLOW_PRIVATE_IP_ADDRESS: Definiše da li je dozvoljeno povezivanje sa privatnom IP adresom ili ne. Podrazumevano je false.
• WOPI_ENABLED: Specifikuje omogućavanje wopi rukovalaca. Podrazumevano je false.
• USE_UNAUTHORIZED_STORAGE: Postavite na true ako koristite samopotpisane sertifikate za vaš server za skladištenje, npr. Nextcloud. Podrazumevano je false.
• GENERATE_FONTS: Kada je true, regeneriše listu fontova i sličice fontova itd. pri svakom pokretanju. Podrazumevano je true.
• METRICS_ENABLED: Specifikuje omogućavanje StatsD za ONLYOFFICE Docs. Podrazumevano je false.
• METRICS_HOST: Definiše StatsD host za slušanje. Podrazumevano je localhost.
• METRICS_PORT: Definiše StatsD port za slušanje. Podrazumevano je 8125.
• METRICS_PREFIX: Definiše StatsD prefiks metrika za pozadinske servise. Podrazumevano je ds..
• LETS_ENCRYPT_DOMAIN: Definiše domen za Let's Encrypt sertifikat.
• LETS_ENCRYPT_MAIL: Definiše email adresu administratora domena za Let's Encrypt sertifikat.

Postavljanje ONLYOFFICE Docs za ipv6

Docker trenutno ne dodeljuje ipv6 adrese kontejnerima po podrazumevanoj vrednosti. Ova funkcija je trenutno eksperimentalna.

Da biste postavili interakciju putem ipv6, potrebno je omogućiti podršku za ovu funkciju u vašem Docker-u. Za to vam je potrebno:

• kreirajte datoteku /etc/docker/daemon.json sa sledećim sadržajem:

  {
  "ipv6": true,
  "fixed-cidr-v6": "2001:db8:abc1::/64"
  }

• ponovo pokrenite docker sa sledećom komandom: systemctl restart docker

Nakon toga, svi pokrenuti kontejneri će dobiti ipv6 adresu i imati inet6 interfejs.

Možete proveriti vašu podrazumevanu mrežu mosta i videti polje EnableIPv6=true. Takođe će biti dodata nova ipv6 podmreža.

Za više informacija, posetite zvanični Docker priručnik.

Registracija vaše verzije Enterprise Edition

Ako ste kupili Enterprise Edition i dobili datoteku license.lic, možete je postaviti u vašu instalaciju da biste dobili punu verziju softvera.

Kada koristite docker container, datoteka license.lic može biti postavljena u bilo koji folder (npr. /app/onlyoffice/DocumentServer/data/license.lic), ali ćete morati da montirate ovaj folder kada se container pokrene:

sudo docker run -i -t -d -p 80:80 --restart=always \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
-e JWT_SECRET=my_jwt_secret onlyoffice/documentserver-ee

Nakon toga, vaša verzija Enterprise Edition će biti registrovana i sa svim funkcionalnostima.