Napraw błąd „Nieautoryzowany host WOPI” w kodzie Collabora Online

Najszybszym i niezawodnym rozwiązaniem jest skonfigurowanie Collabora Online CODE jako zaufanej nazwy hosta i portu, które znajdują się w adresie URL źródłowego WOPI wysłanym przez platformę pamięci masowej. W przypadku pojedynczego serwera Nextcloud należy ustawić listę dozwolonych hostów CODE na tę nazwę hosta Nextcloud, ponownie utworzyć kontener i ponownie przetestować. Jeśli używasz wielu instancji Nextcloud, zezwól na dostęp do każdej z nich jawnie. Nie rozwiązuj problemu, otwierając dostęp do WOPI dla każdego hosta.

„Nieautoryzowany host WOPI” zazwyczaj oznacza, że ​​Collabora odrzuciła host pamięci masowej wskazany w żądaniu WOPI. Samo to nie dowodzi, że hasło użytkownika, uprawnienia do dokumentów, certyfikat TLS lub odwrotny serwer proxy są nieprawidłowe. Te elementy mogą powodować inne awarie połączenia, dlatego przed zmianą ustawień należy sprawdzić logi Collabora, aby potwierdzić konkretną przyczynę.

Wybierz zmianę odpowiadającą Twojemu wdrożeniu

Poniższe przykłady zakładają, że NextCloud jest hostem, https://cloud.example.coma Collabora jest hostem https://office.example.com. Zastąp obie nazwy i port wartościami używanymi w instalacji. Przewodnik konfiguracji Dockera w NextCloud dotyczy aliasgroup1pojedynczego hosta pamięci masowej i opisuje dodawanie kolejnej grupy aliasów dla drugiego hosta NextCloud. Konfiguracja WOPI w Collabora definiuje dopasowanie hosta wokół nazwy hosta i portu; aliasy dotyczą alternatywnych nazw tego samego hosta pamięci masowej.

1. Potwierdź, który host odrzucił Collabora

Zacznij od logów kontenera CODE. W przypadku wdrożenia Docker Compose uruchom:

docker compose logs --since=10m collabora

Zastąp collaboranazwą usługi z pliku Compose. W przypadku zwykłego Dockera użyj docker logs --since 10m CONTAINER_NAME. Poszukaj komunikatu w pobliżu nieudanej próby otwarcia dokumentu, takiego jak No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Nazwa hosta w nawiasach kwadratowych jest wskazówką: dodaj hosta pamięci masowej, który tam jest, a nie publiczną nazwę hosta serwera Collabora.

Zapisz również hosta i port w adresie URL WOPI, jeśli są widoczne w dzienniku. Porównaj je ze skonfigurowanym wpisem. Żądanie cloud.example.com:443może nie pasować do wpisu dla wewnętrznej nazwy kontenera, takiej jak nextcloud, nawet jeśli obie nazwy odnoszą się do tej samej maszyny. Odwrotne serwery proxy, DNS typu split-horizon i wiele publicznych adresów URL mogą sprawić, że ta niezgodność będzie łatwa do przeoczenia.

Jeśli w dziennikach wykryto inny błąd, np. nieudane wyszukiwanie DNS, odrzucone połączenie lub błąd certyfikatu, rozwiąż ten problem zamiast rozszerzać listę hostów WOPI.

2. Zaktualizuj ustawienia zaufanego hosta WOPI w CODE

W przypadku instalacji Docker Compose obsługującej jednego hosta Nextcloud odpowiednia część usługi może wyglądać następująco:

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

Zachowaj pozostałe istniejące opcje usług, klucze tajne, woluminy, porty i ustawienia odwrotnego proxy. Przykład pokazuje tylko wpis na liście dozwolonych; nie jest to kompletny plik produkcyjny Compose. Użyj stylu ustawień obsługiwanego przez uruchomioną wersję CODE i sprawdź konfigurację renderowaną lub startową po jej zmianie. Obrazy kontenerów i interfejsy konfiguracyjne mogą się zmieniać z czasem.

W przypadku pojedynczego hosta, dokładny wpis hosta jest łatwiejszy do zweryfikowania niż ogólne wyrażenie regularne. Jeśli instalacja opiera się na domainzmiennej środowiskowej, sprawdź reguły ucieczki udokumentowane dla obrazu i upewnij się, że wyrażenie pasuje tylko do docelowej nazwy hosta pamięci masowej. Nie kopiuj niezakodowanego symbolu wieloznacznego ani wzorca domeny nadrzędnej, który pasowałby do niepowiązanych subdomen.

W przypadku więcej niż jednej instancji Nextcloud dodaj osobną grupę jawną dla każdego niezależnego hosta, korzystając z mechanizmu obsługiwanego przez wersję CODE. Na przykład, przewodnik integracji Dockera w Nextcloud zawiera dodatkowy aliasgroup2wpis dla drugiej nazwy hosta w chmurze. Aliasy dodawaj tylko wtedy, gdy jeden serwer Nextcloud jest rzeczywiście dostępny pod wieloma nazwami, takimi jak nazwa wewnętrzna i nazwa publiczna. Sporządź pisemną listę tych nazw, aby móc usunąć starą nazwę hosta po migracji.

3. Utwórz ponownie kontener i sprawdź osobną listę dozwolonych w NextCloud

Po edycji pliku Compose utwórz ponownie usługę, aby zastosować nowe środowisko:

docker compose up -d --force-recreate collabora

Użyj prawidłowej nazwy usługi. Następnie sprawdź, czy kontener uruchamia się prawidłowo i czy oczekiwany host pojawia się w konfiguracji startowej lub logach. Unikaj wklejania pełnych zrzutów środowiska do zgłoszeń serwisowych: mogą one ujawnić hasła lub inne poufne informacje.

Nextcloud ma osobne ustawienie o nazwie „Lista dozwolonych żądań WOPI” w ustawieniach administracyjnych pakietu Office. Ta lista ogranicza adresy IP, które mogą wysyłać żądania WOPI do Nextcloud; Collabora zaleca ograniczenie jej do oczekiwanych adresów serwerów Collabora. Jeśli Nextcloud zgłosi to ostrzeżenie, należy dodać adres, który Nextcloud faktycznie widzi dla żądania, co może się różnić w przypadku sieci proxy lub kontenerów. Należy oddzielić to sprawdzenie od wpisu hosta w polu CODE: CODE ufa nazwom hostów pamięci masowej, podczas gdy lista dozwolonych w Nextcloud dotyczy adresu IP serwera żądającego.

Jeśli korzystasz z odwrotnego serwera proxy, upewnij się, że nazwa hosta publikowana przez Nextcloud w linkach WOPI jest taka sama, jak nazwa hosta, której CODE jest skonfigurowany jako zaufany. Sprawdź adres URL serwera Nextcloud Office i publiczną konfigurację hosta odwrotnego serwera proxy. Nie dodawaj nazwy hosta Office do listy dozwolonych serwerów pamięci masowej WOPI, chyba że jest to faktycznie host pamięci masowej w adresie URL WOPI.

4. Sprawdź pełne połączenie

Najpierw sprawdź punkty końcowe usługi Collabora z poziomu przeglądarki i serwera Nextcloud. Zastąp przykładową nazwę hosta adresem URL swojego pakietu Office:

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

Te kontrole potwierdzają odpowiedź punktów końcowych; nie dowodzą one jednak, że żądanie dokumentu WOPI zostanie autoryzowane. Następnie należy sprawdzić, czy CODE może dotrzeć do NextCloud za pośrednictwem tego samego hosta, którego NextCloud publikuje, na przykład:

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

Na koniec otwórz dokument testowy i jednocześnie obserwuj logi CODE i Nextcloud. Pomyślny wynik oznacza załadowanie edytora, zniknięcie komunikatu „Brak akceptowalnych hostów WOPI” i zapisanie niewielkiej zmiany. Przeprowadź test z poziomu zwykłego konta użytkownika z takimi samymi uprawnieniami do udostępniania i edycji jak użytkownik, którego dotyczy problem.

Jak porównać główne opcje

Jeden dokładny host kontra wyrażenie regularne

Dokładna nazwa hosta z docelowym portem zazwyczaj najlepiej sprawdza się w przypadku wdrożenia w pojedynczej chmurze: jest łatwa do sprawdzenia i ogranicza przypadkowe dopasowania. Wyrażenie regularne może być pomocne, gdy celowo zarządzany zestaw nazw hostów ma wspólny wzorzec, ale jest trudniejsze do audytu i może autoryzować niezamierzone subdomeny, jeśli zostanie napisane zbyt ogólnie. Należy użyć najwęższego wyrażenia, które spełnia zweryfikowaną potrzebę.

Jedna instancja KODU kontra oddzielne instancje

Współdzielona usługa CODE zmniejsza liczbę usług do utrzymania, a grupy użytkowników mogą obsługiwać wiele instancji Nextcloud. Oddzielne instancje CODE mogą mieć sens, gdy zespoły potrzebują silniejszej izolacji konfiguracji lub niezależnych okien konserwacyjnych. Kompromisem jest większa infrastruktura do wdrażania poprawek, monitorowania i routingu. Żadna z opcji nie naprawia automatycznie niezgodności nazwy hosta WOPI; każda instancja musi ufać odpowiedniemu hostowi pamięci masowej.

Ustawienia środowiska kontenera a edycja XML

W przypadku wdrożenia Docker CODE należy użyć interfejsu konfiguracyjnego obsługiwanego przez obraz i przechowywać go w Compose lub innym źródle danych wdrożenia. Dzięki temu zmiany będą powtarzalne po ponownym utworzeniu kontenera. coolwsd.xmlBezpośrednia edycja może być przydatna w przypadku pakietu zarządzanego lub celowego wdrożenia niestandardowego, ale edycja wygenerowanego pliku w działającym kontenerze jest niestabilna i może zniknąć po wymianie lub aktualizacji. Postępuj zgodnie z instrukcjami dotyczącymi konkretnego pakietu, diagramu Helm lub obrazu, którego używasz.

Typowe błędy, których należy unikać

• Zezwalanie, office.example.comgdy odrzuconym hostem pamięci masowej WOPI jest cloud.example.com.
• Wprowadzenie prywatnej nazwy kontenera, gdy adres URL WOPI zawiera publiczną nazwę DNS i odwrotnie.
• Zakładając, że pusta lista dozwolonych adresów IP Nextcloud WOPI i konfiguracja hosta CODE stanowią tę samą kontrolę.
• Dodanie szerokiego symbolu wieloznacznego lub wyłączenie sprawdzania poprawności hosta tylko po to, aby umożliwić załadowanie edytora.
• Jednoczesna zmiana reguł proxy, TLS i WOPI utrudnia diagnozę.
• Testowanie wyłącznie punktu końcowego wykrywania i traktowanie go jako dowodu, że autoryzacja dokumentu działa.

Kiedy należy zastosować inną poprawkę

Jeśli odrzucony host zmienia się między żądaniami, przed dodaniem kolejnych nazw sprawdź kanoniczny adres URL Nextcloud, zaufane nagłówki proxy i wszelkie alternatywne katalogi webroot. Jeśli wszystkie nazwy hostów są zgodne, ale błąd nadal występuje, porównaj aktywną konfigurację CODE z edytowanym plikiem lub ustawieniami środowiska i potwierdź, że kontener został utworzony ponownie. W przypadku Kubernetes lub Helm edytuj wartości wykresu lub zarządzane źródło konfiguracji, a nie aktywny pod. Jeśli logi wskazują błędy certyfikatu, zapory sieciowej, protokołu WebSocket lub DNS, rozwiąż problemy z tą warstwą, korzystając z odpowiednich logów serwera i kontroli sieci.

Te kroki są zgodne z podręcznikiem administratora Nextcloud 35, dostępnym od 6 października 2026 r., oraz opublikowanym schematem konfiguracji WOPI firmy Collabora. Konkretne klucze konfiguracyjne mogą się różnić w zależności od metody wdrożenia i wersji obrazu, dlatego przed wprowadzeniem zmiany należy je zweryfikować z dokumentacją zainstalowanej wersji.

Oficjalne referencje

• Rozwiązywanie problemów i sprawdzanie łączności w pakiecie NextCloud Office
• Przykład Dockera firmy Nextcloud dla Collabora, obejmujący ustawienia hosta WOPI
• Wskazówki dotyczące konfiguracji pakietu Nextcloud Office i listy dozwolonych adresów IP w usłudze WOPI
• Opublikowany schemat konfiguracji coolwsd.xml serwisu Collabora Online
• Dokumentacja ustawień proxy Collabora Online