Questo articolo è stato tradotto dall’AI

Installazione di ONLYOFFICE Docs Developer Edition per CentOS e derivati

Introduzione

Developer Edition ti permette di installare ONLYOFFICE Docs sul tuo server locale e integrare gli editor online con la tua applicazione web.

ONLYOFFICE Docs è una suite office online che include visualizzatori ed editor per testi, fogli di calcolo e presentazioni, completamente compatibile con i formati Office Open XML: .docx, .xlsx, .pptx e consente la modifica collaborativa in tempo reale.

Funzionalità

  • Editor di Documenti
  • Editor di Fogli di Calcolo
  • Editor di Presentazioni
  • Visualizzatori web mobili
  • Editor web mobili
  • Modifica collaborativa
  • Supporto per geroglifici
  • Supporto per tutti i formati più popolari: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Consulta la lista dettagliata delle funzionalità disponibili per ONLYOFFICE Docs Developer Edition.

Questa guida ti mostrerà come installare la versione Linux di ONLYOFFICE Docs Developer 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:
    • PostgreSQL: versione 12.9 o successiva
    • NGINX: versione 1.3.13 o successiva
    • Redis: versione 5 o successiva
    • RabbitMQ

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

Istruzioni ufficiali

Installa NGINX:

sudo yum install nginx

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

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;
}
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

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

Installazione e configurazione di PostgreSQL

Installa la versione di PostgreSQL inclusa nella tua versione di CentOS:

sudo yum install postgresql postgresql-server
Se desideri installare un'altra versione di PostgreSQL dal Repository PostgreSQL, consulta la documentazione ufficiale di PostgreSQL per maggiori dettagli.

Inizializza il database PostgreSQL

sudo service postgresql initdb 
sudo chkconfig postgresql on

Su CentOS 9, chkconfig non è installato di default. Installalo utilizzando il seguente comando:

sudo yum install chkconfig

Attiva il metodo di autenticazione 'scram-sha-256' per localhost IPv4 e IPv6

Apri il file /var/lib/pgsql/data/pg_hba.conf in un editor di testo.

Trova la stringa host all all 127.0.0.1/32 ident e sostituiscila con la seguente:

host    all             all             127.0.0.1/32            scram-sha-256

Quindi trova la stringa host all all ::1/128 ident e sostituiscila con la seguente:

host    all             all             ::1/128                 scram-sha-256

Salva le modifiche.

Apri il file /var/lib/pgsql/data/postgresql.conf in un editor di testo.

Trova 'password_encryption', decommentalo e sostituisci il valore con 'scram-sha-256':

password_encryption = 'scram-sha-256'

Salva le modifiche.

Riavvia il servizio PostgreSQL:

sudo service postgresql restart

Crea il database e l'utente PostgreSQL:

Puoi specificare qualsiasi nome utente e password.

Esegui prima il comando

cd /tmp

per evitare l'avviso could not change directory to "/root" se eseguito da root. Quindi il database e l'utente devono essere creati:

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

Esegui il seguente comando:

sudo yum -y install redis

Avvia il servizio redis e abilita l'avvio all'accensione:

sudo systemctl enable --now redis
Installazione di RabbitMQ
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/rabbitmq-server/script.rpm.sh | os=centos dist=$REV sudo bash
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/erlang/script.rpm.sh | os=centos dist=$REV sudo bash

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

sudo yum install rabbitmq-server

In alternativa, puoi installare RabbitMQ su CentOS 8 o CentOS 9 dal sito ufficiale.

Avvia il servizio rabbitmq e abilita l'avvio all'accensione:

sudo systemctl enable --now rabbitmq-server
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 Developer:

sudo yum install onlyoffice-documentserver-de

Avvia il servizio nginx e abilita l'avvio automatico al boot:

sudo service nginx start
sudo systemctl enable nginx

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

Aggiornare ONLYOFFICE Docs

Per aggiornare ONLYOFFICE Docs, esegui il seguente comando:

sudo yum update onlyoffice-documentserver-de
Importante Su RHEL 8 e i suoi derivati, eseguire yum update con il repository di ONLYOFFICE abilitato potrebbe fallire con un errore di dipendenza.

Per evitare ciò, escludi questi pacchetti dal repository di ONLYOFFICE in modo che vengano presi dal repository AppStream di 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 entrata utilizzando la porta 80. A partire dalla versione 4.3 puoi cambiare la porta per ONLYOFFICE Docs se intendi utilizzarne una diversa da quella predefinita.

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.

Avviso Se desideri 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.

Configurare ONLYOFFICE Docs

Esegui uno script di configurazione
Nota Per impostazione predefinita, viene utilizzato PostgreSQL come database. Se desideri utilizzare MySQL invece di PostgreSQL, aggiungi due variabili d'ambiente per definire il tipo di database e la porta prima di eseguire lo script documentserver-configure.sh:
export DB_TYPE=mysql
export DB_PORT=3306

Dopo aver aggiunto queste due variabili, sarai in grado di cambiare il database utilizzando lo script.

Esegui lo script documentserver-configure.sh:

bash documentserver-configure.sh

Ti verrà chiesto di specificare i parametri di connessione per PostgreSQL, Redis e RabbitMQ. Utilizza i seguenti dati:

Per PostgreSQL:

  • Host: localhost
  • Database: onlyoffice
  • Utente: onlyoffice
  • Password: onlyoffice

Per Redis:

  • Host: localhost

Per RabbitMQ:

  • Host: localhost
  • Utente: guest
  • Password: guest
Aggiungi un'eccezione al firewall
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload
Disabilita SELinux
deprecato dalla versione 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 versione 8.1, nuove chiavi WOPI vengono generate in local.json quando si esegue lo script documentserver-configure.sh. Se stai utilizzando una connessione WOPI, devi eseguire lo script dopo aver aggiornato ONLYOFFICE Docs:
documentserver-configure.sh --wopienabled true

Avviare ONLYOFFICE Docs in un browser

Una volta completata la configurazione, puoi inserire http://localhost 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.

Registrare la tua versione Developer Edition

Se hai acquistato Developer Edition e hai ricevuto il file license.lic, puoi posizionarlo nella tua installazione per ottenere la versione completa del software.

Se sei un utente di una distribuzione Linux basata su Red Hat, il file license.lic viene posizionato nella seguente cartella:

/var/www/onlyoffice/Data/license.lic

Dopo di ciò, la tua versione di Developer Edition sarà registrata e completa di tutte le funzionalità.

Voci con l'etichetta tag:
Sfoglia tutti i tag