Instalando o ONLYOFFICE Docs Developer Edition (Debian ARM64)

Introdução

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

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

O ONLYOFFICE Docs é um pacote office online corporativo que compreende visualizadores e editores para textos, planilhas e apresentações. Ele é totalmente compatível com os formatos Office Open XML (.docx, .xlsx, .pptx) e permite 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 todos os formatos populares: DOC, DOCX, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, XLSX, CSV, PPTX, HTML

Consulte a lista detalhada de recursos disponíveis para o ONLYOFFICE Docs Developer Edition.

Este guia demonstrará como instalar o ONLYOFFICE Docs Developer 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 com arquitetura ARM de 64 bits
• 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)
• Sistema Operacional
  Ubuntu 18.04 ou Ubuntu 20.04 (arm64)
  Nota de Compatibilidade: Atualmente, distribuições legadas como o Ubuntu 16.04 não são mais suportadas.
• 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
  • 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 exige a presença prévia do libstdc++6, NGINX e PostgreSQL no sistema.

O ONLYOFFICE Docs possui dependências adicionais obrigatórias que costumam ser instaladas de forma nativa ao usar as versões recomendadas do Ubuntu LTS:

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

1. 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 e instaladas automaticamente durante a instalação principal usando o comando apt-get install.

Instalando o PostgreSQL:

Instale a versão do PostgreSQL incluída na sua versão do Ubuntu executando:

sudo apt-get install postgresql

Após a instalação bem-sucedida do PostgreSQL, 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

2. 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 físico, é recomendável alterar essa porta.

Para alterar a porta padrão, registre a sua escolha no sistema debconf utilizando o comando abaixo (substitua <PORT_NUMBER> pelo número da porta desejada):

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

Existem opções avançadas adicionais que podem ser injetadas para a instalação. Leia a seção de parâmetros extras no fim da página para obter mais informações sobre elas antes de continuar.

3. Instalando os pacotes do ONLYOFFICE Docs

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

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

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

Ao instalar o ONLYOFFICE Docs no Debian puro, adicione o componente contrib ao seu arquivo /etc/apt/sources.list. Para saber mais sobre essa diretiva, consulte a documentação do Debian.

Atualize o cache local do gerenciador de pacotes do servidor:

sudo apt-get update

Instale as fontes essenciais da Microsoft para garantir total compatibilidade de renderização de textos e formatação:

sudo apt-get install ttf-mscorefonts-installer

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

sudo apt-get install onlyoffice-documentserver-de

Ao finalizar o download e a extração, o ONLYOFFICE Docs será inicializado como um serviço em segundo plano. O pacote poderá ser atualizado normalmente com os comandos apt convencionais no futuro.

Agora você pode digitar http://localhost (ou o IP externo do servidor) na barra de endereços do seu navegador para abrir a página de boas-vindas do ONLYOFFICE Docs. Lá, você encontrará testes práticos e guias técnicos de pareamento para integrar a API com a sua aplicação web utilizando as diretrizes da API fornecida.

Executando o ONLYOFFICE Docs usando HTTPS

Para prover tráfego seguro em ambientes corporativos e aplicações reais, operar o portal sob o protocolo criptografado HTTPS é extremamente necessário. Você pode configurar o ONLYOFFICE Docs para responder usando certificados SSL (como Let's Encrypt ou certificados próprios) acompanhando as instruções de ativação HTTPS aqui.

Registrando a sua chave Developer Edition

Se você assinou o plano e possui a licença comercial Developer Edition e recebeu o arquivo de autenticação license.lic, você deve alocá-lo no servidor para desbloquear todos os limites estruturais do software.

Em instalações Linux baseadas em Debian e Ubuntu, faça upload e mova o arquivo license.lic estritamente para o seguinte diretório do sistema:

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

Após posicionar o arquivo, os serviços validarão a chave em background e a sua instância do Developer Edition estará operante, registrada e completa.

Informações Avançadas: Argumentos extra do DEBCONF

O instalador debian do ONLYOFFICE Docs oferece a pré-configuração direta de diversas opções do sistema debconf, o que é valioso para provisionamentos baseados em scripts ou para implantações onde os serviços (como o banco de dados) não ficam fisicamente no mesmo servidor do ONLYOFFICE.

Abaixo estão os parâmetros que você pode injetar no sistema via terminal:

Opções de conexão com o banco de dados PostgreSQL

• Definir o endereço (Host) do servidor PostgreSQL (Substitua <DB_HOST> pelo IP da máquina com o serviço):

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

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

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

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

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

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

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

Opções de conexão com o Redis

• Definir o endereço IP (Host) do serviço de cache Redis:

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

Opções de conexão com o RabbitMQ

• Definir o endereço IP (Host) da fila de mensagens RabbitMQ:

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

• Definir o usuário da fila RabbitMQ:

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

• Definir a senha de autorização do usuário do RabbitMQ:

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

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

Você pode utilizar a ferramenta debconf-set-selections para aplicar e fixar as suas chaves no sistema, desativando o comportamento padrão de substituição dos valores no arquivo local.json durante as atualizações futuras de versão do ONLYOFFICE Docs.

• Habilitar a segurança e autenticação via JSON Web Tokens (JWT):

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

• Definir e travar uma chave criptográfica customizada (Secret JWT) no sistema:

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