Un contenedor Collabora CODE puede reiniciarse con la configuración predeterminada tras una reconstrucción, o bien, un fallo del servidor puede dejarle sin una copia funcional de su configuración. Realice una copia de seguridad de los coolwsd.xmlarchivos activos y de implementación que proporcionan la configuración. Restáurelos en la misma fuente persistente y, a continuación, valide el archivo y el servicio antes de que los usuarios reanuden la edición.
El archivo principal suele ser /etc/coolwsd/coolwsd.xml. La fuente de información principal difiere para las instalaciones de paquetes, Docker y Helm, así que identifique el despliegue antes de copiar nada.
Al instalar un paquete, inspeccione el archivo host. En Docker, inspeccione el archivo dentro del contenedor en ejecución y verifique si un archivo o directorio host está montado sobre él. Conserve también los valores de Compose, los archivos de entorno referenciados o los valores de Helm: las opciones de inicio que se proporcionan allí no necesariamente se almacenan en XML.
sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml
Sustituye esto collabora-codepor el nombre real de tu contenedor. La configuración de Collabora y la documentación de Docker describen estas rutas de despliegue, y su gráfico Helm original expone la configuración a nivel de gráfico. Consulta la documentación de tu versión; los valores predeterminados y el comportamiento de despliegue pueden variar entre versiones.
/etc/coolwsd/coolwsd.xml.Guarde una copia fechada en un directorio restringido. La configuración puede revelar hosts WOPI permitidos, comportamiento del proxy, rutas de certificados o ajustes administrativos. Trate la copia de seguridad como datos operativos confidenciales.
Para la instalación de un paquete, conserve los metadatos del archivo:
sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
/var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml
Para Docker, copie el archivo en vivo del contenedor al host:
mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml
Si el archivo se proporciona mediante un montaje de enlace, también realice una copia de seguridad de su origen en el host; este archivo puede sobrescribir una edición realizada dentro del contenedor al reiniciar. Mantenga el archivo Compose y cualquier .envarchivo referenciado en el mismo conjunto de copias de seguridad protegidas. Para Helm, guarde el archivo de valores exactos y la identidad de la versión, además de los Secrets o ConfigMaps gestionados por separado utilizando su proceso de gestión de secretos existente.
Registre la etiqueta de imagen CODE o la versión del paquete, el nombre del contenedor, el origen del montaje y la fecha de la copia de seguridad. Las instalaciones de paquetes pueden utilizar esta cp -ainformación para conservar los metadatos. La propiedad de los archivos del contenedor puede diferir de la del host, por lo que no asuma que un propietario o modo de host será adecuado para todas las versiones de la imagen.
Para Compose, determine si se monta un archivo o un directorio completo en /etc/coolwsd. Un montaje de directorio puede ocultar archivos incluidos en la imagen; un directorio incompleto puede impedir el acceso a archivos esperados. Realice copias de seguridad de todos los archivos del directorio montado que CODE utiliza. Mantenga la configuración del entorno por separado y proteja la información confidencial.
Para Helm, no confíe en editar un pod generado: las actualizaciones pueden recrearlo. Conserve los valores del gráfico y cualquier Secret o ConfigMap externo. El gráfico original de Collabora admite el contenido de configuración mediante valores, por lo que su origen declarado puede ser más fiable que una copia de un pod en ejecución.
Detenga CODE o utilice una ventana de mantenimiento. Guarde el archivo actual antes de reemplazarlo. Para la instalación de un paquete, restaure la copia de seguridad elegida y conserve la propiedad y el modo esperados por dicho paquete.
sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
/etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
/etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd
Es posible que el propietario y el grupo de la muestra no coincidan con su paquete. Verifique el archivo existente staty conserve su propiedad y modo esperados en lugar de aplicar valores de muestra sin criterio. Para un contenedor montado mediante enlace, restaure el archivo del host y siga su flujo de trabajo de reinicio o recreación de Compose. Si una imagen personalizada o un valor de Helm proporciona la configuración, actualice esa fuente y vuelva a implementarla; la edición de un contenedor desechable no tendrá efecto.
Revise la configuración antes de restaurarla tras un cambio de versión importante. Las opciones pueden variar entre versiones, así que compare el archivo guardado con la plantilla y las notas de migración de la versión de destino. La restauración del archivo XML no restaura los certificados, las claves privadas, las fuentes personalizadas ni la configuración del proxy inverso, a menos que se hayan realizado copias de seguridad por separado.
Compruebe que el archivo existe, que el servicio puede leerlo y que es un XML bien formado. Si está instalado, xmllintcompruebe la sintaxis:
xmllint --noout /etc/coolwsd/coolwsd.xml
Esto solo confirma la sintaxis XML; no prueba que todas las opciones sean compatibles con su versión de CODE. Revise los registros en busca de errores de análisis y confirme que el servicio sigue en ejecución. Para contenedores, revise docker compose pslos registros recientes. Para paquetes, revise systemctl status coolwsdel registro del sistema.
Finalmente, abra un documento a través del host WOPI habitual y confirme que se carga y guarda correctamente. Si CODE se inicia pero los documentos no se cargan, compare la lista de permisos restaurada, el nombre de host externo, la terminación TLS y la configuración del proxy con la configuración de la implementación. Si el inicio falla, revierta a la copia anterior a la restauración y compare los archivos antes de intentarlo de nuevo.
Realice una copia de seguridad de coolwsd.xml y sus fuentes de implementación, restáurelas de forma segura y verifique el CÓDIGO antes de que los usuarios vuelvan a editarlo.
Permita el origen exacto de Nextcloud u otro WOPI en CODE, luego verifique la lista de hosts permitidos activa y distíngala de la restricción de IP de origen de Nextcloud.
Analiza las conexiones del navegador, WOPI y WebSocket de Collabora para descubrir por qué no se abre un documento y, a continuación, aplica la solución que coincida con la configuración de tu Nextcloud.
Implementa réplicas de Collabora CODE con Helm, mantén cada documento en un pod mediante la afinidad WOPI y verifica el acceso, la ubicación de los nodos y la edición en Nextcloud.
Rastrea un error en el protocolo de enlace de socket desde el navegador hasta coolwsd, y luego compara la ruta del proxy inverso con tu versión de Collabora, incluyendo el cambio de Apache CODE 26.04.
Detecta fallos en la prueba WOPI de Collabora debidos a claves que no coinciden, datos de descubrimiento obsoletos, desfase horario o cambios en la URL del proxy, sin debilitar la validación.
Restablezca el zoom del navegador, pruebe una sesión limpia e identifique cuándo un menú de tamaño con formato incorrecto necesita una actualización del servidor de Collabora.
Implemente Collabora CODE con Docker, conéctelo de forma segura a Nextcloud Office y verifique la edición de documentos con comprobaciones prácticas de WOPI y proxy.
Activa temporalmente el modo de depuración de coolwsd, captura un intento de apertura fallido y utiliza la secuencia de registros para separar los problemas de WebSocket, WOPI, proxy y contenedor.
Configure el inicio de sesión de administrador de Collabora Online para Docker o Linux, reinicie el servicio correspondiente y verifique la nueva contraseña sin exponerla.
