Si un contenedor de Collabora Online Development Edition (CODE) se cierra inmediatamente en una máquina ARM64, comience por verificar la compatibilidad de la arquitectura antes de modificar la configuración de red, los certificados o WOPI. A fecha de 7 de octubre de 2026, el collabora/coderepositorio oficial incluye linux/arm64variantes nativas para las versiones actuales, incluida la latestetiqueta y versión 26.04.4.2.1. Esto significa que un host ARM64 moderno normalmente no necesita emulación x86 para ejecutar CODE. El flujo de trabajo más útil para principiantes consiste en confirmar la arquitectura del host, inspeccionar la etiqueta exacta de la imagen, eliminar cualquier configuración AMD64 forzada, descargar una imagen compatible con ARM64 y, solo entonces, solucionar problemas de configuración a nivel de aplicación.
Esta guía se centra en el fallo de inicio en sí. No presupone que todos los problemas de ARM64 tengan la misma causa. Si el contenedor se inicia correctamente, pero Nextcloud, ownCloud u otro host WOPI no pueden conectarse a él, se trata de una fase diferente de resolución de problemas.
ARM64 es una arquitectura de CPU ARM de 64 bits. Linux la suele reportar como aarch64, mientras que Docker suele etiquetar el mismo objetivo como linux/arm64. AMD64 , también llamado x86-64, es una arquitectura de CPU diferente. Una imagen de contenedor contiene binarios compilados para una o más arquitecturas; Docker puede seleccionar automáticamente la variante correcta solo cuando la etiqueta de la imagen proporciona un manifiesto compatible.
Una imagen multiplataforma es una única etiqueta de imagen cuyo manifiesto de registro apunta a compilaciones de imagen independientes para arquitecturas como AMD64 y ARM64. Docker indica que, al descargar una imagen multiplataforma, selecciona automáticamente la variante correspondiente al host. Consulte la documentación de Docker sobre imágenes multiplataforma para obtener más información sobre su funcionamiento.
Para Collabora CODE en concreto, consulta la lista oficial de etiquetas collabora/code en Docker Hub en lugar de basarte en un tutorial antiguo. Cuando se revisó este artículo el 7 de octubre de 2026, se incluyó latesty también se listó una etiqueta específica . Las versiones anteriores fijadas pueden variar, por lo que la etiqueta que implementes es más importante que una afirmación general como «Collabora es compatible con ARM».26.04.4.2.1linux/arm64latest-arm64
docker-compose.ymlcomando actual o de implementación.El resultado deseado es sencillo: Docker debería descargar una imagen ARM64, el contenedor debería permanecer en ejecución en lugar de finalizar inmediatamente, y sus registros deberían continuar con el inicio normal de Collabora en lugar de fallar con un error de arquitectura.
Ejecute estas comprobaciones en la máquina que ejecuta el contenedor de Collabora:
uname -m
docker info --format '{{.Architecture}}'
docker versionEn un host Linux ARM nativo de 64 bits, uname -mnormalmente devuelve aarch64, mientras que Docker debería informar arm64. Estos nombres se refieren a la misma familia de arquitectura en este contexto.
Si Docker informa que la máquina física es AMD64, aunque sea ARM64, determine si está utilizando un contexto Docker remoto, una máquina virtual o Docker Desktop con un backend diferente. Resuelva esta ambigüedad antes de continuar. De lo contrario, podría inspeccionar un sistema mientras implementa en otro.
Las señales típicas incluyen exec format errorun mensaje de registro que indica que existe un error no matching manifest for linux/arm64o un servicio Compose configurado explícitamente con un error platform: linux/amd64. Estos mensajes son una prueba más sólida de una incompatibilidad de plataforma que la salida genérica de "el contenedor ha finalizado".
No asuma que todas las etiquetas históricas tienen la misma compatibilidad de plataforma que las actuales latest. Inspeccione los metadatos del registro de la etiqueta en su implementación:
docker buildx imagetools inspect collabora/code:latestLa documentación de `buildx imagetools inspect` de Docker explica cómo este comando muestra las plataformas contenidas en una imagen de registro. También puede usar docker manifest inspect; Docker documenta ese comando en su referencia de inspección de manifiestos .
Si linux/arm64aparece, puede usar la etiqueta multiplataforma y dejar que Docker seleccione la imagen correcta. Para una prueba de solución de problemas explícita, el repositorio oficial también la incluye latest-arm64. Para implementaciones de producción de larga duración, una etiqueta versionada exacta que haya probado suele ser más fácil de reproducir que latest, porque latestcambia a medida que se publican nuevas versiones.
Si la etiqueta fijada no incluye ARM64, tiene tres opciones:
| Elección | Mejor ajuste | Compensación |
|---|---|---|
| Cambiar a una etiqueta de CÓDIGO nativa ARM64 actual | La mayoría de los servidores ARM64 y los laboratorios domésticos | Debe validar la compatibilidad de la versión y la configuración de integración. |
| Manténgase en la versión anterior usando la emulación AMD64. | Pruebas de compatibilidad a corto plazo | Complejidad adicional y posible sobrecarga de rendimiento; no es la solución preferida cuando existe una imagen nativa. |
| Mantén la versión anterior en un host AMD64. | Fijación estricta de versiones cuando el riesgo de actualización es inaceptable. | Requiere hardware o capacidad de máquina virtual diferente. |
Un fallo común no es la imagen de Collabora en sí, sino un archivo de despliegue que fuerza la plataforma incorrecta. Docker Compose define platformcomo el sistema operativo y la arquitectura de destino utilizados para seleccionar la variante de imagen. La referencia del servicio Docker Compose muestra valores como linux/arm64/v8.
En un host ARM64, esta configuración resulta sospechosa:
services:
collabora:
image: collabora/code:latest
platform: linux/amd64Si no necesita emulación, elimine esa línea y deje que Docker elija la variante nativa del host. Como alternativa, especifique platform: linux/arm64cuándo desea que la arquitectura sea explícita.
Luego, elimine únicamente el contenedor que falló y vuelva a descargar la imagen. No elimine los datos persistentes a menos que tenga una razón específica para hacerlo:
docker compose down
docker image rm collabora/code:latest 2>/dev/null || true
docker pull --platform linux/arm64 collabora/code:latest
docker compose up -dSi utiliza la etiqueta de arquitectura dedicada para una ejecución de diagnóstico, sustituya collabora/code:latest-arm64. Una vez que confirme que la implementación funciona, considere fijar una versión exacta, como una etiqueta 26.04.x probada, en lugar de dejar un sistema de producción con una etiqueta cambiante.
Tras recrear el contenedor, compruebe el estado y los registros:
docker compose ps
docker compose logs --tail=100 collaboraPara una implementación de un solo contenedor, los comandos equivalentes son docker ps -ay docker logs --tail=100 <container-name>.
El primer criterio de éxito es que el contenedor permanezca activo y no presente errores de formato de manifiesto o ejecutable. Solo después de esto debería considerar la accesibilidad al puerto 9980, la configuración del proxy inverso, TLS, los hosts WOPI permitidos o la integración de la aplicación. La documentación oficial de Collabora para Docker (CODE) es el lugar adecuado para verificar los parámetros de implementación actuales.
La emulación puede ser útil cuando el software solo existe para otra arquitectura de CPU, pero las imágenes actuales de Collabora CODE incluyen variantes ARM64. Agregar la emulación primero puede ocultar el problema real y añadir un componente adicional. Prefiera ARM64 nativo cuando la versión de CODE que necesite lo permita.
La disponibilidad de la plataforma está vinculada a una etiqueta de imagen y un manifiesto específicos. Una etiqueta actual puede ser compatible con ARM64, mientras que una versión anterior no lo es. Consulte la referencia exacta en su archivo Compose.
Esto puede provocar que un host ARM64 utilice la variante x86-64 incluso cuando existe una imagen ARM64 nativa. Elimine la anulación a menos que tenga una razón deliberada y comprobada para la emulación.
Esto exec format errorocurre antes de que Collabora pueda procesar correctamente la mayor parte de la configuración a nivel de aplicación. Primero, solucione la selección de la arquitectura. La resolución de problemas de red y WOPI se abordará más adelante.
Las discrepancias en la arquitectura normalmente no requieren la destrucción de datos persistentes. Limite el alcance de la solución para que la reversión sea sencilla.
Si el manifiesto incluye claramente linux/arm64esa variante y Docker la descarga, la arquitectura ya no es la explicación principal. En ese punto, captura:
docker compose psodocker ps -aA continuación, investigue los permisos, las rutas de montaje, los perfiles de seguridad, la presión de memoria, los conflictos de puertos, los certificados o la configuración de WOPI según el mensaje de registro. Evite cambiar de arquitectura repetidamente una vez que haya verificado que la imagen en ejecución es ARM64.
platformconfiguración.En un sistema ARM64 moderno, la solución preferida no suele ser la emulación. Como se verificó el 7 de octubre de 2026, las etiquetas CODE oficiales actuales de Collabora incluyen imágenes nativas ARM64. Confirme aarch64/ arm64en el host, inspeccione el manifiesto de la imagen, elimine las referencias AMD64 obsoletas o forzadas, vuelva a descargar la imagen compatible con ARM64 y verifique que el contenedor siga en ejecución. Esta secuencia facilita la resolución de problemas para principiantes y evita que cambios no relacionados con SSL, proxy o WOPI oculten una incompatibilidad básica de la plataforma.
Diagnostica errores de memoria de ONLYOFFICE Docs en un VPS, comprueba los límites del host y de Docker, revisa los registros y los documentos olvidados, añade memoria de intercambio de forma segura y reinicia sin arriesgarte a perder las ediciones activas.
Solucione los problemas de copiar y pegar de Collabora Online con aplicaciones locales probando los atajos de teclado, los permisos del portapapeles del navegador, HTTPS, las políticas de iframe y los formatos de contenido.
Solucione el problema del texto borroso en los editores de escritorio de ONLYOFFICE en Linux comprobando el escalado de la pantalla, el escalado de la interfaz de la aplicación, la disponibilidad de la fuente y el ámbito de representación en un orden seguro.
Aprende a añadir controles de formulario de Writer, configurar etiquetas y el orden de tabulación, exportar con la opción Crear formulario PDF activada y probar tu PDF interactivo antes de compartirlo.
Aprenda cómo bloquear la impresión y las descargas en las integraciones de ONLYOFFICE Workspace, DocSpace o Docs, y verifique qué controles se aplican a cada método de uso compartido.
Solucione los errores 502 del servidor de documentos ONLYOFFICE detrás de Nginx. Verifique el estado del servicio, los registros, los puertos ascendentes, los encabezados reenviados, los WebSockets y la red de Docker.
Solucione los problemas de tiempo de espera de ONLYOFFICE Documents en un servidor autohospedado comprobando la URL correcta del portal o WebDAV, el acceso a la red, HTTPS, las credenciales y el enrutamiento del servidor.
Establezca una plantilla personalizada de LibreOffice Writer como predeterminada, actualícela o restablézcala y verifique que los nuevos documentos utilicen sus estilos y diseño de página preferidos.
Solucione los problemas de exportación de PDF de ONLYOFFICE separando los problemas de conversión, descarga del navegador y servidor, y luego verifique que el PDF guardado se abra y conserve su diseño.
Solucione los fallos de inicio de Collabora CODE en ARM64 comprobando la arquitectura del host, los manifiestos de imagen, la configuración de la plataforma Docker Compose y las etiquetas nativas de ARM64.
