Solucione el error "Host WOPI no autorizado" en Collabora Online CODE

La solución más rápida y fiable consiste en configurar Collabora Online CODE para que confíe en el nombre de host y el puerto exactos que aparecen en la URL de origen WOPI enviada por su plataforma de almacenamiento. Para un único servidor Nextcloud, configure la lista de hosts permitidos de CODE con ese nombre de host de Nextcloud, recree el contenedor y vuelva a probar. Si utiliza varias instancias de Nextcloud, habilite explícitamente el acceso a cada una. No solucione el error abriendo el acceso WOPI a todos los hosts.

El mensaje "Host WOPI no autorizado" generalmente significa que Collabora rechazó el host de almacenamiento especificado en la solicitud WOPI. Esto no prueba, por sí solo, que la contraseña del usuario, los permisos de los documentos, el certificado TLS o el proxy inverso sean incorrectos. Estos componentes pueden causar otros fallos de conexión, por lo que se recomienda consultar los registros de Collabora para confirmar la causa específica antes de modificar la configuración.

Elige el cambio que se ajuste a tu implementación.

Los ejemplos a continuación asumen Nextcloud en https://cloud.example.comy Collabora en https://office.example.com. Reemplace ambos nombres y el puerto con los valores utilizados en su instalación. La guía de configuración de Docker de Nextcloud utiliza aliasgroup1para un único host de almacenamiento y describe cómo agregar otro grupo de alias para un segundo host de Nextcloud. La configuración WOPI de Collabora define la coincidencia de host en torno al nombre de host y el puerto; los alias son para nombres alternativos del mismo host de almacenamiento.

1. Confirma qué host rechazó Collabora

Comience con los registros del contenedor CODE. En una implementación de Docker Compose, ejecute:

docker compose logs --since=10m collabora

Reemplaza collaboracon el nombre del servicio en tu archivo Compose. Con Docker estándar, usa docker logs --since 10m CONTAINER_NAME. Busca cerca del intento fallido de apertura del documento un mensaje como No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. El nombre de host entre corchetes es la clave: agrega el host de almacenamiento que se muestra allí, no el nombre de host público del servidor Collabora.

Registre también el host y el puerto en la URL de WOPI, si aparecen en el registro. Compárelos con la entrada configurada. Una solicitud a cloud.example.com:443puede no coincidir con una entrada para un nombre de contenedor interno como nextcloud, incluso si ambos nombres se resuelven a la misma máquina. Los proxies inversos, el DNS de horizonte dividido y las múltiples URL públicas pueden hacer que esta discrepancia pase desapercibida.

Si los registros muestran un error diferente, como un fallo en la búsqueda de DNS, una conexión rechazada o un error de certificado, solucione ese problema en lugar de ampliar la lista de hosts de WOPI.

2. Actualizar la configuración del host WOPI de confianza de CODE.

Para una instalación de Docker Compose que da servicio a un host de Nextcloud, la parte relevante del servicio puede tener este aspecto:

services:
  collabora:
    image: collabora/code
    environment:
      - aliasgroup1=https://cloud.example.com:443

Conserva el resto de tus opciones de servicio, secretos, volúmenes, puertos y configuraciones de proxy inverso existentes. El ejemplo muestra solo la entrada de la lista de permitidos; no es un archivo Compose de producción completo. Usa el estilo de configuración compatible con la versión de CODE que utilizas y verifica la configuración renderizada o de inicio después de modificarla. Las imágenes de contenedor y las interfaces de configuración pueden cambiar con el tiempo.

Para un único host, una entrada de host exacta es más fácil de auditar que una expresión regular amplia. Si su instalación utiliza la domainvariable de entorno, verifique las reglas de escape documentadas para su imagen y asegúrese de que la expresión coincida únicamente con el nombre de host de almacenamiento previsto. No copie un comodín sin escape ni un patrón de dominio principal que coincida con subdominios no relacionados.

Para más de una instancia de Nextcloud, añade un grupo explícito independiente para cada host mediante el mecanismo compatible con tu versión de CODE. Por ejemplo, la guía de integración de Docker de Nextcloud muestra una aliasgroup2entrada adicional para un segundo nombre de host en la nube. Añade alias solo cuando se acceda a un servidor Nextcloud con varios nombres, como un nombre interno y uno público. Guarda una lista escrita de estos nombres para poder eliminar un nombre de host antiguo tras una migración.

3. Recrea el contenedor y comprueba la lista de permitidos independiente de Nextcloud.

Tras editar el archivo Compose, vuelva a crear el servicio para que se aplique el nuevo entorno:

docker compose up -d --force-recreate collabora

Utilice el nombre de servicio correcto. A continuación, compruebe que el contenedor se inicia correctamente y que el host esperado aparece en su configuración de inicio o en los registros. Evite adjuntar volcados completos del entorno a las solicitudes de soporte, ya que podrían exponer contraseñas u otra información confidencial.

Nextcloud cuenta con una configuración independiente llamada "Lista de permitidos para solicitudes WOPI" en la configuración de administración de Office. Esta lista restringe las direcciones IP que pueden realizar solicitudes WOPI a Nextcloud; Collabora recomienda limitarla a las direcciones de servidor de Collabora esperadas. Si Nextcloud muestra esta advertencia, agregue la dirección que Nextcloud realmente ve para la solicitud, que puede variar cuando interviene un proxy o una red de contenedores. Mantenga esta verificación separada de la entrada de host de CODE: CODE confía en los nombres de host de almacenamiento, mientras que la lista de permitidos de Nextcloud se refiere a la IP del servidor solicitante.

Si utiliza un proxy inverso, confirme que el nombre de host que Nextcloud publica en los enlaces de WOPI sea el mismo que CODE tiene configurado para confiar. Verifique la URL del servidor Nextcloud Office y la configuración de host público del proxy inverso. No agregue el nombre de host de Office a la lista de hosts permitidos de almacenamiento de WOPI a menos que sea realmente el host de almacenamiento en la URL de WOPI.

4. Verificar la conexión completa

Primero, compruebe los puntos de acceso del servicio Collabora desde un navegador y desde el servidor Nextcloud. Reemplace el nombre de host de ejemplo con la URL de su Office:

curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discovery

Estas comprobaciones establecen que los puntos finales responden; no prueban que se autorizará una solicitud de documento WOPI. A continuación, verifique que CODE pueda acceder a Nextcloud utilizando el mismo host que Nextcloud publica, por ejemplo:

curl -fsS https://cloud.example.com/status.php

Finalmente, abre un documento de prueba y observa los registros de CODE y Nextcloud simultáneamente. Si el resultado es correcto, el editor se carga, el mensaje específico "No se encontraron hosts WOPI aceptables" desaparece y se guarda un pequeño cambio sin problemas. Realiza la prueba desde una cuenta de usuario normal con los mismos permisos de edición y uso compartido que el usuario afectado.

Comparación de las principales opciones

Un host exacto frente a una expresión regular

Un nombre de host exacto con el puerto deseado suele ser la mejor opción para una implementación en una sola nube: facilita la revisión y limita las coincidencias accidentales. Una expresión regular puede ser útil cuando un conjunto de nombres de host gestionados deliberadamente comparte un patrón, pero es más difícil de auditar y puede autorizar subdominios no deseados si se escribe de forma demasiado general. Utilice la expresión más específica que satisfaga una necesidad verificada.

Una instancia de CODE frente a instancias separadas

Un servicio CODE compartido reduce la cantidad de servicios que mantener, y los grupos explícitos pueden admitir varias instancias de Nextcloud. Las instancias CODE separadas pueden ser útiles cuando los equipos necesitan un mayor aislamiento de la configuración o ventanas de mantenimiento independientes. La desventaja es una mayor infraestructura que parchear, monitorear y enrutar. Ninguna de las opciones corrige automáticamente un nombre de host WOPI incorrecto; cada instancia debe confiar en el host de almacenamiento correcto.

Configuración del entorno del contenedor frente a la edición de XML

Para un despliegue de Docker CODE, utilice la interfaz de configuración compatible con la imagen y guárdela en Compose u otra fuente de información de despliegue. Esto permite repetir los cambios al recrear el contenedor. La edición coolwsd.xmldirecta puede ser útil para un paquete gestionado o un despliegue personalizado, pero editar un archivo generado dentro de un contenedor en ejecución es delicado y puede desaparecer al reemplazarlo o actualizarlo. Siga las instrucciones específicas del paquete, gráfico de Helm o imagen que utilice.

Errores comunes que se deben evitar

• Permitir office.example.comcuando el host de almacenamiento WOPI rechazado es cloud.example.com.
• Introducir un nombre de contenedor privado cuando la URL de WOPI contiene un nombre DNS público, o viceversa.
• Suponiendo que una lista de direcciones IP permitidas de Nextcloud WOPI en blanco y la configuración de host de CODE sean el mismo control.
• Agregar un comodín amplio o deshabilitar la validación del host solo para que el editor se cargue.
• Modificar simultáneamente las reglas de proxy, TLS y WOPI dificulta el diagnóstico del problema.
• Probar únicamente el punto final de descubrimiento y tratarlo como prueba de que la autorización de documentos funciona.

Cuándo utilizar una solución diferente

Si el host rechazado cambia entre solicitudes, inspeccione la URL canónica de Nextcloud, los encabezados del proxy de confianza y cualquier raíz web alternativa antes de agregar más nombres. Si todos los nombres de host coinciden pero el error persiste, compare la configuración activa de CODE con el archivo o la configuración del entorno que editó y confirme que el contenedor se recreó. Para Kubernetes o Helm, edite los valores del gráfico o la fuente de configuración administrada en lugar de un pod en ejecución. Si los registros muestran errores de certificado, firewall, WebSocket o DNS, solucione el problema de esa capa utilizando los registros del servidor y las comprobaciones de red correspondientes.

Estos pasos se basan en el Manual de administración de Nextcloud 35, disponible el 6 de octubre de 2026, y en el esquema de configuración WOPI publicado por Collabora. Las claves de configuración específicas pueden variar según el método de implementación y la versión de la imagen, por lo que conviene verificarlas con la documentación de la versión instalada antes de aplicar cualquier cambio.

Referencias oficiales

• Solución de problemas y comprobaciones de conectividad de Nextcloud Office
• Ejemplo de Docker de Nextcloud para Collabora, incluyendo la configuración del host WOPI.
• Guía de configuración de Nextcloud Office y de la lista de direcciones IP permitidas de WOPI.
• Esquema de configuración coolwsd.xml publicado por Collabora Online
• Documentación sobre la configuración del proxy de Collabora Online