ONLYOFFICE DocSpace 3.7 lançado: geração de arquivos e novos provedores em agentes de IA, formulários mais inteligentes, agrupamento de salas e muito mais
ONLYOFFICE DocSpace 3.7 lançado

Instalando o ONLYOFFICE Docs Enterprise Edition (Debian ARM64)

Introdução

A partir da versão 7.1, o ONLYOFFICE Docs pode ser instalado de forma nativa em sistemas Debian para a arquitetura ARM de 64 bits.

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

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

Principais Funcionalidades:

  • Document Editor
  • Spreadsheet Editor
  • Presentation Editor
  • Visualizadores e editores web otimizados para dispositivos 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 Enterprise Edition.

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

  • Compartilhar arquivos;
  • Gerenciar direitos de acesso rigorosos a documentos;
  • Incorporar documentos em um site;
  • Visualizar e editar arquivos armazenados em serviços conectados, como Google Drive, Box, Dropbox, OneDrive e OwnCloud.

Este guia demonstrará como instalar o ONLYOFFICE Docs Enterprise Edition versão 7.1 e posteriores no Ubuntu 18.04 ou Ubuntu 20.04 para a arquitetura ARM de 64 bits.

Requisitos de sistema

  • CPU
    Processadores ARM de 64 bits
  • RAM
    Mínimo de 2 GB (A necessidade depende do SO host; quanto mais memória, melhor)
  • HDD / SSD
    Pelo menos 40 GB de espaço livre
  • SWAP
    Pelo menos 4 GB (A eficiência do Swap depende do SO host)
  • SO
    Ubuntu 18.04 ou Ubuntu 20.04 (arm64)
    Nota: Atualmente, o Ubuntu 16.04 não é suportado.
  • Requisitos 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
    • Redis: versão 4 ou posterior
    • RabbitMQ

Instalando o ONLYOFFICE Docs

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

Todas as instruções necessárias para a instalação desses componentes e de suas dependências podem ser encontradas em seus respectivos sites oficiais.

Existem outras dependências 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 18.04 LTS ou Ubuntu 20.04 LTS.

Instalando e configurando dependências

O ONLYOFFICE Docs utiliza o NGINX como proxy e o PostgreSQL como banco de dados. As dependências encontradas no repositório do sistema serão instaladas automaticamente durante a instalação do ONLYOFFICE Docs usando o comando apt-get install.

Instalando o PostgreSQL:

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

sudo apt-get install postgresql
Se você deseja instalar alguma outra versão do PostgreSQL diretamente do Repositório oficial do PostgreSQL, consulte a documentação do PostgreSQL para obter mais detalhes.

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

Importante: O usuário do banco de dados deve obrigatoriamente ter o nome onlyoffice. Você pode especificar qualquer senha. No exemplo abaixo, usamos a senha "onlyoffice". 
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 ONLYOFFICE Docs (Opcional)

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

Se você for alterar a porta padrão, certifique-se de que ela esteja aberta no firewall para as conexões de entrada e saída. Veja a lista completa de portas usadas pelo ONLYOFFICE Docs.

Para fazer isso, você precisará alterar a configuração da porta registrando a mudança no sistema debconf executando o comando abaixo:

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

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

Aviso de Segurança: Se o seu objetivo for alterar o protocolo do ONLYOFFICE Docs para HTTPS, não altere a porta para 443 nesta etapa. Em vez disso, utilize esta instrução de configuração HTTPS posteriormente.

Existem opções adicionais que podem ser injetadas para a instalação do ONLYOFFICE Docs. Leia esta seção avançada no fim da página para obter mais informações sobre elas. Depois disso, você pode continuar com a instalação dos pacotes.

Instalando os pacotes do ONLYOFFICE Docs

Adicione a chave pública GPG para validar os pacotes:

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

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

echo "deb https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list
Embora o pacote APT seja nomeado para o "Debian Squeeze" (uma versão legada), ele é totalmente compatível com vários derivados modernos do Debian (incluindo o Ubuntu atual), o que significa que você pode usar o mesmo repositório em todas essas distribuições.

Ao instalar o ONLYOFFICE Docs em um sistema Debian puro, certifique-se de adicionar o componente contrib ao seu arquivo /etc/apt/sources.list. Para saber mais, consulte a documentação oficial do Debian.

Atualize o cache local do gerenciador de pacotes:

sudo apt-get update

Instale as fontes nativas da Microsoft (mscorefonts) para manter a compatibilidade da renderização dos textos:

sudo apt-get install ttf-mscorefonts-installer

Por fim, instale o ONLYOFFICE Docs Enterprise Edition:

sudo apt-get install onlyoffice-documentserver-ee
Durante o processo de extração e instalação, o terminal solicitará que você forneça a senha do usuário PostgreSQL onlyoffice. Digite exatamente a senha que você especificou ao configurar o banco de dados nos passos anteriores.

Após a conclusão, o ONLYOFFICE Docs será executado como um processo em segundo plano. O pacote poderá ser atualizado no futuro como qualquer outro pacote DEB tradicional do seu sistema.

Agora você pode digitar http://localhost (ou o endereço de IP público do servidor) na barra de endereços do seu navegador para abrir a página de boas-vindas do ONLYOFFICE Docs. Lá, você encontrará exemplos de documentos interativos e guias sobre como integrar os editores online na sua aplicação web usando a API fornecida.

Executando o ONLYOFFICE Docs usando HTTPS

Na maioria dos casos em ambientes de produção, acessar o portal corporativo via protocolo criptografado HTTPS é imensamente mais seguro do que através da conexão HTTP usada por padrão. Você pode configurar facilmente o ONLYOFFICE Docs para responder usando certificados SSL seguros. Veja os detalhes de como fazer isso na documentação de implementação HTTPS.

Registrando a sua versão Enterprise Edition

Se você adquiriu uma assinatura corporativa do Enterprise Edition e recebeu o seu arquivo license.lic, você deve alocá-lo na sua instalação para desbloquear as métricas da versão completa do software.

Sendo usuário de uma distribuição Linux baseada em Debian, faça upload ou mova o arquivo license.lic para a seguinte pasta raiz:

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

Depois disso, o servidor processará a validação da sua licença e o Enterprise Edition se tornará registrado e operante sem as limitações da versão gratuita.

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

O instalador debian do ONLYOFFICE Docs permite a pré-configuração de diversas opções do debconf, o que é de grande utilidade caso você planeje implementá-lo via scripts automatizados (como Ansible, Bash, etc.) ou caso o seu banco de dados esteja instalado em um servidor físico secundário remoto.

As opções de customização por linha de comando incluem:

Opções de banco de dados PostgreSQL

  • Definir o endereço do host do banco de dados (Substituindo <DB_HOST> pelo endereço real do servidor PostgreSQL):

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

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

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

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

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

  • Definir o nome personalizado do banco de dados (Schema):

    echo onlyoffice-documentserver-ee onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections
Opções do Redis

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

    echo onlyoffice-documentserver-ee onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections
Opções do RabbitMQ

  • Definir o endereço IP de host do serviço de filas RabbitMQ:

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

  • Definir o nome de usuário do RabbitMQ:

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

  • Definir a senha de acesso do usuário do RabbitMQ:

    echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections
Segurança: Opções JWT (JSON Web Tokens)

Você pode usar o utilitário debconf-set-selections para fixar e proteger suas chaves customizadas, impedindo que os valores contidos no arquivo local.json sejam apagados ou sobrescritos após uma atualização de versão do ONLYOFFICE Docs.

  • Habilitar a autenticação de segurança via JSON Web Tokens (JWT) nas requisições:

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

  • Definir uma chave secreta e criptográfica JWT segura (substituindo o argumento <JWT_SECRET> pelo seu próprio Hash):

    echo onlyoffice-documentserver-ee onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections
Artigo com o tag:
Veja todas as etiquetas