Exemplo ilustrativo: Imagine uma pequena equipe cujos arquivos do Nextcloud estão hospedados em https://cloud.example.com. O administrador deseja um servidor separado do Collabora Online Development Edition (CODE) em https://office.example.com. Esta é uma configuração hipotética para explicar os passos, não um relato de uma instalação real. Substitua ambos os nomes de host de exemplo por domínios que você controla.
O CODE funciona como um serviço separado do Nextcloud. O Docker inicia o serviço Collabora; um proxy reverso TLS o publica; e a integração do Nextcloud Office conecta os dois. Seu navegador precisa acessar o URL público do Office, e os servidores precisam acessar os endpoints relevantes do Nextcloud e do Collabora. O manual de instalação atual do Nextcloud Office descreve o Docker como uma opção de implantação e observa que um servidor dedicado geralmente precisa de um proxy reverso.
Antes de começar
Para exemplificar, suponha que um host Linux possa executar o Docker, o Nextcloud já funcione via HTTPS e os registros DNS para ambos os nomes de host apontem para os servidores corretos. Obtenha um certificado TLS válido para o host office.example.com. Planeje expor o serviço Collabora por meio desse nome de host, em vez de abrir sua porta Docker diretamente para a internet pública.
- Confirme se o host CODE consegue resolver e conectar-se a
cloud.example.com.
- Confirme se os navegadores conseguem acessar o site
https://office.example.comvia HTTPS.
- Escolha se o proxy reverso será executado no host Docker ou em outro local. Um proxy no mesmo host pode usar uma porta de contêiner publicada em loopback; um proxy em outro contêiner precisa de uma rede Docker compartilhada acessível ou de outra rota privada.
- Antes de usar o CODE em produção, verifique a documentação atual do CODE e do Nextcloud para obter informações sobre compatibilidade e requisitos de proxy. O CODE é a Edição de Desenvolvimento; equipes que precisam de estabilidade ou suporte do fornecedor devem avaliar uma oferta do Collabora Online com suporte.
Os comandos abaixo usam o collabora/codenome oficial da imagem e uma única origem do Nextcloud. Os exemplos não definem uma tag de lançamento, portanto, o administrador deve definir uma política de versionamento e atualização, em vez de tratá-la latestcomo uma estratégia de controle de alterações em produção.
1. Aponte o nome de host do escritório para o seu servidor.
Crie um registro DNS A ou AAAA office.example.comque aponte para o host ou balanceador de carga que serve o Collabora. Configure o proxy reverso para encerrar as conexões HTTPS com um certificado válido para esse nome e encaminhar os caminhos do aplicativo Collabora e o tráfego WebSocket para o contêiner CODE. A documentação oficial do Collabora sobre proxy reverso fornece exemplos específicos para cada proxy; use a seção correspondente ao seu software de proxy e à versão atual do CODE.
Não copie cegamente um trecho de código genérico de proxy. O proxy deve suportar atualizações do WebSocket, preservar as informações necessárias de host e protocolo encaminhado e repassar rotas do Collabora, como /browser`/ var/www/html`, /hosting/discovery`/ /coolvar/www/html` e `/var/www/html`. As diretivas exatas variam entre Apache, NGINX, Traefik e outros gateways. Se o proxy estiver sendo executado no host Docker, o encaminhamento para `/var/www/html` 127.0.0.1:9980é um destino privado comum. Se for um contêiner separado, esse endereço de loopback se refere ao próprio contêiner do proxy, não ao host do CODE.
2. Inicie o contêiner Docker do CODE.
No host Docker, faça o pull e inicie o contêiner. Neste exemplo, a porta está vinculada ao loopback, portanto, não está diretamente exposta em todas as interfaces de rede do host:
docker pull collabora/code
docker run -d --name collabora -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart always --cap-add MKNOD collabora/code
O aliasgroup1valor autoriza a origem Nextcloud que deverá usar este serviço CODE. Mantenha o esquema e o nome do host alinhados com a URL que as pessoas usam para acessar o Nextcloud; inclua uma porta não padrão se o serviço público do Nextcloud usar uma. Se várias instâncias do Nextcloud usarem o serviço, configure os grupos de hosts adicionais permitidos de acordo com a documentação atual da imagem CODE, em vez de permitir hosts arbitrários de forma ampla.
Este comando pressupõe que o proxy reverso esteja na mesma máquina e encaminhe as requisições para a porta de loopback. Se você estiver usando o Docker Compose, um proxy em contêiner ou um proxy remoto, ajuste as configurações de rede e a exposição de portas com cuidado. Evite expor a porta 9980 publicamente apenas para que uma conexão de proxy funcione; use uma rede Docker privada, uma regra de firewall ou outro caminho restrito. Para obter informações sobre as opções atuais da imagem Docker do CODE, consulte o guia do CODE Docker da Collabora .
3. Configure o proxy reverso e verifique o CÓDIGO.
Após configurar o proxy, recarregue-o usando o método do seu software e verifique a configuração antes de aplicar as alterações. Em seguida, solicite o endpoint de descoberta pública a partir de uma máquina que consiga acessar o domínio:
curl -fsS https://office.example.com/hosting/discovery | head
Uma resposta bem-sucedida deve conter informações de descoberta XML em vez de uma página de erro de proxy. Esta verificação confirma que a URL pública alcança um endpoint do Collabora; ela não comprova que a autorização do Nextcloud, WebSockets ou a edição de documentos estejam funcionando corretamente. Inspecione também o contêiner se o endpoint falhar:
docker ps --filter name=collabora
docker logs --tail=100 collabora
Na configuração hipotética, uma conexão recusada ao URL público aponta primeiro para DNS, TLS, firewall ou roteamento de proxy. Uma resposta 502 geralmente significa que o proxy não consegue alcançar o servidor upstream configurado no contêiner. Se a descoberta funcionar, mas o editor falhar posteriormente durante o carregamento, verifique o encaminhamento do WebSocket e se o proxy reporta uma atualização ou um erro do servidor upstream.
4. Conecte o Nextcloud ao Collabora
No Nextcloud, abra a área de Aplicativos e instale ou habilite a integração do Office oferecida para a sua versão. O nome do aplicativo pode ser “Nextcloud Office” ou “Collabora Online”, dependendo da versão e do catálogo de aplicativos instalados. Em seguida, abra as configurações de administração do Office e insira:
https://office.example.com
Salve a configuração e verifique o status da conexão. A documentação de configuração do Office do Nextcloud identifica este campo como a URL e a porta do servidor Collabora e recomenda o uso de HTTPS. Use a URL pública do Collabora que os navegadores conseguem acessar. Em instalações com DNS dividido, NAT ou redes segmentadas, o Nextcloud também pode precisar de uma rota interna para esse serviço; consulte as opções avançadas de conexão da sua versão do aplicativo instalada, em vez de presumir que o DNS público funciona a partir do servidor.
Por exemplo, o Nextcloud considera cloud.example.como host WOPI permitido e os navegadores dos usuários abrem o editor a partir dele office.example.com. Se a sua página de administração do Nextcloud oferece uma lista de permissões para solicitações WOPI, restrinja-a aos endereços esperados do servidor Collabora após confirmar os endereços corretos na sua rede. O Nextcloud recomenda limitar as solicitações WOPI aos hosts Collabora esperados; não adicione intervalos amplos sem uma justificativa específica para a sua rede.
5. Teste com um documento de exemplo.
Faça login como um usuário comum do Nextcloud, crie um pequeno documento de texto ou abra um arquivo de teste descartável e escolha o editor do navegador. Confirme se a barra de ferramentas do editor carrega, faça uma alteração inofensiva, aguarde o indicador de salvamento, feche o arquivo e abra-o novamente para verificar se a alteração foi aplicada. Se a instalação suportar edição simultânea, abra o mesmo arquivo de teste em uma segunda sessão de usuário e confirme se a presença ou as edições são atualizadas conforme o esperado.
Essas verificações separam as principais camadas: a solicitação de descoberta testa o roteamento público; o status do Nextcloud testa a conexão com o servidor configurado; abrir o editor testa o acesso do navegador e a troca WOPI; e reabrir o arquivo testa o caminho de salvamento. Não use um documento importante para o primeiro teste. O CODE é uma versão de desenvolvimento, portanto, um teste bem-sucedido não substitui a avaliação da disponibilidade, capacidade de recursos, backups e necessidades de suporte da sua organização.
Problemas comuns e o que verificar
O Nextcloud informa que o servidor está inacessível.
Verifique se o URL do Office contém erros de digitação, se a cadeia de certificados é válida e se o esquema HTTPS corresponde. Teste o URL de descoberta tanto em um navegador quanto no host do Nextcloud. Se o DNS público for resolvido de forma diferente dentro da rede do servidor, configure uma rota interna adequada ou use as configurações avançadas de URL do servidor compatíveis com seu conector.
A página abre, mas o editor de documentos trava.
Inspecione os logs de acesso e de erros do proxy reverso em busca de falhas na atualização do WebSocket. Confirme se o proxy está encaminhando as rotas atuais do Collabora e mantendo as conexões WebSocket de longa duração abertas. As ferramentas de desenvolvedor do navegador podem mostrar se a solicitação WebSocket foi rejeitada, redirecionada para HTTP ou bloqueada por um erro de certificado.
A Collabora rejeitou o host do Nextcloud.
Compare a origem real do Nextcloud, incluindo esquema, nome do host e porta, com o grupo de aliases configurado. Uma incompatibilidade entre um URL público, um nome de host interno e uma reescrita de proxy pode causar falhas de autorização de host ou WOPI. Adicione apenas o nome de host do Nextcloud pretendido à configuração permitida.
O código inicia e depois é encerrado ou apresenta problemas de funcionamento.
Analise docker logs collaborao disco e a memória disponíveis, as permissões do contêiner e os requisitos de tempo de execução da tag de imagem que você implantou. Evite copiar opções como o modo privilegiado de exemplos não relacionados, a menos que as instruções oficiais atuais para o seu ambiente exijam o seu uso.
Atualizações e cuidados operacionais
Mantenha a imagem do contêiner atualizada para segurança e compatibilidade, mas agende e teste as atualizações em vez de baixar uma nova imagem não revisada durante o horário comercial. Registre a versão que você está usando, leia as notas de versão relevantes e mantenha um caminho de reversão. Revise a configuração do proxy após alterações importantes no Collabora ou Nextcloud, pois os requisitos de endpoint e WebSocket podem evoluir. Monitore também a memória, a CPU, o armazenamento e os logs do contêiner do host à medida que o número de editores ativos aumenta.
Para a equipe hipotética, a instalação estará pronta para uso limitado somente após o endpoint de descoberta responder, o Nextcloud reportar uma conexão, o documento de exemplo abrir em um navegador e a edição salva permanecer após a reabertura. Se uma dessas verificações falhar, solucione o problema nessa camada antes de convidar os usuários a dependerem do serviço.
Referências oficiais
Documentação revisada em 6 de outubro de 2026. O manual estável do Nextcloud estava marcado como versão 35 quando verificado; o passo a passo do Docker vinculado é da versão 28, portanto, use-o como um exemplo de instalação e verifique a sintaxe do proxy em relação ao guia da Collabora e às versões que você realmente utiliza.