Este artigo foi traduzido por IA

Instalando ONLYOFFICE Docs Developer Edition para CentOS e derivados

Introdução

Developer Edition permite que você instale o ONLYOFFICE Docs em seu servidor local e integre os editores online com sua aplicação web.

ONLYOFFICE Docs é um pacote de escritório online que inclui visualizadores e editores para textos, planilhas e apresentações, totalmente compatível com os formatos Office Open XML: .docx, .xlsx, .pptx e que possibilita a edição colaborativa em tempo real.

Funcionalidades

  • Editor de documentos
  • Editor de planilhas
  • Editor de apresentações
  • Visualizadores web móveis
  • Editores web móveis
  • Edição colaborativa
  • Suporte a hieróglifos
  • Suporte para todos os formatos populares: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Veja a lista detalhada de funcionalidades disponíveis para o ONLYOFFICE Docs Developer Edition.

Este guia mostrará como instalar a versão Linux do ONLYOFFICE Docs Developer Edition em sua máquina.

Requisitos do sistema
  • CPU: dual core 2 GHz ou melhor
  • RAM: pelo menos 2 GB, mas depende do sistema operacional host. Mais é melhor
  • HDD: pelo menos 40 GB de espaço livre
  • SWAP: pelo menos 4 GB, mas depende do sistema operacional host. Mais é melhor
  • OS: CentOS Stream 9, RHEL 8 ou RHEL 9
  • Requisitos adicionais:
    • PostgreSQL: versão 12.9 ou posterior
    • NGINX: versão 1.3.13 ou posterior
    • Redis: versão 5 ou posterior
    • RabbitMQ

Instalando dependências

Instalando a versão atualizada do pacote NGINX

Para configurar o repositório yum para RHEL/CentOS, crie o arquivo chamado /etc/yum.repos.d/nginx.repo com o seguinte conteúdo:

[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

Instrução oficial

Instale o NGINX:

sudo yum install nginx

Depois disso, edite o arquivo de configuração /etc/nginx/nginx.conf do NGINX, para que ele fique da seguinte forma:

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;
}
Instalando o repositório EPEL
sudo yum install epel-release

Para instalar o EPEL no CentOS 9, use os seguintes comandos:

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

Para instalar o EPEL no RHEL, use os seguintes 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

Altere $REV para a versão do seu sistema operacional manualmente (7 para versões 7.x, 8 para versões 8.x, 9 para versões 9.x e assim por diante).

Instalando e configurando o PostgreSQL

Instale o PostgreSQL incluído na sua versão do CentOS:

sudo yum install postgresql postgresql-server
Se você deseja instalar alguma outra versão do PostgreSQL do Repositório PostgreSQL, por favor, consulte a documentação oficial do PostgreSQL para mais detalhes sobre isso.

Inicialize o banco de dados PostgreSQL

sudo service postgresql initdb 
sudo chkconfig postgresql on

No CentOS 9, o chkconfig não está instalado por padrão. Instale-o usando o seguinte comando:

sudo yum install chkconfig

Ative o método de autenticação 'scram-sha-256' para localhost IPv4 e IPv6

Abra o arquivo /var/lib/pgsql/data/pg_hba.conf em um editor de texto.

Encontre a string host all all 127.0.0.1/32 ident e substitua-a pela seguinte:

host    all             all             127.0.0.1/32            scram-sha-256

Em seguida, encontre a string host all all ::1/128 ident e substitua-a pela seguinte:

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

Salve as alterações.

Abra o arquivo /var/lib/pgsql/data/postgresql.conf em um editor de texto.

Encontre 'password_encryption', descomente-o e substitua o valor por 'scram-sha-256':

password_encryption = 'scram-sha-256'

Salve as alterações.

Reinicie o serviço PostgreSQL:

sudo service postgresql restart

Crie o banco de dados e o usuário do PostgreSQL:

Você pode especificar qualquer nome de usuário e senha.

Primeiro execute o comando

cd /tmp

para evitar o aviso could not change directory to "/root" se estiver executando como root. Em seguida, o banco de dados e o usuário devem ser criados:

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"
Instalando o Redis

Execute o seguinte comando:

sudo yum -y install redis

Inicie o serviço redis e habilite a inicialização automática:

sudo systemctl enable --now redis
Instalando o 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

Altere $REV para a versão do seu sistema operacional manualmente (7 para versões 7.x, 8 para versões 8.x, 9 para versões 9.x e assim por diante).

sudo yum install rabbitmq-server

Alternativamente, você pode instalar o RabbitMQ no CentOS 8 ou CentOS 9 a partir do site oficial.

Inicie o serviço rabbitmq e habilite a inicialização automática:

sudo systemctl enable --now rabbitmq-server
Adicionando o repositório ONLYOFFICE Docs

Adicione o repositório yum do ONLYOFFICE Docs com o seguinte comando:

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

Instale os pacotes cabextract e xorg-x11-font-utils:

sudo yum install cabextract xorg-x11-font-utils

Para CentOS 7.8(2003), fontconfig também é necessário:

sudo yum install fontconfig

Instale o pacote de fontes msttcore:

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

Instalando o ONLYOFFICE Docs

Execute o seguinte comando para a edição Developer:

sudo yum install onlyoffice-documentserver-de

Inicie o serviço nginx e habilite a inicialização automática:

sudo service nginx start
sudo systemctl enable nginx

Após isso, o ONLYOFFICE Docs será executado como um processo. O pacote será atualizado como qualquer outro pacote rpm.

Atualizando ONLYOFFICE Docs

Para atualizar o ONLYOFFICE Docs, execute o seguinte comando:

sudo yum update onlyoffice-documentserver-de
Importante No RHEL 8 e seus derivados, executar yum update com o repositório ONLYOFFICE habilitado pode falhar com um erro de dependência.

Para evitar isso, exclua esses pacotes do repositório ONLYOFFICE para que eles sejam obtidos do repositório AppStream do sistema:

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

Este comando precisa ser executado apenas uma vez. Depois disso, yum update funcionará como esperado.

Se você instalou o ONLYOFFICE Docs via OneClick Install, essa exclusão já é aplicada automaticamente.

Alterando a porta padrão do ONLYOFFICE Docs

Por padrão, o ONLYOFFICE Docs escuta as conexões de entrada usando a porta 80. A partir da versão 4.3, você pode alterar a porta para o ONLYOFFICE Docs se planeja usá-la em vez da padrão.

Se você for alterar a porta padrão, certifique-se de que ela está aberta para conexões de entrada/saída. Veja a lista completa das portas usadas pelo ONLYOFFICE Docs.

Para fazer isso, você precisará editar a variável de ambiente DS_PORT executando o comando:

export DS_PORT=<PORT_NUMBER>

Por favor, escreva o número da porta em vez de <PORT_NUMBER> no comando acima.

Aviso Se você deseja alterar o protocolo do ONLYOFFICE Docs para HTTPS, não altere a porta para 443, mas use esta instrução em vez disso.

Depois disso, você pode continuar configurando o ONLYOFFICE Docs.

Configurando ONLYOFFICE Docs

Executar um script de configuração
Nota Por padrão, o PostgreSQL é usado como banco de dados. Se você quiser usar MySQL em vez de PostgreSQL, por favor, adicione duas variáveis de ambiente para definir o tipo de banco de dados e a porta antes de executar o script documentserver-configure.sh:
export DB_TYPE=mysql
export DB_PORT=3306

Após adicionar essas duas variáveis, você poderá alternar o banco de dados usando o script.

Execute o script documentserver-configure.sh:

bash documentserver-configure.sh

Você será solicitado a especificar os parâmetros de conexão do PostgreSQL, Redis e RabbitMQ. Use os seguintes dados:

Para PostgreSQL:

  • Host: localhost
  • Banco de dados: onlyoffice
  • Usuário: onlyoffice
  • Senha: onlyoffice

Para Redis:

  • Host: localhost

Para RabbitMQ:

  • Host: localhost
  • Usuário: guest
  • Senha: guest
Adicionar uma exceção de firewall
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --reload
Desativar SELinux
obsoleto desde v.5.0

Abra o arquivo /etc/selinux/config usando qualquer editor de texto, substitua a string SELINUX=enforcing ou SELINUX=permissive por SELINUX=disabled e salve as alterações.

Reinicie seu servidor para que as alterações tenham efeito.

Nota Por razões de segurança, a partir da v8.1, novas chaves WOPI são geradas em local.json ao executar o script documentserver-configure.sh. Se você estiver usando uma conexão WOPI, precisará executar o script após atualizar o ONLYOFFICE Docs:
documentserver-configure.sh --wopienabled true

Iniciando ONLYOFFICE Docs em um navegador

Uma vez que a configuração esteja concluída, você pode digitar http://localhost na barra de endereços do seu navegador para abrir a página de boas-vindas do ONLYOFFICE Docs, onde encontrará mais instruções sobre como habilitar exemplos de documentos ou integrar editores online em sua aplicação web usando a API fornecida.

Registrando sua versão Developer Edition

Se você comprou a Developer Edition e recebeu o arquivo license.lic, pode colocá-lo em sua instalação para obter a versão completa do software.

Quando você é um usuário de uma distribuição Linux baseada em Red Hat, o arquivo license.lic é colocado na seguinte pasta:

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

Depois disso, sua versão da Developer Edition será registrada e completa.

Artigo com o tag:
Veja todas as etiquetas