Cum se configurează spațiul de lucru ONLYOFFICE pe Ubuntu 24.04 LTS

ONLYOFFICE Workspace combină editarea online a documentelor cu un portal de colaborare mai amplu. Pe Ubuntu 24.04 LTS, cea mai accesibilă configurare a serverului este utilizarea scriptului oficial de instalare ONLYOFFICE Workspace Community cu Docker. Docker rulează componentele Workspace în containere izolate, ceea ce face ca implementarea să fie mai ușor de reprodus și actualizat decât o stivă construită manual.

Acest ghid utilizează ediția Community și începe cu o opțiune practică pentru administratorii începători: instalați Workspace fără serverul opțional ONLYOFFICE Mail. Aceasta elimină cerințele DNS și de livrare a e-mailului încă de la prima implementare. Puteți adăuga Mail ulterior din Panoul de control, dacă aveți nevoie.

Începând cu octombrie 2026, Docker acceptă oficial Ubuntu 24.04 LTS (Noble). Documentația actuală a comunității Workspace a ONLYOFFICE listează o gazdă Linux amd64 cu cel puțin un procesor cu 4 nuclee, 8 GB de RAM, 40 GB de spațiu liber pe disc și 6 GB de swap. Furnizorul recomandă mai mult CPU și RAM pentru o implementare mai lină. Consultați ghidul de instalare actual al Docker al comunității Workspace a ONLYOFFICE și documentația de instalare Ubuntu a Docker înainte de implementarea pe un server de producție.

Ce ai nevoie înainte de a începe

Aveți nevoie de un server sau o mașină virtuală Ubuntu 24.04 LTS, un cont cu sudoprivilegii, acces la internet pentru descărcarea de pachete și imagini de containere și suficiente resurse gratuite pentru serviciile Workspace. Dacă doriți ca portalul să fie accesibil de pe alte computere, serverul are nevoie și de o adresă LAN stabilă sau o adresă IP publică.

amd64 reprezintă arhitectura comună de server x86 pe 64 de biți utilizată de procesoarele Intel și AMD. Nu presupuneți că suportul Docker pentru o altă arhitectură înseamnă automat că ONLYOFFICE Workspace o acceptă; cerințele actuale ale Workspace menționează în mod specific amd64 Linux.

Pasul 1: Confirmați că gazda Ubuntu are suficiente resurse

Deschideți Terminalul sau conectați-vă la server prin SSH. Executați:

uname -m
free -h
df -h

uname -mraportează arhitectura procesorului. Pe o gazdă compatibilă x86-64, veți vedea în mod normal x86_64. free -harată memoria RAM și swap-ul, în timp ce df -harată spațiul liber pe disc în unități lizibile de om.

Evitați să continuați pe un server care are deja puțină memorie sau spațiu de stocare. Instalarea se poate finaliza, dar ulterior se poate eșua în timpul editării sau indexării sarcinilor de lucru, ceea ce este mai greu de diagnosticat decât corectarea mai întâi a capacității.

Pasul 2: Instalați Docker Engine din depozitul oficial Ubuntu al Docker

Docker Engine este serviciul care creează și rulează containerele utilizate de implementarea Workspace. Instrucțiunile actuale ale Docker pentru Ubuntu sunt compatibile cu Ubuntu 24.04 LTS și recomandă utilizarea propriului depozit APT Docker pentru o instalare normală a serverului.

Mai întâi instalați instrumentele de bază ale repozitoriului:

sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings

Adăugați cheia de semnare și depozitul curent al Docker:

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg   -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

Apoi instalați Docker Engine și pluginul Compose:

sudo apt install -y docker-ce docker-ce-cli containerd.io   docker-buildx-plugin docker-compose-plugin

Confirmați că serviciul rulează:

sudo systemctl status docker --no-pager

Pasul 3: Verificați Docker înainte de a implica ONLYOFFICE

Această mică verificare diferențiază problemele Docker de problemele Workspace. Executați:

sudo docker run --rm hello-world

Docker descarcă o imagine de test minusculă, pornește un container, afișează un mesaj de confirmare și se închide. Dacă această acțiune eșuează, remediați mai întâi Docker, în loc să continuați cu scriptul Workspace.

O greșeală frecventă a începătorilor este tratarea unei erori de permisiuni de la dockerONLYOFFICE ca o eroare. Acest ghid folosește intenționat sudo docker, deci nu este nevoie să adăugați contul dvs. la grupul Docker. Docker avertizează că apartenența la acel grup oferă efectiv control la nivel de root, așa că nu adăugați utilizatori la întâmplare doar pentru a scurta comenzile.

Pasul 4: Descărcați programul de instalare oficial ONLYOFFICE Workspace

ONLYOFFICE publică un script de instalare pe propriul domeniu de descărcare. Descărcați-l direct:

curl -O https://download.onlyoffice.com/install/workspace-install.sh

Înainte de a rula orice script administrativ descărcat, este o practică bună să îl inspectați:

less workspace-install.sh

Apasă qpentru a ieși less. Aceasta nu dovedește că un script este sigur, dar îți oferă șansa de a verifica sursa și de a observa comenzi neașteptate înainte de a-i acorda privilegii de root.

Pasul 5: Instalați mai întâi Workspace fără serverul de e-mail

Pentru o primă implementare, rulați scriptul oficial, ignorând ONLYOFFICE Mail:

sudo bash workspace-install.sh -ims false

Parametrul -ims falseînseamnă „nu instalați componenta Server de mail”. Aceasta menține configurarea inițială concentrată pe portalul Spațiu de lucru, editorii de documente și componentele de administrare. Documentele ONLYOFFICE pe care Mail le poate instala ulterior din Panoul de control.

Dacă aveți deja un domeniu de serviciu de mail configurat corect și doriți în mod specific instalarea completă, ONLYOFFICE documentează în schimb acest formular:

sudo bash workspace-install.sh -md "mx1.example.com"

Înlocuiți mx1.example.comcu numele de gazdă real al serviciului de e-mail. Numele de gazdă trebuie să fie rezolvat către server, iar domeniul de e-mail are nevoie de înregistrările DNS corespunzătoare. Nu utilizați un nume de gazdă inventat doar pentru a face programul de instalare să continue. Un DNS incorect este una dintre cele mai simple modalități de a transforma o implementare Workspace altfel reușită într-o problemă de livrare a e-mailului.

Pasul 6: Verificați dacă containerele funcționează efectiv

Când scriptul se termină, inspectați containerele care rulează:

sudo docker ps

Nu vă faceți griji dacă numele containerelor diferă de exemplele pe care le vedeți online. Numele și componentele interne se pot schimba de la o versiune la alta. Semnalele utile sunt că containerele ONLYOFFICE așteptate sunt prezente și starea lor este în execuție, în loc să repornească sau să se oprească în mod repetat.

Dacă un container repornește în mod repetat, verificați numele real docker ps -ași apoi executați:

sudo docker logs --tail 100 CONTAINER_NAME

Înlocuiți CONTAINER_NAMEcu un nume afișat de Docker. Acest lucru este mai sigur decât copierea unui nume vechi de container dintr-un tutorial.

Pasul 7: Deschideți portalul folosind adresa de rețea reală a serverului

Găsiți adresele serverului cu:

hostname -I

Dintr-un browser care poate accesa serverul, deschideți:

http://SERVER_IP

Ghidul Docker de la ONLYOFFICE recomandă în mod specific utilizarea adresei IP de rețea a mașinii în loc de localhostsau 127.0.0.1la verificarea portalului. Pornirea inițială poate dura câteva minute după instalare, așadar o scurtă întârziere nu înseamnă automat că implementarea a eșuat.

Pasul 8: Finalizați configurarea administratorului

Prima pagină de rulare vă solicită să creați un cont de administrator al portalului. Setați o parolă puternică, introduceți o adresă de e-mail validă, selectați limba și fusul orar corecte și acceptați termenii licenței. ONLYOFFICE menționează că politica implicită privind parolele necesită între 8 și 120 de caractere; puteți consolida setările de securitate ulterior.

După asistentul inițial, confirmați că puteți deschide modulul Documente și crea un document de test. O conectare reușită dovedește că portalul este accesibil; deschiderea și editarea unui document verifică, de asemenea, dacă componenta de editare a documentelor este conectată corect.

Securizează instalarea înainte de a invita utilizatori

Dacă serverul va fi utilizat în afara unui laborator temporar, treceți de la HTTP simplu la HTTPS. Panoul de control ONLYOFFICE poate genera și aplica un certificat Let's Encrypt sau poate accepta un certificat și o cheie privată existente. Pentru fluxul de lucru Let's Encrypt încorporat, portul 80 trebuie să fie accesibil în timpul emiterii certificatului. Consultați ghidul oficial de configurare HTTPS ONLYOFFICE .

De asemenea, verificați de ce porturi de rețea aveți nevoie. ONLYOFFICE publică o referință pentru porturile Workspace Community . Nu expuneți porturile bazei de date sau ale serviciilor interne la internet doar pentru că apar în tabelul respectiv.

Ubuntu include UFW, un firewall pentru gazdă, dar există o avertizare importantă specifică Docker: documentația Docker avertizează că porturile de container publicate pot ocoli regulile UFW. Aceasta înseamnă că „L-am blocat în UFW” nu este o dovadă suficientă că un port publicat de Docker este inaccesibil. Examinați comportamentul firewall-ului Docker și, pentru un server conectat la internet, utilizați o politică de firewall pentru gazdă sau în amonte proiectată corespunzător, în loc să presupuneți că UFW controlează singur fiecare port de container. Referința proprie pentru firewall-ul Ubuntu este disponibilă în documentația firewall-ului Ubuntu Server .

Probleme frecvente și ce trebuie verificat mai întâi

Programul de instalare spune că un port necesar este deja utilizat.

Verificați listenerele înainte de a opri serviciile aleatorii:

sudo ss -ltnp | grep -E ':(80|443)\b'

Dacă Apache, Nginx, un alt container sau un panou de administrare deține deja portul, decideți care serviciu ar trebui să îl păstreze. Nu închideți orbește un server web de producție.

Portalul nu se încarcă după instalare

Verificați mai întâi Docker:

sudo systemctl is-active docker
sudo docker ps -a

Dacă Docker este inactiv, pornește-l și verifică jurnalul său. Dacă containerele Workspace sunt active, dar pagina nu este disponibilă, confirmă că folosești adresa IP corectă a serverului și că rutarea, grupurile de securitate în cloud și firewall-urile din amonte permit traficul web necesar.

Serverul rămâne fără memorie în timpul instalării

Verificați din nou free -h. Ghidul bazat pe scripturi Workspace așteaptă cel puțin 6 GB de memorie swap și listează 8 GB de RAM ca minim. O mașină virtuală foarte mică poate deveni instabilă în timp ce mai multe imagini se inițializează simultan. Trecerea la o mașină virtuală mai mare este de obicei mai ușoară decât încercarea de a regla fiecare serviciu pentru a evita memoria insuficientă.

Ai nevoie de ONLYOFFICE Mail mai târziu

Nu este nevoie să reinstalați Workspace. ONLYOFFICE documentează adăugarea serverului de mail din pagina de actualizare a Panoului de control. Înainte de a face acest lucru, pregătiți un nume de gazdă real pentru serviciu și înregistrările DNS ale acestuia. Consultați ghidul ONLYOFFICE pentru adăugarea de mailuri la o instalare Workspace existentă .

Preferi Docker Compose în locul scriptului de instalare

Aceasta este o alternativă validă atunci când doriți mai mult control asupra definiției implementării. Instrucțiunile Compose actuale ale ONLYOFFICE necesită Docker Compose 2.16.0 sau o versiune ulterioară pentru Ubuntu 22.04 și versiuni ulterioare și instruiesc administratorii să activeze cgrouplinia relevantă din fișierul YAML Workspace. Ubuntu 24.04 se încadrează în categoria „22.04 și versiuni ulterioare”. Urmați ghidul oficial ONLYOFFICE Docker Compose în loc să copiați un fișier Compose vechi dintr-un tutorial fără legătură.

Cum să știi că configurarea este cu adevărat finalizată

O instalare bună are mai multe semne independente de funcționare: Docker este activ; containerele Workspace rămân în funcțiune; portalul se deschide de pe o altă mașină folosind adresa de rețea reală a serverului; administratorul se poate conecta; și un document de test se deschide în editorul browserului. Dacă intenționați să expuneți public serviciul, HTTPS ar trebui să funcționeze și cu un certificat în care browserele au încredere.

Pentru o primă implementare Ubuntu 24.04, oprirea după aceste verificări este mai bună decât adăugarea imediată a e-mailului, a proxy-urilor inverse personalizate, a spațiului de stocare terț și a integrărilor de autentificare. Adăugați câte o funcție pe rând, verificați-o și păstrați o evidență a modificărilor DNS, firewall-ului și containerelor. Acest lucru face ca depanarea ulterioară a problemelor să fie mult mai previzibilă.