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 verzija Dockera:
    uname -a && docker --version

Instalacija i sistemski zahtevi

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

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

Q:Koji sistem mi je potreban da bih instalirao server rešenje i uspešno ga koristio?

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 problem?

A:Docker po defaultu 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 može biti locirana 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 da 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, uredite iptables da imate 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.

Autentikacija i sigurnost

Q:JWT autentikacija ne uspeva nakon integracije ONLYOFFICE Docs sa mojom platformom. Kako da to popravim?

A:Proverite da li se JWT tajna konfigurisana u ONLYOFFICE Docs tačno poklapa sa tajnom konfigurisanom u postavkama konektora vaše platforme. Takođe proverite da li se ime JWT zaglavlja poklapa (podrazumevano je "Authorization"). Uobičajene greške:

  • Vodeći ili prateći razmaci u vrednosti tajne.
  • Korišćenje podrazumevane nasumične tajne umesto postavljanja prilagođene. Proverite vašu tajnu 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 raste sa brojem otvorenih dokumenata i istovremenih korisnika. Za server sa nekoliko desetina aktivnih korisnika, 2–4 GB RAM-a je normalno. Ako je korišćenje memorije neočekivano visoko, proverite da li ima zaglavljenih ili zaboravljenih dokumenata u /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

Q:Kontejner se stalno restartuje. Šta da radim?

A:Proverite logove kontejnera za specifičnu grešku:

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 nedostajuće fontove.

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 ga svi korisnici koji su ga uređivali zatvorili. Da biste izbegli gubitak podataka, morate prisilno isključiti korisnike ONLYOFFICE Docs kada treba da zaustavite ONLYOFFICE Docs u slučajevima ažuriranja aplikacije, ponovnog pokretanja servera itd. Da biste to uradili, izvršite sledeći skript na serveru gde je ONLYOFFICE Docs instaliran:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh

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

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 resetovati keš za sve korisnike odjednom?

A:Prisilno obrišite 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 izvršene unutar kontejnera.

Problemi sa Enterprise i Developer izdanjima

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

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 da radim?

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

Članak sa oznaka:
Pregledajte sve oznake