Saltar al contenido principal

Instalación del ONLYOFFICE Docs Community Edition para Linux en CentOS 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, lo que te permite compartir archivos, gestionar derechos de acceso, incorporar documentos a un sitio web y editar archivos almacenados en Drive, Box, Dropbox, OneDrive u ownCloud conectados a ONLYOFFICE (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: CentOS Stream 9, RHEL 8 o RHEL 9
  • Requisitos adicionales
    • NGINX: versión 1.30 o posterior

Instalación de dependencias​

Instalación de la versión actualizada de paquetes NGINX​

Para configurar el repositorio yum para RHEL/CentOS, es necesario crear el archivo llamado /etc/yum.repos.d/nginx.repo con el siguiente contenido:

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key

Instrucción oficial

Instala NGINX:

sudo yum install nginx

Después de eso, edita el archivo de configuración NGINX /etc/nginx/nginx.conf, para que se parezca a lo siguiente:

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}
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.

Instalación del repositorio EPEL​

sudo yum install epel-release

Para instalar EPEL en CentOS 9, usa los siguientes comandos:

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

Para instalar EPEL en RHEL, usa los siguientes comandos:

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

Cambia $REV manualmente por la versión de tu sistema operativo (7 para las versiones 7.x, 8 para las versiones 8.x, 9 para las versiones 9.x, etc.).

Añadir el repositorio del ONLYOFFICE Docs​

Añade el repositorio yum del ONLYOFFICE Docs usando el siguiente comando:

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

Instalación de mscorefonts​

Instala los paquetes cabextract y xorg-x11-font-utils:

sudo yum install cabextract xorg-x11-font-utils

Para CentOS 7.8(2003), también se requiere fontconfig:

sudo yum install fontconfig

Instala el paquete de fuentes msttcore:

sudo rpm -i https://sourceforge.net/projects/mscorefonts2/files/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

Instalación del ONLYOFFICE Docs​

Ejecuta el siguiente comando para la edición Community:

sudo yum install onlyoffice-documentserver

Inicia el servicio nginx y activa el inicio al arrancar:

sudo service nginx start
sudo systemctl enable nginx

Después de eso, ONLYOFFICE Docs será lanzado como un proceso. El paquete se actualizará como cualquier otro paquete rpm.

Actualización del ONLYOFFICE Docs​

Para actualizar ONLYOFFICE Docs, ejecuta el siguiente comando:

sudo yum update onlyoffice-documentserver
Importante

En RHEL 8 y sus derivados, ejecutar yum update con el repositorio de ONLYOFFICE activado puede fallar con un error de dependencias.

Para evitarlo, excluye estos paquetes del repositorio de ONLYOFFICE para que se obtengan del repositorio AppStream del sistema:

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

Este comando solo debe ejecutarse una vez. Después, yum update funcionará como se espera.

Si instalaste ONLYOFFICE Docs mediante OneClick Install, esta exclusión ya se aplica automáticamente.

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 editar la variable de entorno DS_PORT ejecutando el comando:

export DS_PORT=<PORT_NUMBER>

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 la versión actualizada de paquetes NGINX.

Aviso

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

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

Configuración del ONLYOFFICE Docs​

Ejecutar un script de configuración​

Ejecuta el script documentserver-configure:

bash documentserver-configure

Añadir una excepción de firewall​

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

Desactivar SELinux​

nota

no se usa desde la versión 5.0

Abre el archivo /etc/selinux/config usando cualquier editor de texto, reemplaza la cadena SELINUX=enforcing o SELINUX=permissive por la siguiente SELINUX=disabled y guarda los cambios.

Reinicia tu servidor para que los cambios surtan efecto.

Nota

Por razones de seguridad, a partir de la versión 8.1, se generan nuevas claves WOPI en local.json al ejecutar el script documentserver-configure. Si usas una conexión WOPI, debes ejecutar el script después de actualizar ONLYOFFICE Docs:

documentserver-configure --wopienabled true

Inicio del ONLYOFFICE Docs en un navegador​

Una vez finalizada la configuración, 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.

Para conectar ONLYOFFICE Docs a ONLYOFFICE Workspace, consulta esta instrucción.