Jak wyłączyć telemetrię i połączenia zewnętrzne w Collabora CODE

Krótka odpowiedź: Collabora Online Development Edition (CODE) nie oferuje ogólnego przełącznika telemetrii, który administratorzy muszą wyłączać w celu przeprowadzania rutynowych analiz. Collabora twierdzi, że samoobsługowa wersja Online nie wymaga wywołań zwrotnych telemetrii ani analiz. Aktywność wychodząca, którą warto kontrolować, jest oddzielna: okresowe sprawdzanie aktualizacji, opcjonalne integracje, monitorowanie punktów końcowych i funkcje dokumentów pobierające dane zdalne. Wyłącz opcjonalne funkcje, których nie używasz, a następnie wymuś listę dozwolonych połączeń wychodzących, zachowując jednocześnie połączenie WOPI z serwerem pamięci masowej.

Dotyczy to samodzielnie hostowanego CODE, takiego jak instancja zintegrowana z NextCloud lub ownCloud. Całkowite zablokowanie ruchu wychodzącego może przerwać ładowanie i zapisywanie dokumentów, ponieważ CODE musi dotrzeć do swojego hosta WOPI. Poniższe nazwy konfiguracji zostały sprawdzone pod kątem szablonu źródłowego Collabora 6 października 2026 r.; pakiety i ustawienia domyślne mogą się różnić w zależności od wersji.

Co uznaje się za telemetrię, a co za połączenie zewnętrzne?

Telemetria zazwyczaj oznacza dane dotyczące użytkowania produktu lub dane diagnostyczne przesyłane do dostawcy. Collabora deklaruje, że jej samodzielnie hostowany produkt online nie wymaga telemetrii, wywołań zwrotnych analiz ani połączenia z usługami zewnętrznymi. coolwsd.xmlSzablon źródłowy nie zawiera globalnego kolektora danych telemetrycznych ani przełącznika „telefon do domu”.

Wyświetla okresowe sprawdzanie wersji: fetch_update_checkdomyślnie co 10 godzin. Ustaw tę opcję, 0aby wyłączyć to sprawdzanie. allow_update_popupKontroluje, czy powiadomienia o aktualizacjach pojawiają się w edytorze; ustawienie tej opcji ukrywa falsepowiadomienie, ale nie zastępuje wyłączenia samego sprawdzania. Jeśli Twoja wersja obsługuje obie opcje, ustaw obie.

Inne połączenia są zależne od funkcji. Mogą one obejmować skonfigurowany monitor zewnętrzny, zdalne usługi sprawdzania pisowni lub gramatyki, tłumaczenie DeepL, dostawców sztucznej inteligencji, zdalną konfigurację czcionek oraz dane zewnętrzne żądane przez dokument. Szablon źródłowy informuje, że zdalne interfejsy API LanguageTool lub Duden są domyślnie wyłączone; DeepL również jest domyślnie wyłączony. Podczas przeglądania opcji sztucznej inteligencji lub integracji należy korzystać z ustawień dostarczonych z daną wersją CODE.

Krok 1: Określ miejsca docelowe niezbędne i opcjonalne

Zaplanuj działanie edycji przed zmianą sieci. Załóżmy na przykład, że Nextcloud znajduje się w lokalizacji cloud.example.com, a CODE w office.example.com. Przeglądarka ładuje edytor z CODE, a serwer CODE komunikuje się również z Nextcloud poprzez WOPI w celu pobrania i zapisania dokumentu. Zachowaj trasę serwer-serwer, schemat i port używany przez instalację oraz wszelkie usługi DNS lub proxy wymagane przez wdrożenie.

Następnie zinwentaryzuj opcjonalne usługi w swojej konfiguracji. Sprawdź <monitors>jawnie skonfigurowane adresy monitorujące. Sprawdź zdalne sprawdzanie pisowni, DeepL, sztuczną inteligencję, zdalną konfigurację czcionek i adresy URL zdalnej konfiguracji. Usuń niestandardowe punkty końcowe, które nie są częścią zatwierdzonego przepływu pracy. Jeśli taki punkt jest potrzebny, udokumentuj jego nazwę hosta i cel przed utworzeniem odpowiedniego wyjątku sieciowego.

Sprawdź również lok_allow. Kontroluje ona, które hosty edytowane dokumenty mogą wykorzystywać jako zewnętrzne źródła danych, w tym adresy URL używane do wstawiania grafiki lub funkcji arkusza kalkulacyjnego, takich jak WEBSERVICE(). Nie jest to uniwersalna zapora sieciowa. Notatki konfiguracyjne dotyczące hostów WOPI i POST mogą być również traktowane jako dozwolone źródła danych, dlatego należy oddzielić tę zasadę od kontroli ruchu wychodzącego z sieci.

Krok 2: Wyłącz okresowe sprawdzanie aktualizacji

W przypadku kontenera Collabora CODE ustaw opcje za pomocą extra_paramszmiennej środowiskowej. Scal je z istniejącą wartością; zachowaj wszelkie aktualne ustawienia zakończenia TLS, odwrotnego proxy lub hosta, od których zależy instalacja. Przypnij tag obrazu CODE zatwierdzony dla Twojego środowiska zamiast polegać na latesttagu ruchomym.

services:
  collabora:
    image: collabora/code:<approved-tag>
    environment:
      extra_params: >-
        --o:fetch_update_check=0
        --o:allow_update_popup=false

To przykładowy fragment Docker Compose, a nie kompletne wdrożenie. Zachowaj istniejące ograniczenia domeny, dane logowania administratora, ustawienia TLS i konfigurację serwera proxy. W Kubernetesie diagram Helm udostępnia collabora.extra_paramsi obsługuje niestandardową coolwsd.xmlzawartość; użyj pliku wartości i instrukcji dla zainstalowanej wersji diagramu.

Jeżeli zarządzasz plikiem XML bezpośrednio, umieść wartości wewnątrz jego głównego <config>elementu:

<fetch_update_check>0</fetch_update_check>
<allow_update_popup>false</allow_update_popup>

Nie należy polegać na ręcznej edycji w działającym kontenerze, chyba że plik jest trwały. Ponowne uruchomienie, aktualizacja obrazu lub wdrożenie orkiestracji może go zastąpić. Zmień trwałe źródło konfiguracji Compose, Helm lub zamontowane źródło konfiguracji i utwórz ponownie lub wdróż KOD zgodnie ze standardową procedurą.

Krok 3: Wyłącz nieużywane integracje i ogranicz pobieranie dokumentów

Pozostaw <monitors>puste, jeśli nie korzystasz z zewnętrznej usługi monitorowania. Plik źródłowy zawiera skomentowany przykładowy monitor; skomentowany wpis jest przykładem, a nie aktywnym połączeniem. Usuń aktywne wpisy monitora dodane lokalnie, jeśli nie są już potrzebne.

Wyłącz zdalne sprawdzanie pisowni i gramatyki, DeepL i funkcje dostawcy sztucznej inteligencji, chyba że użytkownicy z nich korzystają. Zdalne sprawdzanie języka może wysyłać wybrany tekst dokumentu do skonfigurowanej usługi, więc jego włączenie ma wpływ zarówno na łączność, jak i przetwarzanie danych. Jeśli wymagana jest integracja, zezwól tylko na zatwierdzony punkt końcowy za pomocą polityki wyjścia.

W przypadku zdalnej zawartości żądanej przez dokumenty, usuń hosty publiczne <lok_allow>i zachowaj tylko miejsca docelowe potrzebne użytkownikom. Nie usuwaj ścieżki WOPI, aby to osiągnąć. WOPI to połączenie z pamięcią masową wymagane do normalnej edycji. Należy również pamiętać, że szerokie wpisy w sieci prywatnej mogą zezwalać na pobieranie dokumentów do większej liczby hostów wewnętrznych niż zamierzono; należy je zawęzić tam, gdzie pozwala na to układ sieci i wersja CODE.

Krok 4: Wyegzekwuj reguły wychodzące poza CODE

Ustawienia aplikacji wyłączają określone zachowania; nie gwarantują one, że system operacyjny lub proces nie będzie mógł nawiązać żadnego innego połączenia. Aby zapewnić silniejszą granicę, zastosuj reguły ruchu wychodzącego na zaporze hosta, w sieci kontenerowej, w zasadach sieciowych Kubernetes lub na zaporze zewnętrznej. Użyj opcji „odmów domyślnie” dla CODE, a następnie zezwól tylko na miejsce docelowe WOPI i jawnie zatwierdzone zależności. Zezwól na DNS przez usługę sieciową, z której korzysta Twoja platforma.

W powyższym przykładzie CODE może mieć dostęp cloud.example.comdo schematu i portu skonfigurowanego dla WOPI, podczas gdy niezwiązane z nim publiczne miejsca docelowe są odrzucane. Unikaj polegania na zakodowanym na stałe adresie IP, gdy host pamięci masowej znajduje się za modułem równoważenia obciążenia lub ma zmienne adresy. Utrzymywana grupa docelowa lub kontrolowany serwer proxy wychodzący są łatwiejsze w zarządzaniu. Upewnij się, że każdy serwer proxy jest spójnie skonfigurowany dla kontenera.

Oddziel ścieżki przychodzące i wychodzące. Przeglądarka musi mieć dostęp do opublikowanego punktu końcowego CODE, a serwer pamięci masowej może potrzebować dostępu do CODE w celu odnajdywania lub obsługi sesji dokumentów. Polityka wyjścia, która zezwala CODE na wywoływanie WOPI, nie ustanawia tych tras przychodzących. Podobnie, zmiana lok_allownie wyłącza każdego typu połączenia wychodzącego.

Krok 5: Uruchom ponownie i zweryfikuj zasady

Uruchom ponownie lub wdróż CODE, aby załadować obowiązującą konfigurację. Sprawdź dzienniki uruchamiania pod kątem załadowanych wartości konfiguracji i ostrzeżeń o zignorowanych ustawieniach. Następnie otwórz edytowalny dokument testowy poprzez standardową integrację z pamięcią masową, wprowadź zmianę, zapisz ją, zamknij i otwórz ponownie. Dokument powinien zachować zmianę.

• Przejrzyj logi zapory sieciowej, serwera proxy lub zasad sieciowych podczas uruchamiania i edycji. Oczekiwany ruch WOPI powinien być dozwolony.
• Sprawdź, czy zewnętrzne cele, które chcesz zablokować, są zablokowane. Sam cichy log nie dowodzi, że każda możliwa trasa jest zablokowana.
• Po upływie poprzedniego interwału sprawdzania aktualizacji sprawdź, czy kontener CODE podjął próbę wyszukania aktualizacji. Upewnij się, że wyskakujące okienko z informacją o aktualizacji jest nieobecne, jeśli zostało również wyłączone.
• Przetestuj wszystkie funkcje potrzebne użytkownikom, w tym czcionki zdalne, tłumaczenia, pomoce językowe, linki do dokumentów i formuły pobierające dane zewnętrzne. Przywróć tylko określone, zatwierdzone miejsce docelowe, którego potrzebuje wymagana funkcja.

Jeśli dokumenty nie otwierają się lub nie zapisują, najpierw sprawdź DNS i trasę WOPI między serwerami. Jeśli błąd dotyczy tylko zewnętrznego obrazu lub formuły arkusza kalkulacyjnego, sprawdź lok_allowoddzielnie zasady zapory sieciowej. Zablokowanie publicznego źródła danych, podczas gdy WOPI nadal działa, jest zamierzonym rezultatem; blokowanie zapisu oznacza, że ​​zasady wyjścia są zbyt szerokie.

Co wyłączenie tych połączeń może, a czego nie może zagwarantować

Wyłączenie sprawdzania aktualizacji i nieużywanych integracji zmniejsza oczekiwaną aktywność wychodzącą z CODE. Polityka sieciowa „domyślnie odrzuć” określa granicę egzekwowania. Żadna z nich nie reguluje oddzielnego ruchu z hosta, środowiska wykonawczego kontenera, platformy orkiestracji, odwrotnego serwera proxy ani agenta monitorującego. Jeśli wymaganie obejmuje cały serwer, należy przeprowadzić audyt również tych komponentów.

Domyślne ustawienia konfiguracji mogą się zmieniać między wersjami, a integracje mogą dodawać nowe ustawienia. Przed wdrożeniem porównaj szablon dostarczony z przypiętym obrazem z bieżącym szablonem źródłowym i przetestuj go w środowisku testowym. Głównymi odniesieniami są szablon konfiguracji źródłowej coolwsd.xml firmy Collabora , jej oficjalne wartości w wykresie Helm oraz oświadczenie dotyczące wdrożeń hostowanych samodzielnie i usług zewnętrznych .