Zacznij od sprawdzenia, czy pusty ekran dotyczy jednego pliku, czy wszystkich plików, a następnie sprawdź panele Sieć i Konsola przeglądarki, a także dzienniki platformy Collabora i pamięci masowej. Puste płótno to objaw, a nie diagnoza: edytor mógł zostać załadowany, gdy połączenie z dokumentem, autoryzacja WOPI lub zasoby osadzone nie powiodły się.
Otwórz znany, poprawny dokument w tej samej aplikacji, a następnie wypróbuj problematyczny plik w innej obsługiwanej przeglądarce lub w oknie prywatnym. Nie edytuj oryginału podczas diagnostyki. Jeden problem z plikiem wskazuje na format pliku, zawartość lub uprawnienia; rozproszone problemy wskazują na usługi współdzielone lub zmiany w sieci.
| To, co obserwujesz | Najbardziej przydatne następne sprawdzenie | Kompromis |
|---|---|---|
| Jeden dokument jest pusty | Wypróbuj inny plik o tym samym formacie; sprawdź plik aplikacji pamięci masowej i dzienniki WOPI. | Szybka izolacja, ale nie wykluczająca problemów z analizą składniową lub uprawnieniami konkretnego pliku. |
| Wszystkie dokumenty nie wyświetlają się w jednej przeglądarce | Prywatne okno, inna przeglądarka, rozszerzenia i konsola przeglądarki. | Metoda ta jest szybka i mało ryzykowna, ale obejście problemu w przeglądarce nie rozwiązuje problemu z serwerem. |
| Wszyscy użytkownicy i przeglądarki zawodzą | Żądania sieciowe, odwrotny serwer proxy, polityka hosta WOPI i logi serwera. | Większa wartość diagnostyczna, ale zmiany mogą dotyczyć każdego użytkownika; najpierw należy zapisać bieżące ustawienia. |
Prywatne okno to test, a nie rozwiązanie problemu. Jeśli to działa, wyłączaj rozszerzenia pojedynczo lub wyczyść dane witryny dla źródła problemu dopiero po upewnieniu się, że nie masz niezsynchronizowanej pracy. Wyczyszczenie wszystkich danych przeglądarki może spowodować wylogowanie użytkowników i usunięcie niepowiązanego stanu witryny.
W Chrome lub Chromium otwórz Narzędzia programistyczne ( F12 lub Ctrl+Shift+I ), wybierz Sieć , włącz Zachowaj dziennik i przeładuj. Filtruj pod kątem WS (WebSocket) i sprawdzaj błędy; w dokumentacji sieciowej Chrome DevTools wyjaśniono filtry żądań i szczegóły statusu. Sprawdź Konsolę pod kątem błędów CSP, certyfikatów, mieszanej zawartości lub JavaScript.
Zinterpretuj dowody zamiast stosować ogólny przepis zastępczy:
/browser/ścieżkach edytora: sprawdź, czy odwrotny serwer proxy przekazuje bieżące ścieżki Collabora do właściwego źródła./hosting/discoverypunkt końcowy dowodzi jedynie podstawowego dostępu HTTP; nie dowodzi, że połączenie na żywo edytora działa.W przypadku żądań WebSocket celem jest pomyślne nawiązanie połączenia. Wyświetlany status zależy od wersji protokołu HTTP i ścieżki serwera proxy, dlatego nie należy traktować pojedynczego, oczekiwanego numeru statusu jako uniwersalnego.
Aktualne instrukcje dotyczące rozwiązywania problemów w biurze Nextcloud mówią, że przeglądarka użytkownika musi połączyć się z obydwoma serwerami przez HTTP(S), Nextcloud musi połączyć się z Collabora, a Collabora musi połączyć się z Nextcloud. Wymagają one również tego samego protokołu w obu usługach. Przetestuj publiczny adres Collabora z przeglądarki pod adresem https://office.example.com/hosting/discoveryi https://office.example.com/hosting/capabilities. Z poziomu hosta Nextcloud użyj:
curl -fsS https://office.example.com/hosting/discovery -o /dev/null
curl -fsS https://office.example.com/hosting/capabilities -o /dev/null
Zastąp przykładową nazwę hosta rzeczywistym adresem URL Collabora. Te kontrole sprawdzają dostępność HTTP, a nie poprawną edycję. Jeśli serwer się powiedzie, ale przeglądarka nie, sprawdź publiczny DNS, TLS, zaporę sieciową lub ekspozycję serwera proxy. Przewodnik rozwiązywania problemów NextCloud Office zawiera listę tych kontroli połączenia i zaleca przejrzenie logów obu aplikacji.
Jeśli zasoby edytora statycznego zwrócą błąd 404 lub połączenie aktywne zwróci błąd 502, porównaj trasy odwrotnego proxy z oficjalnymi ustawieniami proxy Collabora . Upewnij się, że proxy wysyła wymagane ścieżki Collabora do prawidłowego serwera nadrzędnego i obsługuje połączenie WebSocket używane przez przeglądarkę. Zachowaj informacje o hoście zewnętrznym i protokole HTTPS wymagane przez wdrożenie. Nie kopiuj konfiguracji dla innego serwera proxy, prefiksu adresu URL ani wersji Collabora bez sprawdzenia ich założeń. Dedykowana nazwa hosta Collabora jest często łatwiejsza do debugowania; routing oparty na ścieżce wymaga spójnej obsługi prefiksów.
WOPI to protokół używany przez Collabora do pobierania i zapisywania dokumentów za pośrednictwem platformy pamięci masowej. Host WOPI to zazwyczaj nazwa hosta Nextcloud lub innego hosta pamięci masowej, a nie nazwa hosta Collabora. Jeśli w logach jest napisane „ No acceptable WOPI hosts found, dodaj lub popraw dokładnego hosta pamięci masowej w konfiguracji hosta WOPI platformy pamięci masowej, a następnie sprawdź, czy lista dozwolonych żądań WOPI platformy pamięci masowej zawiera adres serwera Collabora. Nextcloud zaleca ograniczenie żądań WOPI do oczekiwanych adresów IP Collabora i skonfigurowanie Collabora tak, aby ufał oczekiwanym hostom w swoich wskazówkach dotyczących konfiguracji pakietu Office .
Dodanie konkretnego zaufanego hosta jest bezpieczniejsze niż wyłączenie walidacji hosta lub zezwolenie na szerokie domeny. Zapisz bieżące ustawienie, zmień tylko odpowiedni wpis i uruchom ponownie lub przeładuj usługi tylko wtedy, gdy jest to wymagane przez wdrożenie. Jeśli używasz Dockera, sprawdź ostatnie dane wyjściowe Collabora, używając docker logs --since=10m <collabora-container>; zastąp symbol zastępczy rzeczywistą nazwą kontenera. W przypadku instalacji pakietów lub Kubernetes użyj zamiast tego logów usług lub podów.
Załaduj ponownie ten sam dokument. Sprawdź, czy zasoby zostały załadowane, połączenie na żywo pozostaje otwarte, treść pojawia się, a błędy konsoli ustają. Przetestuj drugi dokument i innego użytkownika, jeśli problem został udostępniony. Zapisz nieszkodliwą edycję testową i otwórz ją ponownie, aby zweryfikować odczyt i zapis.
Jeśli puste płótno pozostaje, ale żądania są teraz realizowane pomyślnie, sprawdź logi serwera pod kątem błędów konwersji dokumentów lub błędów specyficznych dla pliku i porównaj z innym plikiem o tym samym formacie. Jeśli problem pojawił się bezpośrednio po aktualizacji Collabora, przeglądarki lub serwera proxy, przetestuj kontrolowane wycofanie lub zmianę proxy dla konkretnej wersji w oknie konserwacji, zamiast zmieniać kilka zmiennych naraz. Czyszczenie pamięci podręcznej przeglądarki jest przydatne tylko wtedy, gdy dowody wskazują na nieaktualne zasoby klienta; nie może naprawić zablokowanych tras ani odrzuconych żądań WOPI.
Skonfiguruj zakończenie protokołu Nginx TLS, trasy Collabora i nagłówki WebSocket, a następnie przetestuj publiczne punkty końcowe przed otwarciem rzeczywistych dokumentów.
Prześledź 10-minutowe rozłączenie CODE z serwerem proxy, modułem równoważenia obciążenia lub ścieżką WebSocket, a następnie popraw limit czasu i sprawdź, czy sesja pozostaje połączona.
Zainstaluj oficjalną tabelę Collabora Helm, skonfiguruj dostęp do WOPI i powinowactwo wejściowe, a następnie zweryfikuj wdrożenie bez typowych błędów konfiguracji.
Skorzystaj z żądań przeglądarki, dzienników WOPI i ukierunkowanych kontroli serwerów proxy, aby dowiedzieć się, dlaczego Collabora otwiera pusty dokument — i wybierz poprawkę, która pasuje do dowodów.
Skonfiguruj słowniki CODE Docker i poprawnie oznacz fragmenty dokumentu, aby zapewnić prawidłową korektę pisowni w języku angielskim, francuskim i innych obsługiwanych językach.
Dostosuj próg bezczynności dla każdego widoku w coolwsd i odróżnij go od przyciemniania tła karty, usuwania dokumentów, automatycznego zapisywania i wygaśnięcia logowania.
Zatrzymaj zaplanowane sprawdzanie aktualizacji KODU, przejrzyj opcjonalne usługi zdalne i skorzystaj z kontroli sieci wychodzącej bez przerywania edycji dokumentu.
Włącz bezpieczne edytowanie dokumentów w Seafile, konfigurując adres URL wykrywania, protokół HTTPS i dostęp WOPI Collabora dla swojego wdrożenia.
Przetestuj schowek systemowy, dostosuj uprawnienia przeglądarki i zidentyfikuj, kiedy wbudowana integracja Collabora wymaga zmiany zasad dotyczących ramek iframe.
Zamontuj pliki czcionek w systemie Docker i Collabora, aby niestandardowe czcionki były wyświetlane w edytorze i poprawnie renderowane w dokumentach.
