Evite que el servidor de documentos ONLYOFFICE se quede sin memoria VPS.

Si ONLYOFFICE Document Server falla o se reinicia debido a que su VPS se queda sin memoria, primero confirme que se trata de un error de memoria insuficiente y verifique si el límite de memoria de Docker es insuficiente. Luego, asigne suficiente RAM física para la carga de trabajo y agregue memoria de intercambio únicamente como medida de seguridad; reiniciar repetidamente el editor no solucionará una escasez de capacidad persistente.

1. Demuestre que la presión de memoria está causando el fallo.

Comience en el VPS Linux, no en la configuración de integración de ONLYOFFICE. Un mensaje del navegador como "No se puede cargar el documento" también puede deberse a problemas de red o autenticación, por lo que es importante determinar si el mecanismo de eliminación de procesos por falta de memoria (OOM) de Linux realmente finalizó un proceso.

Ejecute estos comandos a través de SSH. Reemplace onlyoffice-document-servercon el nombre del contenedor que se muestra a continuación docker ps -a:

free -h
docker ps -a
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}} {{.State.ExitCode}} {{.HostConfig.Memory}} {{.HostConfig.MemorySwap}}' onlyoffice-document-server

free -hMuestra la RAM y el swap disponibles del host. docker statsMide un contenedor en ejecución, mientras que el comando `inspect` informa el estado de OOM-killed del contenedor, el último código de salida y los límites de recursos configurados en bytes. Un HostConfig.Memoryvalor distinto de cero indica un límite de memoria explícito. La estadística de memoria de Docker puede excluir ciertas cachés de archivos, por lo que debe compararse con las mediciones del host en lugar de tratarse como una imagen completa. Consulte la referencia de estadísticas de Docker .

Si el contenedor se ha detenido, docker statsno podrá mostrar su pico anterior. En su lugar, revise el registro del kernel y los mensajes recientes de la aplicación:

sudo journalctl -k --since "-2 hours" | grep -Ei 'out of memory|killed process|oom'
docker logs --tail 100 onlyoffice-document-server

Los mensajes del kernel que mencionan "Memoria insuficiente" o "Proceso eliminado" ayudan a identificar el proceso involucrado. OOMKilled=trueEsto constituye una fuerte evidencia de un evento de memoria insuficiente en el contenedor, pero falseno descarta que el kernel del host elimine un proceso hijo mientras el contenedor permanece activo. Del mismo modo, el código de salida 137 solo establece una terminación SIGKILL, no su causa. Si no hay evidencia de memoria insuficiente, investigue los registros y los fallos de conexión antes de adquirir más RAM.

2. Asigne suficiente RAM al VPS antes de ajustar cualquier otra cosa.

A partir de octubre de 2026, el archivo README oficial de ONLYOFFICE para Docker Document Server recomienda 4 GB o más de RAM y al menos 2 GB de espacio de intercambio (swap). La documentación oficial del instalador con un solo clic, por separado , recomienda 4 GB de RAM para entornos de prueba de Docker, 8 GB o más para producción y especifica al menos 4 GB de espacio de intercambio en sus requisitos de instalación. Estos documentos describen diferentes contextos de implementación, por lo que no interprete los 4 GB como una garantía de rendimiento fiable en producción.

Si tu VPS solo tiene 1-2 GB de RAM, actualizar su plan es la solución más recomendable para una instalación basada en Docker. Si ya tiene 4 GB, comprueba cuánto consumen el sistema operativo, la base de datos, el proxy inverso, Nextcloud y otros contenedores. Un servidor que parece funcionar correctamente en reposo puede quedarse sin memoria cuando varias personas abren documentos o convierten hojas de cálculo grandes simultáneamente.

En un servidor con mucha carga, utilice esta herramienta ps aux --sort=-rss | headpara identificar los procesos que consumen mucha memoria y repita el proceso docker statsdurante una sesión de edición representativa. Reserve capacidad para el resto del equipo en lugar de asignar toda la RAM disponible a ONLYOFFICE. Si la demanda sostenida supera la capacidad del servidor, traslade los servicios que compiten con él o actualice el VPS; un ajuste a nivel de aplicación no puede solucionar la falta de memoria física.

Compruebe si hay un límite de memoria de Docker accidental

Los contenedores Docker no tienen un límite de memoria estricto por defecto, pero un despliegue puede establecer uno con --memoryo Compose mem_limit. Por ejemplo, un límite de contenedor de 2 GB puede provocar errores de memoria insuficiente (OOM kills) incluso cuando un host de 8 GB tiene RAM libre. Inspeccione el límite real antes de cambiarlo. Si el límite es innecesariamente bajo, ajuste la ejecución original de Docker o la configuración de Compose a un valor justificado por las mediciones y la capacidad restante del host. Consulte la documentación de Docker sobre restricciones de recursos y la especificación del servicio Compose .

No asigne memoria ilimitada a ciegas en un VPS compartido: esto puede exponer otros servicios a errores de memoria insuficiente (OOM) en todo el host. Consulte también --memory-swapla configuración de Docker Compose memswap_limit; Docker tiene en cuenta la RAM y el swap combinados en dicha configuración. Los límites iguales de RAM y combinados desactivan efectivamente el swap para el contenedor. Si administra ONLYOFFICE con Compose, realice el cambio en su archivo Compose para que la configuración se mantenga tras la recreación del contenedor.

3. Agregue un búfer de intercambio si el VPS no tiene ninguno.

El archivo de intercambio puede absorber un pico temporal de memoria, pero se almacena en el disco y es mucho más lento que la RAM. Verifique swapon --showprimero df -h /. El siguiente ejemplo agrega un archivo de intercambio de 2 GiB a un VPS usando un sistema de archivos local compatible como ext4, cuando /swapfileaún no existe y el proveedor permite el intercambio:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
swapon --show
free -h

Solo haga que el nuevo archivo de intercambio sea persistente después de swaponque tenga éxito. Compruebe si existe una entrada con grep -F '/swapfile' /etc/fstab; si no existe ninguna, agréguela una sola vez:

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

La creación de archivos de intercambio en Btrfs, sistemas de archivos de red y otras configuraciones requiere un manejo diferente. No ejecute estos comandos sobre un archivo de intercambio existente ni asuma fallocateque funcionan en todas partes. El manual de swapon de Linux explica las restricciones del sistema de archivos. Si el VPS utiliza el intercambio de memoria con frecuencia durante la edición normal, priorice una mayor cantidad de RAM en lugar de un archivo de intercambio más grande.

4. Vuelva a comprobar el servidor bajo una carga de trabajo de edición realista.

Cambiar un plan VPS o habilitar el intercambio de memoria no suele requerir ninguna modificación en la configuración de ONLYOFFICE. Si modificó algún ajuste de la implementación de Docker, programe el mantenimiento y conserve los puntos de montaje, secretos, rutas de certificados y ajustes de integración existentes al aplicarlo. El archivo README de ONLYOFFICE Docker documenta documentserver-prepare4shutdown.shlos apagados programados y advierte que la desconexión de los editores puede tardar varios minutos. No recree ni reinicie un servidor de documentos en uso, ya que los cambios no guardados podrían verse afectados.

Cuando el servicio esté listo, verifique que el contenedor esté en funcionamiento e inspeccione su memoria nuevamente:

docker ps --filter name=onlyoffice-document-server
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}}' onlyoffice-document-server
docker exec onlyoffice-document-server curl -fsS http://localhost:8000/info/info.json

La última comprobación utiliza el punto final de información interna que se muestra en la comprobación de estado oficial de ONLYOFFICE Docker Compose ; ejecútela dentro del contenedor, ya que es posible que el puerto 8000 no esté publicado en el VPS. La respuesta del punto final indica la disponibilidad del servicio, no necesariamente que todas las integraciones de almacenamiento o las funciones de guardado funcionen correctamente.

Verifica que el problema de memoria esté resuelto.

Vuelva a abrir un documento pequeño y luego un documento grande representativo a través de su Nextcloud, ownCloud u otra integración. Guarde una edición inofensiva y confirme que aparece después de volver a abrir el archivo. Siga monitoreando free -hlos docker statsregistros OOM del kernel durante el período de uso que provocó fallas anteriormente.

Una solución exitosa implica que los documentos normales se siguen abriendo y guardando, el uso de memoria se mantiene dentro de los límites del VPS y del contenedor, y no aparecen nuevos errores de memoria insuficiente (OOM). Si los fallos cesan solo cuando la actividad es baja, el VPS aún no tiene suficiente capacidad para el uso máximo; ajuste la RAM para ese pico en lugar de depender del intercambio continuo. Si la RAM permanece disponible y no aparecen nuevos mensajes de OOM, pero los documentos siguen fallando, revise los registros de ONLYOFFICE, el proxy inverso o el conector de almacenamiento en lugar de realizar más cambios en la memoria.