Saltar al contenido principal

Solución de problemas para ONLYOFFICE Docs en Docker

Antes de contactar con soporte: recopilación de información de diagnóstico​

Si experimentas un problema que no está cubierto a continuación, reúne la siguiente información antes de contactar con el soporte de ONLYOFFICE:

  • Registros del contenedor:

    sudo docker logs <CONTAINER_ID>

  • Versión del contenedor:

    sudo docker inspect --format='{{.Config.Image}}' <CONTAINER_ID>

  • Lista de volúmenes montados:

    sudo docker inspect --format='{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' <CONTAINER_ID>

  • Sistema operativo del host y versión de Docker:

    uname -a && docker --version

Instalación y requisitos del sistema​

P: Quiero instalar el servidor basado en Docker en mi servidor local. ¿Cómo puedo hacerlo?

R: El servidor de oficina en línea basado en Docker más reciente está disponible en Docker hub. Selecciona ONLYOFFICE Docs y sigue las instrucciones de instalación.

P: ¿Qué sistema necesito para instalar la solución de servidor y usarla correctamente?

R: Los requisitos del sistema son:

  • CPU: doble núcleo 2 GHz o mejor
  • RAM: 4 GB o más
  • HDD: al menos 20 GB de espacio libre
  • SWAP: al menos 4 GB, pero depende del sistema operativo del host. Más es mejor
  • OS: amd64/arm64 cualquier versión soportada por el equipo de Docker

Red y DNS​

P: He instalado una de las versiones del servidor usando el servicio Docker, pero tengo algunos problemas relacionados con el servidor DNS o la resolución de nombres propia. ¿Qué puede estar mal?

R: Docker especifica los servidores DNS de Google de forma predeterminada, y el servidor intenta contactarlos cada vez que realiza solicitudes de red. Si tu ONLYOFFICE Docs no va a tener acceso a Internet, te recomendamos cambiar la dirección DNS predeterminada de Docker por la dirección de tu servidor DNS local. Para ello, ve al archivo /etc/default/docker y cambia la dirección IP en la siguiente línea por la dirección IP de un servidor DNS de tu red local:

docker_OPTS="--dns 8.8.8.8"

Para los sistemas operativos basados en RPM como CentOS, el archivo de configuración puede encontrarse aquí: /etc/docker/daemon.json

P: Los editores de documentos se abren y aparece la interfaz, pero el documento en sí no se carga y muestra continuamente el progreso de carga. ¿Qué puedo hacer?

R: El motivo puede ser que el equipo debe poder dirigirse a sí mismo mediante el acceso de bucle invertido (loopback) de Internet, es decir, debe ser accesible desde fuera para sí mismo. Para habilitarlo, edita iptables para tener las redirecciones de la siguiente manera:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>

No olvides sustituir las direcciones public_ip y local_ip por las direcciones IP reales.

Autenticación y seguridad​

P: La autenticación JWT falla después de integrar ONLYOFFICE Docs con mi plataforma. ¿Cómo lo soluciono?

R: Verifica que el secreto JWT configurado en ONLYOFFICE Docs coincida exactamente con el secreto configurado en la configuración del conector de tu plataforma. También verifica que el nombre del encabezado JWT coincida (por defecto es "Authorization"). Errores comunes:

  • Espacios al principio o al final del valor del secreto.

  • Usar el secreto aleatorio predeterminado en lugar de establecer uno personalizado. Verifica tu secreto con:

    sudo docker exec <CONTAINER_ID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json services.CoAuthoring.secret.session.string

Rendimiento y uso de recursos​

P: ONLYOFFICE Docs usa mucha memoria. ¿Es esto normal?

R: El uso de memoria escala con el número de documentos abiertos y usuarios concurrentes. Para un servidor con unas pocas docenas de usuarios activos, un uso de 2–4 GB de RAM es normal. Si el uso de memoria es inesperadamente alto, verifica si hay documentos atascados u olvidados en /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

P: El contenedor se reinicia continuamente. ¿Qué debo hacer?

R: Revisa los registros del contenedor para ver el error concreto:

sudo docker logs <CONTAINER_ID>

Las causas comunes incluyen:

  • Memoria insuficiente (el contenedor requiere al menos 4 GB de RAM).
  • El puerto 80 ya está en uso por otra aplicación. Detén la otra aplicación o cambia el puerto de ONLYOFFICE Docs.
  • Fallo en la inicialización de la base de datos. Si utilizas una base de datos externa, verifica que los parámetros de conexión sean correctos.

Manejo de documentos​

P: La conversión de documentos falla (por ejemplo, al abrir archivos DOC, XLS o PPT aparece un error). ¿Qué puedo hacer?

R: Revisa el registro del convertidor para ver errores ejecutando el siguiente comando:

sudo docker exec <CONTAINER_ID> cat /var/log/onlyoffice/documentserver/converter/out.log

Las causas comunes incluyen espacio en disco insuficiente y fuentes que faltan.

P: Se ha producido una pérdida de datos al detener ONLYOFFICE Docs. ¿Cómo prevenir la pérdida de datos?

R: Debido a la característica operativa, ONLYOFFICE Docs guarda un documento solo después de que todos los usuarios que lo editaron lo hayan cerrado. Para evitar la pérdida de datos, debes desconectar forzosamente a los usuarios de ONLYOFFICE Docs cuando necesites detener ONLYOFFICE Docs en casos de actualización de la aplicación, reinicio del servidor, etc. Para hacerlo, ejecuta el siguiente script en el servidor donde está instalado ONLYOFFICE Docs:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh
nota

La ejecución del script puede tardar mucho tiempo (hasta 5 minutos), ya que espera a que todos los usuarios se desconecten.

Caché y personalización​

P: He añadido un tema de interfaz personalizado o actualizado mis archivos de idioma del editor (corregido algunas traducciones) pero el servidor sigue mostrando los valores anteriores en lugar de los correctos. ¿Cómo puedo restablecer la caché para todos los usuarios al mismo tiempo?

R: Borra la caché forzosamente ejecutando el siguiente comando:

sudo docker exec <CONTAINER_ID> documentserver-flush-cache.sh

La caché debería restablecerse para todos los usuarios del servidor.

nota

Ten en cuenta que, para la instalación en Docker, todas las acciones deben realizarse dentro del contenedor.

Problemas de Enterprise Edition y Developer Edition​

P: Veo una advertencia de "Licencia expirada". ¿Qué debo hacer?

R: Tu archivo license.lic ha expirado. Contacta con sales@onlyoffice.com para renovar tu licencia. Después de recibir el nuevo archivo, reemplaza el archivo license.lic antiguo en el directorio de datos y reinicia ONLYOFFICE Docs.

P: No puedo acceder al Panel de Administración. ¿Qué debo hacer?

R: Si aún no has configurado el Panel de Administración, sigue la guía de configuración del Panel de Administración. Si has olvidado tu contraseña de administrador, elimina la entrada passwordHash de runtime.json y reinicia — se generará un nuevo código de arranque.