Disabilita i controlli di aggiornamento del codice Collabora e le connessioni indesiderate

Per impedire a Collabora Online Development Edition (CODE) di eseguire il controllo di versione pianificato, impostare fetch_update_checksu 0e allow_update_popupsu false. Per una distribuzione che non deve contattare servizi esterni non approvati, disabilitare anche le integrazioni non utilizzate e imporre una lista di traffico in uscita consentita al confine della rete; nascondere solo le notifiche di aggiornamento non blocca il traffico di rete.

Sappi cosa stai disabilitando

A ottobre 2026, la coolwsd.xml.indocumentazione di Collabora indicava un intervallo di controllo degli aggiornamenti di 10 ore e un controllo separato per le notifiche di aggiornamento. Non era presente un interruttore universale denominato "disabilita telemetria". Una richiesta di aggiornamento, la modifica assistita dal cloud (opzionale), i log di diagnostica locali e l'essenziale connessione WOPI a un server di archiviazione documenti sono elementi distinti. Trattarli come un'unica impostazione può lasciare le connessioni attive o compromettere la modifica dei documenti.

Queste istruzioni si applicano principalmente a collabora/codeun'installazione Docker autonoma. Le installazioni di pacchetti utilizzano gli stessi concetti di configurazione, ma in genere modificano /etc/coolwsd/coolwsd.xmle riavviano il coolwsdservizio. Le installazioni CODE integrate gestite da un altro prodotto potrebbero rigenerare le opzioni di avvio; è preferibile modificarle nel prodotto di gestione piuttosto che applicare patch a file temporanei.

1. Identifica le impostazioni di esecuzione e mantieni una copia di ripristino

Innanzitutto, verifica se il tuo servizio CODE è configurato tramite Docker Compose, un docker runcomando o un pacchetto nativo. Nel caso di Docker, esamina il container e il suo ambiente corrente senza pubblicare l'output, poiché le variabili d'ambiente possono contenere credenziali:

docker ps --format 'table {{.Names}}	{{.Image}}'
docker inspect --format '{{range .Config.Env}}{{println .}}{{end}}' code

Sostituisci codecon il nome effettivo del tuo container. Salva una copia sicura del file di distribuzione o di quello esistente coolwsd.xmlprima di modificarlo. Se la configurazione di Compose include già la terminazione TLS, le autorizzazioni host WOPI o i parametri di autenticazione, mantieni tali valori.

2. Disabilitare la connessione di aggiornamento periodico

Per Docker Compose

Aggiungi queste opzioni al extra_paramsvalore esistente nel blocco del tuo servizio CODE environment. Si tratta di un frammento, non di una sostituzione completa del file Compose:

services:
  code:
    environment:
      extra_params: >-
        --o:fetch_update_check=0
        --o:allow_update_popup=false

Unisci i due flag con eventuali extra_paramsflag esistenti invece di sovrascriverli. Quindi ricrea solo il servizio CODE con docker compose up -d --no-deps --force-recreate code, utilizzando il nome effettivo del tuo servizio Compose. In una docker rundistribuzione, includi le stesse opzioni nella extra_paramsvariabile d'ambiente quando ricrei il container.

Per i pacchetti Linux

Modifica /etc/coolwsd/coolwsd.xml. Individua gli elementi esistenti e modifica i loro valori, mantenendo gli attributi originali:

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

Se gli elementi esistenti contengono attributi, mantienili e modifica solo i valori di testo. Verifica che il file sia XML valido prima di riavviare; ad esempio, usa xmllint --noout /etc/coolwsd/coolwsd.xmlse xmllintè installato. Riavvia usando sudo systemctl restart coolwsd.

Importante: allow_update_popup=false questa impostazione sopprime la notifica di aggiornamento dell'editor; non costituisce di per sé un controllo in uscita. L' fetch_update_check=0impostazione riguarda il controllo pianificato. La tua organizzazione deve comunque monitorare gli aggiornamenti di sicurezza attraverso il normale processo di manutenzione.

3. Disattiva i servizi opzionali che possono contattare altri host

Esaminate la configurazione attiva per le integrazioni remote. Nella configurazione upstream corrente, la correzione di bozze remota di LanguageTool o Duden è disabilitata per impostazione predefinita, e anche le opzioni AI e DeepL a livello di server sono documentate come disabilitate per impostazione predefinita. Un amministratore o un'integrazione potrebbero averle abilitate. Se queste opzioni sono presenti nella versione di CODE installata, mantenetele disabilitate se non ne avete bisogno.

--o:languagetool.enabled=false
--o:ai.enabled=false
--o:deepl.enabled=false

Includi solo le opzioni supportate dalla versione installata e uniscile extra_paramsanziché stabilire un secondo valore in conflitto. Gli stessi effetti possono essere configurati nelle sezioni corrispondenti <languagetool>di <ai>un'installazione <deepl>XML nativa.

Prima di eliminarli remote_config.remote_url, remote_font_config.urlcontrollali. Un URL di configurazione remota vuoto evita il recupero facoltativo della configurazione; un URL di font remoto potrebbe legittimamente puntare alla tua installazione di Nextcloud. La sua rimozione potrebbe influire sulla tipografia del documento, quindi mantienilo se il servizio di font è approvato e richiesto. Esamina anche gli indirizzi WebSocket di monitoraggio configurati e i plugin aggiuntivi, come un gestore di citazioni, in base alle esigenze della tua implementazione.

La registrazione dei log è una questione di privacy separata, non una prova di telemetria esterna. Esamina logging.docstats, logging.userstats, e logging.anonymize.anonymize_user_datase desideri limitare gli identificatori locali nella diagnostica. Mantieni una quantità sufficiente di log di sicurezza e operativi per risolvere gli incidenti; la modifica del livello di dettaglio dei log non blocca i socket in uscita.

4. Limitare il traffico in uscita senza interrompere WOPI

Una modifica che interessa solo la configurazione non può garantire l'assenza di connessioni in uscita impreviste. Posiziona CODE dietro un firewall o un proxy in uscita che consenta le destinazioni e le porte specifiche richieste dalla tua implementazione. In genere, ciò significa che dovrai utilizzare l'host di archiviazione WOPI approvato, eventuali servizi interni di font o di identità effettivamente utilizzati e l'infrastruttura necessaria, come il DNS interno. Blocca altre destinazioni Internet, inclusi gli endpoint di aggiornamento non approvati, dal carico di lavoro di CODE.

Non disabilitare la rete indiscriminatamente né impostare la rete Docker su internal: true: a seconda dell'architettura, ciò potrebbe impedire a CODE di raggiungere il suo server WOPI o di funzionare correttamente le integrazioni necessarie. Ricorda inoltre che il browser dell'utente carica le risorse dell'editor e può effettuare richieste indipendentemente dal server CODE; le regole del firewall del server non regolano il browser.

Per le installazioni di Docker Engine che utilizzano il backend iptables, Docker documenta la DOCKER-USERcatena come il luogo previsto per le regole di inoltro dell'amministratore. Con il backend nftables, implementa una catena di base separata anziché presupponerne DOCKER-USERl'esistenza. Progetta le regole per la tua rete bridge o container effettiva, IPv4 e IPv6, DNS, stato della connessione e traffico WOPI legittimo; una DROPregola generica incollata può essere modificata offline. Consulta le linee guida di Docker per iptables e nftables prima di applicare le policy.

5. Verificare le modifiche, inclusa l'attività di rete effettiva.

Dopo un riavvio o una ricreazione del container, controlla i log di avvio per individuare eventuali errori di configurazione e prova ad aprire, modificare e salvare un documento tramite la normale integrazione con lo storage. Un editor reattivo da solo non è sufficiente a garantire che tutte le richieste non autorizzate siano state interrotte. Verifica i parametri di avvio in esecuzione, quindi esamina i log DNS e delle connessioni in uscita dal firewall, dal proxy di uscita o dalla rete del container durante l'avvio e la modifica del documento.

docker logs --since 10m code
# Check configured flags without exposing unrelated environment secrets:
docker inspect --format '{{range .Config.Env}}{{println .}}{{end}}' code | grep '^extra_params='

Nelle installazioni native, utilizza sudo journalctl -u coolwsd --since '10 minutes ago'e analizza il file XML locale. Per quanto riguarda il browser, apri gli strumenti per sviluppatori e controlla la scheda Rete mentre apri un documento. Distingui le richieste dirette ai tuoi host CODE e WOPI da quelle provenienti da destinazioni di terze parti.

Criteri di successo: CODE carica e salva i documenti normalmente; l'opzione di verifica degli aggiornamenti è impostata su zero; le integrazioni cloud opzionali rimangono disabilitate a meno che non siano esplicitamente approvate; e il monitoraggio della rete mostra solo le destinazioni consentite durante il periodo di osservazione. Se il caricamento dei documenti non riesce dopo il filtraggio del traffico, esaminare temporaneamente le destinazioni bloccate rispetto all'elenco WOPI e infrastruttura approvato anziché disabilitare la verifica del certificato TLS o aprire il traffico in uscita illimitato.

Riferimenti principali: il modello di configurazione del server gestito da Collabora , la configurazione del container Nextcloud All-in-One CODE e la descrizione ufficiale dell'immagine Docker di CODE . Questi documenti descrivono le impostazioni e i modelli di implementazione pertinenti; non sostituiscono un'analisi di rete della vostra specifica installazione.