Configure Nextcloud com OnlyOffice Server 🔥 Guia completo de integração

Planeje os dois servidores e nomes de host

Esta configuração tem duas partes que funcionam juntas. Nextcloud armazena seus arquivos e contas de usuário, e o OnlyOffice Document Server faz a edição real de documentos e planilhas no navegador. Dê a cada um seu próprio nome de host desde o início: Nextcloud responde em cloud.example.com e o Document Server responde em office.example.com. Aponte ambos os registros DNS para seus servidores antes de começar, porque as configurações de conexão, a segurança JWT e os certificados HTTPS dependem de que esses nomes permaneçam fixos.

Instale o servidor Nextcloud

Primeiro instale o Nextcloud em seu servidor e conclua a configuração web - crie a conta de administrador e deixe-o se conectar ao seu banco de dados. Abra cloud.example.com no navegador e faça login com a conta de administrador para confirmar se o lado do armazenamento de arquivos está funcionando totalmente antes de trazer o servidor do escritório. Cada documento que você editar posteriormente com OnlyOffice ficará neste armazenamento Nextcloud.

Instale o servidor de documentos OnlyOffice

Agora instale o OnlyOffice Document Server — o serviço separado que renderiza e edita documentos, planilhas e apresentações. Nesta configuração ele é acessado como office.example.com, e antes de configurar o HTTPS ele responde na porta 8080 do servidor. O Document Server não possui armazenamento próprio de arquivos: o Nextcloud envia um arquivo, o usuário o edita no navegador e o resultado salvo volta para o Nextcloud.

Verifique o servidor de documentos com o Healthcheck

Antes de conectar qualquer coisa, prove que o Document Server está realmente em execução. Abra o endereço de verificação de integridade em um navegador:

http://your-server:8080/healthcheck

A página deve retornar exatamente uma palavra: true. Essa única palavra confirma que os serviços do Document Server estão ativos e prontos para aceitar conexões.

Instale o aplicativo ONLYOFFICE Connector

Faça login no Nextcloud como administrador, abra a seção Aplicativos e instale o aplicativo conector oficial do ONLYOFFICE. Este conector é a ponte entre os dois servidores: ele adiciona a página de configurações do OnlyOffice ao Nextcloud e faz com que os documentos sejam abertos no editor do OnlyOffice em vez de baixados. Ative o aplicativo depois de instalado.

Conecte os dois servidores — endereço e segredo JWT

Abra as configurações do ONLYOFFICE dentro da administração do Nextcloud e insira o endereço do Document Editing Service - o endereço HTTPS público do seu servidor de documentos:

https://office.example.com/

Em seguida, insira a chave secreta JWT — o mesmo segredo configurado no Document Server. Esse segredo compartilhado é como os dois servidores provam um ao outro que as solicitações são genuínas, para que ninguém possa fazer mau uso do seu serviço de edição. Salve as configurações; Nextcloud verifica a conexão com o Document Server enquanto salva.

Configurar HTTPS em ambos os servidores

Ambos os nomes de host — cloud.example.com e office.example.com — devem abrir via HTTPS com certificados válidos. Este não é um polimento opcional: a sessão de edição é executada dentro do navegador do usuário, portanto, o próprio navegador aplica as regras de segurança para ambos os servidores.

Faça sua primeira edição real

Acesse Arquivos no Nextcloud e crie ou abra uma planilha ou documento. Em vez de ser baixado, o arquivo agora abre dentro do editor OnlyOffice diretamente no navegador – o mesmo estilo de trabalho do Planilhas Google ou do Google Docs, mas hospedado inteiramente por você. Digite algo, deixe salvar e feche o arquivo: a versão editada está de volta ao armazenamento Nextcloud. Seu escritório auto-hospedado está ativo.