Los de foutmelding "Unauthorized WOPI Host" in Collabora Online CODE op.

De snelste en meest betrouwbare oplossing is om Collabora Online CODE de exacte hostnaam en poort te laten vertrouwen die in de WOPI-bron-URL van uw opslagplatform staan. Stel voor één Nextcloud-server de host-whitelist van CODE in op die Nextcloud-hostnaam, maak de container opnieuw aan en test het nogmaals. Als u meerdere Nextcloud-instanties gebruikt, moet u elke instantie expliciet toegang verlenen. Los de fout niet op door WOPI-toegang tot elke host te openen.

"Ongeautoriseerde WOPI-host" betekent meestal dat Collabora de opslaghost die in het WOPI-verzoek wordt genoemd, heeft geweigerd. Dit bewijst op zichzelf niet dat het wachtwoord van de gebruiker, de documentrechten, het TLS-certificaat of de reverse proxy onjuist zijn. Deze componenten kunnen andere verbindingsproblemen veroorzaken, dus raadpleeg de Collabora-logboeken om de specifieke oorzaak te achterhalen voordat u instellingen wijzigt.

Kies de wijziging die overeenkomt met uw implementatie.

De onderstaande voorbeelden gaan ervan uit dat Nextcloud zich bevindt op https://cloud.example.comen Collabora op https://office.example.com. Vervang zowel de namen als de poort door de waarden die in uw installatie worden gebruikt. De Docker-installatiehandleiding van Nextcloud gebruikt aliasgroup1voor één opslaghost en beschrijft het toevoegen van een extra aliasgroep voor een tweede Nextcloud-host. De WOPI-configuratie van Collabora definieert hostmatching op basis van de hostnaam en poort; aliassen worden gebruikt voor alternatieve namen van dezelfde opslaghost.

1. Bevestig welke host Collabora heeft afgewezen.

Begin met de logbestanden van de CODE-container. Voer op een Docker Compose-implementatie het volgende commando uit:

docker compose logs --since=10m collabora

Vervang dit collaboradoor de servicenaam in uw Compose-bestand. Bij standaard Docker gebruikt u docker logs --since 10m CONTAINER_NAME`. Kijk in de buurt van de mislukte poging om het document te openen naar een bericht zoals ` No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. De hostnaam tussen haakjes is de aanwijzing: voeg de opslaghost toe die daar wordt weergegeven, niet de openbare hostnaam van de Collabora-server.

Noteer ook de host en poort in de WOPI-URL, indien deze in het logboek worden weergegeven. Vergelijk deze met de geconfigureerde vermelding. Een verzoek aan cloud.example.com:443komt mogelijk niet overeen met een vermelding voor een interne containernaam zoals nextcloud, zelfs als beide namen naar dezelfde machine verwijzen. Reverse proxies, split-horizon DNS en meerdere openbare URL's kunnen ervoor zorgen dat deze mismatch gemakkelijk over het hoofd wordt gezien.

Als de logbestanden een andere fout tonen, zoals een DNS-zoekfout, een geweigerde verbinding of een certificaatfout, los dan dat probleem op in plaats van de WOPI-hostlijst uit te breiden.

2. Werk de vertrouwde WOPI-hostinstelling van CODE bij.

Voor een Docker Compose-installatie die één Nextcloud-host bedient, kan het relevante deel van de service er als volgt uitzien:

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

Behoud de rest van uw bestaande serviceopties, geheimen, volumes, poorten en reverse-proxy-instellingen. Het voorbeeld toont alleen de whitelist-vermelding; het is geen volledig productie-Compose-bestand. Gebruik de instellingsstijl die al wordt ondersteund door de CODE-versie die u gebruikt en controleer de weergegeven of opstartconfiguratie nadat u deze hebt gewijzigd. Containerimages en configuratie-interfaces kunnen in de loop van de tijd veranderen.

Voor één enkele host is een exacte hostvermelding gemakkelijker te controleren dan een brede reguliere expressie. Als uw installatie domainin plaats daarvan afhankelijk is van de omgevingsvariabele, controleer dan de ontsnappingsregels die voor uw image zijn gedocumenteerd en zorg ervoor dat de expressie alleen overeenkomt met de beoogde hostnaam van de opslag. Kopieer geen niet-ontsnapte wildcard of een parent-domain-patroon dat zou overeenkomen met niet-gerelateerde subdomeinen.

Voor meer dan één Nextcloud-instantie voegt u voor elke onafhankelijke host een aparte expliciete groep toe met behulp van het mechanisme dat door uw CODE-release wordt ondersteund. De Docker-integratiehandleiding van Nextcloud laat bijvoorbeeld een extra aliasgroup2vermelding zien voor een tweede cloudhostnaam. Voeg alleen aliassen toe wanneer een Nextcloud-server daadwerkelijk onder meerdere namen bereikbaar is, zoals een interne naam en een publieke naam. Houd een lijst bij van deze namen, zodat een oude hostnaam na een migratie kan worden verwijderd.

3. Maak de container opnieuw aan en controleer de aparte whitelist van Nextcloud.

Nadat je het Compose-bestand hebt bewerkt, maak je de service opnieuw aan zodat de nieuwe omgeving wordt toegepast:

docker compose up -d --force-recreate collabora

Gebruik de juiste servicenaam. Controleer vervolgens of de container correct opstart en of de verwachte host in de opstartconfiguratie of logboeken voorkomt. Vermijd het plakken van volledige omgevingsdumps in ondersteuningsverzoeken: deze kunnen wachtwoorden of andere geheimen blootleggen.

Nextcloud heeft een aparte instelling genaamd "Toegestane lijst voor WOPI-verzoeken" onder de Office-beheerinstellingen. Deze lijst beperkt welke IP-adressen WOPI-verzoeken naar Nextcloud mogen verzenden; Collabora raadt aan deze te beperken tot de verwachte Collabora-serveradressen. Als Nextcloud deze waarschuwing geeft, voeg dan het adres toe dat Nextcloud daadwerkelijk voor het verzoek ziet. Dit adres kan afwijken wanneer een proxy of containernetwerk betrokken is. Houd deze controle gescheiden van de CODE-hostvermelding: CODE vertrouwt op hostnamen van opslag, terwijl de toegestane lijst van Nextcloud betrekking heeft op het IP-adres van de aanvragende server.

Als u een reverse proxy gebruikt, controleer dan of de hostnaam die Nextcloud in WOPI-links publiceert, dezelfde hostnaam is die CODE vertrouwt. Controleer de URL van de Nextcloud Office-server en de openbare hostconfiguratie van de reverse proxy. Voeg de hostnaam van Office niet toe aan de WOPI-opslagtoegangslijst, tenzij dit daadwerkelijk de opslaghost in de WOPI-URL is.

4. Controleer of de verbinding volledig is.

Controleer eerst de eindpunten van de Collabora-service vanuit een browser en vanaf de Nextcloud-server. Vervang de voorbeeldhostnaam door uw Office-URL:

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

Deze controles bevestigen dat de eindpunten reageren; ze bewijzen niet dat een WOPI-documentverzoek zal worden geautoriseerd. Controleer vervolgens of CODE Nextcloud kan bereiken via dezelfde host die Nextcloud publiceert, bijvoorbeeld:

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

Open tot slot een testdocument en bekijk tegelijkertijd de CODE- en Nextcloud-logboeken. Een succesvol resultaat is dat de editor laadt, de specifieke melding "Geen acceptabele WOPI-hosts" verdwenen is en het opslaan van een kleine wijziging werkt. Test dit vanuit een normaal gebruikersaccount met dezelfde deel- en bewerkingsrechten als de gebruiker met het probleem.

Hoe de belangrijkste opties zich tot elkaar verhouden

Eén exacte host versus een reguliere expressie

Een exacte hostnaam met de beoogde poort is meestal het meest geschikt voor een implementatie in één cloudomgeving: deze is gemakkelijk te controleren en beperkt onbedoelde overeenkomsten. Een reguliere expressie kan nuttig zijn wanneer een bewust beheerde set hostnamen een gemeenschappelijk patroon vertoont, maar is lastiger te controleren en kan onbedoelde subdomeinen toestaan ​​als deze te breed is geformuleerd. Gebruik de meest specifieke expressie die voldoet aan een geverifieerde behoefte.

Eén CODE-instantie versus afzonderlijke instanties

Een gedeelde CODE-service vermindert het aantal te onderhouden services, en expliciete groepen kunnen meerdere Nextcloud-instanties ondersteunen. Aparte CODE-instanties kunnen zinvol zijn wanneer teams behoefte hebben aan een sterkere configuratie-isolatie of onafhankelijke onderhoudsvensters. Het nadeel is dat er meer infrastructuur nodig is om te patchen, te monitoren en te routeren. Geen van beide opties lost een onjuiste WOPI-hostnaam automatisch op; elke instantie moet de juiste opslaghost vertrouwen.

Containeromgevingsinstellingen versus het bewerken van XML

Voor een Docker CODE-implementatie gebruikt u de configuratie-interface die door de image wordt ondersteund en bewaart u deze in Compose of een andere bron van waarheid voor de implementatie. Hierdoor zijn wijzigingen herhaalbaar wanneer de container opnieuw wordt aangemaakt. coolwsd.xmlDirect bewerken kan handig zijn voor een beheerd pakket of een specifieke, aangepaste implementatie, maar het bewerken van een gegenereerd bestand in een draaiende container is kwetsbaar en kan verloren gaan bij vervanging of upgrade. Volg de instructies voor het specifieke pakket, de Helm-grafiek of de image die u gebruikt.

Veelgemaakte fouten die je moet vermijden

• Toestaan office.example.com​​wanneer de afgewezen WOPI-opslaghost is cloud.example.com.
• Het invoeren van een privécontainernaam wanneer de WOPI-URL een openbare DNS-naam bevat, of omgekeerd.
• Ervan uitgaande dat een lege Nextcloud WOPI IP-whitelist en de hostconfiguratie van CODE dezelfde controle betreffen.
• Het toevoegen van een algemene wildcard of het uitschakelen van hostvalidatie, puur om de editor te laten laden.
• Het tegelijkertijd wijzigen van de proxy-, TLS- en WOPI-regels maakt het lastiger om de oorzaak te achterhalen.
• Alleen het ontdekkings-eindpunt testen en dat beschouwen als bewijs dat documentautorisatie werkt.

Wanneer een andere oplossing te gebruiken

Als de geweigerde host tussen verzoeken verandert, controleer dan de canonieke Nextcloud-URL, de vertrouwde proxyheaders en eventuele alternatieve webroots voordat u meer namen toevoegt. Als alle hostnamen overeenkomen maar de fout blijft bestaan, vergelijk dan de actieve CODE-configuratie met het bestand of de omgevingsinstellingen die u hebt bewerkt en controleer of de container opnieuw is aangemaakt. Voor Kubernetes of Helm moet u de chartwaarden of de beheerde configuratiebron bewerken in plaats van een actieve pod. Als de logboeken certificaat-, firewall-, WebSocket- of DNS-fouten tonen, los dan die laag op met behulp van de juiste serverlogboeken en netwerkcontroles.

Deze stappen volgen de Nextcloud 35-beheerhandleiding die beschikbaar is vanaf 6 oktober 2026, en het gepubliceerde WOPI-configuratieschema van Collabora. Specifieke configuratiesleutels kunnen variëren afhankelijk van de implementatiemethode en de imageversie. Controleer deze daarom aan de hand van de documentatie voor uw geïnstalleerde release voordat u een wijziging doorvoert.

Officiële referenties

• Probleemoplossing en verbindingscontroles voor Nextcloud Office
• Nextcloud's Docker-voorbeeld voor Collabora, inclusief WOPI-hostinstellingen
• Configuratie van Nextcloud Office en richtlijnen voor de WOPI IP-whitelist
• Het door Collabora Online gepubliceerde configuratieschema coolwsd.xml
• Documentatie voor proxy-instellingen van Collabora Online