Ir al contenido principal

OnlyOffice

Despliegue y configuración de OnlyOffice como servicio opcional de Docker Compose.

📋 Requisitos previos​

⚠️ Para habilitar la integración de OnlyOffice, primero asegúrese de que la configuración de proxy inverso esté habilitada.

⚡ Activación​

Siga los pasos a continuación para habilitar OnlyOffice con el proxy inverso de Nginx.

Configuración de Nginx​

En ./config/nginx/nginx.conf, descomente la inclusión de OnlyOffice al final del archivo:

include onlyoffice.conf;

En ./config/nginx/docker-compose.nginx.yaml, asegúrese de que la configuración de OnlyOffice esté montada en el contenedor Nginx:

services:
  nginx:
    volumes:
      - ./onlyoffice.conf:/etc/nginx/onlyoffice.conf

Configuración de Docker Compose​

En docker-compose.yaml, elimine el comentario de los archivos de Docker Compose requeridos:

include:
  - ./config/nginx/docker-compose.nginx.yaml
  - ./config/onlyoffice/docker-compose.onlyoffice.yaml

Configuración de Sync-in​

En environment.yaml, habilite la integración de OnlyOffice:

server:
  # Opcional por ahora; será obligatorio en la próxima versión principal
  publicUrl: 'https://sync-in.domain.com'
applications:
  files:
    editors:
      onlyoffice:
        # habilitar la integración
        enabled: true
        # utilizar el mismo secreto que en docker-compose.yaml
        secret: 'REPLACE_WITH_LONG_RANDOM_ONLYOFFICE_SECRET'

Genere un valor seguro y luego asegúrese de que coincida con el definido en ./config/onlyoffice/docker-compose.onlyoffice.yaml:

services:
  onlyoffice:
    environment:
      - 'JWT_SECRET=REPLACE_WITH_LONG_RANDOM_ONLYOFFICE_SECRET'
información

Ejecute docker compose up -d && docker compose restart nginx sync_in para aplicar los cambios.

🌐 Acceso​

Sync-in y OnlyOffice se ejecutan en contenedores Docker y se comunican a través del proxy inverso Nginx.

Si configura server.publicUrl, establezca su valor en la dirección exacta utilizada para acceder a Sync-in, incluido cualquier puerto no estándar. Por ejemplo, con una asignación de puerto Nginx de 8060:80, use http://your-server:8060. Esta URL debe ser accesible desde el navegador y desde el contenedor de OnlyOffice. Si se omite, Sync-in utiliza el origen de la solicitud reenviada por Nginx como respaldo de compatibilidad. Por motivos de seguridad, server.publicUrl será obligatorio en la próxima versión principal, de modo que los endpoints del editor se creen desde un origen de confianza controlado por el administrador en lugar de desde los encabezados de las solicitudes.

advertencia

Acceder a Sync-in a través de http://localhost o http://127.0.0.1 impedirá que OnlyOffice funcione correctamente (los documentos no se mostrarán ni editarán).