Conecte Seafile y Collabora con la URL WOPI correcta.

Para conectar Seafile con Collabora Online, habilite HTTPS en Seafile, implemente Collabora y configure la integración de Seafile con Office para que apunte al punto final de descubrimiento de Collabora. Si ambos servicios se ejecutan en la misma red Docker, la guía de integración actual de Seafile utiliza la URL interna http://collabora:9980/hosting/discovery; si Collabora se ejecuta en un host independiente, utilice su URL HTTPS pública.

El manual de administración actual de Seafile documenta una collabora.ymlintegración y configuración específicas para Compose seahub_settings.py. Los archivos de implementación exactos pueden variar según la versión de Seafile, por lo que al adaptar estos ejemplos, utilice el manual correspondiente a su versión instalada.

Antes de empezar

• Utilice una dirección HTTPS de Seafile con un certificado TLS válido. Seafile indica que HTTPS es un requisito para la integración con Collabora.
• Averigüe si Collabora se ejecutará como otro contenedor en el mismo host de Docker o como un servicio alojado por separado.
• Tener acceso de administrador al directorio de implementación de Seafile y seahub_settings.py.
• Seleccione qué formatos de documento desea permitir para la vista previa y la edición. La configuración de Seafile controla estas listas de extensiones.

Seafile y Collabora se comunican mediante WOPI. Seafile proporciona la información de acceso al documento y Collabora solicita el archivo a Seafile. La URL de descubrimiento le indica a Seafile qué servicio de Collabora debe usar y qué funcionalidades de edición ofrece.

1. Confirma HTTPS en Seafile

Abra Seafile en un navegador y confirme que su dirección normal comienza con https://y que su certificado es válido. Para la implementación de Seafile en Docker, su manual actual muestra la configuración SEAFILE_SERVER_PROTOCOL=httpsen el .envarchivo y luego completando la configuración HTTPS a través del proxy inverso configurado. No continúe con un punto final de Seafile público con HTTP simple.

# In the Seafile deployment .env file
SEAFILE_SERVER_PROTOCOL=https

Mantenga el certificado y la clave privada bajo el control de su proxy TLS o administrador de certificados. Esta configuración por sí sola no emite un certificado ni configura un proxy inverso; complete los pasos HTTPS para su implementación antes de habilitar la edición de Office en línea.

2. Agregue Collabora al despliegue de Docker de Seafile.

Para la configuración documentada de Docker en el mismo host, utilice el archivo Collabora Compose proporcionado por Seafile en lugar de crear una definición de contenedor independiente. En el directorio de implementación de Seafile, descargue el archivo de la versión manual correspondiente y agréguelo collabora.ymla la lista existente COMPOSE_FILEen .env. Conserve los archivos Compose que ya utiliza su instalación.

# Example for a Seafile 14.0 deployment
wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Establezca las variables de Collabora documentadas por Seafile en .env:

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=your_admin_username
COLLABORA_PASSWORD=use_a_long_unique_secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_ENABLE_FILE_LOGGING=false

Utilice una contraseña segura y única, y restrinja el acceso al .envarchivo, ya que contiene credenciales. El puerto de ejemplo es el puerto expuesto en la configuración de integración de Seafile; no asuma que es el puerto público de su proxy inverso. Siga las instrucciones collabora.ymldel archivo correspondiente y la configuración del proxy para su versión.

Una vez que el servicio se haya agregado al despliegue, inicie o actualice la pila de Compose siguiendo su procedimiento habitual de Seafile. Evite publicar el puerto interno de Collabora directamente en internet a menos que su diseño lo requiera explícitamente y haya protegido el punto final.

3. Apunta Seafile a la URL de descubrimiento de Collabora.

Edite el seahub_settings.pyarchivo activo y agregue la configuración de integración. Para la configuración de Compose en el mismo host, el manual de Seafile utiliza el nombre del servicio y el puerto interno de 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_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

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

La http://URL que se muestra aquí es la dirección interna de servicio a servicio en la red Docker documentada de Seafile. El sitio web de Seafile accesible desde el navegador aún requiere HTTPS. No copie esta dirección interna en una implementación de host independiente.

Para Collabora en un host diferente, configure Collabora detrás de HTTPS en el puerto público estándar, con el proxy inverso reenviando las solicitudes al puerto de escucha de Collabora. Establezca la URL base con su nombre de host público real, por ejemplo:

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

Asegúrese de que el nombre de host en la URL se resuelva correctamente y presente un certificado válido de los clientes que necesitan abrir los documentos. Configure también la lista de permisos WOPI de Collabora para que acepte el host del servidor Seafile. La documentación oficial de Docker de Collabora describe la aliasgroupvariable de entorno para declarar el host WOPI permitido; asegúrese de que coincida exactamente con el host y el esquema utilizados por Seafile, y evite el acceso con comodines amplios en un servidor de producción.

4. Reinicie y pruebe la conexión.

Reinicia Seafile para que Seahub cargue la nueva configuración de Python. Sigue el procedimiento de reinicio correspondiente a tu paquete, pila de Compose o configuración de Kubernetes; los nombres de los servicios y los comandos varían según la implementación. Si agregaste un nuevo archivo Compose, confirma que el contenedor de Collabora esté en ejecución antes de probar el flujo de trabajo del navegador.

Abra un documento de Office compatible desde la interfaz web de Seafile. El archivo debería abrirse en el editor de Collabora, mostrar su contenido y guardar un pequeño cambio de prueba en Seafile. Que el documento se abra correctamente es más útil que comprobar solo la página de detección, ya que permite probar el navegador, Seafile, Collabora y la transferencia de archivos WOPI.

Solucione los problemas comprobando cada conexión.

• Seahub informa un error de detección: Confirme OFFICE_WEB_APP_BASE_URLque se puede acceder desde el servicio Seafile. Use el nombre del servicio interno de Docker solo cuando ambos contenedores compartan esa red.
• El editor se carga pero no puede acceder al archivo: revise los registros de Collabora y Seafile. Confirme que Collabora permite el acceso al host WOPI de Seafile y que el certificado HTTPS de Seafile es de confianza.
• Funciona en el mismo host, pero no de forma remota: Reemplace la URL interna con la URL pública de descubrimiento HTTPS, confirme DNS y TLS, y verifique que el proxy reenvíe las solicitudes de Collabora al puerto 9980.
• Solo se abren algunos formatos: Revisión OFFICE_WEB_APP_FILE_EXTENSIONy OFFICE_WEB_APP_EDIT_FILE_EXTENSION. Mantenga estas listas limitadas a los formatos que sus usuarios necesitan y que su implementación de Collabora admite.
• La configuración parece no haber cambiado después del reinicio:seahub_settings.py Confirme que ha editado el servicio Seafile activo y lo ha reiniciado correctamente.

Para un nodo Collabora independiente, Seafile dirige específicamente a los administradores a la documentación de implementación de Collabora en lugar de usar el archivo incluido collabora.yml. El archivo incluido está diseñado para la misma configuración de host/red de Docker descrita anteriormente.

Referencias oficiales

• Manual de administración de Seafile: Integración en línea con Collabora
• Archivo de redacción Seafile 14.0 Collabora
• Documentación de la imagen Docker de Collabora CODE