Instalando o ONLYOFFICE Docs para Debian, Ubuntu e derivados

Introdução

A Community Edition permite que você instale o ONLYOFFICE Docs em seu servidor local e integre editores online nativos com a plataforma de colaboração da 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. É totalmente compatível com os formatos Office Open XML (.docx, .xlsx, .pptx) e oferece recursos avançados de edição colaborativa em tempo real.

Principais Funcionalidades:

• Document Editor
• Spreadsheet Editor
• Presentation Editor
• Visualizadores web móveis
• Edição colaborativa em tempo real
• Suporte a hieróglifos e caracteres complexos
• Suporte nativo para os formatos mais 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 Community Edition.

Ao utilizá-lo em conjunto com o ONLYOFFICE Workspace, você também poderá:

• Compartilhar arquivos internamente e externamente;
• Gerenciar direitos e permissões de acesso 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 Community Edition na sua máquina.

Requisitos de sistema

• CPU: Processador Dual Core de 2 GHz ou superior
• RAM: Mínimo de 2 GB (A necessidade depende da carga do SO host; quanto mais memória, melhor)
• HDD / SSD: Pelo menos 40 GB de espaço livre em disco
• SWAP: Pelo menos 4 GB (A eficiência do Swap depende 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
  • libstdc++6: versão 4.8.4 ou posterior
  • RabbitMQ

Instalando o 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 distribuições mais recentes. Distribuições legadas podem exigir a instalação manual dos pacotes.

1. Instalando e configurando dependências

O ONLYOFFICE Docs utiliza o NGINX como proxy e o PostgreSQL como banco de dados. As dependências nativas serão instaladas automaticamente durante o processo principal, mas os serviços base precisam ser ativados.

Instalando o PostgreSQL:

sudo apt-get install postgresql

Após a instalação, crie o banco de dados e o usuário administrador do PostgreSQL:

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 RabbitMQ:

sudo apt-get install rabbitmq-server

2. Alterando a porta padrão do ONLYOFFICE Docs (Opcional)

Por padrão, o ONLYOFFICE Docs escuta as conexões de entrada na porta HTTP 80. Se você planeja utilizar essa porta para outros serviços, é recomendável alterá-la.

Para registrar a alteração de porta no sistema debconf, execute (substitua <PORT_NUMBER> pelo número desejado):

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

3. Guia de instalação dos pacotes ONLYOFFICE Docs

Adicione a chave pública GPG para validação de segurança:

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 do ONLYOFFICE Docs à lista de fontes do sistema:

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

Atualize o cache local do gerenciador de pacotes:

sudo apt-get update

Instale as fontes nativas da Microsoft (mscorefonts) para consistência tipográfica:

sudo apt-get install ttf-mscorefonts-installer

Finalmente, instale o motor do ONLYOFFICE Docs Community Edition:

sudo apt-get install onlyoffice-documentserver

Após a conclusão, o ONLYOFFICE Docs será executado permanentemente como um processo em segundo plano e poderá ser atualizado via APT.

Abra o seu navegador e acesse http://localhost (ou o endereço IP do servidor) para visualizar a página de boas-vindas do ONLYOFFICE Docs e conferir a documentação de integração com a API fornecida.

Executando o ONLYOFFICE Docs usando HTTPS

Para garantir a segurança em ambientes de produção, operar o portal sob o protocolo criptografado HTTPS é imensamente superior ao HTTP padrão. Você pode facilmente habilitar certificados SSL seguros acompanhando os detalhes técnicos na documentação de implementação HTTPS para Linux.

Informações adicionais: Opções avançadas via Debconf

O instalador debian do ONLYOFFICE Docs expõe variáveis nativas ao debconf, permitindo o provisionamento automatizado de configurações complexas (como instalações em múltiplos servidores ou instâncias isoladas de banco de dados).

Opções de banco de dados PostgreSQL Externo

• Definir o endereço (host) do servidor PostgreSQL (substituindo <DB_HOST> pelo IP real):

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

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

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

• Definir a senha do usuário do banco de dados:

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

• Definir um nome personalizado para o banco de dados (schema):

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

Opções do serviço RabbitMQ

• Definir o endereço IP (host) do RabbitMQ:

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

• Definir o nome de usuário do RabbitMQ:

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

• Definir a senha do usuário do RabbitMQ:

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

Opções JWT (JSON Web Tokens)

O utilitário debconf-set-selections pode ser invocado para impedir a substituição indesejada de parâmetros de segurança configurados no arquivo local.json durante as rotinas de atualização sistêmica do ONLYOFFICE Docs:

• Ativar a autenticação via JWT:

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

• Definir uma chave secreta e exclusiva (Secret JWT):

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