Instalando o ONLYOFFICE Docs Enterprise Edition no Debian e Ubuntu

Introdução

A Enterprise Edition permite que você instale o ONLYOFFICE Docs em seu servidor local corporativo e integre os editores online nativamente com a plataforma de colaboração ONLYOFFICE ou com outros sistemas populares.

O ONLYOFFICE Docs é um pacote office online de alto desempenho que compreende visualizadores e editores para textos, planilhas e apresentações, sendo totalmente compatível com os formatos Office Open XML (.docx, .xlsx, .pptx) e permitindo a edição colaborativa segura em tempo real.

Principais Funcionalidades:

• Document Editor, Spreadsheet Editor e Presentation Editor
• Visualizadores e editores web otimizados para dispositivos móveis
• Edição colaborativa avançada em tempo real
• Suporte a hieróglifos e caracteres complexos
• Suporte nativo para os formatos populares: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Veja a lista detalhada de recursos disponíveis para o ONLYOFFICE Docs Enterprise Edition.

Ao utilizá-lo no ecossistema do ONLYOFFICE Workspace, você também poderá:

• Compartilhar arquivos internamente e externamente;
• Gerenciar direitos e permissões de acesso rigorosas a documentos;
• Incorporar documentos publicamente em sites e portais;
• Visualizar e editar arquivos armazenados em provedores conectados, como Google Drive, Box, Dropbox, OneDrive e OwnCloud.

Este guia demonstrará como instalar a versão Linux do ONLYOFFICE Docs Enterprise Edition na sua infraestrutura Debian ou Ubuntu.

Requisitos de sistema

• CPU: Processador Dual Core de 2 GHz ou superior
• RAM: Mínimo de 2 GB (A necessidade real depende da carga do SO host; quanto mais memória, melhor a estabilidade)
• HDD / SSD: Pelo menos 40 GB de espaço livre em disco
• SWAP: Pelo menos 4 GB (A eficiência do Swap depende estritamente do SO host)
• SO: Debian, Ubuntu de 64 bits ou outra distribuição compatível com versão de kernel 3.13 ou posterior
• Requisitos de Software Adicionais: PostgreSQL (versão 12.9 ou posterior), NGINX (versão 1.3.13 ou posterior), Redis (versão 4 ou posterior) e RabbitMQ.

Passo 1. Preparando a instalação do ONLYOFFICE Docs

A instalação a partir de repositórios em distribuições baseadas em Debian exige a presença prévia do libstdc++6, NGINX e PostgreSQL no sistema.

Existem dependências adicionais obrigatórias que são instaladas junto com o ONLYOFFICE Docs:

• libcurl3
• libxml2
• fonts-dejavu
• fonts-liberation
• ttf-mscorefonts-installer
• fonts-crosextra-carlito
• fonts-takao-gothic
• fonts-opensymbol

Essas dependências são instaladas automaticamente quando você utiliza o Ubuntu 14.04 LTS ou posterior. Distribuições muito antigas podem exigir a instalação manual.

Instalando e configurando dependências vitais

O ONLYOFFICE Docs utiliza o NGINX como servidor web proxy e o PostgreSQL como banco de dados mestre. As dependências nativas serão resolvidas automaticamente usando apt-get install, mas as bases de serviço precisam ser inicializadas.

Instalando o PostgreSQL:

sudo apt-get install postgresql

Após a instalação bem-sucedida, crie o banco de dados e o usuário administrador da aplicação:

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:

sudo apt-get install redis-server

Instalando o RabbitMQ:

sudo apt-get install rabbitmq-server

Alterando a porta padrão do servidor (Opcional)

Por padrão, o ONLYOFFICE Docs intercepta as conexões de entrada escutando a porta HTTP 80. Se você planeja hospedar outros serviços no mesmo servidor web, pode ser útil alterar essa porta.

Para alterar a porta padrão, registre a sua escolha no sistema debconf utilizando o comando abaixo (substitua <NUMERO_DA_PORTA> pela porta desejada):

echo onlyoffice-documentserver-ee onlyoffice/ds-port select <NUMERO_DA_PORTA> | sudo debconf-set-selections

Passo 2. Instalando os pacotes do ONLYOFFICE Docs

Adicione a chave pública GPG para validar a segurança e a integridade dos pacotes no sistema:

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

Adicione o repositório oficial do ONLYOFFICE Docs à sua lista de fontes do APT:

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

Em instalações do Debian puro, certifique-se de adicionar o componente contrib ao seu arquivo /etc/apt/sources.list.

Atualize o cache local do gerenciador de pacotes do servidor:

sudo apt-get update

Instale as fontes essenciais da Microsoft para garantir total compatibilidade na renderização de documentos:

sudo apt-get install ttf-mscorefonts-installer

Finalmente, instale o motor base do ONLYOFFICE Docs Enterprise Edition:

sudo apt-get install onlyoffice-documentserver-ee

Após a conclusão, o ONLYOFFICE Docs rodará como um processo contínuo no host e o pacote poderá ser atualizado normalmente via comando APT.

Acesse http://localhost (ou o IP do servidor) no seu navegador para abrir o painel de boas-vindas da API. Lá, você encontrará instruções para testes e a documentação para integrar os editores à sua aplicação web.

Executando o ONLYOFFICE Docs usando HTTPS

Para proteger os dados em trânsito no seu ambiente corporativo, utilizar o protocolo criptografado HTTPS é mandatório. Você pode configurar certificados SSL seguros acompanhando a documentação detalhada em Configurando HTTPS no Linux.

Registrando a sua chave Enterprise Edition

Se você assinou a API e recebeu o seu arquivo de licenciamento license.lic, deve injetá-lo no sistema para desbloquear todas as funções comerciais da plataforma.

Faça upload e mova o arquivo license.lic estritamente para o seguinte diretório do seu host Linux:

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

Feito isso, os serviços da ONLYOFFICE validarão automaticamente a chave, efetivando a sua edição corporativa.

Informações Avançadas: Parâmetros extra do DEBCONF

A instalação modular do ONLYOFFICE Docs permite a pré-configuração de variáveis do debconf, o que é de imenso valor para provisionamento via scripts de automação ou para quando serviços vitais (como o PostgreSQL) estiverem rodando em máquinas separadas (clusterização).

Opções de conexão com o PostgreSQL Externo

• Definir o endereço (Host) do servidor de banco de dados (Substitua <DB_HOST> pelo IP aplicável):

  echo onlyoffice-documentserver-ee onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections

• Definir o nome de usuário do banco de dados:

  echo onlyoffice-documentserver-ee onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections

• Definir a senha do usuário:

  echo onlyoffice-documentserver-ee onlyoffice/db-pwd password <DB_PASSWORD> | sudo debconf-set-selections

• Definir o nome estrutural do banco de dados (schema):

  echo onlyoffice-documentserver-ee onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections

Opções de conexão com o Redis e RabbitMQ Externos

• Definir o host do serviço de cache Redis:

  echo onlyoffice-documentserver-ee onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections

• Definir o host da fila RabbitMQ:

  echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections

• Definir usuário e senha do RabbitMQ:

  echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections
  echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections

Opções de Segurança JWT (JSON Web Tokens)

Você pode blindar o seu arquivo local.json para evitar que as chaves JWT sejam reescritas ao atualizar o pacote da aplicação futuramente:

• Habilitar JSON Web Tokens:

  echo onlyoffice-documentserver-ee onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

• Definir e forçar uma chave secreta (JWT Secret) personalizada no host:

  echo onlyoffice-documentserver-ee onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections