Platforma Collabora Online może na pierwszy rzut oka wyglądać poprawnie, a mimo to ulegać awarii, gdy tylko edytor próbuje nawiązać połączenie WebSocket. Znanym objawem jest dokument, który zaczyna się ładować, a następnie zgłasza, że połączenie z gniazdem zostało nieoczekiwanie zamknięte, czemu czasami towarzyszy nieudane wss://żądanie w przeglądarce. W 2026 roku istnieje jeden powód, dla którego należy to sprawdzić, zanim cokolwiek zmienisz: gałąź 26.04 wprowadziła bardziej zwarty adres URL WebSocket, a starsze reguły odwrotnego proxy mogą z nim kolidować.
Oficjalne informacje o wydaniu Collabora CODE 26.04 wskazują, że wersja CODE 26.04.1, wydana 8 czerwca 2026 r., wymagała od użytkowników odwrotnego proxy Apache2 zmiany reguły ProxyPass dla nowego, kompaktowego adresu URL WebSocket. Późniejsze informacje o wersji 26.04.2.x wskazują, że CODE może powrócić do starszego adresu URL, gdy nowa trasa nie może być użyta, i generuje ostrzeżenie audytu, które odsyła administratorów do aktualnych zaleceń dotyczących proxy. Wersja korporacyjna Collabora Online 26.04 jest również aktualna w 2026 r., dlatego administratorzy powinni porównać każdą konfigurację proxy skopiowaną ze starszej wersji podręcznika 24.04 lub 25.04 z najnowszą dokumentacją dostawcy, zanim potraktują problem jako losową awarię sieci.
Komunikat nie wskazuje pojedynczej przyczyny. Oznacza to, że protokół WebSocket między przeglądarką a Collabora albo nigdy nie został pomyślnie zaktualizowany, albo został ustanowiony, a następnie nieoczekiwanie zakończony. To rozróżnienie jest istotne, ponieważ poprawki różnią się między sobą.
| Obserwowane zachowanie | Najbardziej przydatna pierwsza kontrola | Typowe przyczyny |
|---|---|---|
| Natychmiast kończy się niepowodzeniem po otwarciu dokumentu | Sieć przeglądarki > Dzienniki dostępu/błędów WS i odwrotnego serwera proxy | Nieprawidłowa /cool/trasa, brak nagłówków aktualizacji, reguła Apache niezgodna z wersją 26.04, niezgodność hosta/źródła |
| Działa krótko, a następnie rozłącza się w powtarzalnych odstępach czasu | Limity czasu bezczynności serwera proxy, ruchu przychodzącego, modułu równoważenia obciążenia i zapory sieciowej | Zbyt krótki limit czasu dla długotrwałego protokołu WebSocket |
| Odkrywanie działa, ale edycja nie działa | Przetestuj WebSocket oddzielnie od/hosting/discovery | Punkty końcowe HTTP są osiągalne, podczas gdy trasa WebSocket nie jest dostępna |
| Nie działa tylko jedna przeglądarka lub ścieżka sieciowa | Porównaj protokół żądań i zachowanie serwera proxy | Obsługa protokołu HTTP/2 lub HTTP/3, przekazywanie CONNECT, filtrowanie pośrednie |
| Dziennik serwera wyraźnie odrzuca aktualizację | Przeczytaj dokładny błąd coolwsd | Niezgodność pochodzenia, hosta, portu, hosta WOPI lub konfiguracji serwera proxy |
Jeśli problem pojawił się natychmiast po przejściu z wersji 25.04 lub starszego obrazu CODE na wersję 26.04, należy traktować odwrotny serwer proxy jako pierwsze podejrzenie. To nie spekulacja: Collabora udokumentowała zmianę kompaktowego adresu URL WebSocket w informacjach o wydaniu wersji 26.04, a oficjalny problem z projektem zgłaszał awarię WebSocket po aktualizacji do wersji 26.04.1, dopóki nie zmieniono reguł serwera proxy Apache.
Nie rozwiązuj tego problemu, bezmyślnie obniżając wersję i pozostawiając stary serwer proxy bez zmian. Przywrócenie poprzedniej wersji może być tymczasowym rozwiązaniem, ale trwałym rozwiązaniem jest dostosowanie serwera proxy do wersji, którą zamierzasz uruchomić. W przypadku Apache użyj aktualnych ustawień serwera proxy Collabora Online, a nie wersji sprzed wersji 26.04. Własny rekord problemu z WebSocket 26.04 firmy Collabora dokumentuje przypadek, w którym aktualizacja reguł Apache przywróciła działanie.
Najpierw przetestuj zwykłe punkty końcowe Collabora:
curl -I https://office.example.com/hosting/discovery
curl -I https://office.example.com/hosting/capabilitiesPomyślna odpowiedź dowodzi, że DNS, TLS, serwer proxy front-end i przynajmniej część usługi Collabora są dostępne. Nie dowodzi to jednak , że edycja dokumentów będzie działać. Edytor jest zależny od trasy WebSocket w /cool/, która ma inne wymagania dotyczące serwera proxy.
Następnie otwórz narzędzia programistyczne przeglądarki, odtwórz błąd i sprawdź panel Sieć za pomocą filtra WS. Udane uzgadnianie WebSocket zazwyczaj aktualizuje połączenie HTTP; RFC 6455 definiuje odpowiedź serwera jako status HTTP 101, gdy aktualizacja się powiedzie. Jeśli zamiast tego zobaczysz kod 400, 404, 405, 502 lub natychmiastowe nieudane żądanie, skoreluj ten znacznik czasu z logami odwrotnego proxy i coolwsd.
W przypadku Nginx najważniejsze właściwości są proste: żądanie musi dotrzeć do /cool/ścieżki Collabora, serwer proxy musi używać protokołu HTTP/1.1 w celu przeprowadzenia klasycznego procesu uaktualniania WebSocket, nagłówki Upgradei Connectionmuszą zostać przekazane, oryginalny host musi zostać zachowany, a limit czasu odczytu musi być wystarczająco długi, aby można było przeprowadzić sesję edycji.
Podręcznik Collabora SDK od dawna wskazuje dedykowaną lokalizację WebSocket z Upgrade, Connection, Hosti długim proxy_read_timeout. Oficjalny problem z dokumentacją projektu Collabora również wskazywał na potrzebę stosowania nagłówków WebSocket na szerszej /cooltrasie. Konserwatywny wzorzec zgodny z wersją 26.04 to:
location ^~ /cool/ {
proxy_pass http://127.0.0.1:9980;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
proxy_set_header Host $http_host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 3600s;
}Nie wklejaj tego do działającej konfiguracji produkcyjnej bez dostosowania adresu źródłowego, modelu TLS, obsługi ścieżki i wszelkich istniejących zabezpieczeń. Prawidłowym wyborem jest zachowanie topologii przy jednoczesnym dostosowaniu do bieżących wymagań trasy i nagłówka Collabora.
Sesje edycji WebSocket są długotrwałe. Aktualne wartości Helm projektu Collabora wyraźnie to opisują i stosują długi limit czasu dla dołączonego serwera proxy Nginx. Jeśli Twój system równoważenia obciążenia brzegowego, serwer przychodzący Kubernetes, CDN, zapora sieciowa lub odwrotny serwer proxy zamknie bezczynne połączenia wcześniej, niż oczekuje tego aplikacja, użytkownicy mogą przez jakiś czas normalnie edytować, a następnie są rozłączani w regularnych odstępach czasu.
Jeśli awaria występuje za każdym razem po mniej więcej takiej samej liczbie sekund, sprawdź każdego pośrednika na ścieżce, zamiast zwiększać tylko limit czasu Nginx. Wygrywa najkrótszy limit czasu.
Typowe wdrożenie kończy protokół HTTPS na Nginx, Apache, HAProxy, Traefik lub kontrolerze wejściowym i przekierowuje zwykły protokół HTTP do Collabora na porcie 9980. W tym projekcie oficjalna konfiguracja Collabora wymaga, aby zaplecze wiedziało, że protokół TLS jest zakończony przez serwer proxy. Dokumentacja podręcznika SDK ssl.enable=falsewraz z informacjami ssl.termination=truedotyczącymi tego modelu.
W przypadku wdrożeń Dockera wyraża się to zazwyczaj za pomocą dodatkowych parametrów Collabora:
--o:ssl.enable=false --o:ssl.termination=trueUżywaj ich tylko wtedy, gdy TLS jest rzeczywiście zakończony w górę. Jeśli serwer proxy łączy się z Collabora przez HTTPS, skonfiguruj tę topologię spójnie, zamiast mieszać oba modele. Niezgodność może skutkować błędnymi schematami, nieprawidłowymi adresami URL WebSocket, błędami certyfikatów lub przekierowaniami, które uniemożliwią aktualizację.
Collabora weryfikuje źródła WebSocket. Jeśli log zawiera sformułowania takie jak Rejecting WebSocket upgrade„pochodzenie” i „oczekiwany host”, popraw relację zewnętrzna nazwa hosta/port zamiast losowo dodawać dozwolone nagłówki. Oficjalny system śledzenia problemów Collabora zawiera udokumentowany przykład, w którym skonfigurowana nazwa serwera, w :443tym „źródło”, nie była zgodna z źródłem przeglądarki bez podania konkretnego portu.
Przydatne polecenia zależą od instalacji:
docker logs collabora --tail 200
journalctl -u coolwsd --since "10 minutes ago"
nginx -t
apachectl configtestPoszukaj pierwszego błędu w tym samym czasie, co nieudane żądanie WS. Komunikaty o odrzuconych aktualizacjach, błędnej składni URI, nieoczekiwanym hoście lub niedostępnym upstreamie są bardziej przydatne niż ogólne wyskakujące okienko w przeglądarce.
To węższy przypadek, ale warto go sprawdzić przed przebudową serwera. Projekt Collabora udokumentował przypadek związany z Chromium, w którym serwer proxy przekazał żądanie HTTP/2 CONNECT WebSocket bezpośrednio do coolwsd i otrzymał błąd 405 Method Not Allowed. Inny problem rejestruje błędy ładowania dokumentów związane z HTTP/3/QUIC na określonej ścieżce serwera proxy. Te zgłoszenia nie oznaczają, że HTTP/2 lub HTTP/3 muszą być zawsze wyłączone; oznaczają one, że pośrednik musi przełożyć zachowanie klienta na połączenie WebSocket obsługiwane przez Collabora.
Jeśli Firefox działa, a Chrome nie działa na tym samym koncie i dokumencie, przechwyć protokół i kod stanu na serwerze proxy. Lepiej poprawić zachowanie serwera proxy/ruchu przychodzącego niż globalnie wyłączyć nowoczesne protokoły, chyba że w Twoim środowisku nie ma kompatybilnej alternatywy.
Najpierw przetestuj składnię serwera proxy. Następnie przeładuj go, zamiast wielokrotnie restartować bez sprawdzania:
sudo nginx -t && sudo systemctl reload nginx
sudo apachectl configtest && sudo systemctl reload apache2W przypadku kontenerów uruchom ponownie usługę Collabora tylko wtedy, gdy zmienisz jej własne środowisko lub coolwsdustawienia. Zmiana dotycząca wyłącznie serwera proxy zazwyczaj wymaga jedynie przeładowania serwera proxy.
Zamiast polegać na pojedynczym pomyślnie otwartym dokumencie, zastosuj krótką sekwencję weryfikacji:
/hosting/discovery, że /hosting/capabilitiesużytkownicy są dostępni poprzez tę samą publiczną nazwę hosta.Jeśli dokonałeś aktualizacji do wersji 26.04 i korzystasz z Apache, aktualizacja reguł proxy ma najwyższy priorytet, ponieważ Collabora wyraźnie udokumentowała tę zmianę. Jeśli rozłączenie występuje po ustalonym czasie, skoncentruj się na ustawieniach limitu czasu dla każdego przeskoku sieciowego. Jeśli awaria występuje natychmiast we wszystkich przeglądarkach, sprawdź /cool/routing, uaktualnij nagłówki, spójność hosta/źródła oraz zakończenie TLS. Jeśli awaria dotyczy tylko jednej rodziny przeglądarek, porównaj obsługę protokołu HTTP przed zmianą samej Collabora.
Kluczem jest unikanie traktowania komunikatu „nieoczekiwane zamknięcie połączenia z gniazdem” jako domyślnej awarii aplikacji Collabora. W wielu wdrożeniach edytor, punkt końcowy wykrywania i host WOPI działają prawidłowo, podczas gdy odwrotny serwer proxy nieprawidłowo obsługuje typ połączenia, który jest najważniejszy dla edycji na żywo: długotrwałe połączenie WebSocket.
Dowiedz się, jak przeciągać obraz w programie Word, wybierać opcje zawijania tekstu, zachowywać go w akapicie lub mocować na stronie oraz rozwiązywać problemy z obrazami, których nie można przenieść.
Dowiedz się, jak wstawić pole wyboru w programie Excel za pomocą narzędzia w komórce, zliczyć zaznaczone elementy za pomocą formuł lub dodać powiązany formant formularza w starszych wersjach programu na komputery stacjonarne.
Generuj litery od A do Z, małe litery lub etykiety powyżej Z w programie Excel za pomocą formuły z uchwytem wypełniania, SEKWENCJI lub wielokrotnego użytku listy niestandardowej.
Dowiedz się, jak przekreślać wiersze w programie Excel w systemie Windows, na komputerze Mac i w przeglądarce, formatować część komórki i usuwać wiersze bez usuwania ich wartości.
Microsoft Access to aplikacja bazy danych systemu Windows do przechowywania powiązanych rekordów, tworzenia zapytań, tworzenia formularzy wprowadzania danych i generowania raportów. Dowiedz się, jak działa i kiedy się sprawdza.
Dowiedz się, jak zaimportować plik PST do programu Outlook 2010 lub wyeksportować pocztę, kontakty, kalendarz i zadania. Postępuj zgodnie z odpowiednimi menu i unikaj pominiętych folderów lub duplikatów.
Dowiedz się, jak dostosować wysokość i szerokość linii siatki w programie Word 2010, zmienić widoczną częstotliwość linii oraz ustawić odstępy między liniami siatki w pionie i w poziomie.
Za pomocą dodatku LiveWeb możesz umieścić witrynę internetową na slajdzie programu PowerPoint, ustawić jej rozmiar i sposób odświeżania oraz sprawdzić zgodność przed prezentacją.
Odzyskaj zapomniane hasło PST programu Outlook, korzystając z bieżących instrukcji Kernela, obejmujących m.in. identyfikację właściwego pliku, wykonanie kopii zapasowej i sprawdzenie ograniczeń narzędzia.
Dodaj święta krajowe w nowym Outlooku, Outlooku w przeglądarce lub klasycznej wersji Outlooka. Dowiedz się, jak unikać duplikatów wydarzeń i sprawdzać, czy nie brakuje dat z lat 2026–2027.
