Este artículo está traducido por IA

Instalación de ONLYOFFICE Docs Developer Edition para CentOS y derivados

Introducción

Developer Edition te permite instalar ONLYOFFICE Docs en tu servidor local e integrar los editores en línea con tu aplicación web.

ONLYOFFICE Docs es una suite ofimática en línea que incluye visores y editores para textos, hojas de cálculo y presentaciones, totalmente compatible con los formatos Office Open XML: .docx, .xlsx, .pptx y que permite la edición colaborativa en tiempo real.

Funcionalidades

  • Editor de Documentos
  • Editor de Hojas de Cálculo
  • Editor de Presentaciones
  • Visores web móviles
  • Editores web móviles
  • Edición colaborativa
  • Soporte para jeroglíficos
  • Soporte para todos los formatos populares: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Consulta la lista detallada de características disponibles para ONLYOFFICE Docs Developer Edition.

Esta guía te mostrará cómo instalar la versión para Linux de ONLYOFFICE Docs Developer Edition en tu máquina.

Requisitos del sistema
  • CPU: doble núcleo 2 GHz o mejor
  • RAM: al menos 2 GB, pero depende del sistema operativo anfitrión. Más es mejor
  • HDD: al menos 40 GB de espacio libre
  • SWAP: al menos 4 GB, pero depende del sistema operativo anfitrión. Más es mejor
  • OS: CentOS Stream 9, RHEL 8, o RHEL 9
  • Requisitos adicionales:
    • PostgreSQL: versión 12.9 o posterior
    • NGINX: versión 1.3.13 o posterior
    • Redis: versión 5 o posterior
    • RabbitMQ

Instalación de dependencias

Instalación de la versión actualizada del paquete NGINX

Para configurar el repositorio yum para RHEL/CentOS, crea 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 /etc/nginx/nginx.conf de NGINX, para que se vea de la siguiente manera:

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;
}
Instalación del repositorio EPEL
sudo yum install epel-release

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

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

Para instalar EPEL en RHEL, utiliza 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 a la versión de tu sistema operativo manualmente (7 para versiones 7.x, 8 para versiones 8.x, 9 para versiones 9.x y así sucesivamente).

Instalación y configuración de PostgreSQL

Instala la versión de PostgreSQL incluida en tu versión de CentOS:

sudo yum install postgresql postgresql-server
Si deseas instalar alguna otra versión de PostgreSQL desde el Repositorio de PostgreSQL, por favor consulta la documentación oficial de PostgreSQL para más detalles.

Inicializa la base de datos de PostgreSQL

sudo service postgresql initdb 
sudo chkconfig postgresql on

En CentOS 9, chkconfig no está instalado por defecto. Instálalo usando el siguiente comando:

sudo yum install chkconfig

Activa el método de autenticación 'scram-sha-256' para localhost IPv4 e IPv6

Abre el archivo /var/lib/pgsql/data/pg_hba.conf en un editor de texto.

Encuentra la cadena host all all 127.0.0.1/32 ident y reemplázala con la siguiente:

host    all             all             127.0.0.1/32            scram-sha-256

Luego encuentra la cadena host all all ::1/128 ident y reemplázala con la siguiente:

host    all             all             ::1/128                 scram-sha-256

Guarda los cambios.

Abre el archivo /var/lib/pgsql/data/postgresql.conf en un editor de texto.

Encuentra 'password_encryption', descoméntalo y reemplaza el valor con 'scram-sha-256':

password_encryption = 'scram-sha-256'

Guarda los cambios.

Reinicia el servicio de PostgreSQL:

sudo service postgresql restart

Crea la base de datos y el usuario de PostgreSQL:

Puedes especificar cualquier nombre de usuario y contraseña.

Primero ejecuta el comando

cd /tmp

para evitar la advertencia could not change directory to "/root" si se ejecuta desde root. Luego, la base de datos y el usuario deben ser creados:

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"
Instalación de Redis

Ejecuta el siguiente comando:

sudo yum -y install redis

Inicia el servicio redis y habilita el inicio al arrancar:

sudo systemctl enable --now redis
Instalación de RabbitMQ
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/rabbitmq-server/script.rpm.sh | os=centos dist=$REV sudo bash
sudo curl -s https://packagecloud.io/install/repositories/rabbitmq/erlang/script.rpm.sh | os=centos dist=$REV sudo bash

Cambia $REV a la versión de tu sistema operativo manualmente (7 para versiones 7.x, 8 para versiones 8.x, 9 para versiones 9.x y así sucesivamente).

sudo yum install rabbitmq-server

Alternativamente, puedes instalar RabbitMQ en CentOS 8 o CentOS 9 desde el sitio oficial.

Inicia el servicio rabbitmq y habilita el inicio al arrancar:

sudo systemctl enable --now rabbitmq-server
Añadiendo el repositorio de ONLYOFFICE Docs

Añade el repositorio yum de ONLYOFFICE Docs con 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 de ONLYOFFICE Docs

Ejecuta el siguiente comando para la edición Developer:

sudo yum install onlyoffice-documentserver-de

Inicia el servicio nginx y habilita el inicio al arrancar:

sudo service nginx start
sudo systemctl enable nginx

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

Actualización de ONLYOFFICE Docs

Para actualizar ONLYOFFICE Docs, ejecuta el siguiente comando:

sudo yum update onlyoffice-documentserver-de
Importante En RHEL 8 y sus derivados, ejecutar yum update con el repositorio de ONLYOFFICE habilitado puede fallar con un error de dependencia.

Para evitar esto, excluye estos paquetes del repositorio de ONLYOFFICE para que se obtengan del repositorio AppStream del sistema en su lugar:

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

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

Si instalaste ONLYOFFICE Docs a través de OneClick Install, esta exclusión ya se aplica automáticamente.

Cambiar el puerto predeterminado de ONLYOFFICE Docs

Por defecto, ONLYOFFICE Docs escucha las conexiones entrantes utilizando el puerto 80. A partir de la versión 4.3 puedes cambiar el puerto para ONLYOFFICE Docs si planeas usarlo en lugar del predeterminado.

Si vas a cambiar el puerto predeterminado, asegúrate de que esté abierto para las conexiones entrantes/salientes. Consulta la lista completa de los puertos utilizados 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 lugar de <PORT_NUMBER> en el comando anterior.

Advertencia Si deseas cambiar el protocolo de ONLYOFFICE Docs a HTTPS, no cambies el puerto a 443, sino utiliza esta instrucción en su lugar.

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

Configuración de ONLYOFFICE Docs

Ejecutar un script de configuración
Nota Por defecto, se utiliza PostgreSQL como base de datos. Si deseas usar MySQL en lugar de PostgreSQL, por favor añade dos variables de entorno para definir el tipo de base de datos y el puerto antes de ejecutar el script documentserver-configure.sh:
export DB_TYPE=mysql
export DB_PORT=3306

Después de añadir estas dos variables, podrás cambiar la base de datos usando el script.

Ejecuta el script documentserver-configure.sh:

bash documentserver-configure.sh

Se te pedirá que especifiques los parámetros de conexión de PostgreSQL, Redis y RabbitMQ. Usa los siguientes datos:

Para PostgreSQL:

  • Host: localhost
  • Base de datos: onlyoffice
  • Usuario: onlyoffice
  • Contraseña: onlyoffice

Para Redis:

  • Host: localhost

Para RabbitMQ:

  • Host: localhost
  • Usuario: guest
  • Contraseña: guest
Añadir una excepción al firewall
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload
Desactivar SELinux
obsoleto desde v.5.0

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

Reinicia tu servidor para que los cambios surtan efecto.

Nota Por razones de seguridad, a partir de la v8.1, se generan nuevas claves WOPI en local.json al ejecutar el script documentserver-configure.sh. Si estás usando una conexión WOPI, necesitas ejecutar el script después de actualizar ONLYOFFICE Docs:
documentserver-configure.sh --wopienabled true

Iniciar ONLYOFFICE Docs en un navegador

Una vez finalizada la configuración, puedes ingresar http://localhost 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 ejemplos de documentos o integrar editores en línea en tu aplicación web utilizando la API proporcionada.

Registrar tu versión de Developer Edition

Si compraste Developer Edition y recibiste el archivo license.lic, puedes colocarlo en tu instalación para obtener la versión completa del software.

Cuando eres usuario de una distribución Linux basada en Red Hat, el archivo license.lic se coloca en la siguiente carpeta:

/var/www/onlyoffice/Data/license.lic

Después de eso, tu versión de Developer Edition estará registrada y con todas las funciones habilitadas.

Artículos con etiqueta:
Ver todas las etiquetas