Como instalar o ONLYOFFICE Docs no Ubuntu/Debian (arm64)

Introdução

A partir da versão 7.1, o motor do ONLYOFFICE Docs foi otimizado e pode ser implantado nativamente em sistemas baseados em Debian operando sob a arquitetura ARM de 64 bits (arm64).

A versão Community Edition permite instalar o ONLYOFFICE Docs em seu próprio servidor local e integrar os editores web corporativos com a plataforma de colaboração ONLYOFFICE ou a outros sistemas DMS populares de terceiros.

O ONLYOFFICE Docs é uma suíte de escritório online que engloba visualizadores e editores para textos, planilhas e apresentações, apresentando total compatibilidade nativa com os formatos Office Open XML (.docx, .xlsx, .pptx) e suportando coautoria e edição colaborativa em tempo real.

Principais Recursos:

Document Editor (Editor de Textos)
Spreadsheet Editor (Editor de Planilhas)
Presentation Editor (Editor de Apresentações)
Visualizadores e editores otimizados para web móvel
Edição colaborativa simultânea (Coautoria)
Suporte avançado a hieróglifos e alfabetos internacionais
Suporte para todos os formatos populares do mercado: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX e HTML

Para auditar as especificações técnicas detalhadas, consulte a lista de recursos da versão Community Edition do ONLYOFFICE Docs no GitHub.

Ao utilizá-lo de forma integrada dentro do ONLYOFFICE Workspace, você também poderá:

Compartilhar arquivos em redes corporativas;
Gerenciar direitos de acesso e níveis de permissão em documentos;
Incorporar documentos dinâmicos em portais e sites web;
Visualizar e editar arquivos armazenados em nuvens de terceiros conectadas à instância (como Google Drive, Box, Dropbox, OneDrive e ownCloud).

Este guia demonstrará o passo a passo para instalar a versão 7.1 (ou posterior) da Community Edition em distribuições Ubuntu 18.04 LTS ou Ubuntu 20.04 LTS rodando sob a arquitetura ARM de 64 bits.

Requisitos de Sistema da Instância

CPU: Processadores multi-core com arquitetura ARM de 64 bits (arm64).
Memória RAM: No mínimo 2 GB livres (a alocação real depende dos serviços do SO host; quanto mais recursos disponíveis, melhor a estabilidade).
Armazenamento (HDD/SSD): Pelo menos 40 GB de espaço livre em disco.
Partição SWAP: Mínimo de 4 GB alocados.
Sistema Operacional: Ubuntu 18.04 LTS ou Ubuntu 20.04 LTS para arm64.
Nota de Suporte: A distribuição Ubuntu 16.04 atingiu seu fim de vida (EOL) e não é mais suportada oficialmente por este build.
Dependências e Microsserviços 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.

Considerações sobre as dependências

A instalação do servidor de documentos em distribuições baseadas em Debian exige a presença prévia das bibliotecas libstdc++6, do proxy NGINX e do banco de dados PostgreSQL ativos no sistema.

As instruções detalhadas de arquitetura e instalação granular para estes componentes podem ser encontradas diretamente em suas respectivas documentações oficiais.

O gerenciador de pacotes apt cuidará de instalar e configurar automaticamente as seguintes dependências em background (quando implantado sobre o Ubuntu 18.04 ou 20.04):

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

1. Instalando e configurando as dependências base

O ONLYOFFICE Docs utiliza o NGINX como servidor web (proxy reverso) e o PostgreSQL como seu motor de banco de dados relacional. Tais dependências, se disponíveis nos repositórios padrão do SO, serão injetadas através da cadeia de comandos de instalação.

Instalando e configurando o PostgreSQL:

Instale a versão do PostgreSQL incluída no repositório nativo do seu Ubuntu:

sudo apt-get install postgresql

Caso necessite acoplar uma versão externa não nativa do PostgreSQL para arquitetura arm64, consulte a documentação oficial para Ubuntu.

Após a inicialização do daemon do PostgreSQL, crie a role de usuário e o esquema de banco de dados do ONLYOFFICE:

O usuário proprietário do banco de dados deve ser obrigatoriamente nomeado como onlyoffice. A senha pode ser especificada livremente.

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

sudo apt-get install rabbitmq-server

2. Alterando a porta padrão do servidor de documentos

O proxy interno do ONLYOFFICE Docs é pré-configurado de fábrica para escutar requisições externas através da porta HTTP 80. Se você precisar redirecionar o tráfego em caso de conflitos com outros softwares locais, é possível mapear uma nova porta lógica.

Se você for customizar a porta de escuta, garanta que a nova regra esteja liberada para conexões de entrada/saída em seu firewall. Consulte a lista completa de portas lógicas do ONLYOFFICE Docs.

Para executar a alteração nativamente via pacote DEB, você deve injetar a nova variável portuária diretamente no sistema debconf através do comando:

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

Substitua o marcador <PORT_NUMBER> pelo valor decimal da porta desejada no comando acima.

Aviso de Segurança (HTTPS): Caso a sua intenção não seja apenas mudar a porta HTTP, mas sim ativar o protocolo criptografado HTTPS, não exporte a porta 443 manualmente através deste método. Ao invés disso, siga a instrução técnica de Como configurar HTTPS no Linux.

O instalador do pacote permite o pré-carregamento de outras propriedades avançadas (como host de banco e tokens) via debconf. Para injetá-las antes de prosseguir, consulte a seção Informações Adicionais no final deste guia.

3. Guia de instalação do ONLYOFFICE Docs (Via APT)

Adicione a chave criptográfica GPG do repositório remoto ao seu sistema:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys CB2DE8E5

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

echo "deb https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

Nota de Distribuição: Apesar do pacote binário do APT carregar o codinome do Debian Squeeze, ele foi arquitetado para ser retrocompatível com todos os derivados do Debian (incluindo as versões LTS do Ubuntu), garantindo que o repositório funcione perfeitamente sobre a sua infraestrutura.

Aviso de Fontes Opcionais: Ao instalar o ONLYOFFICE Docs no Debian puro, assegure-se de que o componente contrib esteja devidamente ativado no seu arquivo /etc/apt/sources.list. Consulte a documentação do Debian para mais detalhes.

Atualize a árvore de indexação do gerenciador de pacotes local:

sudo apt-get update

Instale os utilitários de suporte de fontes Microsoft:

sudo apt-get install ttf-mscorefonts-installer

Por fim, baixe e instale o pacote corporativo do ONLYOFFICE Docs:

sudo apt-get install onlyoffice-documentserver

Validação Interativa: Durante a etapa final do processo de instalação, a interface do terminal solicitará a injeção de uma senha para o usuário do PostgreSQL. Digite exatamente a mesma credencial (por exemplo: onlyoffice) que você configurou no banco de dados na Etapa 1.

Com o término da descompactação, o daemon do ONLYOFFICE Docs entrará na memória do sistema operacional como um processo ativo de background. Futuras manutenções poderão ser feitas simplesmente atualizando a cadeia local através do apt-get upgrade.

Para auditar o painel do sistema, acesse http://localhost através de um navegador da máquina. A página inicial do ONLYOFFICE Docs proverá instruções para ativar o conector de testes embutido ou engajar os endpoints da Documentação da API para roteamento web corporativo.

Executando o ONLYOFFICE Docs utilizando SSL/HTTPS

Para ambientes expostos na internet, trafegar a coautoria dos arquivos via HTTPS é um requisito crucial de segurança para blindar a infraestrutura contra interceptações maliciosas (packet sniffing). Para engajar os certificados TLS/SSL no proxy do servidor de documentos de forma confiável, siga o manual Mudando o ONLYOFFICE Docs para protocolo HTTPS no Linux.

Informações adicionais: Personalização de variáveis no debconf

O instalador do pacote suporta a declaração prévia de variáveis de ambiente diretamente na pipeline do debconf, o que é fundamental para engenheiros de DevOps automatizarem o processo (deploy em massa em clusters de servidores sem prompts interativos).

As chaves suportadas incluem propriedades de bancos externos, mensageria e chaves JWT:

Opções de Roteamento do PostgreSQL
- Defina o endereço host do banco relacional (substituindo <DB_HOST> pelo IP ou DNS interno do seu servidor de banco remoto):
```
echo onlyoffice-documentserver onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections
```
- Defina a root de usuário do PostgreSQL (substitua <DB_USER> pela role configurada):
```
echo onlyoffice-documentserver onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections
```
- Injete a credencial alfanumérica do PostgreSQL (substitua <DB_PASSWORD>):
```
echo onlyoffice-documentserver onlyoffice/db-pwd password <DB_PASSWORD> | sudo debconf-set-selections
```
- Mapeie o nome do esquema de banco provisionado no PostgreSQL (substitua <DB_NAME>):
```
echo onlyoffice-documentserver onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections
```

Opções de Roteamento do RabbitMQ

Defina o host do broker de mensagens (substitua <RABBITMQ_HOST> pelo endpoint do RabbitMQ):

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

Defina o usuário autorizado de mensageria (substitua <RABBITMQ_USER>):

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

Injete a credencial do broker RabbitMQ (substitua <RABBITMQ_PWD>):

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

Opções de Criptografia JWT (JSON Web Tokens)
O uso do debconf-set-selections também protege as suas chaves e propriedades personalizadas, impedindo que o script de atualização as sobrescreva fisicamente dentro do arquivo de registro local.json durante upgrades no sistema.
- Habilite a autenticação de payloads baseada em tokens JWT (obrigatório para conexões corporativas fechadas):
```
echo onlyoffice-documentserver onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections
```
- Assine digitalmente a comunicação declarando uma Chave Secreta única (substitua a string de hash em <JWT_SECRET> pelo valor hexadecimal ou texto da sua chave):
```
echo onlyoffice-documentserver onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections
```

Instalando o ONLYOFFICE Docs no Ubuntu e Debian (arm64)