Saltar al contenido principal

Instalación de ONLYOFFICE Docs en sistemas Debian para arm64

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 ONLYOFFICE Docs Community Edition versión 7.1 y posteriores en Ubuntu 18.04 o Ubuntu 20.04 para arm64.

Requisitos del sistema​

  • Procesador: procesadores ARM de 64 bits
  • 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 arm64, Ubuntu 18.04 arm64 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.

Instalación de NGINX​

Instala NGINX usando el siguiente comando:

sudo apt-get install nginx
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:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys CB2DE8E5

Añade el repositorio de ONLYOFFICE Docs:

echo "deb 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