Ovaj članak je preveden pomoću veštačke inteligencije

Rešavanje problema za ONLYOFFICE Docs na Dockeru

Pre nego što kontaktirate podršku: prikupljanje dijagnostičkih informacija

Ako imate problem koji nije pokriven u nastavku, prikupite sledeće informacije pre nego što kontaktirate ONLYOFFICE podršku:

  • Logovi kontejnera:
    sudo docker logs <CONTAINER_ID>
  • Verzija kontejnera:
    sudo docker inspect --format='{{.Config.Image}}' <CONTAINER_ID>
  • Lista montiranih volumena:
    sudo docker inspect --format='{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"
    "}}{{end}}' <CONTAINER_ID>
  • Host OS i Docker verzija:
    uname -a && docker --version

Instalacija i sistemski zahtevi

Q:Želim da instaliram server baziran na Dockeru na moj lokalni server. Kako to mogu da uradim?

A:Najnoviji server za online kancelariju baziran na Dockeru je dostupan na Docker hubu. Molimo vas da izaberete ONLYOFFICE Docs i pratite uputstva za instalaciju.

Q:Koji sistem mi je potreban za instalaciju server rešenja i uspešno korišćenje?

A:Sistemski zahtevi su:

  • CPU: dual core 2 GHz ili bolji
  • RAM: 4 GB ili više
  • HDD: najmanje 20 GB slobodnog prostora
  • SWAP: najmanje 4 GB, ali zavisi od host OS-a. Više je bolje
  • OS: amd64/arm64 bilo koja verzija koju podržava Docker tim

Mreža i DNS

Q:Instalirao sam jednu od verzija servera koristeći Docker servis, ali imam problema vezanih za DNS server ili sopstvenu rezoluciju imena. Šta može biti pogrešno?

A:Docker podrazumevano koristi Google DNS servere, i server pokušava da ih kontaktira svaki put kada pravi mrežne zahteve. Ako vaš ONLYOFFICE Docs neće imati pristup internetu, preporučujemo da promenite podrazumevanu Docker DNS adresu na adresu vašeg lokalnog DNS servera. Da biste to uradili, idite u datoteku /etc/default/docker i promenite IP adresu u sledećem redu na IP adresu DNS servera u vašoj lokalnoj mreži:

docker_OPTS="--dns 8.8.8.8"

Za operativne sisteme bazirane na RPM-u kao što je CentOS, konfiguraciona datoteka se može nalaziti ovde: /etc/docker/daemon.json

Q:Urednici dokumenata se otvaraju i interfejs se pojavljuje, ali sam dokument se ne učitava, stalno pokazuje napredak učitavanja. Šta mogu da uradim?

A:Razlog može biti to što računar mora biti u mogućnosti da se adresira putem internet loopback pristupa, tj. mora biti dostupan spolja za sebe. Da biste to omogućili, izmenite iptables da imaju preusmeravanja kao što su:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip> iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>
Ne zaboravite da zamenite public_ip i local_ip adrese stvarnim IP adresama.

Autentifikacija i sigurnost

Q:JWT autentifikacija ne uspeva nakon integracije ONLYOFFICE Docs sa mojom platformom. Kako da rešim ovo?

A:Proverite da li tajni ključ JWT-a konfigurisan u ONLYOFFICE Docs tačno odgovara tajnom ključu konfigurisanom u postavkama konektora vaše platforme. Takođe proverite da li naziv JWT zaglavlja odgovara (podrazumevano je "Authorization"). Uobičajene greške:

  • Vodeći ili prateći razmaci u vrednosti tajnog ključa.
  • Korišćenje podrazumevanog nasumičnog ključa umesto postavljanja prilagođenog. Proverite svoj tajni ključ sa:
    sudo docker exec <CONTAINER_ID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json services.CoAuthoring.secret.session.string

Performanse i korišćenje resursa

Q:ONLYOFFICE Docs koristi mnogo memorije. Da li je to normalno?

A:Korišćenje memorije se povećava sa brojem otvorenih dokumenata i istovremenih korisnika. Za server sa nekoliko desetina aktivnih korisnika, korišćenje 2–4 GB RAM-a je normalno. Ako je korišćenje memorije neočekivano visoko, proverite da li postoje zaglavljeni ili zaboravljeni dokumenti u /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

Q:Kontejner se stalno restartuje. Šta treba da uradim?

A:Proverite logove kontejnera za specifične greške:

sudo docker logs <CONTAINER_ID>

Uobičajeni uzroci uključuju:

  • Nedovoljno memorije (kontejner zahteva najmanje 4 GB RAM-a).
  • Port 80 je već u upotrebi od strane druge aplikacije. Ili zaustavite drugu aplikaciju ili promenite port za ONLYOFFICE Docs.
  • Neuspeh inicijalizacije baze podataka. Ako koristite eksternu bazu podataka, proverite da li su parametri konekcije tačni.

Rukovanje dokumentima

Q:Konverzija dokumenata ne uspeva (npr. otvaranje DOC, XLS ili PPT fajlova prikazuje grešku). Šta mogu da uradim?

A:Proverite log konvertera za greške pokretanjem sledeće komande:

sudo docker exec <CONTAINER_ID> cat /var/log/onlyoffice/documentserver/converter/out.log

Uobičajeni uzroci uključuju nedovoljno prostora na disku i nedostatak fontova.

Q:Došlo je do gubitka podataka prilikom zaustavljanja ONLYOFFICE Docs. Kako sprečiti gubitak podataka?

A:Zbog operativnih karakteristika, ONLYOFFICE Docs čuva dokument samo nakon što su svi korisnici koji su ga uređivali zatvorili dokument. Da biste izbegli gubitak podataka, morate prinudno prekinuti vezu korisnika ONLYOFFICE Docs kada treba da zaustavite ONLYOFFICE Docs u slučajevima ažuriranja aplikacije, restartovanja servera itd. Da biste to uradili, pokrenite sledeći skript na serveru gde je instaliran ONLYOFFICE Docs:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh

Izvršavanje skripta može potrajati dugo (do 5 minuta) jer čeka da se svi korisnici diskonektuju.

Keš i prilagođavanje

Q:Dodao sam prilagođenu temu interfejsa ili ažurirao jezičke datoteke urednika (ispravio neke prevode), ali server i dalje prikazuje prethodne vrednosti umesto ispravnih. Kako mogu da resetujem keš za sve korisnike odjednom?

A:Prinudno očistite keš pokretanjem sledeće komande:

sudo docker exec <CONTAINER_ID> documentserver-flush-cache.sh

Keš bi trebalo da bude resetovan za sve korisnike servera.

Imajte na umu da za instalaciju na Dockeru, sve akcije moraju biti izvedene unutar kontejnera.

Problemi sa Enterprise i Developer izdanjem

Q:Vidim upozorenje "Licenca je istekla". Šta treba da uradim?

A:Vaša license.lic datoteka je istekla. Kontaktirajte sales@onlyoffice.com da obnovite vašu licencu. Nakon što dobijete novu datoteku, zamenite staru license.lic datoteku u direktorijumu sa podacima i restartujte ONLYOFFICE Docs.

Q:Ne mogu da pristupim Admin Panelu. Šta treba da uradim?

A:Ako još niste postavili Admin Panel, pratite uputstvo za postavljanje Admin Panela. Ako ste zaboravili vašu administratorsku lozinku, obrišite unos passwordHash iz runtime.json i restartujte — novi bootstrap kod će biti generisan.

Članak sa oznaka:
Pregledajte sve oznake