Conecte o Nextcloud a um contêiner Collabora CODE auto-hospedado.

Para conectar o Nextcloud a um contêiner do Collabora Online Development Edition (CODE) auto-hospedado, execute o CODE em um nome de host separado, configure-o com HTTPS e insira seu URL público no Nextcloud Office. O contêiner do CODE também deve permitir a origem do site do Nextcloud como um host WOPI. No exemplo abaixo, Nextcloud é `<nome_do_host>` cloud.example.come Collabora é `<nome_do_host>` office.example.com; substitua ambos pelos seus nomes de host reais.

O que deve estar pronto antes de começar?

Você precisa de uma instalação funcional do Nextcloud, um host Docker capaz de executar o contêiner CODE, registros DNS para os nomes de host do Nextcloud e do Collabora, e certificados HTTPS válidos para ambos os sites públicos. O host do Nextcloud e o servidor Collabora devem conseguir se comunicar pela rede. Um servidor Collabora dedicado visa melhorar a capacidade em relação à opção CODE integrada; como ainda está em fase de desenvolvimento, verifique os termos e diretrizes de lançamento atuais do Collabora antes de usá-lo para uma implementação maior ou crítica para os negócios.

Este guia pressupõe que um proxy reverso esteja em execução no host Docker e encaminhe o tráfego HTTPS para office.example.coma porta local do contêiner. Se o seu proxy estiver em execução em um contêiner diferente ou em outra máquina, não copie o mapeamento da porta de loopback sem alterações: use uma rede Docker privada ou um endereço de host privado que o proxy possa alcançar e configure um firewall para proteger o backend contra exposição pública.

1. Inicie o contêiner CODE

Primeiro, baixe a imagem e inicie um contêiner. Na configuração do alias, use o endereço IP público do Nextcloud, incluindo o protocolo e a porta. Não inclua a URL do Collabora. O exemplo de instalação do Docker do Nextcloud usa este padrão:

docker pull collabora/code
docker run -t -d -p 127.0.0.1:9980:9980 \
  -e 'aliasgroup1=https://cloud.example.com:443' \
  --restart always \
  --cap-add MKNOD \
  collabora/code

O vínculo de loopback significa que a porta 9980 só pode ser acessada a partir do host Docker, por exemplo, por um proxy reverso nesse mesmo host. O proxy fornece aos navegadores e ao Nextcloud um endpoint HTTPS público, mantendo a porta do contêiner privada. Se o Nextcloud for servido em uma porta não padrão ou por meio de um nome de host público diferente, faça com que o alias corresponda à origem que os usuários realmente utilizam. Se você tiver várias instâncias do Nextcloud, configure cada host WOPI permitido usando a sintaxe documentada da Collabora, em vez de permitir domínios arbitrários de forma ampla.

O comando acima segue o exemplo do Docker do manual de administração do Nextcloud 35. Antes de usar em produção, revise a documentação atual da imagem CODE e escolha uma política de atualização de versão/tag que se adeque ao seu processo de manutenção. A referência da imagem padrão pode ser alterada conforme as versões forem publicadas; planeje as atualizações, monitore o contêiner e teste novamente a edição de documentos após as atualizações.

2. Coloque o contêiner atrás do proxy reverso HTTPS.

Configure seu proxy existente para servir https://office.example.come encaminhar solicitações para o serviço CODE em 127.0.0.1:9980. Use a configuração de proxy reverso atual da Collabora para seu software de proxy. O proxy deve preservar os caminhos necessários e suportar atualizações do WebSocket; a sessão do navegador do editor depende disso. O exemplo do Nextcloud com Docker inclui rotas para /browser, /hosting/discovery, /hosting/capabilitiese /cool, incluindo o endpoint do WebSocket. Algumas integrações também usam a /loolrota de compatibilidade.

Não considere o carregamento bem-sucedido da página inicial como prova de que o proxy está funcionando corretamente. Um proxy que lida com solicitações HTTPS comuns, mas não consegue atualizar as conexões WebSocket, pode exibir o frame do editor e, em seguida, deixá-lo carregando ou desconectado. Use um certificado público válido para o nome de host do Collabora. Mantenha a porta 9980 fechada para a internet pública quando o proxy for o único ponto de entrada.

3. Ative o Nextcloud Office e insira o URL do servidor.

No Nextcloud, abra Aplicativos e instale ou habilite o Nextcloud Office (a richdocumentsintegração). Em seguida, abra Configurações de administração → Office , escolha a opção de servidor Collabora externo e insira o endereço https://office.example.com. Salve a configuração. Use a URL pública, não o endereço localhost:9980do servidor: o servidor Nextcloud e os navegadores dos usuários precisam resolver o mesmo endpoint externo do Collabora.

O manual de administração do Nextcloud indica que a URL do servidor configurada deve usar o mesmo protocolo da instalação do Collabora e recomenda o uso de HTTPS. Após salvar, o Nextcloud pode exibir um status de conectividade ou descoberta. Se ele reportar um problema com certificado, DNS ou WOPI, resolva essa verificação específica antes de tentar abrir um arquivo.

4. Verifique o caminho WOPI e abra um documento de teste.

O WOPI é o protocolo que o Nextcloud usa para conceder ao Collabora acesso controlado a um documento. Nas configurações de administração do Office no Nextcloud, revise a lista de permissões para solicitações WOPI e restrinja as solicitações aos endereços IP de onde o seu serviço Collabora acessa o Nextcloud. Configure também o Collabora para aceitar apenas o host WOPI pretendido. O endereço exato pode variar quando contêineres, NAT ou um proxy reverso estão envolvidos; portanto, use o endereço de origem que o Nextcloud realmente vê em seus logs, em vez de tentar adivinhar.

Para verificar a funcionalidade, faça login como um usuário normal do Nextcloud, crie ou carregue um pequeno arquivo DOCX ou ODT e abra-o em Arquivos. Confirme se o editor carrega, faça uma alteração inofensiva, aguarde o indicador de salvamento, feche o documento, abra-o novamente e confirme se a alteração foi mantida. Teste com cada tipo de arquivo e grupo de usuários relevantes para sua implementação; um teste bem-sucedido com um arquivo DOCX não comprova que todos os formatos ou permissões estejam configurados corretamente.

O que você deve verificar se o editor não abrir?

• Erro de descoberta ou conexão: Confirme se o office.example.comendereço IP está sendo resolvido pelo servidor Nextcloud e pelo navegador, se o certificado é válido e se o proxy está enviando as requisições /hosting/discoverypara o CODE.
• Carregamento infinito ou editor desconectado: verifique o tratamento de atualizações do WebSocket no proxy reverso e as /coolrotas. Analise os logs do proxy e do contêiner em busca de solicitações rejeitadas.
• Host WOPI rejeitado: Compare a configuração aliasgroup1com a origem pública exata do Nextcloud, incluindo esquema e porta. Verifique a lista de permissões WOPI do Nextcloud em relação ao IP de origem do Collabora visível para o Nextcloud.
• Funciona no host, mas não no Nextcloud: Teste a conectividade do servidor Nextcloud com a URL pública do Collabora. O nome de host interno de um contêiner ou o endereço localhost do host Docker não são automaticamente acessíveis a partir de todos os outros contêineres.
• Aviso de certificado: Corrija a incompatibilidade da cadeia de certificados ou do nome do host. Desativar a verificação de certificado pode ocultar a causa e enfraquecer a conexão.

Para diagnóstico, compare sua configuração com o exemplo oficial de instalação do Nextcloud em Docker , as orientações de configuração do Office e do WOPI e a documentação da imagem Docker CODE e do proxy reverso da Collabora . Essas referências são versionadas e podem sofrer alterações; os comandos aqui refletem o exemplo de administração do Nextcloud 35 disponível em 10 de outubro de 2026.