Rozwiąż błąd „Cóż, to jest żenujące” w aplikacji Collabora

Zacznij od sprawdzenia, czy przeglądarka, Nextcloud i Collabora mogą dotrzeć do prawidłowych adresów URL serwerów za pośrednictwem tego samego schematu HTTP lub HTTPS. W Nextcloud przetestuj Collabora /hosting/capabilitiesi /hosting/discoverypunkty końcowe; jeśli odpowiadają, ale dokumenty nadal nie są ładowane, sprawdź trasę WebSocket odwrotnego serwera proxy i listę dozwolonych WOPI.

Komunikat „No cóż, to jest żenujące” to ogólny błąd otwierania dokumentu, a nie diagnoza sama w sobie. Przyczyną może być niedostępny adres URL, niezgodność TLS lub DNS, serwer proxy, który blokuje aktualizacje WebSocket, lub host WOPI, któremu Collabora lub Nextcloud nie ufa. Poniższe testy wykorzystują typowy przykład z Nextcloud pod adresem https://cloud.example.comi Collabora pod adresem https://office.example.com; zastąp obie nazwy rzeczywistymi nazwami hostów.

1. Czy punkty końcowe Collabora ładują się?

Z przeglądarki znajdującej się w tej samej sieci co użytkownik otwórz te adresy URL, zmieniając nazwę hosta Collabora:

• https://office.example.com/hosting/capabilities
• https://office.example.com/hosting/discovery

Powinny one zwracać dane punktu końcowego Collabora, a nie ostrzeżenie o certyfikacie przeglądarki, stronę 404 lub błąd odwrotnego proxy. Punkt końcowy wykrywania zazwyczaj zwraca XML. Można również przeprowadzić test z poziomu hosta Nextcloud lub jego kontenera aplikacji:

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

Awaria przeglądarki wskazuje na publiczny lub lokalny serwer DNS, zaporę sieciową, certyfikat lub routing proxy. Pomyślne połączenie przeglądarki z awarią wiersza poleceń Nextcloud oznacza, że ​​trasa po stronie serwera jest inna; przeglądarka użytkownika i serwer Nextcloud potrzebują osobnych ścieżek roboczych do Collabora. Aktualny podręcznik administracyjny Nextcloud zaleca przetestowanie obu punktów końcowych z obu lokalizacji i potwierdzenie, że Collabora może również połączyć się z Nextcloud przez HTTP(S).

2. Czy obie usługi zgadzają się co do nazwy hosta i protokołu?

W NextCloud otwórz Ustawienia → Administracja → Biuro i sprawdź, czy pole Serwer Collabora Online zawiera publiczny lub w inny sposób dostępny adres URL Collabora. Użyj tej opcji, https://jeśli usługa jest skonfigurowana do obsługi protokołu HTTPS. Dokumentacja NextCloud zaleca korzystanie z protokołu HTTPS skonfigurowanego adresu URL, który jest używany w instalacji Collabora.

Teraz sprawdź ścieżkę powrotną. Z hosta lub kontenera Collabora wyślij żądanie do punktu końcowego stanu NextCloud:

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

Odpowiedź powinna być dostępna z Collabora, a nie tylko z laptopa. Jeśli któryś z serwerów znajduje się w Dockerze, przetestuj go z odpowiedniego kontenera lub przestrzeni nazw sieciowych: nazwa hosta, która jest rozpoznawana na hoście, może nie być rozpoznawana w kontenerze. W przypadku wbudowanego serwera CODE, Nextcloud musi móc połączyć się z samym sobą, używając tej samej nazwy hosta, której użytkownicy używają w przeglądarce. Jeśli rozdzielony DNS lub lokalne rozpoznawanie nazw to uniemożliwia, popraw DNS lub mapowanie hosta zamiast korzystać localhostze zdalnej usługi.

3. Czy Twój odwrotny serwer proxy przepuszcza ruch WebSocket?

Jeśli adres URL wyszukiwania wczytuje się, ale ramka edytora pozostaje pusta, obraca się lub rozłącza, sprawdź serwer proxy przed Collabora. Edycja korzysta z trwałego połączenia WebSocket: serwer proxy musi kierować bieżący /cool/…/wspunkt końcowy Collabora do usługi Collabora i przekazywać nagłówki aktualizacji HTTP/1.1. Sprawdź aktualny przykład serwera proxy Collabora pod kątem oprogramowania i wersji swojego serwera proxy; nie wklejaj starej konfiguracji bez zmian.

Starsze instalacje mogą nadal korzystać ze ścieżek takich jak /lool. Wskazówki dotyczące migracji Collabora dokumentują zmianę z lool. Serwer proxy pozostawiony na starych trasach może zwracać błędy 404 nawet po otwarciu domeny bazowej. Po edycji pliku proxy należy sprawdzić jego składnię za pomocą polecenia test tego serwera, załadować go ponownie, a następnie ponownie przetestować adres URL wykrywania i otworzyć dokument.coolloleafletbrowser

Sprawdź dzienniki dostępu i błędów z tym samym znacznikiem czasu, co nieudana próba. Błąd 404 /browsersugeruje /coolrouting ścieżki; nieudana aktualizacja WebSocket sugeruje brak obsługi aktualizacji lub przekroczenie limitu czasu; błąd 502 zazwyczaj oznacza, że ​​serwer proxy nie może połączyć się z serwerem nadrzędnym Collabora. Są to wskazówki, a nie ostateczne diagnozy, dlatego porównaj je z własnym dziennikiem Collabora.

4. Czy host WOPI jest dozwolony?

WOPI (Web Application Open Platform Interface) to protokół używany przez Nextcloud i Collabora do wymiany żądań dostępu do dokumentów. Jeśli w logu Collabora pojawi się komunikat „Nie znaleziono akceptowalnych hostów WOPI” lub nieautoryzowany host WOPI, należy sprawdzić, czy Collabora została skonfigurowana tak, aby ufać nazwie hosta Nextcloud, a nie własnej nazwie hosta Collabora. W obrazie Dockera sprawdź konfigurację startową i logi kontenera:

docker ps
 docker logs --tail=100 CONTAINER_NAME

Zastąp CONTAINER_NAMErzeczywistą nazwą kontenera Collabora. W przypadku instalacji pakietu natywnego sprawdź dziennik usługi za pomocą sudo journalctl -u coolwsd --since "15 minutes ago". Postępuj zgodnie z instrukcjami konfiguracji hosta WOPI dla wybranej metody instalacji; unikaj szerokich reguł zezwalających na użycie symboli wieloznacznych.

W Nextcloud Office istnieje również osobna lista dozwolonych adresów WOPI. Określa ona, które adresy IP serwerów Collabora mogą żądać plików od Nextcloud. Dodaj adres IP źródłowy, który Nextcloud faktycznie widzi dla Collabora, co może się różnić w przypadku sieci Docker lub odwrotnego proxy. Nie wprowadzaj 0.0.0.0ani nie wyłączaj ograniczenia tylko po to, aby wyciszyć błąd: Nextcloud zaleca ograniczenie żądań WOPI do oczekiwanych adresów serwerów Collabora.

Sprawdź poprawność

Przetestuj ponownie z przeglądarki użytkownika i z serwera Nextcloud: punkty końcowe wykrywania i możliwości powinny odpowiedzieć, Nextcloud powinien dotrzeć do skonfigurowanego adresu URL Collabora, a Collabora powinna dotrzeć do punktu końcowego stanu Nextcloud. Następnie otwórz mały dokument testowy. Jeśli problem nadal występuje, zapisz znacznik czasu, akcję dokumentu, której dotyczy problem, status HTTP lub WebSocket w dzienniku proxy oraz odpowiadające im wpisy w dzienniku Nextcloud i Collabora. Takie dowody pomagają odróżnić awarię ścieżki sieciowej od problemu z autoryzacją WOPI.

Oficjalne źródła

• Rozwiązywanie problemów z kontrolą i błędami połączenia w pakiecie NextCloud Office
• Konfiguracja adresu URL i WOPI Nextcloud Office
• Wskazówki Nextcloud dotyczące zmian ścieżki punktu końcowego Collabora
• Ustawienia odwrotnego serwera proxy Collabora Online