Introducción
LYONOFFICE Docs es una suite ofimática de código abierto que incluye editores colaborativos para documentos de texto, hojas de cálculo, presentaciones, formularios y PDF. El paquete se distribuye bajo la licencia AGPL v3.0. OOXML (DOCX, XLSX y PPTX) se utiliza como formato principal. Los editores se pueden integrar con varios servicios en la nube, como marcos CMS, plataformas de colaboración y contenido, rastreadores de problemas, soluciones de aprendizaje electrónico, etc. Las integraciones listas para usar incluyen Redmine, Odoo, ownCloud, Moodle, WordPress, Confluence, Jira y más. También existe la opción de integrar la suite en su aplicación o servicio web.
Este artículo explica cómo instalar OnlyOFFICE Docs en Ubuntu 22.04 usando Docker y conectar Oracle Database.
Requisitos de hardware
Para instalar OnlyOffice Docs, necesitará al menos:
- CPU: 2GHz de doble núcleo o superior
- RAM: 4 GB o más
- HDD: al menos 40 GB de espacio libre
- SWAP: al menos 4 GB (pero depende del sistema operativo host)
- La última versión de Docker
Instalación de OnlyOffice
La forma más sencilla de instalar la suite es utilizar Docker. Los desarrolladores recomiendan oficialmente este método. Si Docker no está instalado, puede consultar las instrucciones de instalación de Docker.
Una vez que tenga la última versión de Docker, puede instalar OnlyOFFICE Docs con todas las dependencias usando un solo comando:
sudo docker run -i -t -d -p 80:80 --restart=always \
-e JWT_SECRET=my_jwt_secret onlyoffice/documentserver
En OnlyOffice Docs, un secreto JWT se genera aleatoriamente. Si el secreto JWT no se especifica con la variable de entorno, provoca su regeneración durante cada reinicio de las VM o del servidor físico, por lo que puede haber problemas en las integraciones. Se recomienda que especifique su valor en -e JWT_SECRET=my_jwt_secret
. Si no va a utilizar JWT en su instalación, utilice -e JWT_ENABLED=false
.
Si desea cambiar el puerto, use la opción -p
:
sudo docker run -i -t -d -p <PORT_NUMBER>:80 --restart=always \
-e JWT_SECRET=my_jwt_secret onlyoffice/documentserver
Una vez que esté listo, acceda a http://localhost
en la barra de direcciones de su navegador para iniciar la página de bienvenida. Allí se proporciona un ejemplo de integración de forma predeterminada junto con los editores. Es un DMS simple que se utiliza para probar editores y ver cómo se puede implementar la integración.
Para integrar OnlyOffice Docs con su plataforma en la nube requerida, consulte las instrucciones correspondientes.
Almacenamiento de datos fuera de contenedores
Se recomienda encarecidamente almacenar datos fuera de los contenedores Docker en la computadora host, ya que le permite actualizar fácilmente OnlyOffice Docs una vez que se lanza la nueva versión sin perder datos.
Para obtener acceso a los datos ubicados fuera del contenedor, monte los volúmenes. Se puede hacer especificando la opción -v
en el comando de ejecución de Docker:
sudo docker run -i -t -d -p 80:80 --restart=always \
-v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
-v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
-v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
-e JWT_SECRET=my_jwt_secret onlyoffice/documentserver
Si elimina el contenedor o algo sale mal durante la actualización, no perderá sus datos. También podrá actualizar sus certificados sin interferir con el contenedor.
Cambiar a HTTPS
La forma más sencilla de cambiar OnlyOFFICE Docs a HTTPS es obtener certificados SSL Let's Encrypt utilizando certbot automáticamente.
Ejecute el contenedor Docker de OnlyOffice Docs. Especifique los puertos 80 y 443 y configure el nombre de dominio y el correo electrónico:
sudo docker run -i -t -d -p 80:80 -p 443:443 --restart=always \
-e LETS_ENCRYPT_DOMAIN=yourdomain.com -e [email protected] \
-e JWT_SECRET=my_jwt_secret onlyoffice/documentserver
Una vez terminado, OnlyOffice Docs estará disponible en formato https://yourdomain.com
.
Conexión de base de datos Oracle
Consulte las opciones run
del comando Docker para conocer el indicador --env-file
, donde puede especificar todas las variables de entorno requeridas en un solo archivo. Esto le evitará escribir un comando de ejecución de Docker potencialmente largo.
Para conectar la base de datos Oracle, cambie el parámetro DB_TYPE
a oracle
.
Para utilizar la configuración de conexión avanzada para Oracle, utilice el parámetro oracleExtraOptions
.
Conclusión
Le mostramos cómo instalar OnlyOFFICE Docs en Ubuntu 22.04 y conectarse a Oracle DB. Ahora puede editar y coeditar varios documentos de Office dentro de la plataforma en la nube que ya utiliza.
Si tiene alguna pregunta, deje comentarios a continuación.