Passa al contenuto principale

Installazione di ONLYOFFICE Docs per CentOS e derivati

Introduzione​

Community Edition ti permette di installare ONLYOFFICE Docs sul tuo server locale e integrare gli editor online con la piattaforma di collaborazione ONLYOFFICE o con altri sistemi popolari, consentendoti di condividere file, gestire i diritti di accesso, incorporare documenti su un sito web e modificare file archiviati su Drive, Box, Dropbox, OneDrive o ownCloud collegati a ONLYOFFICE (consulta la lista dettagliata delle funzionalità). Questa guida ti mostrerà come installare la versione Linux di ONLYOFFICE Docs Community Edition sulla tua macchina.

Requisiti di sistema​

  • CPU: dual core 2 GHz o superiore
  • RAM: almeno 2 GB, ma dipende dal sistema operativo host. Più è meglio
  • HDD: almeno 40 GB di spazio libero
  • SWAP: almeno 4 GB, ma dipende dal sistema operativo host. Più è meglio
  • OS: CentOS Stream 9, RHEL 8, o RHEL 9
  • Requisiti aggiuntivi
    • NGINX: versione 1.30 o successiva

Installazione delle dipendenze​

Installazione della versione aggiornata del pacchetto NGINX​

Per configurare il repository yum per RHEL/CentOS, crea il file denominato /etc/yum.repos.d/nginx.repo con il seguente contenuto:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Istruzione ufficiale

Installa NGINX:

sudo yum install nginx

Dopodiché, modifica il file di configurazione /etc/nginx/nginx.conf di NGINX, in modo che appaia come segue:

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}
Importante

Se intendi eseguire ONLYOFFICE Docs sulla porta 80, disattiva ora il sito web predefinito di NGINX. Altrimenti ONLYOFFICE Docs potrebbe non funzionare correttamente. Per farlo, esegui i seguenti comandi:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

A seconda di come è stato installato NGINX, uno dei primi due comandi potrebbe segnalare che il file non esiste. Puoi ignorare tranquillamente questo messaggio.

Installazione del repository EPEL​

sudo yum install epel-release

Per installare EPEL su CentOS 9, utilizza i seguenti comandi:

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

Per installare EPEL su RHEL, utilizza i seguenti comandi:

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

Cambia $REV con la versione del tuo sistema operativo manualmente (7 per le versioni 7.x, 8 per le versioni 8.x, 9 per le versioni 9.x e così via).

Aggiunta del repository ONLYOFFICE Docs​

Aggiungi il repository yum di ONLYOFFICE Docs con il seguente comando:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

Installazione di mscorefonts​

Installa i pacchetti cabextract e xorg-x11-font-utils:

sudo yum install cabextract xorg-x11-font-utils

Per CentOS 7.8(2003), è richiesto anche fontconfig:

sudo yum install fontconfig

Installa il pacchetto di font msttcore:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

Installazione di ONLYOFFICE Docs​

Esegui il seguente comando per l'edizione Community:

sudo yum install onlyoffice-documentserver

Avvia il servizio nginx e abilita l'avvio automatico:

sudo service nginx start
sudo systemctl enable nginx

Dopo di ciò, ONLYOFFICE Docs verrà eseguito come un processo. Il pacchetto verrà aggiornato come qualsiasi altro pacchetto rpm.

Aggiornamento di ONLYOFFICE Docs​

Per aggiornare ONLYOFFICE Docs, esegui il seguente comando:

sudo yum update onlyoffice-documentserver
Importante

Su RHEL 8 e i suoi derivati, eseguire yum update con il repository ONLYOFFICE abilitato potrebbe fallire con un errore di dipendenza.

Per evitare ciò, escludi questi pacchetti dal repository ONLYOFFICE in modo che siano ottenuti dal repository AppStream del sistema:

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

Questo comando deve essere eseguito solo una volta. Dopo di ciò, yum update funzionerà come previsto.

Se hai installato ONLYOFFICE Docs tramite OneClick Install, questa esclusione è già applicata automaticamente.

Cambiare la porta predefinita di ONLYOFFICE Docs​

Per impostazione predefinita, ONLYOFFICE Docs ascolta le connessioni in arrivo utilizzando la porta 8083. A partire dalla versione 4.3 puoi cambiare la porta per ONLYOFFICE Docs se prevedi di utilizzarla al posto di quella predefinita.

note

Se intendi cambiare la porta predefinita, assicurati che sia aperta per le connessioni in entrata/uscita. Consulta l'elenco completo delle porte utilizzate da ONLYOFFICE Docs.

Per farlo, dovrai modificare la variabile d'ambiente DS_PORT eseguendo il comando:

export DS_PORT=<PORT_NUMBER>

Inserisci il numero di porta al posto di <PORT_NUMBER> nel comando sopra.

note

Se imposti la porta su 80, assicurati di aver disattivato il sito web predefinito di NGINX come descritto nella sezione Installazione della versione aggiornata del pacchetto NGINX.

Attenzione

Se vuoi cambiare il protocollo di ONLYOFFICE Docs in HTTPS, non cambiare la porta a 443, ma utilizza questa istruzione invece.

Dopo di ciò, puoi continuare a configurare ONLYOFFICE Docs.

Configurazione di ONLYOFFICE Docs​

Esegui uno script di configurazione​

Esegui lo script documentserver-configure:

bash documentserver-configure

Aggiungi un'eccezione al firewall​

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

Disabilita SELinux​

note

deprecato dalla v.5.0

Apri il file /etc/selinux/config utilizzando un qualsiasi editor di testo, sostituisci la stringa SELINUX=enforcing o SELINUX=permissive con SELINUX=disabled e salva le modifiche.

Riavvia il server affinché le modifiche abbiano effetto.

Nota

Per motivi di sicurezza, a partire dalla v8.1, nuove chiavi WOPI vengono generate in local.json quando si esegue lo script documentserver-configure. Se stai utilizzando una connessione WOPI, devi eseguire lo script dopo aver aggiornato ONLYOFFICE Docs:

documentserver-configure --wopienabled true

Avviare ONLYOFFICE Docs in un browser​

Una volta completata la configurazione, puoi inserire http://localhost:8083 nella barra degli indirizzi del tuo browser per aprire la pagina di benvenuto di ONLYOFFICE Docs, dove troverai ulteriori istruzioni su come abilitare esempi di documenti o integrare editor online nella tua applicazione web utilizzando l'API fornita.

Per connettere ONLYOFFICE Docs a ONLYOFFICE Workspace, consulta questa istruzione.