So verbinden Sie Collabora Online mit Seafile: Einrichtungsoptionen und Schritte

Seafile kann unterstützte Office-Dateien in Collabora Online über WOPI öffnen. WOPI ist ein Protokoll, das den Austausch von Dokumentinformationen und Dateiinhalten zwischen Speicherserver und Online-Editor ermöglicht. Die optimale Bereitstellung hängt davon ab, wo Seafile ausgeführt wird, wie HTTPS und Reverse-Proxys verwaltet werden und ob Collabora im selben Docker-Netzwerk oder auf einem separaten Server laufen soll.

Diese Anleitung orientiert sich an den aktuellen Anweisungen zur Collabora-Integration im Seafile-Administratorhandbuch (Seafile 14.0-Dokumentation, Stand: 6. Oktober 2026). Da sich die genauen Docker-Compose-Dateien und Image-Tags ändern können, verwenden Sie bitte die Dateien Ihrer installierten Seafile-Version und kopieren Sie nicht die vollständige Compose-Konfiguration eines älteren Tutorials.

Welche Bereitstellungsart sollten Sie wählen?

Für eine neue Docker-Bereitstellung auf einem einzelnen Knoten verwenden Sie die von Seafile bereitgestellte Konfiguration collabora.yml. Für einen bestehenden eigenständigen Collabora-Server oder einen Cluster verwenden Sie die Installationsanleitung von Collabora und legen Sie die Discovery-URL von Seafile auf die externe Collabora-Adresse fest. Die Seafile-Integrationsanleitung erfordert HTTPS für Seafile und weist darauf hin, dass ein separater Collabora-Knoten HTTPS auf dem Standardport 443 verwenden sollte, der per Reverse-Proxy an den Collabora-Dienst auf Port 9980 weitergeleitet wird. Weitere Informationen finden Sie in der Anleitung zur Online-Integration von Seafile und Collabora sowie in der Collabora-Installationsdokumentation .

Bevor Sie beginnen

• Vergewissern Sie sich, dass Ihr Seafile-Server über HTTPS mit einem gültigen Zertifikat erreichbar ist. Die Seafile-Anleitung setzt HTTPS für diese Integration ausdrücklich voraus.
• Wählen Sie Ihren Bereitstellungstyp: Aktuelle Docker-Einzelknoteninstallation, Binärinstallation oder Multi-Host-/Cluster-Setup. Compose-Dateinamen und Proxy-Routing hängen von dieser Wahl ab.
• Wählen Sie einen Collabora-Hostnamen, z. B. „ office.example.comcollabora.com“, wenn Collabora von den Browsern der Benutzer unabhängig erreicht werden soll. Stellen Sie sicher, dass DNS und TLS-Zertifikat vor der Konfiguration von Seafile funktionieren.
• Sie benötigen Administratorrechte für Seafile seahub_settings.pyund gegebenenfalls die Docker- .envDatei. Speichern Sie das Collabora-Administratorpasswort in einer geschützten Umgebungsdatei und veröffentlichen Sie es nicht in Screenshots, Protokollen oder einem öffentlichen Repository.

Die Dokumentation von Seafile beschreibt die Docker-Schritte für das unterstützte Compose-Layout auf demselben Host. Falls Ihr Reverse-Proxy, Ihr Compose-Projekt oder Ihr Netzwerk abweichen, verwenden Sie die unten stehenden Beispielwerte als Ausgangspunkt und überprüfen Sie die Dienstnamen und Routen in Ihrer eigenen Bereitstellung.

Option A: Collabora zu einer Seafile-Docker-Bereitstellung hinzufügen

1. Fügen Sie die offizielle Collabora Compose-Datei hinzu.

Laden Sie aus dem Verzeichnis, in dem sich Ihre Seafile Compose-Konfiguration befindet, die Collabora-Datei für die von Ihnen verwendete Seafile-Version herunter. Der Pfad für Seafile 14.0 im aktuellen Handbuch lautet:

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

Die bestehende Liste öffnen .envund ergänzen . Alle aktuellen Einträge beibehalten; beispielsweise würde bei einer Installation, die bereits den Seafile-Server, Caddy und die SeaDoc-Dateien auflistet, die Collabora-Datei angehängt, anstatt die Liste zu ersetzen:collabora.ymlCOMPOSE_FILE

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

Ihre tatsächliche Liste kann abweichen. Entfernen Sie den aktuellen Reverse-Proxy oder andere Dienste nicht, nur um diesem Beispiel zu entsprechen. Die Compose-Datei legt die Container- und Netzwerkeinstellungen fest, die von der mitgelieferten Seafile-Bereitstellung erwartet werden.

2. Umgebungswerte von Collabora festlegen

Fügen Sie die von Seafile dokumentierten Variablen in dieselbe .envDatei ein. Das aktuelle Beispiel verwendet den fortlaufenden collabora/codeImage-Namen; Teams, die reproduzierbare Aktualisierungen benötigen, sollten ein von ihrer Umgebung unterstütztes Collabora-Release-Tag auswählen und dieses explizit festlegen. Lesen Sie die Versionshinweise und testen Sie Aktualisierungen, bevor Sie einen funktionierenden Editor-Service ändern.

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

Der angegebene Port ist der Host-Port, der im Seafile-Compose-Beispiel verwendet wird; Collabora lauscht innerhalb des Containers auf Port 9980. Halten Sie die Administrationskonsole privat oder beschränken Sie den Zugriff über Proxy/Firewall. Benutzername und Passwort sind Beispiele – wählen Sie eindeutige Anmeldeinformationen und schützen Sie die Datei. Falls Ihre Organisation die Administrationskonsole nicht benötigt, deaktivieren Sie sie gemäß den Anweisungen in der Compose-Vorlage.

3. Konfigurieren Sie die WOPI-Verbindung von Seafile.

Bearbeiten seahub_settings.pyund fügen Sie die Collabora-Integrationseinstellungen hinzu. Für Container im selben Compose-Netzwerk verwendet das aktuelle Beispiel von Seafile den internen Dienstnamen 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'
)

Die interne Discovery-URL dient der Kommunikation zwischen Seafile und Collabora im gemeinsamen Docker-Netzwerk. Die Browser der Benutzer müssen die Collabora-Adresse, die ihnen von der Integration bereitgestellt wird, ebenfalls erreichen können. Befolgen Sie die offizielle Compose-Datei und die Proxy-Konfiguration, damit die Browser-URL sicher veröffentlicht wird. Ein Hostname, der nur innerhalb von Docker aufgelöst werden kann, ist keine gültige öffentliche Browser-URL.

Beschränken Sie die Dateierweiterungslisten auf die Formate, die Ihre Benutzer benötigen und die Ihre Collabora-Version unterstützt. Die oben angegebene Vorschaugröße entspricht dem Wert von 30 MiB im aktuellen Beispiel von Seafile; bei größeren Dokumenten muss die Beschränkung gegebenenfalls angepasst werden, wobei die Auswirkungen auf Speicher und Leistung zu berücksichtigen sind.

4. Starten oder aktualisieren Sie die Dienste.

Überprüfen Sie die Compose-Konfiguration und starten Sie dann den Stack aus dem Projektverzeichnis:

docker compose config
docker compose up -d

Die Seafile-Anleitung empfiehlt, Seafile nach Änderungen neu zu starten seahub_settings.py. Bei Docker-Bereitstellungen docker compose up -dwird die aktualisierte Compose-Konfiguration angewendet. Falls die Änderung nicht wirksam wird, starten Sie den Seafile-Dienst gemäß der für Ihre Version geltenden Methode neu. Vermeiden Sie einen umfassenden Neustart, docker compose downes sei denn, Sie möchten den gesamten Stack stoppen.

Option B: Seafile auf Collabora auf einem anderen Host verbinden

Installieren und konfigurieren Sie Collabora gemäß den offiziellen Anweisungen für Bereitstellung und Reverse-Proxy. Verwenden Sie HTTPS für den normalen öffentlichen Endpunkt und leiten Sie Anfragen an den internen Port 9980 von Collabora weiter. Stellen Sie sicher, dass der Seafile-Host Collabora erreichen kann und dass Collabora die HTTPS-Adresse von Seafile erreichen kann; beide Richtungen sind für das Laden von WOPI-Dokumenten erforderlich.

Behalten Sie die übrigen Seafile-Einstellungen aus dem vorherigen Abschnitt bei, ändern Sie jedoch die Erkennungseinstellung auf den tatsächlichen Collabora-Hostnamen:

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

Verwenden Sie Ihren tatsächlichen Hostnamen und Ihr Zertifikat. Geben Sie den internen Docker-Dienstnamen nur dann an, wenn Seafile und Collabora tatsächlich im selben Netzwerk arbeiten, in dem dieser Name aufgelöst wird. Ein separater Host ermöglicht Ihnen unabhängige Ressourcen- und Wartungskontrolle, erfordert aber zusätzlichen Aufwand für DNS, Firewall, Zertifikate und Reverse-Proxy. Orientieren Sie sich bei einem Seafile-Cluster an dessen Proxy- und Service-Discovery-Architektur und gehen Sie nicht davon aus, dass das Compose-Netzwerk mit einem einzelnen Knoten gilt.

So überprüfen Sie, ob die Verbindung funktioniert

1. Öffnen Sie https://office.example.com/hosting/discoverydie Seite im Browser, wenn Sie einen separaten Host verwenden. Bei einer Installation auf demselben Host testen Sie die öffentliche Collabora-Route, die von Ihrem Proxy bereitgestellt wird. Eine erfolgreiche Antwort bestätigt, dass der Discovery-Endpunkt erreichbar ist, beweist aber nicht automatisch, dass die WOPI-Bearbeitung funktioniert.
2. Melden Sie sich bei Seafile an und öffnen Sie eine kleine, nicht sensible Datei .docx, eine Datei .xlsxoder .odteine Datei, die in Ihren konfigurierten Erweiterungslisten enthalten ist.
3. Vergewissern Sie sich, dass die Datei in Collabora geöffnet wird, nehmen Sie eine harmlose Änderung vor, warten Sie, bis das Speichern abgeschlossen ist, und schließen Sie den Editor.
4. Öffnen Sie die Datei in Seafile erneut und überprüfen Sie, ob die Änderung übernommen wurde. Zur Sicherheit können Sie eine Kopie herunterladen und den erwarteten Inhalt bestätigen.

Testen Sie mit einer Datei, die Sie gefahrlos bearbeiten können. Ein sichtbarer Editor ohne erfolgreiches Speichern ist nur ein Teilerfolg: WOPI muss die Datei abrufen und die bearbeitete Version an Seafile zurücksenden können.

Häufige Fehler und welche Seite zu überprüfen ist

Für Docker-Logs und Seafile-Dokumente docker logs seafile-collaboraprüfen Sie die Seafile-/Seahub-Logs zusammen mit der Collabora-Ausgabe und korrelieren Sie die Anfragen am Proxy. Aktivieren Sie die ausführliche Protokollierung oder die Dateiprotokollierung nicht dauerhaft, wenn dadurch Dokument-URLs oder andere sensible Betriebsdetails offengelegt werden. Der offizielle Collabora-Leitfaden zur Fehlerbehebung bietet zusätzliche Prüfmöglichkeiten für Collabora-seitige Fehler.

Welche Option ist sinnvoll?

Wählen Sie den mitgelieferten Container, wenn Ihre Seafile-Installation auf einem einzelnen Docker-Host läuft, Sie die unterstützte Compose-Konfiguration benötigen und die gemeinsame Nutzung von CPU und Arbeitsspeicher mit Seafile akzeptabel ist. Wählen Sie einen separaten Collabora-Host, wenn Sie bereits einen betreiben, unabhängige Kapazität oder Upgrade-Zeitpläne benötigen oder eine Multi-Host-Architektur integrieren und HTTPS sowie das Netzwerk-Routing zuverlässig gewährleisten können. Beachten Sie in jedem Fall die Dokumentation Ihrer Seafile-Version, sichern Sie die Browser-seitigen Endpunkte und überprüfen Sie das Öffnen und Speichern von Dokumenten, bevor Sie Benutzer zur Online-Bearbeitung einladen.