Collega Seafile e collabora utilizzando l'URL WOPI corretto.

Per connettere Seafile con Collabora Online, abilita HTTPS su Seafile, distribuisci Collabora e configura l'integrazione di Seafile con Office in modo che punti all'endpoint di rilevamento di Collabora. Se entrambi i servizi sono in esecuzione sulla stessa rete Docker, la guida di integrazione di Seafile utilizza l'URL interno http://collabora:9980/hosting/discovery; se Collabora è in esecuzione su un host separato, utilizza invece il suo URL HTTPS pubblico.

Il manuale di amministrazione di Seafile attualmente disponibile documenta collabora.ymlun'integrazione e impostazioni dedicate per Compose seahub_settings.py. I file di distribuzione esatti possono variare a seconda della versione di Seafile, quindi, quando si adattano questi esempi, è necessario utilizzare il manuale corrispondente alla versione installata.

Prima di iniziare

• Utilizza un indirizzo Seafile HTTPS con un certificato TLS valido. Seafile indica HTTPS come requisito per l'integrazione con Collabora.
• Scopri se Collabora verrà eseguito come un altro container sullo stesso host Docker o come un servizio ospitato separatamente.
• Disporre dell'accesso di amministratore alla directory di distribuzione di Seafile e seahub_settings.py.
• Scegli quali formati di documento consentire per l'anteprima e la modifica. Le impostazioni di Seafile controllano questi elenchi di estensioni.

Seafile e Collabora comunicano tramite WOPI. Seafile fornisce le informazioni di accesso al documento e Collabora richiede il file a Seafile. L'URL di rilevamento indica a Seafile quale servizio di Collabora utilizzare e quali funzionalità di modifica offre.

1. Confermare l'utilizzo di HTTPS su Seafile

Apri Seafile in un browser e verifica che il suo indirizzo normale inizi con https://e che il suo certificato sia valido. Per la distribuzione di Seafile con Docker, il manuale attuale mostra come impostare SEAFILE_SERVER_PROTOCOL=httpsnel .envfile e quindi completare la configurazione HTTPS tramite il proxy inverso configurato. Non procedere con un endpoint Seafile pubblico in HTTP semplice.

# In the Seafile deployment .env file
SEAFILE_SERVER_PROTOCOL=https

Mantieni il certificato e la chiave privata sotto il controllo del tuo proxy TLS o del gestore dei certificati. Questa impostazione da sola non emette un certificato né configura un proxy inverso; completa i passaggi HTTPS per la tua distribuzione prima di abilitare la modifica online di Office.

2. Aggiungi Collabora alla distribuzione Docker di Seafile

Per la configurazione Docker documentata sullo stesso host, utilizzare il file Compose di Collabora fornito da Seafile anziché creare una definizione di container non correlata. Nella directory di distribuzione di Seafile, scaricare il file per la versione manuale corrispondente e aggiungerlo collabora.ymlall'elenco esistente COMPOSE_FILEin .env. Conservare i file Compose già utilizzati dall'installazione.

# Example for a Seafile 14.0 deployment
wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Imposta le variabili Collabora documentate da Seafile in .env:

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=your_admin_username
COLLABORA_PASSWORD=use_a_long_unique_secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_ENABLE_FILE_LOGGING=false

Utilizza una password complessa e univoca e limita l'accesso al .envfile poiché contiene le credenziali. La porta di esempio è la porta esposta nella configurazione di integrazione di Seafile; non dare per scontato che sia la porta pubblica sul tuo reverse proxy. Segui le istruzioni relative collabora.ymlal file e alla configurazione del proxy per la tua versione.

Una volta aggiunto il servizio alla distribuzione, avviare o aggiornare lo stack Compose utilizzando la normale procedura Seafile. Evitare di pubblicare la porta interna di Collabora direttamente su Internet, a meno che la progettazione non lo richieda esplicitamente e l'endpoint non sia protetto.

3. Imposta Seafile sull'URL di rilevamento di Collabora

Modifica il file attivo seahub_settings.pye aggiungi le impostazioni di integrazione. Per la configurazione di Compose sullo stesso host, il manuale di Seafile utilizza il nome del servizio e la porta Collabora interna:

OFFICE_SERVER_TYPE = 'CollaboraOffice'
ENABLE_OFFICE_WEB_APP = True
OFFICE_WEB_APP_BASE_URL = 'http://collabora:9980/hosting/discovery'
WOPI_ACCESS_TOKEN_EXPIRATION = 30 * 60

OFFICE_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

ENABLE_OFFICE_WEB_APP_EDIT = True
OFFICE_WEB_APP_EDIT_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

L' http://URL qui riportato è l'indirizzo interno di comunicazione tra servizi nella rete Docker documentata di Seafile. Il sito Seafile accessibile tramite browser richiede comunque il protocollo HTTPS. Non copiare questo indirizzo interno in un'installazione su un host separato.

Per Collabora su un host diverso, configura Collabora dietro HTTPS sulla porta pubblica standard, con il reverse proxy che inoltra le richieste alla porta di ascolto di Collabora. Imposta l'URL di base sul tuo nome host pubblico effettivo, ad esempio:

OFFICE_WEB_APP_BASE_URL = 'https://office.example.com/hosting/discovery'

Assicurati che il nome host nell'URL sia risolvibile e che presenti un certificato valido dai client che devono aprire i documenti. Configura inoltre la lista di autorizzazione WOPI di Collabora in modo che accetti l'host del server Seafile. La documentazione ufficiale di Docker di Collabora descrive la aliasgroupvariabile d'ambiente per dichiarare l'host WOPI consentito; assicurati che corrisponda esattamente all'host e allo schema utilizzati da Seafile ed evita l'accesso con caratteri jolly generici su un server di produzione.

4. Riavvia e verifica la connessione

Riavvia Seafile in modo che Seahub carichi le nuove impostazioni Python. Utilizza la procedura di riavvio specifica per il tuo pacchetto, stack Compose o configurazione Kubernetes; i nomi dei servizi e i comandi variano a seconda dell'implementazione. Se hai aggiunto un nuovo file Compose, verifica che il container Collabora sia in esecuzione prima di testare il flusso di lavoro del browser.

Apri un documento di Office supportato dall'interfaccia web di Seafile. Il file dovrebbe aprirsi nell'editor di Collabora, mostrare il suo contenuto e salvare una piccola modifica di prova in Seafile. L'apertura corretta di un documento è più utile del semplice controllo della pagina di rilevamento, perché mette alla prova il browser, Seafile, Collabora e il trasferimento file WOPI.

Risolvere i problemi controllando ogni connessione

• Seahub segnala un errore di rilevamento: Confermare OFFICE_WEB_APP_BASE_URLche il servizio Seafile è raggiungibile. Utilizzare il nome del servizio Docker interno solo quando entrambi i container condividono la stessa rete.
• L'editor si carica ma non riesce a recuperare il file: controlla i log di Collabora e i log di Seafile. Verifica che Collabora consenta l'host WOPI di Seafile e che il certificato HTTPS di Seafile sia considerato attendibile.
• Funziona sullo stesso host ma non da remoto: sostituire l'URL interno con l'URL pubblico di rilevamento HTTPS, verificare DNS e TLS e accertarsi che il proxy inoltri le richieste di Collabora alla porta 9980.
• Sono aperti solo alcuni formati: Revisione OFFICE_WEB_APP_FILE_EXTENSIONe OFFICE_WEB_APP_EDIT_FILE_EXTENSION. Limita questi elenchi ai formati necessari ai tuoi utenti e supportati dalla tua implementazione di Collabora.
• Le impostazioni sembrano invariate dopo il riavvio:seahub_settings.py conferma di aver modificato il servizio Seafile attivo e di averlo riavviato correttamente.

Per un nodo Collabora autonomo, Seafile indirizza specificamente gli amministratori alla documentazione di distribuzione di Collabora anziché utilizzare il file incluso collabora.yml. Il file incluso è pensato per la stessa configurazione host/rete Docker descritta in precedenza.

Riferimenti ufficiali

• Manuale di amministrazione di Seafile: Integrazione con Collabora Online
• Seafile 14.0 Collabora Componi file
• Documentazione dell'immagine Docker di Collabora CODE