Verbinden Sie Seafile und Collabora mit der korrekten WOPI-URL.

Um Seafile mit Collabora Online zu verbinden, aktivieren Sie HTTPS in Seafile, stellen Sie Collabora bereit und verweisen Sie die Office-Integration von Seafile auf den Discovery-Endpunkt von Collabora. Wenn beide Dienste im selben Docker-Netzwerk laufen, verwendet die aktuelle Integrationsanleitung von Seafile die interne URL http://collabora:9980/hosting/discovery; läuft Collabora auf einem separaten Host, verwenden Sie stattdessen die öffentliche HTTPS-URL.

Das aktuelle Seafile-Administratorhandbuch dokumentiert eine spezielle collabora.ymlCompose-Integration und die zugehörigen Einstellungen seahub_settings.py. Die genauen Bereitstellungsdateien können je nach Seafile-Version variieren. Verwenden Sie daher beim Anpassen dieser Beispiele das Handbuch, das zu Ihrer installierten Version passt.

Bevor Sie beginnen

• Verwenden Sie eine HTTPS-Seafile-Adresse mit einem gültigen TLS-Zertifikat. Seafile gibt HTTPS als Voraussetzung für die Collabora-Integration an.
• Informieren Sie sich, ob Collabora als weiterer Container auf demselben Docker-Host oder als separat gehosteter Dienst ausgeführt wird.
• Sie benötigen Administratorzugriff auf das Bereitstellungsverzeichnis von Seafile und seahub_settings.py.
• Wählen Sie aus, welche Dokumentformate in der Vorschau und Bearbeitung angezeigt werden sollen. Die Seafile-Einstellungen steuern diese Erweiterungslisten.

Seafile und Collabora kommunizieren über WOPI. Seafile stellt die Zugriffsinformationen für das Dokument bereit, und Collabora fordert die Datei von Seafile an. Die Discovery-URL teilt Seafile mit, welchen Collabora-Dienst es nutzen soll und welche Bearbeitungsfunktionen dieser anbietet.

1. Bestätigen Sie HTTPS auf Seafile

Öffnen Sie Seafile in einem Browser und prüfen Sie, ob die normale Adresse mit „http://“ beginnt https://und das Zertifikat gültig ist. Die aktuelle Anleitung für die Docker-Bereitstellung von Seafile beschreibt die Konfiguration SEAFILE_SERVER_PROTOCOL=httpsin der .envDatei „/etc/secfile“ und die anschließende Einrichtung von HTTPS über den konfigurierten Reverse-Proxy. Verwenden Sie keinen öffentlichen, unverschlüsselten HTTP-Seafile-Endpunkt.

# In the Seafile deployment .env file
SEAFILE_SERVER_PROTOCOL=https

Das eigentliche Zertifikat und der private Schlüssel müssen von Ihrem TLS-Proxy oder Zertifikatsmanager verwaltet werden. Diese Einstellung allein stellt kein Zertifikat aus und konfiguriert keinen Reverse-Proxy. Schließen Sie die HTTPS-Schritte für Ihre Bereitstellung ab, bevor Sie die Online-Office-Bearbeitung aktivieren.

2. Collabora zur Seafile-Docker-Bereitstellung hinzufügen

Verwenden Sie für die dokumentierte Docker-Konfiguration auf demselben Host die von Seafile bereitgestellte Collabora-Compose-Datei, anstatt eine separate Containerdefinition zu erstellen. Laden Sie im Seafile-Bereitstellungsverzeichnis die Datei für die entsprechende manuelle Version herunter und fügen Sie sie collabora.ymlder bestehenden COMPOSE_FILEListe hinzu .env. Behalten Sie die bereits von Ihrer Installation verwendeten Compose-Dateien bei.

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

Legen Sie die von Seafile dokumentierten Collabora-Variablen in folgendem Verzeichnis fest .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

Verwenden Sie ein sicheres, individuelles Passwort und beschränken Sie den Zugriff auf die .envDatei, da sie Zugangsdaten enthält. Der Beispielport ist der in der Seafile-Integrationskonfiguration freigegebene Port; gehen Sie nicht davon aus, dass es sich um den öffentlichen Port Ihres Reverse-Proxys handelt. Beachten Sie die collabora.ymlfür Ihre Version geltenden Vorgaben bezüglich der zugehörigen Datei und der Proxy-Konfiguration.

Sobald der Dienst zur Bereitstellung hinzugefügt wurde, starten oder aktualisieren Sie den Compose-Stack wie gewohnt mit Seafile. Vermeiden Sie es, den internen Port von Collabora direkt im Internet zu veröffentlichen, es sei denn, Ihre Architektur erfordert dies ausdrücklich und Sie haben den Endpunkt gesichert.

3. Seafile auf die Discovery-URL von Collabora verweisen.

Bearbeiten Sie die aktive seahub_settings.pyDatei und fügen Sie die Integrationseinstellungen hinzu. Bei der Compose-Konfiguration auf demselben Host verwendet das Seafile-Handbuch den Dienstnamen und den internen Collabora-Port:

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

Die http://hier angegebene URL ist die interne Dienstadresse im dokumentierten Docker-Netzwerk von Seafile. Die für den Browser sichtbare Seafile-Website benötigt weiterhin HTTPS. Kopieren Sie diese interne Adresse nicht in eine Bereitstellung auf einem separaten Host.

Wenn Collabora auf einem anderen Host läuft, konfigurieren Sie Collabora hinter HTTPS auf dem Standard-Port. Der Reverse-Proxy leitet die Anfragen an den Listening-Port von Collabora weiter. Legen Sie die Basis-URL auf Ihren tatsächlichen öffentlichen Hostnamen fest, zum Beispiel:

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

Stellen Sie sicher, dass der Hostname in der URL aufgelöst wird und ein gültiges Zertifikat von den Clients anzeigt, die Dokumente öffnen müssen. Konfigurieren Sie außerdem die WOPI-Zulassungsliste von Collabora so, dass der Host des Seafile-Servers akzeptiert wird. Die offizielle Docker-Dokumentation von Collabora beschreibt die aliasgroupUmgebungsvariable zur Deklaration des zulässigen WOPI-Hosts. Achten Sie darauf, dass Host und Schema exakt mit dem von Seafile verwendeten übereinstimmen, und vermeiden Sie auf einem Produktionsserver einen umfassenden Wildcard-Zugriff.

4. Starten Sie das System neu und testen Sie die Verbindung.

Starten Sie Seafile neu, damit Seahub die neuen Python-Einstellungen lädt. Verwenden Sie die Neustartprozedur für Ihr Paket, Ihren Compose-Stack oder Ihre Kubernetes-Konfiguration; Dienstnamen und Befehle variieren je nach Bereitstellung. Wenn Sie eine neue Compose-Datei hinzugefügt haben, vergewissern Sie sich, dass der Collabora-Container ausgeführt wird, bevor Sie den Browser-Workflow testen.

Öffnen Sie ein unterstütztes Office-Dokument über die Weboberfläche von Seafile. Die Datei sollte sich im Editor von Collabora öffnen, ihren Inhalt anzeigen und eine kleine Teständerung in Seafile speichern. Das erfolgreiche Öffnen eines Dokuments ist aussagekräftiger als die alleinige Überprüfung der Suchseite, da es die Funktionalität von Browser, Seafile, Collabora und WOPI für die Dateiübertragung testet.

Fehlerbehebung durch Überprüfung jeder einzelnen Verbindung

• Seahub meldet einen Erkennungsfehler: Confirm OFFICE_WEB_APP_BASE_URList vom Seafile-Dienst aus nicht erreichbar. Verwenden Sie den internen Docker-Dienstnamen nur, wenn beide Container dasselbe Netzwerk nutzen.
• Der Editor wird geladen, kann die Datei aber nicht abrufen: Überprüfen Sie die Collabora- und Seafile-Protokolle. Stellen Sie sicher, dass Collabora den Seafile-WOPI-Host zulässt und dass das HTTPS-Zertifikat von Seafile als vertrauenswürdig eingestuft ist.
• Auf demselben Host funktioniert es, aber nicht remote: Ersetzen Sie die interne URL durch die öffentliche HTTPS-Discovery-URL, bestätigen Sie DNS und TLS und vergewissern Sie sich, dass der Proxy Collabora-Anfragen an Port 9980 weiterleitet.
• Nur einige Formate sind verfügbar: Überprüfung OFFICE_WEB_APP_FILE_EXTENSIONund OFFICE_WEB_APP_EDIT_FILE_EXTENSION. Beschränken Sie diese Listen auf die Formate, die Ihre Benutzer benötigen und die Ihre Collabora-Bereitstellung unterstützt.
• Die Einstellungen scheinen nach dem Neustart unverändert zu sein: Vergewissern Sie sich, dass Sie den aktiven Seafile-Dienst bearbeitet seahub_settings.pyund den richtigen Seafile-Dienst neu gestartet haben.

Für einen eigenständigen Collabora-Knoten verweist Seafile Administratoren ausdrücklich auf die Bereitstellungsdokumentation von Collabora, anstatt die mitgelieferte Datei zu verwenden collabora.yml. Die mitgelieferte Datei ist für dieselbe Docker-Host-/Netzwerkkonfiguration vorgesehen, die oben beschrieben wurde.

Offizielle Referenzen

• Seafile-Administratorhandbuch: Collabora-Online-Integration
• Seafile 14.0 Collabora Compose-Datei
• Collabora CODE Docker-Image-Dokumentation