Cum să instalați ONLYOFFICE Docs pe Ubuntu 24.04

ONLYOFFICE Docs este o suită de birou online colaborativă, gratuită și totuși puternică, care include vizualizatoare și editoare pentru documente text, prezentări, foi de calcul, formulare și PDF-uri. Suita ONLYOFFICE este complet compatibilă cu formatele Office Open XML: .docx, .xlsx, .pptx și suportă editarea colaborativă a documentelor în timp real. În acest articol vă vom arăta cum să instalați și să configurați ONLYOFFICE Docs pe Ubuntu 24.04 (Noble Numbat).

Ghidul suprem pentru desktop Ubuntu

Stăpânește Ubuntu ca un profesionist - de la personalizarea frumoasă a desktopului până la automatizarea puternică din terminal. Perfect pentru dezvoltatori, administratori de sistem și utilizatori avansați care doresc control total asupra spațiului lor de lucru.

Docs ONLYOFFICE este împachetat cu următoarele componente:

server – Acesta este un strat de server backend care controlează toate componentele ONLYOFFICE Docs.
core – Permite comunicarea între formatele de documente de birou (DOC, DOCX, ODT, RTF, TXT, PDF, HTML, EPUB, XPS, DjVu, XLS, XLSX, ODS, CSV, PPT, PPTX, ODP).
sdkjs – SDK JavaScript API pentru toate componentele incluse și interacțiunea pe partea de client.
web-apps – Acesta este frontend-ul pentru ONLYOFFICE Docs
dicționare – Conțin dicționarele mai multor limbi folosite pentru verificarea ortografiei în ONLYOFFICE Docs.

Iată lista editorilor care vin cu ONLYOFFICE Docs:

Editor de documente ONLYOFFICE
Editor de foi de calcul ONLYOFFICE
Editor de Prezentări ONLYOFFICE
Creator de formulare ONLYOFFICE
Editor, cititor și convertor PDF ONLYOFFICE

Configurați cerințele

În acest articol instalăm Editia Comunitară a ONLYOFFICE Docs pe un server local Ubuntu. Cerințele minime de hardware pentru server sunt următoarele:

CPU: Cel puțin dual-core 2 GHz
RAM: Cel puțin 2 GB
Spațiu pe disc: Cel puțin 40 GB de spațiu liber
SWAP: Cel puțin 4 GB, sau mai multă memorie RAM dacă nu există swap.
Sistem de operare: Linux Ubuntu sau Debian pe 64 de biți

Dacă îndeplinești cerințele, este un moment bun să îți concentrezi atenția pe configurarea serverului de documente.

Pasul 1: Configurați baza de date PostgreSQL

Începe configurarea asigurându-te că sistemul tău este actualizat:

sudo apt update && sudo apt upgrade -y

Putem instala serverul PostgreSQL versiunea disponibilă în depozitele implicite ale sistemului nostru de operare.

sudo apt install postgresql

Odată ce pachetul este instalat, serviciul pornește automat, următorul pas este să creezi baza de date și utilizatorul PostgreSQL:

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

Pasul 2: Instalați RabbitMQ Server

ONLYOFFICE folosește RabbitMQ ca broker de mesaje pentru a permite comunicarea între diferitele servicii din suita ONLYOFFICE. Instalați pachetul rulând următoarea comandă:

sudo apt install rabbitmq-server

Poți verifica starea serviciului:

$ systemctl status rabbitmq-server.service
● rabbitmq-server.service - RabbitMQ Messaging Server
     Loaded: loaded (/usr/lib/systemd/system/rabbitmq-server.service; enabled; preset: enabled)
     Active: active (running) since Tue 2024-07-30 08:20:24 UTC; 6s ago
   Main PID: 15046 (beam.smp)
      Tasks: 24 (limit: 4658)
     Memory: 102.8M (peak: 107.9M)
        CPU: 3.770s
     CGroup: /system.slice/rabbitmq-server.service
             ├─15046 /usr/lib/erlang/erts-13.2.2.5/bin/beam.smp -W w -MBas ageffcbf -MHas ageffcbf -MBlmbcs 512 -MHlmbcs 512 -MMmcs 30 -pc unicode -P 1048576 -t 5000000 -stbt db -zdbbl 128000 -sbwt none -sbwtdcpu none -sb>
             ├─15056 erl_child_setup 65536
             ├─15108 /usr/lib/erlang/erts-13.2.2.5/bin/inet_gethost 4
             ├─15109 /usr/lib/erlang/erts-13.2.2.5/bin/inet_gethost 4
             └─15112 /bin/sh -s rabbit_disk_monitor

Jul 30 08:20:20 ubuntu-cloudspinx-com systemd[1]: Starting rabbitmq-server.service - RabbitMQ Messaging Server...
Jul 30 08:20:24 ubuntu-cloudspinx-com systemd[1]: Started rabbitmq-server.service - RabbitMQ Messaging Server.

Pasul 3: Instalați ONLYOFFICE Docs

Acum că am configurat mediul, suntem gata să instalăm ONLYOFFICE Docs pe sistemul nostru Ubuntu. Totuși, trebuie să importăm mai întâi cheia GPG folosită pentru semnarea pachetelor.

curl -fsSL  https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE|sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/onlyoffice.gpg

Odată ce GPG este importat, putem adăuga depozitul APT pentru ONLYOFFICE:

echo "deb https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

Actualizați memoria cache a managerului de pachete și instalați ONLYOFFICE Docs.

sudo apt update
sudo apt install onlyoffice-documentserver ttf-mscorefonts-installer

Când vi se solicită să introduceți parola bazei de date, apăsați pur și simplu tasta <ENTER> de pe tastatură pentru a continua. Apoi, acceptați termenii acordului de licență.

Verificați dacă apar erori în timpul instalării. Dacă totul decurge bine, ONLYOFFICE poate fi accesat în browserul dvs. la http://localhost sau http://serverdomain_or_ip.

Pasul 4: Protejați ONLYOFFICE Docs cu SSL

Putem configura ONLYOFFICE Docs pentru acces folosind protocolul HTTPS, care este mult mai sigur decât HTTP. Implicit, este configurat să ruleze pe HTTP.

În configurația noastră, serverul utilizat rulează într-un mediu Cloud. Acest lucru permite folosirea SSL gratuit de la Let’s Encrypt.

Folosirea SSL de la Let’s Encrypt

Cel mai simplu mod de a configura HTTPS pentru ONLYOFFICE Docs este să folosiți certificate SSL Let's Encrypt utilizând certbot. Folosiți următoarea comandă pentru a instala certbot.

Debian/Ubuntu:

sudo apt update && sudo apt install certbot
sudo apt install python3-certbot-nginx

Sisteme bazate pe RHEL:

sudo dnf -y install epel-release
sudo dnf -y install certbot python3-certbot-nginx

După ce ați instalat certbot, rulați scriptul ONLYOFFICE care automatizează configurările SSL.

sudo bash /usr/bin/documentserver-letsencrypt.sh [email  yourdomain.com

Înlocuiți [email cu adresa dvs. de email reală și yourdomain.com cu numele de domeniu configurat în DNS pentru serverul ONLYOFFICE Docs.

Când rulezi comenzile, acestea vor afișa calea către un fișier jurnal de unde poți verifica progresul generării SSL și orice erori vor fi înregistrate acolo.

Saving debug log to /var/log/letsencrypt/letsencrypt.log

Pentru a verifica conținutul fișierului de jurnal folosiți comanda cat:

sudo cat /var/log/letsencrypt/letsencrypt.log

Exemplu de ultimele câteva linii de ieșire din fișier:

...

-----BEGIN CERTIFICATE-----
MIIEVzCCAj+gAwIBAgIRAIOPbGPOsTmMYgZigxXJ/d4wDQYJKoZIhvcNAQELBQAw
TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMjQwMzEzMDAwMDAw
WhcNMjcwMzEyMjM1OTU5WjAyMQswCQYDVQQGEwJVUzEWMBQGA1UEChMNTGV0J3Mg
RW5jcnlwdDELMAkGA1UEAxMCRTUwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAAQNCzqK
a2GOtu/cX1jnxkJFVKtj9mZhSAouWXW0gQI3ULc/FnncmOyhKJdyIBwsz9V8UiBO
VHhbhBRrwJCuhezAUUE8Wod/Bk3U/mDR+mwt4X2VEIiiCFQPmRpM5uoKrNijgfgw
gfUwDgYDVR0PAQH/BAQDAgGGMB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcD
ATASBgNVHRMBAf8ECDAGAQH/AgEAMB0GA1UdDgQWBBSfK1/PPCFPnQS37SssxMZw
i9LXDTAfBgNVHSMEGDAWgBR5tFnme7bl5AFzgAiIyBpY9umbbjAyBggrBgEFBQcB
AQQmMCQwIgYIKwYBBQUHMAKGFmh0dHA6Ly94MS5pLmxlbmNyLm9yZy8wEwYDVR0g
BAwwCjAIBgZngQwBAgEwJwYDVR0fBCAwHjAcoBqgGIYWaHR0cDovL3gxLmMubGVu
Y3Iub3JnLzANBgkqhkiG9w0BAQsFAAOCAgEAH3KdNEVCQdqk0LKyuNImTKdRJY1C
2uw2SJajuhqkyGPY8C+zzsufZ+mgnhnq1A2KVQOSykOEnUbx1cy637rBAihx97r+
bcwbZM6sTDIaEriR/PLk6LKs9Be0uoVxgOKDcpG9svD33J+G9Lcfv1K9luDmSTgG
6XNFIN5vfI5gs/lMPyojEMdIzK9blcl2/1vKxO8WGCcjvsQ1nJ/Pwt8LQZBfOFyV
XP8ubAp/au3dc4EKWG9MO5zcx1qT9+NXRGdVWxGvmBFRAajciMfXME1ZuGmk3/GO
koAM7ZkjZmleyokP1LGzmfJcUd9s7eeu1/9/eg5XlXd/55GtYjAM+C4DG5i7eaNq
cm2F+yxYIPt6cbbtYVNJCGfHWqHEQ4FYStUyFnv8sjyqU8ypgZaNJ9aVcWSICLOI
E1/Qv/7oKsnZCWJ926wU6RqG1OYPGOi1zuABhLw61cuPVDT28nQS/e6z95cJXq0e
K1BcaJ6fJZsmbjRgD5p3mvEf5vdQM7MCEvU0tHbsx2I5mHHJoABHb8KVBgWp/lcX
GWiWaeOyB7RP+OfDtvi2OsapxXiV7vNVs7fMlrRjY1joKaqmmycnBvAq14AEbtyL
sVfOS66B8apkeFX2NY4XPEYV4ZSCe8VHPrdrERk2wILG3T/EGmSIkCYVUMSnjmJd
VQD9F6Na/+zmXCc=
-----END CERTIFICATE-----

2024-07-30 08:56:34,141:DEBUG:acme.client:Storing nonce: Ma8ZwRNA9J1JoJ_IMl_v_1HLCTTt5G01XNs8p_Mvri6JbKsSWrI
2024-07-30 08:56:34,142:DEBUG:certbot._internal.storage:Creating directory /etc/letsencrypt/archive.
2024-07-30 08:56:34,142:DEBUG:certbot._internal.storage:Creating directory /etc/letsencrypt/live.
2024-07-30 08:56:34,142:DEBUG:certbot._internal.storage:Writing README to /etc/letsencrypt/live/README.
2024-07-30 08:56:34,143:DEBUG:certbot._internal.storage:Creating directory /etc/letsencrypt/archive/docs.cloudlabske.com.
2024-07-30 08:56:34,143:DEBUG:certbot._internal.storage:Creating directory /etc/letsencrypt/live/docs.cloudlabske.com.
2024-07-30 08:56:34,143:DEBUG:certbot._internal.storage:Writing certificate to /etc/letsencrypt/live/docs.cloudlabske.com/cert.pem.
2024-07-30 08:56:34,143:DEBUG:certbot._internal.storage:Writing private key to /etc/letsencrypt/live/docs.cloudlabske.com/privkey.pem.
2024-07-30 08:56:34,143:DEBUG:certbot._internal.storage:Writing chain to /etc/letsencrypt/live/docs.cloudlabske.com/chain.pem.
2024-07-30 08:56:34,143:DEBUG:certbot._internal.storage:Writing full chain to /etc/letsencrypt/live/docs.cloudlabske.com/fullchain.pem.
2024-07-30 08:56:34,144:DEBUG:certbot._internal.storage:Writing README to /etc/letsencrypt/live/docs.cloudlabske.com/README.
2024-07-30 08:56:34,156:DEBUG:certbot.configuration:Var account=985390e388f48deb37eab1e67d361272 (set by user).
2024-07-30 08:56:34,157:DEBUG:certbot._internal.plugins.selection:Requested authenticator webroot and installer None
2024-07-30 08:56:34,157:DEBUG:certbot._internal.plugins.selection:Requested authenticator webroot and installer None
2024-07-30 08:56:34,157:DEBUG:certbot.configuration:Var webroot_path=['/var/www/onlyoffice/documentserver/letsencrypt'] (set by user).
2024-07-30 08:56:34,157:DEBUG:certbot.configuration:Var webroot_map={'docs.cloudlabske.com': '/var/www/onlyoffice/documentserver/letsencrypt'} (set by user).
2024-07-30 08:56:34,157:DEBUG:certbot._internal.storage:Writing new config /etc/letsencrypt/renewal/docs.cloudlabske.com.conf.
2024-07-30 08:56:34,159:DEBUG:certbot._internal.display.obj:Notifying user:
Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/docs.cloudlabske.com/fullchain.pem
Key is saved at:         /etc/letsencrypt/live/docs.cloudlabske.com/privkey.pem
This certificate expires on 2024-10-28.
These files will be updated when the certificate renews.
Certbot has set up a scheduled task to automatically renew this certificate in the background.
2024-07-30 08:56:34,161:DEBUG:certbot._internal.display.obj:Notifying user: If you like Certbot, please consider supporting our work by:
 * Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
 * Donating to EFF:                    https://eff.org/donate-le

Utilizarea certificatelor SSL auto-semnate

Pentru sistemele aflate într-o rețea privată, poți genera certificate auto-semnate. Alternativ, dacă gestionezi DNS-ul pe Cloudflare, consultă articolul nostru despre cum să configurezi Let’s Encrypt cu DNS-ul Cloudflare.

Utilizatorii care folosesc certificate auto-sem semnate pot edita următorul conținut al fișierului și pot ajusta calea către cheia și certificatul de domeniu:

sudo nano /etc/onlyoffice/documentserver/nginx/ds.conf

Vezi conținutul de mai jos din configurația noastră în acest articol folosind Let’s Encrypt.

include /etc/nginx/includes/http-common.conf;

## Normal HTTP host
server {
  listen 0.0.0.0:80;
  listen [::]:80 default_server;
  server_name _;
  server_tokens off;
  set $secure_link_secret nsdy8N28Ylobmp5EL4wF;

  ## Redirects all traffic to the HTTPS host
  root /nowhere; ## root doesn't have to be a valid path since we are redirecting
  rewrite ^ https://$host$request_uri? permanent;
}

#HTTP host for internal services
server {
  listen 127.0.0.1:80;
  listen [::1]:80;
  server_name localhost;
  server_tokens off;
  set $secure_link_secret nsdy8N28Ylobmp5EL4wF;

  include /etc/nginx/includes/ds-common.conf;
  include /etc/nginx/includes/ds-docservice.conf;
}

## HTTPS host
server {
  listen 0.0.0.0:443 ssl;
  listen [::]:443 ssl default_server;
  server_tokens off;
  set $secure_link_secret nsdy8N28Ylobmp5EL4wF;
  root /usr/share/nginx/html;

  ## Strong SSL Security
  ## https://raymii.org/s/tutorials/Strong_SSL_Security_On_nginx.html
  ssl_certificate /etc/letsencrypt/live/docs.cloudlabske.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/docs.cloudlabske.com/privkey.pem;
  # Uncomment string below and specify the path to the file with the password if you use encrypted certificate key
  # ssl_password_file {{SSL_PASSWORD_PATH}};
  ssl_verify_client off;

  ssl_ciphers "EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH";

  ssl_protocols TLSv1.2;
  ssl_session_cache  builtin:1000  shared:SSL:10m;

  ssl_prefer_server_ciphers   on;

  add_header Strict-Transport-Security max-age=31536000;
  # add_header X-Frame-Options SAMEORIGIN;
  add_header X-Content-Type-Options nosniff;

  ## [Optional] If your certficate has OCSP, enable OCSP stapling to reduce the overhead and latency of running SSL.
  ## Replace with your ssl_trusted_certificate. For more info see:
  ## - https://medium.com/devops-programming/4445f4862461
  ## - https://www.ruby-forum.com/topic/4419319
  ## - https://linux-console.net/community/tutorials/how-to-configure-ocsp-stapling-on-apache-and-nginx
  # ssl_stapling on;
  # ssl_stapling_verify on;
  # ssl_trusted_certificate /etc/nginx/ssl/stapling.trusted.crt;
  # resolver 208.67.222.222 208.67.222.220 valid=300s; # Can change to your DNS resolver if desired
  # resolver_timeout 10s;

  ## [Optional] Generate a stronger DHE parameter:
  ##   cd /etc/ssl/certs
  ##   sudo openssl dhparam -out dhparam.pem 4096
  ##
  # ssl_dhparam /etc/ssl/certs/dhparam.pem;

  include /etc/nginx/includes/ds-*.conf;

}

Actualizați ssl_certificate și ssl_certificate_key pentru a corespunde mediului dvs.

Accesează documentele OnlyOffice la https://yourdomain

Veți accesa pagina de bun venit a ONLYOFFICE Docs cu instrucțiuni suplimentare despre cum puteți activa exemplele de documente și integra aplicațiile utilizând API-ul furnizat.

Pasul 5: Integrează aplicații terțe

Procesul de integrare a ONLYOFFICE cu aplicațiile tale terțe, cum ar fi Pydio, Zimbra, WordPress, Odoo, SuiteCRM, Mattermost, etc., este simplu și fluid. Verifică toate conectoarele la următorul link:

Lista convertoarelor ONLYOFFICE