Saltar al contenido principal

Instalación del ONLYOFFICE Docs Community Edition para Linux en Debian, Ubuntu y derivados

Introducción​

Community Edition te permite instalar ONLYOFFICE Docs en tu servidor local e integrar los editores en línea con la plataforma de colaboración de ONLYOFFICE o con otros sistemas populares (consulta la lista detallada de funciones). Esta guía te mostrará cómo instalar la versión de ONLYOFFICE Docs Community Edition para Linux en tu máquina.

Requisitos del sistema​

  • Procesador: doble núcleo de 2 GHz o superior
  • RAM: al menos 2 GB, pero depende del sistema operativo host. Cuanto más, mejor
  • HDD: al menos 40 GB de espacio libre
  • SWAP: al menos 4 GB, pero depende del sistema operativo host. Cuanto más, mejor
  • Sistema Operativo: Debian 12, Ubuntu 18.04 de 64 bits u otra distribución compatible
  • Requisitos adicionales
    • NGINX: versión 1.30 o posterior

Instalación del ONLYOFFICE Docs​

La instalación en las distribuciones basadas en Debian también requiere tener NGINX instalado.

Todas las instrucciones necesarias para la instalación de estos componentes y sus dependencias pueden encontrarse en sus sitios web oficiales.

Existen otras dependencias que se instalan junto con ONLYOFFICE Docs:

  • libcurl3
  • libxml2
  • fonts-dejavu
  • fonts-liberation
  • ttf-mscorefonts-installer
  • fonts-crosextra-carlito
  • fonts-takao-gothic
  • fonts-opensymbol

Estas dependencias se instalan automáticamente si usas Ubuntu 18.04 LTS o posterior. Las distribuciones anteriores pueden requerir la instalación manual.

Instalación de dependencias​

ONLYOFFICE Docs usa NGINX como base de datos. Las dependencias encontradas en el repositorio del sistema se instalarán automáticamente al instalar ONLYOFFICE Docs usando el comando apt-get install.

Instalación de NGINX​

sudo apt-get install nginx
nota

En Ubuntu 18.04, instala el paquete nginx-extras en su lugar: sudo apt-get install nginx-extras

Importante

Si planeas ejecutar ONLYOFFICE Docs en el puerto 80, desactiva ahora el sitio web predeterminado de NGINX. De lo contrario, ONLYOFFICE Docs puede no funcionar correctamente. Para ello, ejecuta los siguientes comandos:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

Según cómo se haya instalado NGINX, uno de los dos primeros comandos puede indicar que el archivo no existe. Puedes ignorar este mensaje sin problema.

Cambio del puerto predeterminado para el ONLYOFFICE Docs​

De forma predeterminada, ONLYOFFICE Docs escucha las conexiones entrantes usando el puerto 8083. A partir de la versión 4.3 puedes cambiar el puerto para ONLYOFFICE Docs si planeas usar otro en vez del predeterminado.

nota

Si planeas cambiar el puerto predeterminado, asegúrate de que está abierto a las conexiones entrantes/salientes. Consulta la lista completa de los puertos usados por ONLYOFFICE Docs.

Para hacerlo, necesitarás cambiar el puerto predeterminado para el sistema debconf ejecutando el comando:

echo onlyoffice-documentserver onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

Por favor, escribe el número de puerto en vez de <PORT_NUMBER> en el comando de arriba.

nota

Si estableces el puerto 80, asegúrate de haber desactivado el sitio web predeterminado de NGINX como se describe en la sección Instalación de NGINX.

Aviso

Si deseas cambiar el protocolo de ONLYOFFICE Docs a HTTPS, no cambies el puerto a 443, sino usa esta instrucción.

Existen opciones adicionales que pueden usarse para instalar ONLYOFFICE Docs. Por favor, consulta esta sección para obtener más información.

Después de eso, puedes seguir instalando ONLYOFFICE Docs.

Guía de instalación de ONLYOFFICE Docs​

Añade la clave GPG:

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

Añade el repositorio de ONLYOFFICE Docs:

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list
nota

Aunque el paquete APT está construido para Debian Squeeze, es compatible con varios derivados de Debian (incluido Ubuntu), lo que significa que puedes usar el mismo repositorio para todas estas distribuciones.

Al instalar ONLYOFFICE Docs en Debian, añade el componente contrib a /etc/apt/sources.list. Para obtener más información, puedes consultar la documentación de Debian.

Actualiza la caché del administrador de paquetes:

sudo apt-get update

Instala mscorefonts:

sudo apt-get install ttf-mscorefonts-installer

Instala ONLYOFFICE Docs:

sudo apt-get install onlyoffice-documentserver

Después de eso, ONLYOFFICE Docs se ejecutará como un proceso. El paquete se actualizará como cualquier otro paquete deb.

Ahora puedes introducir http://localhost:8083 en la barra de direcciones de tu navegador para abrir la página de bienvenida de ONLYOFFICE Docs, donde encontrarás más instrucciones sobre cómo habilitar los ejemplos de documentos o integrar los editores en línea en tu aplicación web usando la API proporcionada.

Ejecución del ONLYOFFICE Docs usando HTTPS​

En la mayoría de los casos, el acceso al portal a través del protocolo HTTPS es mucho más seguro que a través del protocolo HTTP que se usa por defecto. Puedes ejecutar fácilmente ONLYOFFICE Docs usando una conexión segura. Por favor, consulta los detalles aquí para saber más sobre cómo hacerlo.

Información adicional: más opciones para la instalación del ONLYOFFICE Docs​

La instalación de ONLYOFFICE Docs permite el uso de más opciones debconf, que pueden ser muy útiles si planeas instalarlo en más de un servidor o en otros casos.

Estas opciones incluyen:

  • Opciones de JWT

    Puedes usar debconf-set-selections para desactivar la sobrescritura de los valores personalizados en el archivo local.json después de actualizar ONLYOFFICE Docs.

    • Habilita JSON Web Tokens (JWT):

      echo onlyoffice-documentserver onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

    • Establece una clave secreta JWT reemplazando <JWT_SECRET> por tu propio valor:

      echo onlyoffice-documentserver onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections