Hoe Collabora Online te verbinden met Seafile: installatieopties en -stappen

Seafile kan ondersteunde Office-bestanden openen in Collabora Online via WOPI, een protocol waarmee de opslagserver en de online editor documentinformatie en bestandsinhoud kunnen uitwisselen. De juiste implementatie hangt af van waar u Seafile uitvoert, hoe u HTTPS en reverse proxies beheert en of u Collabora op hetzelfde Docker-netwerk of op een aparte server wilt draaien.

Deze handleiding volgt de instructies voor de Collabora-integratie uit de huidige Seafile Admin Manual (Seafile 14.0-documentatie, gecontroleerd op 6 oktober 2026). De exacte Docker Compose-bestanden en imagetags kunnen veranderen, dus gebruik de bestanden die bij uw geïnstalleerde Seafile-versie horen in plaats van de volledige Compose-configuratie van een oudere handleiding te kopiëren.

Welke implementatie moet u kiezen?

Voor een nieuwe Docker-implementatie met één node, begin met de door Seafile meegeleverde configuratie collabora.yml. Voor een bestaande standalone Collabora-server of een cluster, volg de installatiehandleiding van Collabora zelf en stel de discovery-URL van Seafile in op het externe Collabora-adres. De integratiehandleiding van Seafile vereist HTTPS voor Seafile en vermeldt dat een aparte Collabora-node HTTPS moet gebruiken op standaardpoort 443, die via een reverse-proxy wordt doorgestuurd naar de Collabora-service op poort 9980. Zie de online integratiehandleiding van Seafile en Collabora en de installatiedocumentatie van Collabora .

Voordat je begint

• Controleer of uw Seafile-server bereikbaar is via HTTPS met een geldig certificaat. De handleiding van Seafile vereist expliciet HTTPS voor deze integratie.
• Bepaal uw implementatietype: de huidige Docker-installatie op één node, een binaire installatie of een configuratie met meerdere hosts/clusters. De namen van de compose-bestanden en de proxy-routering zijn afhankelijk van die keuze.
• Kies een Collabora-hostnaam, bijvoorbeeld office.example.com, als Collabora onafhankelijk bereikbaar moet zijn voor de browsers van gebruikers. Zorg ervoor dat de DNS en het TLS-certificaat werken voordat u Seafile configureert.
• Zorg dat je beheerdersrechten hebt voor Seafile seahub_settings.pyen, indien van toepassing, het Docker- .envbestand. Bewaar het Collabora-beheerderswachtwoord in een beveiligd omgevingsbestand en publiceer het niet in screenshots, logbestanden of een openbare repository.

De documentatie van Seafile beschrijft de Docker-stappen voor dezelfde host als de door hen ondersteunde Compose-layout. Als uw reverse proxy, Compose-project of netwerk afwijkt, beschouw de onderstaande voorbeeldwaarden dan als uitgangspunt en controleer de servicenamen en routes in uw eigen implementatie.

Optie A: Collabora toevoegen aan een Seafile Docker-implementatie

1. Voeg het officiële Collabora Compose-bestand toe.

Download vanuit de map waar uw Seafile Compose-configuratie zich bevindt het Collabora-bestand voor de Seafile-versie die u gebruikt. Voor de huidige versie van Seafile 14.0 in de handleiding:

wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Open het bestand .enven voeg het toe collabora.ymlaan de bestaande COMPOSE_FILElijst. Behoud alle huidige vermeldingen; een installatie die bijvoorbeeld al de Seafile-server, Caddy en SeaDoc-bestanden bevat, voegt het Collabora-bestand toe in plaats van de lijst te vervangen.

COMPOSE_FILE='seafile-server.yml,caddy.yml,seadoc.yml,collabora.yml'

Uw daadwerkelijke lijst kan afwijken. Verwijder de huidige reverse proxy of andere services niet alleen om aan dit voorbeeld te voldoen. Het Compose-bestand definieert de container- en netwerkinstellingen die de meegeleverde implementatie van Seafile verwacht.

2. Stel de omgevingswaarden van Collabora in.

Voeg de door Seafile gedocumenteerde variabelen toe aan hetzelfde .envbestand. Het huidige voorbeeld gebruikt de rolling collabora/codeimage name; teams die reproduceerbare upgrades nodig hebben, moeten een Collabora-releasetag selecteren die door hun omgeving wordt ondersteund en deze bewust vastzetten. Lees de release notes en test upgrades voordat u een werkende editorservice wijzigt.

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=admin
COLLABORA_PASSWORD=replace-with-a-long-random-secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_REMOTE_FONT=
COLLABORA_ENABLE_FILE_LOGGING=false

De poortwaarde is de poort die door het Compose-voorbeeld van Seafile wordt gebruikt voor de host; Collabora luistert binnen de container op poort 9980. Houd de beheerdersconsole privé of beperk de toegang via de proxy/firewall. De bovenstaande gebruikersnaam en het wachtwoord zijn voorbeelden; kies unieke inloggegevens en beveilig het bestand. Als uw organisatie de beheerdersconsole niet nodig heeft, kunt u deze uitschakelen volgens de ondersteunde instellingen van de Compose-sjabloon.

3. Configureer de WOPI-verbinding van Seafile

Bewerk seahub_settings.pyen voeg de Collabora-integratie-instellingen toe. Voor containers op hetzelfde Compose-netwerk gebruikt het huidige voorbeeld van Seafile de interne servicenaam collabora:

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_PREVIEW_MAX_SIZE = 30 * 1024 * 1024
ENABLE_OFFICE_WEB_APP_EDIT = True

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

De interne discovery-URL is bedoeld voor de communicatie tussen Seafile en Collabora op het gedeelde Docker-netwerk. Gebruikers moeten ook het Collabora-adres kunnen bereiken dat de integratie aan hen doorgeeft via hun browser. Volg de officiële Compose-file en proxy-instellingen zodat de route die toegankelijk is voor de browser veilig wordt gepubliceerd; een hostnaam die alleen binnen Docker werkt en alleen binnen de container wordt opgelost, is geen bruikbare openbare URL voor de browser.

Beperk de lijst met bestandsextensies tot de formaten die uw gebruikers nodig hebben en die uw Collabora-build ondersteunt. De hierboven getoonde instelling voor de voorbeeldgrootte is de waarde van 30 MiB in het huidige voorbeeld van Seafile; voor grotere documenten kan een bewuste aanpassing van de limiet nodig zijn, waarbij rekening moet worden gehouden met de bijbehorende impact op het geheugen en de prestaties.

4. Start of update de services

Valideer de Compose-configuratie en start vervolgens de stack vanuit de projectmap:

docker compose config
docker compose up -d

De handleiding van Seafile geeft aan dat Seafile opnieuw moet worden opgestart na een wijziging seahub_settings.py. Bij Docker-implementaties docker compose up -dwordt de bijgewerkte Compose-configuratie toegepast; als de wijziging van de instelling geen effect heeft, start u de Seafile-service opnieuw op met de methode die voor uw release beschikbaar is. Vermijd een brede herstart, docker compose downtenzij u van plan bent de gehele stack te stoppen.

Optie B: Verwijs Seafile naar Collabora op een andere host.

Installeer en configureer Collabora volgens de officiële implementatie- en reverse-proxy-instructies. Gebruik HTTPS op het normale publieke eindpunt en proxy verzoeken naar Collabora's interne poort 9980. Controleer of de Seafile-host Collabora kan bereiken en of Collabora het HTTPS-adres van Seafile kan bereiken; beide richtingen zijn belangrijk voor het laden van WOPI-documenten.

Behoud de overige Seafile-instellingen uit de vorige sectie, maar wijzig de detectie-instelling naar de daadwerkelijke Collabora-hostnaam:

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

Gebruik uw daadwerkelijke hostnaam en certificaat. Voeg de interne Docker-servicenaam niet toe, tenzij Seafile en Collabora daadwerkelijk een netwerk delen waar die naam wordt opgelost. Een aparte host biedt u onafhankelijke controle over resources en onderhoud, maar brengt extra werk met zich mee op het gebied van DNS, firewall, certificaten en reverse proxy. Volg voor een Seafile-cluster het proxy- en service-discovery-ontwerp van het cluster in plaats van aan te nemen dat het Compose-netwerk met één node van toepassing is.

Hoe controleer je of de verbinding werkt?

1. Open de pagina https://office.example.com/hosting/discoveryin een browser als u een aparte host gebruikt. Test bij een configuratie op dezelfde host de openbare Collabora-route die door uw proxy wordt gepubliceerd. Een succesvolle reactie bevestigt dat het discovery-eindpunt bereikbaar is, maar bewijst op zichzelf niet dat WOPI-bewerking werkt.
2. Meld u aan bij Seafile en open een klein, niet-gevoelig .docxbestand .xlsxdat .odtis opgenomen in uw geconfigureerde extensielijsten.
3. Controleer of het bestand in Collabora is geopend, breng een onschadelijke wijziging aan, wacht tot het opslaan is voltooid en sluit de editor.
4. Heropen het bestand in Seafile en controleer of de wijziging is opgeslagen. Voor een grondigere controle kunt u een kopie downloaden en de verwachte inhoud bevestigen.

Test met een bestand dat u veilig kunt wijzigen. Een zichtbare editor zonder een succesvolle opslag is slechts een gedeeltelijk succes: WOPI moet het bestand kunnen ophalen en de bewerkte versie terugsturen naar Seafile.

Veelvoorkomende storingen en welke kant je moet controleren

Voor Docker-logs, raadpleeg Seafile-documenten docker logs seafile-collabora. Controleer de Seafile/Seahub-logs samen met de Collabora-output en correleer de verzoeken bij de proxy. Schakel uitgebreide logboekregistratie of bestandslogboekregistratie niet permanent in als dit document-URL's of andere gevoelige operationele gegevens blootlegt. De officiële Collabora-handleiding voor probleemoplossing biedt aanvullende controles voor fouten aan de Collabora-kant.

Welke keuze is logisch?

Kies de gebundelde container als uw Seafile-installatie op één Docker-host draait, u de ondersteunde Compose-configuratie wilt gebruiken en het delen van CPU en geheugen met Seafile acceptabel is. Kies een aparte Collabora-host als u er al een gebruikt, onafhankelijke capaciteit of upgradeschema's nodig hebt, of een architectuur met meerdere hosts integreert en HTTPS en netwerkroutering betrouwbaar kunt handhaven. Volg in beide gevallen de documentatie die overeenkomt met uw Seafile-release, beveilig de voor browsers toegankelijke eindpunten en controleer zowel het openen als het opslaan van documenten voordat u gebruikers uitnodigt om online te bewerken.