Cómo conectar Collabora Online con Seafile: Opciones y pasos de configuración

Seafile puede abrir archivos de Office compatibles en Collabora Online mediante WOPI, un protocolo que permite al servidor de almacenamiento y al editor en línea intercambiar información de documentos y contenido de archivos. La implementación adecuada depende de dónde se ejecute Seafile, cómo se gestionen HTTPS y los proxies inversos, y si se desea que Collabora esté en la misma red Docker o en un servidor independiente.

Esta guía sigue las instrucciones de integración con Collabora del Manual de administración de Seafile (documentación de Seafile 14.0, revisada el 6 de octubre de 2026). Los archivos Docker Compose y las etiquetas de imagen exactos pueden cambiar, por lo que se recomienda usar los archivos correspondientes a la versión de Seafile instalada en lugar de copiar la configuración completa de Compose de un tutorial anterior.

¿Qué implementación debería elegir?

Para una nueva implementación de Docker de nodo único, comience con la configuración proporcionada por Seafile collabora.yml. Para un servidor Collabora independiente existente o un clúster, utilice la guía de instalación de Collabora y configure la URL de descubrimiento de Seafile con la dirección externa de Collabora. La guía de integración de Seafile requiere HTTPS para Seafile e indica que un nodo Collabora independiente debe usar HTTPS en el puerto estándar 443, con proxy inverso al servicio de Collabora en el puerto 9980. Consulte la guía de integración en línea de Seafile Collabora y la documentación de instalación de Collabora .

Antes de comenzar

• Confirma que tu servidor Seafile sea accesible mediante HTTPS con un certificado válido. La guía de Seafile exige explícitamente HTTPS para esta integración.
• Identifique su tipo de despliegue: Docker actual de nodo único, instalación binaria o configuración de múltiples hosts/clúster. Los nombres de los archivos de composición y el enrutamiento del proxy dependen de esa elección.
• Elija un nombre de host de Collabora, como office.example.com, si los navegadores de los usuarios accederán a Collabora de forma independiente. Asegúrese de que su certificado DNS y TLS funcionen antes de configurar Seafile.
• Si corresponde, tenga acceso de administrador a Seafile seahub_settings.pyy al archivo Docker .env. Guarde la contraseña de administrador de Collabora en un archivo de entorno protegido y no la publique en capturas de pantalla, registros ni en un repositorio público.

La documentación de Seafile describe los pasos de Docker en el mismo host para su configuración de Compose compatible. Si su proxy inverso, proyecto de Compose o red difieren, utilice los valores de ejemplo a continuación como punto de partida y verifique los nombres de los servicios y las rutas en su propia implementación.

Opción A: Agregar Collabora a una implementación de Docker de Seafile

1. Añade el archivo oficial de Collabora Compose.

Desde el directorio donde se encuentra su configuración de Seafile Compose, descargue el archivo Collabora para la versión de Seafile que utiliza. Para la ruta de Seafile 14.0 del manual actual:

wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Abra .envy agregue collabora.ymla la COMPOSE_FILElista existente. Conserve todas las entradas actuales; por ejemplo, una instalación que ya enumera los archivos del servidor Seafile, Caddy y SeaDoc agregaría el archivo Collabora en lugar de reemplazar la lista:

COMPOSE_FILE='seafile-server.yml,caddy.yml,seadoc.yml,collabora.yml'

Es posible que su lista real sea diferente. No elimine el proxy inverso actual ni otros servicios solo para que coincidan con este ejemplo. El archivo Compose establece la configuración de red y del contenedor que espera la implementación integrada de Seafile.

2. Configurar los valores del entorno de Collabora

Agregue las variables documentadas por Seafile al mismo .envarchivo. Su ejemplo actual utiliza el collabora/codenombre de imagen rotativo; los equipos que requieran actualizaciones reproducibles deben seleccionar una etiqueta de lanzamiento de Collabora compatible con su entorno y fijarla deliberadamente. Revise las notas de la versión y pruebe las actualizaciones antes de modificar un servicio de edición que funcione correctamente.

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=admin
COLLABORA_PASSWORD=replace-with-a-long-random-secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_REMOTE_FONT=
COLLABORA_ENABLE_FILE_LOGGING=false

El valor del puerto corresponde al puerto que utiliza el ejemplo de Compose de Seafile en el host; Collabora escucha en el puerto 9980 dentro del contenedor. Mantenga la consola de administración privada o restrinja el acceso en el proxy/cortafuegos. El nombre de usuario y la contraseña anteriores son ejemplos; elija credenciales únicas y proteja el archivo. Si su organización no necesita la consola de administración, siga la configuración compatible de la plantilla de Compose para deshabilitarla.

3. Configurar la conexión WOPI de Seafile

Edita seahub_settings.pyy añade la configuración de integración de Collabora. Para contenedores en la misma red Compose, el ejemplo actual de Seafile utiliza el nombre de servicio interno collabora:

OFFICE_SERVER_TYPE = 'CollaboraOffice'
ENABLE_OFFICE_WEB_APP = True
OFFICE_WEB_APP_BASE_URL = 'http://collabora:9980/hosting/discovery'
WOPI_ACCESS_TOKEN_EXPIRATION = 30 * 60
OFFICE_PREVIEW_MAX_SIZE = 30 * 1024 * 1024
ENABLE_OFFICE_WEB_APP_EDIT = True

OFFICE_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)
OFFICE_WEB_APP_EDIT_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

La URL de descubrimiento interna se utiliza para la comunicación entre Seafile y Collabora en la red compartida de Docker. Los navegadores de los usuarios también deben poder acceder a la dirección de Collabora que les proporciona la integración. Siga el archivo Compose oficial y la configuración del proxy para que la ruta visible en el navegador se publique de forma segura; un nombre de host exclusivo del contenedor que solo se resuelve dentro de Docker no es una URL pública utilizable en el navegador.

Limita las listas de extensiones de archivo a los formatos que tus usuarios necesitan y que admite tu compilación de Collabora. El tamaño de vista previa que se muestra arriba corresponde al valor de 30 MiB del ejemplo actual de Seafile; para documentos más grandes, puede ser necesario modificar el límite, teniendo en cuenta el impacto en el rendimiento y la memoria.

4. Iniciar o actualizar los servicios

Valida la configuración de Compose y, a continuación, inicia la pila desde su directorio de proyecto:

docker compose config
docker compose up -d

La guía de Seafile indica que se debe reiniciar Seafile después de realizar cambios seahub_settings.py. Con las implementaciones de Docker, docker compose up -dse aplica la configuración actualizada de Compose; si la edición de la configuración no surte efecto, reinicie el servicio de Seafile utilizando el método correspondiente a su versión. Evite un reinicio general docker compose downa menos que pretenda detener toda la pila.

Opción B: Dirigir Seafile a Collabora en otro servidor.

Instale y configure Collabora siguiendo las instrucciones oficiales de implementación y proxy inverso. Utilice HTTPS en el punto final público habitual y redirija las solicitudes al puerto interno 9980 de Collabora. Confirme que el host de Seafile pueda acceder a Collabora y que Collabora pueda acceder a la dirección HTTPS de Seafile; ambas direcciones son importantes para la carga de documentos WOPI.

Mantén las demás configuraciones de Seafile de la sección anterior, pero cambia la configuración de descubrimiento al nombre de host real de Collabora:

OFFICE_WEB_APP_BASE_URL = 'https://office.example.com/hosting/discovery'

Utilice su nombre de host y certificado reales. No incluya el nombre del servicio interno de Docker a menos que Seafile y Collabora compartan una red donde dicho nombre se resuelva. Un host independiente le brinda control independiente sobre los recursos y el mantenimiento, pero implica tareas adicionales de DNS, firewall, certificados y proxy inverso. Para un clúster de Seafile, siga el diseño de proxy y descubrimiento de servicios del clúster en lugar de asumir que se aplica la red Compose de nodo único.

Cómo confirmar que la conexión funciona

1. Si utiliza un servidor independiente, abra la aplicación https://office.example.com/hosting/discoverydesde un navegador. Para una configuración en el mismo servidor, pruebe la ruta pública de Collabora publicada por su proxy. Una respuesta exitosa confirma que el punto final de descubrimiento es accesible, aunque esto no demuestra por sí solo que la edición de WOPI funcione.
2. Inicie sesión en Seafile y abra un archivo pequeño, no confidencial .docx, .xlsxo .odtincluido en sus listas de extensiones configuradas.
3. Confirma que el archivo se abre en Collabora, realiza un cambio inofensivo, espera a que finalice el guardado y cierra el editor.
4. Vuelva a abrir el archivo en Seafile y verifique que el cambio se haya mantenido. Para una verificación más exhaustiva, descargue una copia y confirme el contenido esperado.

Prueba con un archivo que puedas modificar sin problemas. Si el editor aparece pero no se guarda correctamente, el resultado es solo parcial: WOPI debe poder recuperar el archivo y devolver la versión editada a Seafile.

Fallos comunes y qué lado revisar

Para los registros de Docker, consulte los documentos de Seafile docker logs seafile-collabora. Revise los registros de Seafile/Seahub junto con la salida de Collabora y correlacione las solicitudes en el proxy. No habilite el registro detallado o de archivos indefinidamente si expone URL de documentos u otros detalles operativos confidenciales. La guía oficial de solución de problemas de Collabora proporciona comprobaciones adicionales para fallas en Collabora.

¿Qué opción tiene sentido?

Elija el contenedor incluido si su instalación de Seafile se ejecuta en un único host Docker, desea utilizar la configuración de Compose compatible y le resulta aceptable compartir la CPU y la memoria con Seafile. Elija un host Collabora independiente si ya dispone de uno, necesita capacidad independiente o planes de actualización, o si integra una arquitectura multihost y puede mantener HTTPS y el enrutamiento de red de forma fiable. En ambos casos, siga la documentación correspondiente a su versión de Seafile, mantenga la seguridad de los puntos de acceso al navegador y verifique la apertura y el guardado de documentos antes de permitir que los usuarios utilicen la edición en línea.