Przykład ilustrujący: Wyobraź sobie mały zespół, którego pliki Nextcloud są hostowane w https://cloud.example.com. Jego administrator chce mieć oddzielny serwer Collabora Online Development Edition (CODE) w https://office.example.com. To hipotetyczna konfiguracja, mająca na celu wyjaśnienie kroków, a nie raport z rzeczywistej instalacji. Zastąp obie przykładowe nazwy hostów domenami, które kontrolujesz.
CODE działa jako oddzielna usługa, niezależnie od Nextcloud. Docker uruchamia usługę Collabora; odwrotny serwer proxy TLS ją publikuje; a integracja Nextcloud Office łączy te dwie usługi. Przeglądarka musi mieć dostęp do adresu URL urzędu, a serwery muszą mieć dostęp do odpowiednich punktów końcowych Nextcloud i Collabora. Aktualny podręcznik instalacji Nextcloud Office opisuje Dockera jako jedną z opcji wdrożenia i zaznacza, że dedykowany serwer zazwyczaj wymaga odwrotnego serwera proxy.
Zanim zaczniesz
Załóżmy na przykład, że host z systemem Linux obsługuje Dockera, Nextcloud działa już przez HTTPS, a rekordy DNS dla obu nazw hostów wskazują na prawidłowe serwery. Uzyskaj ważny certyfikat TLS dla domeny office.example.com. Zaplanuj udostępnienie usługi Collabora przez tę nazwę hosta, zamiast otwierać jej port Dockera bezpośrednio w publicznym internecie.
- Sprawdź, czy host CODE może rozwiązać problem i nawiązać połączenie
cloud.example.com.
- Sprawdź, czy przeglądarki mogą nawiązać połączenie
https://office.example.comza pomocą protokołu HTTPS.
- Wybierz, czy serwer proxy odwrotny działa na hoście Dockera, czy gdzie indziej. Serwer proxy na tym samym hoście może korzystać z portu kontenera opublikowanego w pętli zwrotnej; serwer proxy w innym kontenerze wymaga dostępnej współdzielonej sieci Dockera lub innej prywatnej trasy.
- Przed użyciem produkcyjnym należy zapoznać się z aktualną dokumentacją CODE i Nextcloud, aby zapoznać się z wymaganiami dotyczącymi zgodności i serwerów proxy. CODE to wersja rozwojowa; zespoły, które potrzebują stabilności lub wsparcia technicznego zapewnianego przez dostawcę, powinny rozważyć skorzystanie z obsługiwanej oferty Collabora Online.
Poniższe polecenia używają oficjalnej collabora/codenazwy obrazu i pojedynczego źródła Nextcloud. Przykłady nie przypinają znacznika wydania, dlatego administrator powinien zdecydować o polityce wersjonowania i aktualizacji, zamiast traktować je latestjako strategię kontroli zmian w środowisku produkcyjnym.
1. Wskaż nazwę hosta biura na swój serwer
Utwórz rekord DNS A lub AAAA, office.example.comktóry będzie wskazywał na hosta lub moduł równoważenia obciążenia obsługujący Collabora. Skonfiguruj odwrotny serwer proxy, aby kończył HTTPS z certyfikatem ważnym dla tej nazwy i przekierowywał ścieżki aplikacji Collabora oraz ruch WebSocket do kontenera CODE. Oficjalna dokumentacja odwrotnego serwera proxy Collabora zawiera przykłady specyficzne dla serwerów proxy; w tej sekcji znajdziesz informacje o swoim oprogramowaniu proxy i aktualnej wersji CODE.
Nie kopiuj bezmyślnie ogólnego fragmentu kodu proxy. Serwer proxy musi obsługiwać aktualizacje WebSocket, zachowywać wymagane informacje o hoście i protokole przekazywania oraz przekazywać trasy Collabora, takie jak /browser, /hosting/discoveryi /cool. Dokładne dyrektywy różnią się w zależności od bramy Apache, NGINX, Traefik i innych. Jeśli serwer proxy działa na hoście Dockera, przekierowanie 127.0.0.1:9980jest wspólnym celem prywatnym. Jeśli jest to oddzielny kontener, adres pętli zwrotnej odnosi się do samego kontenera proxy, a nie do hosta CODE.
2. Uruchom kontener Docker CODE
Na hoście Dockera ściągnij i uruchom kontener. W tym przykładzie port jest powiązany z pętlą zwrotną, więc nie jest bezpośrednio widoczny na każdym interfejsie sieciowym hosta:
docker pull collabora/code
docker run -d --name collabora -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart always --cap-add MKNOD collabora/code
Wartość aliasgroup1autoryzuje źródło Nextcloud, które ma korzystać z tej usługi CODE. Zachowaj schemat i nazwę hosta zgodne z adresem URL używanym przez użytkowników do uzyskiwania dostępu do Nextcloud; uwzględnij port inny niż domyślny, jeśli publiczna usługa Nextcloud go używa. Jeśli z usługi będzie korzystać wiele instancji Nextcloud, skonfiguruj dodatkowe dozwolone grupy hostów zgodnie z aktualną dokumentacją obrazu CODE, zamiast ogólnie zezwalać na dowolne hosty.
To polecenie zakłada, że serwer proxy odwrotny znajduje się na tym samym komputerze i przekierowuje do portu pętli zwrotnej. Jeśli używasz Docker Compose, konteneryzowanego serwera proxy lub zdalnego serwera proxy, dostosuj ustawienia sieci i portów, aby były widoczne. Unikaj publicznego udostępniania portu 9980 tylko po to, aby połączenie proxy działało; użyj prywatnej sieci Docker, reguły zapory sieciowej lub innej ograniczonej ścieżki. Aktualne opcje obrazu CODE Docker można znaleźć w przewodniku Collabora po CODE Docker .
3. Skonfiguruj odwrotny serwer proxy i sprawdź KOD
Po skonfigurowaniu serwera proxy załaduj go ponownie, używając metody odpowiedniej dla swojego oprogramowania, i sprawdź jego konfigurację przed zastosowaniem zmian. Następnie zażądaj publicznego punktu końcowego wykrywania z komputera, który ma dostęp do domeny:
curl -fsS https://office.example.com/hosting/discovery | head
Pomyślna odpowiedź powinna zawierać informacje o odkryciu XML, a nie stronę błędu serwera proxy. To sprawdzenie potwierdza, że publiczny adres URL dociera do punktu końcowego Collabora; nie dowodzi ono jednak, że autoryzacja NextCloud, WebSockets ani edycja dokumentów już działają. Sprawdź również kontener, jeśli punkt końcowy ulegnie awarii:
docker ps --filter name=collabora
docker logs --tail=100 collabora
W hipotetycznej konfiguracji odrzucone połączenie z publicznym adresem URL kieruje najpierw do DNS, TLS, zapory sieciowej lub routingu proxy. Odpowiedź 502 zazwyczaj oznacza, że proxy nie może dotrzeć do skonfigurowanego serwera nadrzędnego kontenera. Jeśli wyszukiwanie działa, ale edytor później ulega awarii podczas ładowania, należy sprawdzić przekierowanie WebSocket i czy serwer proxy zgłasza błąd aktualizacji lub błąd nadrzędny.
4. Połącz NextCloud z Collabora
W NextCloud otwórz sekcję Aplikacje i zainstaluj lub włącz integrację pakietu Office oferowaną dla Twojej wersji. Etykieta aplikacji może brzmieć „NextCloud Office” lub „Collabora Online”, w zależności od wersji i zainstalowanego katalogu aplikacji. Następnie otwórz ustawienia administracyjne pakietu Office i wprowadź:
https://office.example.com
Zapisz ustawienia i sprawdź stan połączenia. Dokumentacja konfiguracji pakietu Office firmy Nextcloud identyfikuje to pole jako adres URL i port serwera Collabora i zaleca protokół HTTPS. Użyj publicznego adresu URL Collabora, do którego dostęp mają przeglądarki. W instalacjach z podzielonym DNS, NAT lub siecią segmentowaną, Nextcloud może również potrzebować wewnętrznej trasy do tej usługi; zapoznaj się z zaawansowanymi opcjami połączenia dla zainstalowanej wersji aplikacji, zamiast zakładać, że publiczny DNS działa z serwera.
W tym przykładzie Nextcloud widzi cloud.example.comdozwolony host WOPI, a przeglądarki użytkowników otwierają edytor z adresu office.example.com. Jeśli strona administracyjna Nextcloud oferuje listę dozwolonych żądań WOPI, ogranicz ją do oczekiwanych adresów serwerów Collabora po potwierdzeniu poprawności adresów w sieci. Nextcloud zaleca ograniczenie żądań WOPI do oczekiwanych hostów Collabora; nie dodawaj szerokich zakresów bez konkretnego powodu związanego z siecią.
5. Przetestuj na przykładowym dokumencie
Zaloguj się jako zwykły użytkownik Nextcloud, utwórz mały dokument tekstowy lub otwórz jednorazowy plik testowy i wybierz edytor w przeglądarce. Sprawdź, czy pasek narzędzi edytora się załadował, wprowadź nieszkodliwą zmianę, poczekaj na wskaźnik zapisu, zamknij plik i otwórz go ponownie, aby sprawdzić, czy zmiana została zachowana. Jeśli instalacja obsługuje edycję jednoczesną, otwórz ten sam plik testowy w drugiej sesji użytkownika i sprawdź, czy obecność lub zmiany zostały zaktualizowane zgodnie z oczekiwaniami.
Te kontrole oddzielają główne warstwy: żądanie odnajdywania testuje routing publiczny; status Nextcloud testuje skonfigurowane połączenie z serwerem; otwarcie edytora testuje dostęp przez przeglądarkę i wymianę WOPI; a ponowne otwarcie pliku testuje ścieżkę zapisu. Nie należy używać ważnego dokumentu do pierwszego testu. CODE to edycja rozwojowa, więc pomyślny test nie zastępuje oceny dostępności, pojemności zasobów, kopii zapasowych i potrzeb wsparcia w organizacji.
Typowe problemy i co sprawdzić
Nextcloud zgłasza, że serwer jest niedostępny
Sprawdź adres URL pakietu Office pod kątem literówki, prawidłowego łańcucha certyfikatów i pasującego schematu HTTPS. Przetestuj adres URL wykrywania zarówno z poziomu przeglądarki, jak i hosta Nextcloud. Jeśli publiczny DNS rozwiązuje się inaczej w sieci serwerów, skonfiguruj odpowiednią trasę wewnętrzną lub skorzystaj z zaawansowanych ustawień adresu URL serwera obsługiwanych przez Twój łącznik.
Strona się otwiera, ale edytor dokumentów się zawiesza
Sprawdź dzienniki dostępu i błędów odwrotnego serwera proxy pod kątem błędów aktualizacji WebSocket. Upewnij się, że serwer proxy przekazuje bieżące trasy Collabora i utrzymuje otwarte połączenia WebSocket o długim czasie trwania. Narzędzia programistyczne przeglądarek mogą pokazać, czy żądanie WebSocket zostało odrzucone, przekierowane do protokołu HTTP lub zablokowane z powodu błędu certyfikatu.
Collabora odrzuca hosta Nextcloud
Porównaj rzeczywiste pochodzenie Nextcloud, w tym schemat, nazwę hosta i port, ze skonfigurowaną grupą aliasów. Niezgodność między publicznym adresem URL, wewnętrzną nazwą hosta i przepisaniem proxy może spowodować błędy autoryzacji hosta lub WOPI. Do dozwolonej konfiguracji dodaj tylko zamierzoną nazwę hosta Nextcloud.
KOD uruchamia się, a następnie kończy działanie lub staje się niezdrowy
Sprawdź docker logs collaboradostępne dyski i pamięć, uprawnienia kontenera oraz wymagania środowiska wykonawczego dla wdrożonego znacznika obrazu. Unikaj kopiowania flag, takich jak tryb uprzywilejowany, z niepowiązanych przykładów, chyba że aktualne oficjalne instrukcje dla Twojego środowiska tego wymagają.
Aktualizacje i opieka operacyjna
Aktualizuj obraz kontenera, aby zapewnić bezpieczeństwo i zgodność, ale planuj i testuj aktualizacje zamiast pobierać nowy, niesprawdzony obraz w godzinach pracy. Rejestruj używaną wersję, czytaj odpowiednie informacje o wydaniach i twórz ścieżkę wycofania. Przejrzyj konfigurację serwera proxy po wprowadzeniu istotnych zmian w Collabora lub NextCloud, ponieważ wymagania dotyczące punktów końcowych i WebSocket mogą się zmieniać. Monitoruj również logi hosta dotyczące pamięci, procesora, pamięci masowej i kontenerów w miarę wzrostu liczby aktywnych edytorów.
W przypadku hipotetycznego zespołu instalacja będzie gotowa do ograniczonego użytku dopiero po otrzymaniu odpowiedzi z punktu końcowego wykrywania, zgłoszeniu połączenia przez NextCloud, otwarciu przykładowego dokumentu w przeglądarce i pozostawieniu zapisanej edycji po ponownym otwarciu. Jeśli jedno z tych sprawdzeń się nie powiedzie, należy rozwiązać problem z tą warstwą przed zaproszeniem użytkowników do korzystania z usługi.
Oficjalne referencje
Dokumentacja została sprawdzona 6 października 2026 r. W momencie sprawdzania stabilna wersja podręcznika Nextcloud była oznaczona jako wersja 35; powiązany przewodnik po Dockerze to wersja 28, więc użyj go jako przykładu instalacji i zweryfikuj składnię serwera proxy z podręcznikiem Collabora i wersjami, z których faktycznie korzystasz.