Conectando o Nextcloud ao CODE Docker: Configuração e vantagens e desvantagens

Conecte o Nextcloud ao Collabora CODE executando a collabora/codeimagem oficial, restringindo a porta ao host, roteando um subdomínio HTTPS do escritório por meio de um proxy reverso compatível com WebSocket e configurando esse URL público na integração do Nextcloud com o Collabora. Dez minutos só são viáveis ​​se o Docker, o DNS, o TLS e o proxy estiverem prontos.

Escolha primeiro o serviço de escritório adequado. A partir de outubro de 2026, o Nextcloud diferencia o Nextcloud Office, baseado no EuroOffice, do Collabora Online. O CODE é a Edição de Desenvolvimento do Collabora Online, portanto, use a integração com o Collabora, não o conector do EuroOffice. O aplicativo CODE integrado é o mais rápido para uso pessoal, mas o Nextcloud o descreve como mais lento e com escalabilidade limitada. Um contêiner separado é mais fácil de gerenciar de forma independente, mas adiciona trabalho de proxy e atualização. O CODE é adequado para uso doméstico e testes; escolha uma implementação do Collabora Online com suporte quando a empresa precisar de suporte em produção.

Antes de começar: o caminho de dez minutos

Tenha um endereço HTTPS do Nextcloud funcionando, um nome de host separado para o escritório com TLS válido e acesso ao Docker no host do CODE. Aponte o nome de host do escritório para um proxy reverso que possa rotear para o contêiner. Tanto os navegadores dos usuários quanto o servidor Nextcloud devem acessar a URL do escritório.

Se o DNS ou TLS não estiverem prontos, não exponha a porta 9980 publicamente como um atalho. Vincule-a ao loopback e finalize a configuração do proxy primeiro.

1. Inicie o contêiner Docker do CODE.

Substitua o nome de host de exemplo do Nextcloud pela origem HTTPS exata que os usuários utilizam para fazer login. Essa aliasgroup1configuração restringe a qual host WOPI (o serviço de arquivos que fornece documentos ao editor) pode se conectar. Não utilize um caractere curinga apenas para fazer uma conexão com falha desaparecer.

docker pull collabora/code

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

A vinculação 127.0.0.1mantém a porta privada, permitindo que um proxy no mesmo host acesse a porta. Se o seu proxy estiver em outro local, permita que apenas esse proxy confiável se conecte à porta 9980.

Verifique se o contêiner foi iniciado e se o ponto de extremidade de descoberta responde localmente:

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-kIgnora a validação de certificado apenas para esta verificação local de certificado autoassinado; não corrige um certificado público inválido.

2. Coloque o nome de host do escritório público atrás de HTTPS.

Utilize https://office.example.comseu proxy reverso com um certificado válido e direcione as solicitações para o CODE. As diretrizes de proxy da Collabora abrangem recursos do editor, descoberta/capacidades /cool/e encaminhamento de WebSocket. Sem as atualizações do WebSocket, a página pode carregar, mas o editor apresentará falhas.

Utilize a configuração padrão do seu software proxy. Se ele encerrar o TLS antes do CODE, siga as configurações de TLS do backend documentadas; não desative as verificações de certificado globalmente.

3. Conecte a integração do Collabora no Nextcloud.

No Nextcloud, habilite ou instale o aplicativo de integração do Collabora disponível para a sua versão. Em seguida, abra a área administrativa do Office e insira a URL pública do Collabora https://office.example.com. Os manuais atuais denominam a configuração como "Servidor Online do Collabora"; a nomenclatura e os nomes dos aplicativos podem variar de acordo com a versão, especialmente com a adição da opção Euro-Office pelo Nextcloud. Selecione Collabora Online para este servidor CODE. Não insira o endereço somente do contêiner, https://127.0.0.1:9980a menos que o próprio Nextcloud esteja sendo executado no mesmo host e esse endereço também seja o endpoint de serviço configurado; na configuração de proxy recomendada, use o nome de host público do Office.

Salve a configuração e execute a verificação de conexão integrada, caso sua versão a ofereça. Se falhar, compare a origem exata do Nextcloud em aliasgroup1, confirme se tanto o Nextcloud quanto o navegador conseguem resolver e acessar o nome do host do escritório e inspecione os logs do proxy reverso em busca de caminhos negados ou erros de WebSocket.

4. Verifique a edição e, em seguida, escolha se o CÓDIGO é adequado.

Abra um pequeno documento de teste no Nextcloud e confirme se ele abre no editor do navegador, aceita uma alteração, salva e reabre com a alteração intacta. Teste a partir de uma conta de usuário normal e também de uma conta de administrador. Uma verificação de descoberta bem-sucedida por si só confirma que o CODE responde; não prova que a autorização WOPI, os WebSockets proxy e as operações de salvamento de documentos funcionam corretamente.

Para um servidor pessoal ou uma pequena equipe, o CODE Docker separa o editor da pilha PHP do Nextcloud. Você também controla o proxy, reinicializações, verificações de compatibilidade e atualizações de imagem. O aplicativo CODE integrado é mais simples, mas compartilha o host e tem menos recursos de escalabilidade. Para uma organização que depende de edição diária, avalie um serviço Collabora Online com suporte em vez de considerar o CODE como garantia de produção.

Quando estiver pronto para atualizar o CÓDIGO, baixe a nova imagem e recrie o contêiner com as mesmas opções. Revise as notas de versão e teste a abertura e o salvamento de documentos antes de atualizar um serviço do qual os usuários dependem; a latesttag pode mudar. Fixe uma versão específica da imagem quando implantações repetíveis forem importantes.

Verificação

A configuração está funcionando quando o nome de host do escritório público apresenta um certificado válido, a verificação de conexão do Nextcloud é bem-sucedida e um documento de teste abre, salva e reabre pelo editor. Se a página inicial do escritório carregar, mas a edição travar, verifique o encaminhamento do WebSocket. Se o Nextcloud informar que o host não está autorizado, corrija aliasgroup1para corresponder à origem real do Nextcloud. Se o CODE responder localmente, mas não nos navegadores dos usuários, verifique o DNS público, o roteamento do firewall e o proxy reverso.

Referências: Exemplo de instalação do Docker no Nextcloud ; Opções de instalação do Nextcloud Office ; Configuração do Nextcloud Collabora ; Configurações de proxy reverso do Collabora ; Detalhes da imagem Docker oficial do CODE ; Opções do Nextcloud Hub 26 Summer Office .