Installazione della versione Docker di ONLYOFFICE Docs per arm64

Requisiti di sistema

• CPU
  Processori ARM a 64 bit
• RAM
  4 GB o più
• HDD
  almeno 40 GB di spazio libero
• SWAP
  almeno 4 GB, ma dipende dal sistema operativo host. Più è meglio
• OS
  Distribuzione Linux per arm64
• Requisiti aggiuntivi
  • Docker: qualsiasi versione supportata dal team Docker

Generazione di certificati autofirmati

La generazione di certificati SSL autofirmati comporta una semplice procedura in 3 passaggi

PASSAGGIO 1: Creare la chiave privata del server

openssl genrsa -out onlyoffice.key 2048

PASSAGGIO 2: Creare la richiesta di firma del certificato (CSR)

openssl req -new -key onlyoffice.key -out onlyoffice.csr

PASSAGGIO 3: Firmare il certificato utilizzando la chiave privata e il CSR

openssl x509 -req -days 365 -in onlyoffice.csr -signkey onlyoffice.key -out onlyoffice.crt

Hai ora generato un certificato SSL valido per 365 giorni.

Rafforzare la sicurezza del server

Questa sezione ti fornisce istruzioni per rafforzare la sicurezza del tuo server.

Per ottenere ciò, è necessario generare parametri DHE più forti.

openssl dhparam -out dhparam.pem 2048

Installazione dei certificati SSL

Dei quattro file generati sopra, è necessario installare i file onlyoffice.key, onlyoffice.crt e dhparam.pem sul server onlyoffice. Il file CSR non è necessario, ma assicurati di eseguire un backup sicuro del file (nel caso in cui ne avessi nuovamente bisogno).

Il percorso predefinito in cui l'applicazione onlyoffice è configurata per cercare i certificati SSL è /var/www/onlyoffice/Data/certs, tuttavia questo può essere modificato utilizzando le opzioni di configurazione SSL_KEY_PATH, SSL_CERTIFICATE_PATH e SSL_DHPARAM_PATH.

Il percorso /var/www/onlyoffice/Data/ è il percorso dello store dei dati, il che significa che devi creare una cartella chiamata certs all'interno di /app/onlyoffice/DocumentServer/data/ e copiare i file al suo interno e come misura di sicurezza aggiornerai i permessi sul file onlyoffice.key per essere leggibile solo dal proprietario.

mkdir -p /app/onlyoffice/DocumentServer/data/certs
cp onlyoffice.key /app/onlyoffice/DocumentServer/data/certs/
cp onlyoffice.crt /app/onlyoffice/DocumentServer/data/certs/


cp dhparam.pem /app/onlyoffice/DocumentServer/data/certs/
chmod 400 /app/onlyoffice/DocumentServer/data/certs/onlyoffice.key

E riavvia il container Docker:

sudo docker restart {{DOCUMENT_SERVER_ID}}

Ora sei a un passo dall'avere la nostra applicazione sicura.

Parametri di configurazione disponibili

Di seguito è riportato l'elenco completo dei parametri che possono essere impostati utilizzando le variabili di ambiente.

• ONLYOFFICE_HTTPS_HSTS_ENABLED: Opzione di configurazione avanzata per disattivare la configurazione HSTS. Applicabile solo quando SSL è in uso. Il valore predefinito è true.
• ONLYOFFICE_HTTPS_HSTS_MAXAGE: Opzione di configurazione avanzata per impostare il max-age HSTS nella configurazione vHost di onlyoffice NGINX. Applicabile solo quando SSL è in uso. Il valore predefinito è 31536000.
• SSL_CERTIFICATE_PATH: Il percorso al certificato SSL da utilizzare. Il valore predefinito è /var/www/onlyoffice/Data/certs/tls.crt.
• SSL_KEY_PATH: Il percorso alla chiave privata del certificato SSL. Il valore predefinito è /var/www/onlyoffice/Data/certs/tls.key.
• SSL_DHPARAM_PATH: Il percorso al parametro Diffie-Hellman. Il valore predefinito è /var/www/onlyoffice/Data/certs/dhparam.pem.
• SSL_VERIFY_CLIENT: Abilita la verifica dei certificati client utilizzando il CA_CERTIFICATES_PATH file. Il valore predefinito è false.
• DB_TYPE: Il tipo di database. I valori supportati sono postgres, mariadb o mysql. Il valore predefinito è postgres.
• DB_HOST: L'indirizzo IP o il nome dell'host dove è in esecuzione il server del database.
• DB_PORT: Il numero di porta del server del database.
• DB_NAME: Il nome di un database da creare all'avvio dell'immagine.
• DB_USER: Il nuovo nome utente con permessi di superutente per l'account del database.
• DB_PWD: La password impostata per l'account del database.
• AMQP_URI: L'URI AMQP per connettersi al server del broker di messaggi.
• AMQP_TYPE: Il tipo di broker di messaggi. I valori supportati sono rabbitmq o activemq. Il valore predefinito è rabbitmq.
• REDIS_SERVER_HOST: L'indirizzo IP o il nome dell'host dove è in esecuzione il server Redis.
• REDIS_SERVER_PORT: Il numero di porta del server Redis.
• REDIS_SERVER_PASS: La password del server Redis. La password non è impostata di default.
• NGINX_WORKER_PROCESSES: Definisce il numero di processi worker di NGINX.
• NGINX_WORKER_CONNECTIONS: Imposta il numero massimo di connessioni simultanee che possono essere aperte da un processo worker di NGINX.
• SECURE_LINK_SECRET: Definisce il segreto per la direttiva di configurazione nginx secure_link_md5. Il valore predefinito è random string.
• JWT_ENABLED: Specifica l'abilitazione della validazione del JSON web token da parte di ONLYOFFICE Docs. Il valore predefinito è true.
• JWT_SECRET: Definisce la chiave segreta per validare il JSON web token nella richiesta a ONLYOFFICE Docs. Il valore predefinito è un valore casuale.
• JWT_HEADER: Definisce l'intestazione HTTP che verrà utilizzata per inviare il JSON web token. Il valore predefinito è Authorization.
• JWT_IN_BODY: Specifica l'abilitazione della validazione del token nel corpo della richiesta a ONLYOFFICE Docs. Il valore predefinito è false.
• ALLOW_META_IP_ADDRESS: Definisce se è consentito connettersi all'indirizzo IP meta o meno. Il valore predefinito è false.
• ALLOW_PRIVATE_IP_ADDRESS: Definisce se è consentito connettersi all'indirizzo IP privato o meno. Il valore predefinito è false.
• WOPI_ENABLED: Specifica l'abilitazione dei gestori wopi. Il valore predefinito è false.
• USE_UNAUTHORIZED_STORAGE: Imposta su true se si utilizzano certificati autofirmati per il server di archiviazione, ad esempio Nextcloud. Il valore predefinito è false.
• GENERATE_FONTS: Quando true, rigenera l'elenco dei font e le miniature dei font ecc. ad ogni avvio. Il valore predefinito è true.
• METRICS_ENABLED: Specifica l'abilitazione di StatsD per ONLYOFFICE Docs. Il valore predefinito è false.
• METRICS_HOST: Definisce l'host di ascolto di StatsD. Il valore predefinito è localhost.
• METRICS_PORT: Definisce la porta di ascolto di StatsD. Il valore predefinito è 8125.
• METRICS_PREFIX: Definisce il prefisso delle metriche StatsD per i servizi backend. Il valore predefinito è ds..
• LETS_ENCRYPT_DOMAIN: Definisce il dominio per il certificato Let's Encrypt.
• LETS_ENCRYPT_MAIL: Definisce l'indirizzo email dell'amministratore del dominio per il certificato Let's Encrypt.