Verbind Seafile en Collabora met de juiste WOPI-URL.

Om Seafile met Collabora Online te verbinden, moet u HTTPS inschakelen in Seafile, Collabora implementeren en de Office-integratie van Seafile laten verwijzen naar het discovery-eindpunt van Collabora. Als beide services op hetzelfde Docker-netwerk draaien, gebruikt de huidige integratiehandleiding van Seafile de interne URL http://collabora:9980/hosting/discovery; als Collabora op een aparte host draait, gebruikt u in plaats daarvan de openbare HTTPS-URL.

De huidige Seafile-beheerdershandleiding beschrijft een specifieke collabora.ymlCompose-integratie en de bijbehorende instellingen seahub_settings.py. De exacte implementatiebestanden kunnen per Seafile-versie verschillen, dus raadpleeg de handleiding die overeenkomt met uw geïnstalleerde versie wanneer u deze voorbeelden aanpast.

Voordat je begint

• Gebruik een HTTPS Seafile-adres met een geldig TLS-certificaat. Seafile vermeldt HTTPS als een vereiste voor Collabora-integratie.
• Weet of Collabora als een aparte container op dezelfde Docker-host draait of als een afzonderlijk gehoste service.
• U moet beheerdersrechten hebben voor de implementatiemap van Seafile en seahub_settings.py.
• Kies welke documentformaten u wilt bekijken en bewerken. De Seafile-instellingen bepalen welke extensies worden ondersteund.

Seafile en Collabora communiceren via WOPI. Seafile levert de informatie over de toegang tot het document, en Collabora vraagt ​​het bestand op bij Seafile. De discovery-URL vertelt Seafile welke Collabora-service te gebruiken en welke bewerkingsmogelijkheden deze biedt.

1. Controleer of HTTPS is ingeschakeld op Seafile.

Open Seafile in een browser en controleer of het normale adres begint met https://en of het certificaat geldig is. Voor de Docker-implementatie van Seafile laat de huidige handleiding zien hoe je dit instelt SEAFILE_SERVER_PROTOCOL=httpsin het .envbestand en vervolgens de HTTPS-configuratie voltooit via de geconfigureerde reverse proxy. Ga niet verder met een openbaar, gewoon HTTP-adres voor Seafile.

# In the Seafile deployment .env file
SEAFILE_SERVER_PROTOCOL=https

Houd het daadwerkelijke certificaat en de privésleutel onder controle van uw TLS-proxy of certificaatbeheerder. Deze instelling alleen geeft geen certificaat uit en configureert geen reverse proxy; voltooi de HTTPS-stappen voor uw implementatie voordat u online Office-bewerking inschakelt.

2. Voeg Collabora toe aan de Seafile Docker-implementatie.

Voor de gedocumenteerde Docker-configuratie op dezelfde host, gebruikt u het Collabora Compose-bestand dat door Seafile wordt geleverd in plaats van een aparte containerdefinitie samen te stellen. Download in de Seafile-implementatiemap het bestand voor de bijbehorende handmatige versie en voeg dit toe collabora.ymlaan de bestaande COMPOSE_FILElijst in .env. Bewaar de Compose-bestanden die al door uw installatie worden gebruikt.

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

Stel de Collabora-variabelen in zoals gedocumenteerd door 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

Gebruik een uniek, sterk wachtwoord en beperk de toegang tot het .envbestand, omdat het inloggegevens bevat. De voorbeeldpoort is de poort die is blootgesteld in de integratieconfiguratie van Seafile; ga er niet vanuit dat dit de openbare poort van uw reverse proxy is. Volg de instructies in het bijbehorende collabora.ymlbestand en de proxy-instellingen voor uw release.

Zodra de service aan de implementatie is toegevoegd, start of update je de Compose-stack volgens je gebruikelijke Seafile-procedure. Vermijd het rechtstreeks publiceren van de interne poort van Collabora naar internet, tenzij je ontwerp dit expliciet vereist en je het eindpunt hebt beveiligd.

3. Stel Seafile in op de ontdekkings-URL van Collabora.

Bewerk het actieve seahub_settings.pybestand en voeg de integratie-instellingen toe. Voor de Compose-configuratie op dezelfde host gebruikt de Seafile-handleiding de servicenaam en de interne Collabora-poort:

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'
)

De http://URL die hier wordt weergegeven, is het interne service-to-service-adres in het gedocumenteerde Docker-netwerk van Seafile. De voor browsers toegankelijke Seafile-website vereist nog steeds HTTPS. Kopieer dit interne adres niet naar een implementatie op een aparte host.

Voor Collabora op een andere host configureert u Collabora achter HTTPS op de standaard publieke poort, waarbij de reverse proxy de verzoeken doorstuurt naar de luisterpoort van Collabora. Stel de basis-URL in op uw daadwerkelijke publieke hostnaam, bijvoorbeeld:

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

Zorg ervoor dat de hostnaam in de URL correct wordt opgelost en een geldig certificaat presenteert van de clients die documenten moeten openen. Configureer ook de WOPI-whitelist van Collabora om de host van de Seafile-server toe te staan. De officiële Docker-documentatie van Collabora beschrijft de aliasgroupomgevingsvariabele voor het declareren van de toegestane WOPI-host; zorg ervoor dat de host en het schema exact overeenkomen met die van Seafile en vermijd brede wildcard-toegang op een productieserver.

4. Herstart en test de verbinding.

Herstart Seafile zodat Seahub de nieuwe Python-instellingen laadt. Gebruik de herstartprocedure voor uw pakket, Compose-stack of Kubernetes-configuratie; servicenamen en commando's verschillen per implementatie. Als u een nieuw Compose-bestand hebt toegevoegd, controleer dan of de Collabora-container actief is voordat u de browserworkflow test.

Open een ondersteund Office-document via de webinterface van Seafile. Het bestand zou in de editor van Collabora moeten openen, de inhoud ervan weergeven en een kleine testwijziging terug naar Seafile opslaan. Dat een document succesvol opent, is nuttiger dan alleen de ontdekkingspagina controleren, omdat het de browser, Seafile, Collabora en WOPI-bestandsoverdracht test.

Los problemen op door elke verbinding te controleren.

• Seahub meldt een ontdekkingsfout: Bevestig OFFICE_WEB_APP_BASE_URLdat de Seafile-service bereikbaar is. Gebruik de interne Docker-servicenaam alleen wanneer beide containers dat netwerk delen.
• De editor laadt wel, maar kan het bestand niet ophalen: controleer de Collabora-logboeken en de Seafile-logboeken. Controleer of Collabora de Seafile WOPI-host toestaat en of het HTTPS-certificaat van Seafile wordt vertrouwd.
• Het werkt op dezelfde host, maar niet op afstand: vervang de interne URL door de openbare HTTPS-ontdekkings-URL, controleer DNS en TLS en verifieer of de proxy Collabora-verzoeken doorstuurt naar poort 9980.
• Slechts enkele formaten zijn beschikbaar: Review OFFICE_WEB_APP_FILE_EXTENSIONen OFFICE_WEB_APP_EDIT_FILE_EXTENSION. Beperk deze lijsten tot de formaten die uw gebruikers nodig hebben en die uw Collabora-implementatie ondersteunt.
• De instellingen lijken ongewijzigd na de herstart: controleer of u de actieve seahub_settings.pySeafile-service correct hebt bewerkt en opnieuw hebt opgestart.

Voor een zelfstandige Collabora-node verwijst Seafile beheerders specifiek naar de implementatiedocumentatie van Collabora in plaats van het meegeleverde bestand te gebruiken collabora.yml. Het meegeleverde bestand is bedoeld voor dezelfde Docker-host/netwerkconfiguratie als hierboven beschreven.

Officiële referenties

• Seafile-beheerdershandleiding: Integratie met Collabora Online
• Seafile 14.0 Collabora Bestand samenstellen
• Collabora CODE Docker-image documentatie