Desative as verificações de atualização do Collabora CODE e as conexões indesejadas.

Para impedir que o Collabora Online Development Edition (CODE) faça sua verificação de versão agendada, defina `true` fetch_update_checkcomo `false` 0e ​​` false` allow_update_popupcomo `false` false. Para uma implantação que não deve contatar serviços externos não aprovados, desative também as integrações não utilizadas e imponha uma lista de permissões de saída no limite da rede; ocultar os avisos de atualização por si só não bloqueia o tráfego de rede.

Saiba o que você está desativando

A partir de outubro de 2026, a Collabora mantém coolwsd.xml.inum intervalo de verificação de atualizações de 10 horas para os documentos e um controle separado para notificações de atualização. Não há documentação sobre uma opção universal chamada "desativar telemetria". Uma solicitação de atualização, a edição opcional assistida por nuvem, os registros de diagnóstico locais e a conexão WOPI essencial com um servidor de armazenamento de documentos são coisas diferentes. Tratá-las como uma única configuração pode manter as conexões ativas ou interromper a edição de documentos.

Estas instruções aplicam-se principalmente a uma collabora/codeimplementação Docker independente. As instalações de pacotes utilizam os mesmos conceitos de configuração, mas normalmente editam /etc/coolwsd/coolwsd.xmle reiniciam o coolwsdserviço. As instalações CODE integradas, geridas por outro produto, podem regenerar as opções de inicialização; altere-as no produto que as gere, em vez de modificar ficheiros temporários.

1. Identifique as configurações em execução e mantenha um ponto de reversão.

Primeiro, determine se o seu serviço CODE está configurado por meio do Docker Compose, de um docker runcomando ou de um pacote nativo. No caso do Docker, inspecione o contêiner e seu ambiente atual sem publicar a saída, pois as variáveis ​​de ambiente podem conter credenciais.

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

Substitua codepelo nome real do seu contêiner. Salve uma cópia segura do arquivo de implantação ou do arquivo existente coolwsd.xmlantes de alterá-lo. Se a sua configuração do Compose já incluir terminação TLS, permissões de host WOPI ou parâmetros de autenticação, preserve esses valores.

2. Desative a conexão de atualização periódica.

Para Docker Compose

Adicione essas opções ao extra_paramsvalor existente no bloco do seu serviço CODE environment. Este é um fragmento, não uma substituição completa do arquivo Compose:

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

Em vez de sobrescrevê-las , combine as duas flags com quaisquer extra_paramsflags existentes. Em seguida, recrie apenas o serviço CODE com ` --recreate` docker compose up -d --no-deps --force-recreate code, usando o nome real do seu serviço Compose. Em uma docker runimplantação, inclua as mesmas opções na extra_paramsvariável de ambiente ao recriar o contêiner.

Para pacotes Linux

Editar /etc/coolwsd/coolwsd.xml. Localize os elementos existentes e altere seus valores, mantendo seus atributos originais:

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

Se os elementos existentes contiverem atributos, mantenha-os e altere apenas os valores de texto. Verifique se o arquivo é um XML válido antes de reiniciar; por exemplo, use `xxml` xmllint --noout /etc/coolwsd/coolwsd.xmlse xmllinto `xxml` estiver instalado. Reinicie usando `xxml` sudo systemctl restart coolwsd.

Importante: allow_update_popup=false suprime a notificação de atualização do editor; não é um controle de saída em si. A fetch_update_check=0configuração se refere à verificação agendada. Sua organização ainda precisa monitorar as atualizações de segurança por meio de seu processo normal de manutenção.

3. Desative os serviços opcionais que podem contatar outros hosts.

Analise a configuração ativa para integrações remotas. Na configuração upstream atual, a revisão ortográfica remota do LanguageTool ou do Duden está desativada por padrão, e as opções de IA e DeepL em todo o servidor também estão documentadas como desativadas por padrão. Um administrador ou uma integração pode tê-las ativado. Caso essas opções existam na sua versão do CODE instalada, mantenha-as desativadas se não precisar delas:

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

Inclua apenas as opções suportadas pela sua versão instalada e combine-as extra_paramsem vez de criar um segundo valor conflitante. Os mesmos efeitos podem ser configurados nas seções correspondentes `<file>`, `<file>` e `<file>` de uma instalação XML <languagetool>nativa <ai>.<deepl>

Inspecione- remote_config.remote_urlos remote_font_config.urlantes de excluí-los. Uma URL de configuração remota vazia evita a busca opcional de configuração; uma URL de fonte remota pode apontar legitimamente para sua própria instalação do Nextcloud. Removê-la pode afetar a tipografia do documento, portanto, mantenha-a se o serviço de fontes for aprovado e necessário. Examine também quaisquer endereços WebSocket de monitoramento configurados e plugins adicionais, como um gerenciador de citações, de acordo com as necessidades da sua implementação.

O registro de logs é uma questão de privacidade à parte, não sendo uma prova de telemetria externa. Consulte as configurações de privacidade logging.docstats, logging.userstatssegurança e logging.anonymize.anonymize_user_dataoutras diretrizes se desejar limitar os identificadores locais em diagnósticos. Mantenha logs de segurança e operacionais suficientes para solucionar incidentes; alterar o nível de detalhamento dos logs não bloqueia conexões de saída.

4. Restringir o tráfego de saída sem violar o WOPI

Uma alteração que envolva apenas configuração não garante zero conexões de saída inesperadas. Coloque o CODE atrás de um firewall ou proxy de saída que permita os destinos e portas específicos que sua implementação exige. Normalmente, isso significa seu host de armazenamento WOPI aprovado, quaisquer serviços internos de fonte ou identidade que você realmente utilize e a infraestrutura necessária, como DNS interno. Bloqueie outros destinos da Internet, incluindo endpoints de atualização não aprovados, da carga de trabalho do CODE.

Não desative a rede cegamente nem configure a rede do Docker para internal: true`false`: dependendo da sua arquitetura, isso pode impedir que o CODE se conecte ao servidor WOPI ou que as integrações necessárias funcionem. Lembre-se também de que o navegador do usuário carrega recursos do editor e pode fazer solicitações independentemente do servidor CODE; as regras do firewall do servidor não controlam o navegador.

Para instalações do Docker Engine que utilizam o backend iptables, o Docker documenta a DOCKER-USERcadeia como o local apropriado para regras de encaminhamento de administrador. Com o backend nftables, implemente uma cadeia base separada em vez de presumir que DOCKER-USERela já exista. Crie regras para sua rede bridge ou de contêineres, IPv4 e IPv6, DNS, estado da conexão e tráfego WOPI legítimo; uma DROPregra genérica copiada e colada pode exigir edição offline. Consulte as diretrizes do Docker para iptables e nftables antes de aplicar qualquer política.

5. Verifique as alterações, incluindo a atividade real da rede.

Após uma reinicialização ou recriação do contêiner, inspecione os logs de inicialização em busca de erros de configuração e teste a abertura, edição e salvamento de um documento por meio da integração de armazenamento normal. Um editor responsivo por si só não comprova que todas as solicitações não autorizadas foram interrompidas. Verifique os parâmetros de inicialização em execução e, em seguida, revise os logs de DNS e de conexão de saída do seu firewall, proxy de saída ou rede do contêiner durante a inicialização e a edição do 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='

Em instalações nativas, utilize sudo journalctl -u coolwsd --since '10 minutes ago'e inspecione o XML local. No lado do navegador, abra as ferramentas de desenvolvedor e examine a aba Rede enquanto abre um documento. Distinga as requisições para seus próprios hosts CODE e WOPI das requisições de destinos de terceiros.

Critérios de sucesso: o CODE carrega e salva documentos normalmente; a opção de verificação de atualização está definida como zero; as integrações opcionais com a nuvem permanecem desativadas, a menos que sejam explicitamente aprovadas; e o monitoramento de rede mostra apenas os destinos permitidos durante o período de observação. Se o carregamento de documentos falhar após a filtragem do tráfego, revise temporariamente os destinos negados em relação à lista de infraestrutura e WOPI aprovada, em vez de desativar a verificação do certificado TLS ou liberar o tráfego de saída irrestrito.

Referências principais: o modelo de configuração de servidor mantido pela Collabora , a configuração do contêiner CODE All-in-One do Nextcloud e a descrição oficial da imagem Docker do CODE . Esses documentos descrevem as configurações e os padrões de implantação relevantes; eles não substituem uma auditoria de rede da sua instalação específica.