Installazione di ONLYOFFICE Docs Developer Edition per Debian, Ubuntu e derivati

Introduzione

Developer Edition ti consente di installare ONLYOFFICE Docs sul tuo server locale e integrare gli editor online con la tua applicazione web (consulta la lista dettagliata delle funzionalità). 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: 64-bit Debian, Ubuntu o altra distribuzione compatibile con kernel versione 3.13 o successiva
• Requisiti aggiuntivi
  • PostgreSQL: versione 12.9 o successiva
  • NGINX: versione 1.3.13 o successiva
  • libstdc++6: versione 4.8.4 o successiva
  • Redis: versione 4 o successiva
  • RabbitMQ

Installazione di ONLYOFFICE Docs

L'installazione con distribuzioni basate su Debian richiede anche la presenza di libstdc++6, NGINX e PostgreSQL nel sistema.

Tutte le istruzioni necessarie per questi componenti e le loro dipendenze possono essere trovate sui loro siti ufficiali.

Ci sono altre dipendenze installate insieme a ONLYOFFICE Docs:

• libcurl3
• libxml2
• fonts-dejavu
• fonts-liberation
• ttf-mscorefonts-installer
• fonts-crosextra-carlito
• fonts-takao-gothic
• fonts-opensymbol

Queste dipendenze vengono installate automaticamente quando si utilizza Ubuntu 14.04 LTS o successivo. Le distribuzioni precedenti potrebbero richiedere la loro installazione manuale.

Installazione delle dipendenze

ONLYOFFICE Docs utilizza NGINX e PostgreSQL come database. Le dipendenze trovate nel repository di sistema verranno installate automaticamente durante l'installazione di ONLYOFFICE Docs utilizzando il comando apt-get install.

Installazione e configurazione di PostgreSQL

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

sudo apt-get install postgresql

note

Se desideri installare un'altra versione di PostgreSQL dal Repository di PostgreSQL, consulta la documentazione ufficiale di PostgreSQL per maggiori dettagli.

Dopo l'installazione di PostgreSQL, crea il database e l'utente PostgreSQL:

note

L'utente del database deve avere il nome onlyoffice. Puoi specificare qualsiasi password.

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

sudo apt-get install redis-server

Installazione di RabbitMQ

sudo apt-get install rabbitmq-server

Installazione di NGINX

sudo apt-get install nginx

note

Su Ubuntu 18.04, installa invece il pacchetto nginx-extras: sudo apt-get install nginx-extras

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.

note

Le distribuzioni Ubuntu precedenti alla 14.04 LTS potrebbero richiedere l'installazione di altre dipendenze.

Modifica della porta predefinita di ONLYOFFICE Docs

Di default, ONLYOFFICE Docs ascolta le connessioni in entrata utilizzando la porta 8083. A partire dalla versione 4.3 puoi cambiare la porta per ONLYOFFICE Docs se intendi utilizzarla al posto di quella predefinita.

note

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

Per farlo, dovrai cambiare la porta predefinita per il sistema debconf, eseguendo il comando:

echo onlyoffice-documentserver-de onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

Si prega di scrivere 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 di NGINX.

Avviso

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

Ci sono opzioni aggiuntive che possono essere utilizzate per l'installazione di ONLYOFFICE Docs. Si prega di leggere questa sezione per maggiori informazioni su di esse.

Dopo di ciò, puoi continuare con l'installazione di ONLYOFFICE Docs.

Installazione di ONLYOFFICE Docs

Aggiungi chiave GPG:

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

Aggiungi il repository di ONLYOFFICE Docs:

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

note

Sebbene il pacchetto APT sia costruito per Debian Squeeze, è compatibile con numerose derivate di Debian (incluso Ubuntu), il che significa che puoi utilizzare lo stesso repository su tutte queste distribuzioni.

Quando installi ONLYOFFICE Docs su Debian, aggiungi il componente contrib a /etc/apt/sources.list. Per saperne di più, puoi fare riferimento alla documentazione Debian.

Aggiorna la cache del gestore pacchetti:

sudo apt-get update

Installa mscorefonts:

sudo apt-get install ttf-mscorefonts-installer

Installa ONLYOFFICE Docs:

sudo apt-get install onlyoffice-documentserver-de

note

Durante il processo di installazione, ti verrà chiesto di fornire una password per l'utente PostgreSQL onlyoffice. Inserisci la password onlyoffice che hai specificato durante la configurazione di PostgreSQL.

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

Ora 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.

Esecuzione di ONLYOFFICE Docs utilizzando HTTPS

Nella maggior parte dei casi, accedere al portale tramite protocollo HTTPS è molto più sicuro rispetto a HTTP, che è utilizzato di default. Puoi facilmente eseguire ONLYOFFICE Docs utilizzando una connessione sicura. Consulta i dettagli qui per saperne di più su come questo può essere fatto.

Registrazione della tua versione Developer Edition

Se hai acquistato la 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 Debian, 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à.

Informazioni aggiuntive: ulteriori opzioni per l'installazione di ONLYOFFICE Docs

L'installazione di ONLYOFFICE Docs consente l'uso di più opzioni debconf, che potrebbero essere molto utili nel caso in cui pianifichi di installarlo su più di un server o in altri casi.

Queste opzioni includono:

• Opzioni del database PostgreSQL

  • Imposta l'indirizzo host del database PostgreSQL (sostituendo <DB_HOST> con l'indirizzo effettivo del server PostgreSQL installato):

    echo onlyoffice-documentserver-de onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections

  • Imposta il nome utente del database PostgreSQL (sostituendo <DB_USER> con il nome effettivo dell'utente con i diritti appropriati sul database PostgreSQL):

    echo onlyoffice-documentserver-de onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections

  • Imposta la password dell'utente del database PostgreSQL (sostituendo <DB_PASSWORD> con la password effettiva dell'utente con i diritti appropriati sul database PostgreSQL):

    echo onlyoffice-documentserver-de onlyoffice/db-pwd password <DB_PASSWORD> | debconf-set-selections

  • Imposta il nome del database PostgreSQL (sostituendo <DB_NAME> con il nome effettivo del database PostgreSQL):

    echo onlyoffice-documentserver-de onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections

• Opzioni Redis

  • Imposta l'indirizzo host di Redis (sostituendo <REDIS_HOST> con l'indirizzo effettivo di Redis installato):

    echo onlyoffice-documentserver-de onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections

• Opzioni RabbitMQ

  • Imposta l'indirizzo host di RabbitMQ (sostituendo <RABBITMQ_HOST> con l'indirizzo effettivo di RabbitMQ installato):

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections

  • Imposta il nome utente di RabbitMQ (sostituendo <RABBITMQ_USER> con il nome effettivo dell'utente con i diritti appropriati su RabbitMQ):

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections

  • Imposta la password dell'utente di RabbitMQ (sostituendo <RABBITMQ_PWD> con la password effettiva dell'utente con i diritti appropriati su RabbitMQ):

    echo onlyoffice-documentserver-de onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections

• Opzioni JWT

  Puoi utilizzare debconf-set-selections per disabilitare la sovrascrittura dei valori personalizzati nel file local.json dopo l'aggiornamento di ONLYOFFICE Docs.

  • Abilita JSON Web Tokens (JWT):

    echo onlyoffice-documentserver-de onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

  • Imposta una chiave segreta JWT sostituendo <JWT_SECRET> con il tuo valore:

    echo onlyoffice-documentserver-de onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections