Solución de problemas para ONLYOFFICE Docs en Linux

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:

Directorio de registros: /var/log/onlyoffice/documentserver/
Versión del paquete: dpkg -l | grep onlyoffice (Debian/Ubuntu) o rpm -qa | grep onlyoffice (CentOS)
Versión del sistema operativo: cat /etc/os-release

Problemas de compilación

Q:He clonado el código, pero solo encuentro carpetas vacías, no hay código fuente.

A:El repositorio incluye submódulos. Se recomienda clonar el repositorio ejecutando el siguiente comando:

git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git

En caso de que hayas clonado el repositorio usando el comando:

git clone https://github.com/ONLYOFFICE/DocumentServer.git

puedes actualizar los submódulos de la siguiente manera:

Ve al directorio DocumentServer:
```
cd DocumentServer
```
Ejecuta el siguiente comando:
```
git submodule update --init --recursive
```

Problemas de uso

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

A: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 documentserver-prepare4shutdown.sh

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

Q: 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?

A: Por favor, sigue los pasos para restablecer la caché:

Encuentra los archivos /etc/nginx/includes/ds-docservice.conf y /etc/nginx/includes/ds-spellchecker.conf. Debe haber un valor de fecha y hora de compilación. Cambia estos valores a otros (cualquier valor servirá, pero lo principal es que debe ser el mismo en todos los lugares), y reinicia NGINX:

sudo service nginx reload

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

Q:Los servicios de ONLYOFFICE Docs no se inician. ¿Qué debo hacer?

A:Verifica el estado de los servicios y revisa cualquier salida de error:

sudo systemctl status ds-docservice sudo systemctl status ds-converter

Si algún servicio se ha detenido, intenta reiniciarlo:

sudo systemctl restart ds-docservice

Las causas comunes incluyen:

Memoria insuficiente (se recomienda al menos 4 GB de RAM).
El puerto 80 ya está en uso por otra aplicación. Identifica el proceso en conflicto con sudo ss -tlnp | grep :80 y deténlo, o reconfigura ONLYOFFICE Docs para usar un puerto diferente.
Revisa los registros para obtener mensajes de error más específicos: /var/log/onlyoffice/documentserver/

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

A: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"). Para verificar tu secreto actual, lee el archivo de configuración directamente:

cat /etc/onlyoffice/documentserver/local.json

Busca el valor en services.CoAuthoring.secret.session.string. Errores comunes:

Espacios al principio o al final del valor del secreto.
Usar el secreto aleatorio por defecto en lugar de establecer uno personalizado.

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

A:Revisa el registro del convertidor para ver errores:

cat /var/log/onlyoffice/documentserver/converter/out.log

Las causas comunes incluyen espacio insuficiente en disco y fuentes faltantes.

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

A: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/.

Problemas de las ediciones Enterprise y Developer

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

A: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.

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

A: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.