Pular para o conteúdo principal

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 os editores online com a plataforma de colaboração da ONLYOFFICE ou com outros sistemas populares (veja a lista detalhada de recursos). 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, mas depende do SO host. Quanto mais, melhor
  • HDD: pelo menos 40 GB de espaço livre
  • SWAP: pelo menos 4 GB, mas depende do SO host. Quanto mais, melhor
  • SO: Debian 12, Ubuntu 18.04 de 64 bits ou outra distribuição compatível
  • Requisitos adicionais
    • NGINX: versão 1.30 ou posterior

Instalando o ONLYOFFICE Docs​

A instalação em distribuições baseadas em Debian também exige o NGINX instalado.

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

Existem outras dependências 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 posterior. Distribuições mais antigas podem exigir a instalação manual.

Instalando dependências​

O ONLYOFFICE Docs utiliza o NGINX 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 NGINX​

sudo apt-get install nginx
observação

No Ubuntu 18.04, instale o pacote nginx-extras em vez disso: sudo apt-get install nginx-extras

Importante

Se você planeja executar o ONLYOFFICE Docs na porta 80, desative agora o site padrão do NGINX. Caso contrário, o ONLYOFFICE Docs pode não funcionar corretamente. Para isso, execute os seguintes comandos:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

Dependendo de como o NGINX foi instalado, um dos dois primeiros comandos pode informar que o arquivo não existe. Você pode ignorar essa mensagem com segurança.

Alterando a porta padrão do ONLYOFFICE Docs​

Por padrão, o ONLYOFFICE Docs escuta as conexões de entrada na porta 8083. A partir da versão 4.3, você pode alterar a porta do ONLYOFFICE Docs se planeja usar outra em vez da padrão.

observação

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

Para isso, você precisará alterar a porta padrão no sistema debconf executando o comando:

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

Substitua <PORT_NUMBER> no comando acima pelo número da porta desejada.

observação

Se você definir a porta como 80, certifique-se de ter desativado o site padrão do NGINX, conforme descrito na seção Instalando o NGINX.

Aviso

Se você quiser alterar o protocolo do ONLYOFFICE Docs para HTTPS, não altere a porta para 443; em vez disso, utilize este guia.

Existem opções adicionais que podem ser usadas na instalação do ONLYOFFICE Docs. Leia esta seção para obter mais informações sobre elas.

Depois disso, você pode continuar com a instalação do ONLYOFFICE Docs.

Guia de instalação do ONLYOFFICE Docs​

Adicione a chave GPG:

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:

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
observação

Embora o pacote APT seja criado para o Debian Squeeze, ele é compatível com vários derivados do Debian (incluindo o Ubuntu), o que significa que você pode usar o mesmo repositório em todas essas distribuições.

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

Atualize o cache do gerenciador de pacotes:

sudo apt-get update

Instale as mscorefonts:

sudo apt-get install ttf-mscorefonts-installer

Instale o ONLYOFFICE Docs:

sudo apt-get install onlyoffice-documentserver

Depois disso, o ONLYOFFICE Docs será executado como um processo. O pacote será atualizado como qualquer outro pacote deb.

Agora você pode digitar http://localhost:8083 na barra de endereços do navegador para abrir a página de boas-vindas do ONLYOFFICE Docs, onde encontrará mais instruções sobre como ativar os exemplos de documentos ou integrar os editores online ao seu aplicativo web usando a API fornecida.

Executando o ONLYOFFICE Docs usando HTTPS​

Na maioria dos casos, acessar o portal pelo protocolo HTTPS é muito mais seguro do que pelo HTTP, usado por padrão. Você pode executar facilmente o ONLYOFFICE Docs usando uma conexão segura. Veja os detalhes aqui para saber mais sobre como fazer isso.

Informações adicionais: mais opções para a instalação do ONLYOFFICE Docs​

A instalação do ONLYOFFICE Docs permite o uso de mais opções do debconf, que podem ser muito úteis caso você planeje instalá-lo em mais de um servidor ou em outros casos.

Essas opções incluem:

  • Opções JWT

    Você pode usar o debconf-set-selections para impedir que os valores personalizados no arquivo local.json sejam substituídos após a atualização do ONLYOFFICE Docs.

    • Ative os JSON Web Tokens (JWT):

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

    • Defina uma chave secreta JWT substituindo <JWT_SECRET> pelo seu próprio valor:

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