Cómo deshabilitar la telemetría y las conexiones externas en Collabora CODE

Respuesta breve: Collabora Online Development Edition (CODE) no ofrece un interruptor de telemetría general que los administradores deban desactivar para los análisis rutinarios. Collabora afirma que la versión Online autoalojada no requiere telemetría ni devoluciones de llamada para análisis. La actividad saliente que conviene controlar es independiente: comprobaciones periódicas de actualizaciones, integraciones opcionales, puntos finales de monitorización y funciones de documentos que obtienen datos remotos. Desactive las funciones opcionales que no utilice y, a continuación, aplique una lista de permisos de salida manteniendo la conexión WOPI con su servidor de almacenamiento.

Esto se aplica a las instancias de CODE autoalojadas, como las integradas con Nextcloud u ownCloud. Bloquear completamente el tráfico saliente puede provocar fallos en la carga y el guardado de documentos, ya que CODE necesita conectarse a su servidor WOPI. Los nombres de configuración que aparecen a continuación se compararon con la plantilla original de Collabora el 6 de octubre de 2026; el empaquetado y los valores predeterminados pueden variar según la versión.

¿Qué se considera telemetría o conexión externa?

La telemetría generalmente se refiere al uso del producto o a los datos de diagnóstico que se envían a un proveedor. Collabora afirma que su producto Online autoalojado no requiere telemetría, devoluciones de llamada de análisis ni conectividad con servicios externos. La coolwsd.xmlplantilla de origen no muestra un recolector de telemetría global ni un interruptor de "conexión remota".

Muestra una comprobación periódica de la versión: fetch_update_checkpor defecto, cada 10 horas. Configúrala para 0desactivar dicha comprobación. allow_update_popupControla si aparecen avisos de actualización en el editor; al configurarla, se falseoculta la notificación, pero no sustituye la desactivación de la comprobación en sí. Si tu versión admite ambas opciones, configúralas ambas.

Otras conexiones dependen de las funcionalidades. Pueden incluir un monitor externo configurado, servicios remotos de corrección ortográfica o gramatical, traducción con DeepL, proveedores de IA, configuración remota de fuentes y datos externos solicitados por un documento. La plantilla de origen indica que las API remotas de LanguageTool o Duden están deshabilitadas por defecto; DeepL también está deshabilitada por defecto. Utilice la configuración incluida en su versión exacta de CODE al revisar las opciones de IA o integración.

Paso 1: Identificar los destinos esenciales y opcionales.

Mapea el funcionamiento de la edición antes de modificar la red. Por ejemplo, supongamos que Nextcloud se encuentra en cloud.example.comy CODE en office.example.com. El navegador carga el editor desde CODE, mientras que el servidor CODE también se comunica con Nextcloud a través de WOPI para obtener y guardar el documento. Conserva esa ruta de servidor a servidor, el esquema y el puerto utilizados por tu instalación, y cualquier servicio DNS o proxy que requiera tu implementación.

A continuación, haga un inventario de los servicios opcionales en su configuración efectiva. Busque <monitors>direcciones de monitorización configuradas explícitamente. Compruebe la corrección ortográfica remota, DeepL, IA, la configuración remota de fuentes y las URL de configuración remota. Elimine los puntos finales personalizados que no formen parte de un flujo de trabajo aprobado. Si se necesita alguno, documente su nombre de host y su propósito antes de crear la excepción de red correspondiente.

También examine lok_allow. Controla qué hosts pueden usar los documentos editados como fuentes de datos externas, incluidas las URL utilizadas para gráficos insertados o funciones de hoja de cálculo como WEBSERVICE(). No es un cortafuegos universal. La configuración ascendente indica que los hosts WOPI y POST permitidos también pueden tratarse como fuentes de datos permitidas, por lo que debe mantener esta política separada de los controles de salida de red.

Paso 2: Deshabilitar las comprobaciones de actualización periódicas

Para el contenedor Collabora CODE, configure las opciones mediante su extra_paramsvariable de entorno. Incorpórelas al valor existente; conserve cualquier configuración actual de terminación TLS, proxy inverso o host de la que dependa su instalación. Fije una etiqueta de imagen CODE aprobada para su entorno en lugar de depender de una latestetiqueta dinámica.

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

Este es un fragmento ilustrativo de Docker Compose, no una implementación completa. Conserve sus restricciones de dominio, credenciales de administrador, configuración TLS y configuración de proxy existentes. En Kubernetes, el gráfico Helm original expone collabora.extra_paramsy admite coolwsd.xmlcontenido personalizado; utilice el archivo de valores y las instrucciones correspondientes a la versión del gráfico que instaló.

Si gestionas el archivo XML directamente, coloca los valores dentro de su <config>elemento principal:

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

No confíe en una edición manual dentro de un contenedor en ejecución a menos que ese archivo sea persistente. Un reinicio, una actualización de imagen o una implementación de orquestación podrían reemplazarlo. Modifique la fuente de configuración persistente de Compose, Helm o montada y vuelva a crear o implementar CODE siguiendo su procedimiento habitual.

Paso 3: Desactive las integraciones no utilizadas y restrinja la recuperación de documentos.

Déjelo <monitors>en blanco si no utiliza un servicio de monitorización externo. El archivo de origen contiene un ejemplo de monitorización comentado; una entrada comentada es un ejemplo, no una conexión activa. Elimine las entradas de monitorización activas que se hayan añadido localmente si ya no son necesarias.

Mantén desactivadas las funciones de corrección ortográfica y gramatical remota, DeepL y los proveedores de IA, a menos que los usuarios las necesiten. La corrección lingüística remota puede enviar el texto seleccionado del documento al servicio configurado, por lo que su activación tiene consecuencias tanto para la conectividad como para el manejo de datos. Si se requiere una integración, permite únicamente el acceso a su punto final aprobado mediante la política de salida.

Para el contenido remoto solicitado por los documentos, elimine los hosts públicos <lok_allow>y conserve solo los destinos que sus usuarios necesiten. No elimine la ruta WOPI para lograr esto. WOPI es la conexión de almacenamiento necesaria para la edición normal. Tenga en cuenta también que las entradas de red privada amplias pueden permitir la recuperación de documentos a más hosts internos de los previstos; redúzcalas donde lo permitan la configuración de su red y la versión de CODE.

Paso 4: Aplicar reglas de salida fuera del código

La configuración de la aplicación desactiva ciertos comportamientos; no garantiza que el sistema operativo o el proceso no puedan abrir ninguna otra conexión. Para una mayor protección, aplique reglas de salida en el firewall del host, la red del contenedor, la política de red de Kubernetes o un firewall externo. Use la opción denegar por defecto para CODE y permita solo el destino WOPI y las dependencias aprobadas explícitamente. Permita el DNS a través del servicio de red que utiliza su plataforma.

En el ejemplo anterior, es posible que se permita el acceso a CODE cloud.example.commediante el esquema y el puerto configurados para WOPI, mientras que se deniegan los accesos a destinos públicos no relacionados. Evite depender de una IP fija cuando el host de almacenamiento se encuentre detrás de un balanceador de carga o tenga direcciones IP variables. Un grupo de destinos mantenido o un proxy de salida controlado facilitan la gestión. Asegúrese de que cualquier proxy esté configurado de forma coherente para el contenedor.

Mantenga separadas las rutas de entrada y salida. El navegador debe poder acceder al punto final de CODE publicado, y el servidor de almacenamiento podría necesitar acceder a CODE para sesiones de descubrimiento o de documentos. Una política de salida que permite a CODE llamar a WOPI no establece esas rutas de entrada. Del mismo modo, modificar la configuración lok_allowno desactiva todos los tipos de conexiones de salida.

Paso 5: Reinicie y verifique la política.

Reinicia o implementa CODE para que se cargue la configuración efectiva. Revisa los registros de inicio para ver los valores de configuración cargados y las advertencias sobre configuraciones ignoradas. Luego, abre un documento de prueba editable mediante la integración de almacenamiento habitual, realiza un cambio, guárdalo, ciérralo y vuelve a abrirlo. El documento debería conservar el cambio.

• Revise los registros del firewall, el proxy o la política de red durante el inicio y la edición. Se debe permitir el tráfico WOPI previsto.
• Confirme que los destinos externos que pretendía bloquear estén denegados. Un registro de errores silencioso por sí solo no demuestra que todas las rutas posibles estén bloqueadas.
• Una vez transcurrido el intervalo de comprobación de actualizaciones anterior, verifique si el contenedor CODE intentó buscar actualizaciones. Confirme que la ventana emergente de actualización no aparece si también se deshabilitó.
• Pruebe todas las funciones que los usuarios necesiten, incluidas las fuentes remotas, la traducción, las ayudas lingüísticas, los enlaces a documentos y las fórmulas que recuperan datos externos. Restaure únicamente el destino específico aprobado que requiera cada función.

Si los documentos no se abren ni se guardan, compruebe primero el DNS y la ruta WOPI entre servidores. Si solo falla una imagen externa o una fórmula de hoja de cálculo, revise la configuración lok_allowpor separado de la política del firewall. El bloqueo de una fuente de datos pública mientras WOPI sigue funcionando es el resultado esperado; si se bloquea el guardado, significa que la política de salida es demasiado amplia.

Lo que la desactivación de estas conexiones puede y no puede garantizar

Desactivar la comprobación de actualizaciones y las integraciones no utilizadas reduce la actividad saliente prevista de CODE. Una política de red de denegación por defecto establece el límite de aplicación. Ninguna de las dos opciones regula el tráfico independiente del host, el entorno de ejecución de contenedores, la plataforma de orquestación, el proxy inverso o el agente de monitorización. Si el requisito abarca todo el servidor, audite también esos componentes.

La configuración predeterminada puede cambiar entre versiones, y las integraciones pueden añadir ajustes. Compare la plantilla incluida en su imagen fijada con la plantilla actual de la rama principal antes del despliegue y realice pruebas en el entorno de pruebas. Las referencias principales son la plantilla de configuración coolwsd.xml de la rama principal de Collabora , sus valores oficiales del gráfico de Helm y su declaración sobre despliegues autohospedados y servicios externos .