Połączenie Nextcloud z CODE Docker: konfiguracja i kompromisy

Połącz Nextcloud z Collabora CODE, uruchamiając oficjalny collabora/codeobraz, ograniczając jego port do hosta, kierując subdomenę HTTPS Office przez odwrotny serwer proxy obsługujący WebSocket i ustawiając ten publiczny adres URL w integracji Nextcloud z Collabora. Dziesięć minut to realny czas tylko wtedy, gdy Docker, DNS, TLS i serwer proxy są gotowe.

Najpierw wybierz odpowiednią usługę biurową. Od października 2026 roku Nextcloud odróżnia Nextcloud Office oparty na Euro-Office od Collabora Online. CODE to Collabora Online Development Edition, więc korzystaj z integracji Collabora, a nie z łącznika Euro-Office. Wbudowana aplikacja CODE jest najszybsza do użytku osobistego, ale Nextcloud opisuje ją jako wolniejszą i pozbawioną zaawansowanej skalowalności. Oddzielny kontener jest łatwiejszy w samodzielnym zarządzaniu, ale dodaje obsługę proxy i aktualizacji. CODE nadaje się do użytku domowego i testowania; wybierz obsługiwane wdrożenie Collabora Online, gdy firma potrzebuje wsparcia produkcyjnego.

Zanim zaczniesz: dziesięciominutowa ścieżka

Posiadaj działający adres HTTPS Nextcloud, osobną nazwę hosta biura z prawidłowym protokołem TLS oraz dostęp do Dockera na hoście CODE. Skieruj nazwę hosta biura na odwrotny serwer proxy, który może kierować do kontenera. Zarówno przeglądarki użytkowników, jak i serwer Nextcloud muszą mieć dostęp do adresu URL biura.

Jeśli DNS lub TLS nie są gotowe, nie udostępniaj publicznie portu 9980 jako skrótu. Powiąż go z pętlą zwrotną i najpierw zakończ działanie serwera proxy.

1. Uruchom kontener Docker CODE

Zastąp przykładową nazwę hosta Nextcloud dokładną nazwą źródłową HTTPS, której użytkownicy używają do logowania. To aliasgroup1ustawienie ogranicza, który host WOPI (usługa plików dostarczająca dokumenty do edytora) może się połączyć. Nie używaj symbolu wieloznacznego tylko po to, aby zniknęła informacja o nieudanym połączeniu.

docker pull collabora/code

docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/code

Powiązanie z 127.0.0.1portem utrzymuje go w prywatności, dopóki serwer proxy na tym samym hoście ma do niego dostęp. Jeśli Twój serwer proxy znajduje się gdzie indziej, zezwól tylko temu zaufanemu serwerowi proxy na łączenie się z portem 9980.

Sprawdź, czy kontener został uruchomiony i czy jego punkt końcowy wykrywania odpowiada lokalnie:

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-komija sprawdzanie poprawności certyfikatu wyłącznie w przypadku lokalnego, samopodpisanego sprawdzenia; nie naprawia nieprawidłowego certyfikatu publicznego.

2. Umieść nazwę hosta urzędu publicznego za protokołem HTTPS

Obsługuj https://office.example.comserwer proxy odwrotnego z ważnym certyfikatem i kieruj żądania do CODE. Wskazówki Collabora dotyczące serwerów proxy obejmują zasoby edytora, wyszukiwanie/możliwości /cool/oraz przekazywanie WebSocket. Bez aktualizacji WebSocket strona może się załadować, mimo że edytor nie działa.

Użyj zachowanej konfiguracji oprogramowania proxy. Jeśli zakończy ono działanie protokołu TLS przed CODE, postępuj zgodnie z udokumentowanymi ustawieniami protokołu TLS w zapleczu; nie wyłączaj globalnie sprawdzania certyfikatów.

3. Połącz integrację Collabora w NextCloud

W Nextcloud włącz lub zainstaluj aplikację integracyjną Collabora dostępną dla Twojej wersji. Następnie otwórz obszar administracyjny pakietu Office i wprowadź publiczny adres URL Collabora https://office.example.com. Aktualne instrukcje określają to ustawienie jako „Serwer Collabora Online”; sformułowania i etykiety aplikacji mogą się różnić w zależności od wersji, zwłaszcza że Nextcloud dodaje opcję Euro-Office. Wybierz Collabora Online dla tego serwera CODE. Nie wprowadzaj adresu tylko dla kontenera, https://127.0.0.1:9980chyba że Nextcloud działa na tym samym hoście, a ten adres jest również skonfigurowanym punktem końcowym usługi; w zalecanej konfiguracji serwera proxy użyj publicznej nazwy hosta Office.

Zapisz ustawienia i uruchom wbudowaną kontrolę połączenia, jeśli Twoja wersja ją pokazuje. Jeśli się nie powiedzie, porównaj dokładny adres źródłowy Nextcloud w [brakuje kontekstu] aliasgroup1. Upewnij się, że zarówno Nextcloud, jak i przeglądarka mogą rozpoznać i dotrzeć do nazwy hosta w biurze, a także sprawdź dzienniki odwrotnego proxy pod kątem odrzuconych ścieżek lub błędów WebSocket.

4. Sprawdź edycję, a następnie wybierz, czy CODE pasuje

Otwórz mały dokument testowy w NextCloud i sprawdź, czy otwiera się w edytorze przeglądarki, akceptuje zmianę, zapisuje ją i otwiera ponownie z zachowaniem wprowadzonych zmian. Przetestuj z poziomu zwykłego konta użytkownika oraz konta administratora. Samo sprawdzenie poprawności działania potwierdza, że ​​CODE odpowiada; nie dowodzi to jednak, że autoryzacja WOPI, proxy WebSockets i operacje zapisywania dokumentu działają.

W przypadku serwera osobistego lub małego zespołu, CODE Docker oddziela edytor od stosu PHP NextCloud. Użytkownik jest również właścicielem serwera proxy, restartów, kontroli zgodności i aktualizacji obrazów. Wbudowana aplikacja CODE jest prostsza, ale współdzieli hosta i oferuje mniej funkcji skalowalności. W przypadku organizacji, która opiera się na codziennej edycji, warto rozważyć korzystanie z obsługiwanej usługi Collabora Online zamiast traktować CODE jako gwarancję produkcyjną.

Gdy będziesz gotowy do aktualizacji CODE, pobierz nowy obraz i utwórz kontener ponownie z tymi samymi opcjami. Przejrzyj informacje o wydaniu i przetestuj otwieranie i zapisywanie dokumentu przed aktualizacją usługi, na której polegają użytkownicy; znacznik latestmożna przenieść. Przypnij konkretną wersję obrazu, gdy ważne są powtarzalne wdrożenia.

Weryfikacja

Konfiguracja działa, gdy nazwa hosta urzędu publicznego przedstawia prawidłowy certyfikat, sprawdzenie połączenia Nextcloud kończy się pomyślnie, a dokument testowy otwiera się, zapisuje i ponownie otwiera w edytorze. Jeśli strona główna urzędu ładuje się, ale edycja zawiesza się, sprawdź przekierowanie WebSocket. Jeśli Nextcloud zgłasza, że ​​host nie jest dozwolony, popraw ustawienia, aliasgroup1aby odpowiadały rzeczywistemu pochodzeniu Nextcloud. Jeśli CODE odpowiada lokalnie, ale nie z przeglądarek użytkowników, sprawdź publiczny DNS, routing zapory sieciowej i odwrotny serwer proxy.

Odnośniki: Przykład instalacji Dockera w Nextcloud ; Opcje instalacji pakietu Nextcloud Office ; Konfiguracja Nextcloud Collabora ; Ustawienia odwrotnego serwera proxy Collabora ; Szczegóły oficjalnego obrazu Docker w CODE ; Opcje letniego biura Nextcloud Hub 26 .