Beheben Sie den Fehler „Nicht autorisierter WOPI-Host“ im Collabora Online-Code.

Die schnellste und zuverlässigste Lösung besteht darin, Collabora Online CODE so zu konfigurieren, dass es dem Hostnamen und Port vertraut, die in der von Ihrer Speicherplattform gesendeten WOPI-Quell-URL angegeben sind. Für einen einzelnen Nextcloud-Server fügen Sie den Hostnamen in der CODE-Zulassungsliste hinzu, erstellen Sie den Container neu und testen Sie erneut. Wenn Sie mehrere Nextcloud-Instanzen betreiben, erlauben Sie jede einzelne explizit. Beheben Sie den Fehler nicht, indem Sie den WOPI-Zugriff für alle Hosts öffnen.

„Nicht autorisierter WOPI-Host“ bedeutet in der Regel, dass Collabora den im WOPI-Request angegebenen Speicherhost abgelehnt hat. Dies beweist jedoch nicht automatisch, dass das Benutzerpasswort, die Dokumentberechtigungen, das TLS-Zertifikat oder der Reverse-Proxy fehlerhaft sind. Diese Komponenten können andere Verbindungsfehler verursachen. Überprüfen Sie daher die Collabora-Protokolle, um die genaue Ursache zu ermitteln, bevor Sie Einstellungen ändern.

Wählen Sie die Änderung aus, die Ihrer Bereitstellung entspricht.

Die folgenden Beispiele setzen Nextcloud unter [URL] https://cloud.example.comund Collabora unter [URL] voraus https://office.example.com. Ersetzen Sie die Namen und den Port durch die Werte Ihrer Installation. Die Docker-Einrichtungsanleitung von Nextcloud verwendet [URL] aliasgroup1für einen einzelnen Speicherhost und beschreibt das Hinzufügen einer weiteren Aliasgruppe für einen zweiten Nextcloud-Host. Die WOPI-Konfiguration von Collabora definiert die Hostzuordnung anhand von Hostname und Port; Aliase dienen der alternativen Benennung desselben Speicherhosts.

1. Bestätigen Sie, welchen Host Collabora abgelehnt hat.

Beginnen Sie mit den Protokollen des CODE-Containers. Führen Sie bei einer Docker Compose-Bereitstellung Folgendes aus:

docker compose logs --since=10m collabora

Ersetzen Sie collabora`<servicename>` in Ihrer Compose-Datei durch den Dienstnamen. Bei reinem Docker verwenden Sie `<docker-name>` docker logs --since 10m CONTAINER_NAME. Suchen Sie in der Nähe des fehlgeschlagenen Versuchs, das Dokument zu öffnen, nach einer Meldung wie `<meldung> No acceptable WOPI hosts found matching the target host [cloud.example.com] in config`. Der in Klammern stehende Hostname ist der entscheidende Hinweis: Fügen Sie den dort angezeigten Speicherhost hinzu, nicht den öffentlichen Hostnamen des Collabora-Servers.

Notieren Sie außerdem Host und Port der WOPI-URL, sofern diese im Log angezeigt werden. Vergleichen Sie diese mit dem konfigurierten Eintrag. Eine Anfrage an `<wpi-url>` cloud.example.com:443stimmt möglicherweise nicht mit einem Eintrag für einen internen Containernamen wie `<wpi-url>` überein nextcloud, selbst wenn beide Namen auf denselben Rechner verweisen. Reverse-Proxys, Split-Horizon-DNS und mehrere öffentliche URLs können dazu führen, dass diese Diskrepanz leicht übersehen wird.

Wenn die Protokolle einen anderen Fehler anzeigen, z. B. einen DNS-Lookup-Fehler, eine verweigerte Verbindung oder einen Zertifikatsfehler, beheben Sie dieses Problem, anstatt die WOPI-Hostliste zu erweitern.

2. Aktualisieren Sie die Einstellung für vertrauenswürdige WOPI-Hosts in CODE.

Für eine Docker Compose-Installation, die einen Nextcloud-Host bedient, kann der relevante Teil des Dienstes wie folgt aussehen:

services:
  collabora:
    image: collabora/code
    environment:
      - aliasgroup1=https://cloud.example.com:443

Behalten Sie Ihre übrigen bestehenden Serviceoptionen, Geheimnisse, Volumes, Ports und Reverse-Proxy-Einstellungen bei. Das Beispiel zeigt nur den Eintrag in der Zulassungsliste; es handelt sich nicht um eine vollständige Compose-Datei für den Produktiveinsatz. Verwenden Sie den von Ihrer CODE-Version unterstützten Einstellungsstil und überprüfen Sie die gerenderte oder Startkonfiguration nach der Änderung. Container-Images und Konfigurationsschnittstellen können sich im Laufe der Zeit ändern.

Bei einem einzelnen Host ist ein exakter Host-Eintrag einfacher zu prüfen als ein allgemeiner regulärer Ausdruck. Wenn Ihre Installation domainstattdessen auf einer Umgebungsvariablen basiert, überprüfen Sie die für Ihr Image dokumentierten Escape-Regeln und stellen Sie sicher, dass der Ausdruck nur den gewünschten Speicherhostnamen erfasst. Kopieren Sie keine nicht maskierten Wildcards oder Muster von übergeordneten Domains, die auch nicht zugehörige Subdomains erfassen würden.

Bei mehreren Nextcloud-Instanzen fügen Sie für jeden unabhängigen Host eine separate Gruppe hinzu, die von Ihrer CODE-Version unterstützt wird. Beispielsweise zeigt die Docker-Integrationsanleitung von Nextcloud einen zusätzlichen aliasgroup2Eintrag für einen zweiten Cloud-Hostnamen. Fügen Sie Aliase nur dann hinzu, wenn ein Nextcloud-Server tatsächlich unter mehreren Namen erreichbar ist, z. B. unter einem internen und einem öffentlichen Namen. Notieren Sie sich diese Namen, damit ein alter Hostname nach einer Migration entfernt werden kann.

3. Erstellen Sie den Container neu und überprüfen Sie die separate Zulassungsliste von Nextcloud.

Nach der Bearbeitung der Compose-Datei muss der Dienst neu erstellt werden, damit die neue Umgebung angewendet wird:

docker compose up -d --force-recreate collabora

Verwenden Sie den korrekten Dienstnamen. Prüfen Sie anschließend, ob der Container ordnungsgemäß startet und der erwartete Host in seiner Startkonfiguration oder seinen Protokollen erscheint. Vermeiden Sie es, vollständige Umgebungsabbilder in Supportanfragen einzufügen, da diese Passwörter oder andere vertrauliche Informationen preisgeben können.

Nextcloud bietet in seinen Office-Verwaltungseinstellungen eine separate Option namens „Zulassungsliste für WOPI-Anfragen“. Diese Liste beschränkt die IP-Adressen, die WOPI-Anfragen an Nextcloud senden dürfen. Collabora empfiehlt, die Liste auf die erwarteten Collabora-Serveradressen zu beschränken. Falls Nextcloud diese Warnung ausgibt, fügen Sie die Adresse hinzu, die Nextcloud tatsächlich für die Anfrage sieht. Diese kann abweichen, wenn ein Proxy oder ein Containernetzwerk verwendet wird. Diese Prüfung muss unabhängig vom CODE-Hosteintrag durchgeführt werden: CODE vertraut den Hostnamen des Speichers, während die Zulassungsliste von Nextcloud die IP-Adresse des anfragenden Servers betrifft.

Wenn Sie einen Reverse-Proxy verwenden, vergewissern Sie sich, dass der Hostname, den Nextcloud in den WOPI-Links veröffentlicht, mit dem Hostnamen übereinstimmt, dem CODE vertraut. Überprüfen Sie die URL des Nextcloud Office-Servers und die öffentliche Host-Konfiguration des Reverse-Proxys. Fügen Sie den Office-Hostnamen der WOPI-Speicher-Zulassungsliste nur dann hinzu, wenn er tatsächlich der Speicherhost in der WOPI-URL ist.

4. Überprüfen Sie die vollständige Verbindung.

Überprüfen Sie zunächst die Collabora-Dienstendpunkte sowohl im Browser als auch auf dem Nextcloud-Server. Ersetzen Sie den Beispiel-Hostnamen durch Ihre Office-URL:

curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discovery

Diese Prüfungen stellen sicher, dass die Endpunkte antworten; sie beweisen jedoch nicht, dass eine WOPI-Dokumentanfrage autorisiert wird. Überprüfen Sie anschließend, ob CODE Nextcloud über denselben Host erreichen kann, über den Nextcloud veröffentlicht, zum Beispiel:

curl -fsS https://cloud.example.com/status.php

Öffnen Sie abschließend ein Testdokument und beobachten Sie gleichzeitig die CODE- und Nextcloud-Protokolle. Im Idealfall lädt der Editor, die Fehlermeldung „Keine akzeptablen WOPI-Hosts verfügbar“ verschwindet und das Speichern einer kleinen Änderung funktioniert. Testen Sie dies mit einem normalen Benutzerkonto, das über dieselben Freigabe- und Bearbeitungsberechtigungen wie der betroffene Benutzer verfügt.

Vergleich der wichtigsten Optionen

Ein exakter Host versus ein regulärer Ausdruck

Für eine Single-Cloud-Bereitstellung ist ein exakter Hostname mit dem gewünschten Port meist die beste Lösung: Er ist leicht zu überprüfen und minimiert versehentliche Übereinstimmungen. Ein regulärer Ausdruck kann hilfreich sein, wenn eine bewusst verwaltete Gruppe von Hostnamen ein gemeinsames Muster aufweist. Allerdings ist er schwieriger zu prüfen und kann bei zu allgemeiner Formulierung unbeabsichtigte Subdomains autorisieren. Verwenden Sie den präzisesten Ausdruck, der einen nachgewiesenen Bedarf deckt.

Eine CODE-Instanz versus separate Instanzen

Ein gemeinsam genutzter CODE-Dienst reduziert die Anzahl der zu wartenden Dienste, und explizite Gruppen können mehrere Nextcloud-Instanzen unterstützen. Separate CODE-Instanzen sind sinnvoll, wenn Teams eine stärkere Konfigurationsisolation oder unabhängige Wartungsfenster benötigen. Der Nachteil ist ein höherer Infrastrukturaufwand für Patches, Überwachung und Routing. Keine der beiden Optionen behebt automatisch einen nicht übereinstimmenden WOPI-Hostnamen; jede Instanz muss dem richtigen Speicherhost vertrauen.

Container-Umgebungseinstellungen im Vergleich zur XML-Bearbeitung

Für eine Docker CODE-Bereitstellung verwenden Sie die vom Image unterstützte Konfigurationsschnittstelle und speichern Sie diese in Compose oder einer anderen zentralen Bereitstellungsquelle. Dadurch sind Änderungen reproduzierbar, wenn der Container neu erstellt wird. Die coolwsd.xmldirekte Bearbeitung kann für verwaltete Pakete oder bewusst angepasste Bereitstellungen hilfreich sein, jedoch ist die Bearbeitung einer generierten Datei in einem laufenden Container fehleranfällig und kann bei einem Austausch oder Upgrade verloren gehen. Befolgen Sie daher die Anweisungen für das jeweilige Paket, Helm-Chart oder Image.

Häufige Fehler, die es zu vermeiden gilt

• Zulassen, office.example.comwenn der abgelehnte WOPI-Speicherhost cloud.example.com.
• Eingabe eines privaten Containernamens, wenn die WOPI-URL einen öffentlichen DNS-Namen enthält, oder umgekehrt.
• Unter der Annahme, dass eine leere Nextcloud WOPI IP-Zulassungsliste und die Hostkonfiguration von CODE die gleiche Steuerung darstellen.
• Ein allgemeines Wildcard-Zeichen hinzufügen oder die Host-Validierung deaktivieren, nur damit der Editor geladen wird.
• Die gleichzeitige Änderung der Proxy-, TLS- und WOPI-Regeln erschwert die Diagnose des Ergebnisses.
• Es wird lediglich der Discovery-Endpunkt getestet und dies als Beweis dafür gewertet, dass die Dokumentenautorisierung funktioniert.

Wann sollte eine andere Lösung verwendet werden?

Ändert sich der abgelehnte Host zwischen den Anfragen, überprüfen Sie die kanonische Nextcloud-URL, die vertrauenswürdigen Proxy-Header und alle alternativen Webroots, bevor Sie weitere Namen hinzufügen. Stimmen alle Hostnamen überein, besteht der Fehler aber weiterhin, vergleichen Sie die aktive CODE-Konfiguration mit der bearbeiteten Datei oder den Umgebungseinstellungen und stellen Sie sicher, dass der Container neu erstellt wurde. Bearbeiten Sie bei Kubernetes oder Helm die Chart-Werte oder die verwaltete Konfigurationsquelle anstatt eines laufenden Pods. Werden in den Protokollen stattdessen Zertifikats-, Firewall-, WebSocket- oder DNS-Fehler angezeigt, beheben Sie diese Fehler auf der entsprechenden Ebene mithilfe der Serverprotokolle und Netzwerkprüfungen.

Diese Schritte orientieren sich am Nextcloud 35-Administrationshandbuch vom 6. Oktober 2026 und dem von Collabora veröffentlichten WOPI-Konfigurationsschema. Die spezifischen Konfigurationsschlüssel können je nach Bereitstellungsmethode und Image-Version variieren. Überprüfen Sie diese daher anhand der Dokumentation Ihrer installierten Version, bevor Sie Änderungen vornehmen.

Offizielle Referenzen

• Nextcloud Office: Fehlerbehebung und Verbindungsprüfung
• Nextclouds Docker-Beispiel für Collabora, einschließlich WOPI-Hosteinstellungen
• Nextcloud Office-Konfiguration und WOPI-IP-Zulassungsliste
• Das veröffentlichte Konfigurationsschema coolwsd.xml von Collabora Online
• Dokumentation zu den Collabora Online-Proxy-Einstellungen