Como configurar o Nextcloud Office com o CODE Docker em 10 minutos

Nota atualizada para 2026: A documentação do Nextcloud 35 agora separa o Nextcloud Office , que utiliza o Euro-Office, do Collabora Online , que continua sendo uma alternativa com suporte e ainda pode ser hospedado localmente com a imagem Docker oficial do CODE. Este guia utiliza o caminho externo Collabora/CODE. A nomenclatura é importante porque guias mais antigos frequentemente descrevem o CODE como se fosse o único servidor por trás do “Nextcloud Office”. Consulte a visão geral atual do Nextcloud Office antes de aplicar instruções escritas para versões anteriores.

Se o seu site Nextcloud já funciona com HTTPS, o Docker está instalado e você já tem um nome DNS office.example.compronto para o Collabora, a integração em si pode ser concluída em cerca de 10 minutos. A propagação de DNS, a emissão de certificados, as alterações de firewall ou a resolução de problemas com um proxy reverso podem levar mais tempo e não estão incluídas nessa estimativa.

O que você precisa antes de começar

O caminho rápido pressupõe uma instância existente do Nextcloud, um host Linux que possa executar o Docker e um nome de host HTTPS dedicado para o CODE. O exemplo atual do Docker no Nextcloud recomenda um subdomínio separado e um certificado TLS válido. O CODE escuta internamente na porta 9980, enquanto um proxy reverso o expõe de forma segura para navegadores e para o Nextcloud.

• Um servidor Nextcloud em funcionamento, acessível por um URL como https://cloud.example.com.
• Docker Engine no host que executará o CODE.
• Um registro DNS, como por exemplo, office.example.comapontando para o seu proxy reverso.
• Um certificado HTTPS válido para o nome de host do escritório.
• Acesso de administrador ao Nextcloud e acesso root ou sudo ao host Docker.

A documentação de instalação atual do Nextcloud afirma que o servidor CODE integrado é o mais fácil para uso pessoal ou de pequenas equipes, mas recomenda uma instalação dedicada do Collabora Online para melhor desempenho. A imagem oficial do Collabora/Code no Docker Hub é a imagem usada abaixo.

Passo 1: Baixe a imagem Docker do CODE.

No host Docker, confirme se o Docker está disponível e baixe a imagem oficial:

docker --version
docker pull collabora/code:latest

A latestetiqueta é útil para um guia de configuração rápido, pois a Collabora publica atualizações com frequência. Para um ambiente de produção, considere fixar uma versão específica que você já testou e, em seguida, agende atualizações planejadas em vez de permitir uma alteração inesperada da imagem durante uma reconstrução.

Passo 2: Inicie o CODE para o seu host Nextcloud.

O exemplo atual do Nextcloud em Docker usa o comando `docker aliasgroup1ps` para informar ao CODE qual host do Nextcloud tem permissão para se integrar a ele. Substitua o nome do host de exemplo pelo seu URL real do Nextcloud:

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

A vinculação 127.0.0.1impede que a porta 9980 seja exposta diretamente à Internet quando o proxy reverso estiver em execução no mesmo servidor. Se o seu proxy estiver em outra máquina, configure as regras de rede para que somente o proxy possa acessar o CODE; não publique a porta 9980 para todos.

Verifique se o contêiner está em execução:

docker ps --filter name=collabora-code
docker logs --tail 50 collabora-code

Passo 3: Coloque HTTPS e um proxy reverso na frente do código.

O Nextcloud documenta os caminhos necessários para o Collabora como /browser, /hosting/discovery, /hosting/capabilities, /cool/adminws, /cool, além do tráfego WebSocket em /cool/.../ws. É por isso que uma configuração genérica de "proxy para tudo, exceto WebSockets" geralmente resulta em um editor que abre parcialmente e depois se desconecta.

Para o Nginx, o exemplo compacto a seguir mantém o HTTPS interno padrão do CODE e encerra o TLS público no Nginx. Use seus próprios caminhos de certificado:

server {
    listen 443 ssl http2;
    server_name office.example.com;
    ssl_certificate /etc/letsencrypt/live/office.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/office.example.com/privkey.pem;

    location ^~ /browser { proxy_pass https://127.0.0.1:9980; proxy_set_header Host $host; proxy_ssl_verify off; }
    location ^~ /hosting/discovery { proxy_pass https://127.0.0.1:9980; proxy_set_header Host $host; proxy_ssl_verify off; }
    location ^~ /hosting/capabilities { proxy_pass https://127.0.0.1:9980; proxy_set_header Host $host; proxy_ssl_verify off; }
    location ^~ /cool/adminws { proxy_pass https://127.0.0.1:9980; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; proxy_set_header Host $host; proxy_ssl_verify off; }
    location ~ ^/cool/(.*)/ws$ { proxy_pass https://127.0.0.1:9980; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "Upgrade"; proxy_set_header Host $host; proxy_ssl_verify off; }
    location ^~ /cool { proxy_pass https://127.0.0.1:9980; proxy_set_header Host $host; proxy_ssl_verify off; }
}

Este é intencionalmente um exemplo mínimo de roteamento, não uma configuração básica completa de segurança do Nginx. Se você executar o CODE com o TLS interno desativado, o servidor upstream se tornará o mesmo http://127.0.0.1:9980e o contêiner deverá ser configurado de forma consistente. Não misture um proxy HTTP com um contêiner CODE que ainda espera HTTPS.

Etapa 4: Verifique o endpoint público do CODE

Antes de mexer nas configurações do Nextcloud, abra este URL em um navegador:

https://office.example.com/hosting/discovery

Você deverá receber um XML de descoberta WOPI em vez de um erro de proxy, aviso de certificado ou falha de conexão em branco. Você também pode testar a partir da linha de comando:

curl -fsS https://office.example.com/hosting/discovery | head

Se isso falhar, corrija primeiro o DNS, o TLS, o proxy ou o contêiner. Conectar o Nextcloud a um endpoint com problemas apenas adiciona mais uma camada para solucionar o problema.

Etapa 5: Ative a integração do Nextcloud com o Office.

Faça login no Nextcloud como administrador, abra Aplicativos , acesse Escritório e mensagens e habilite o aplicativo de integração do Office disponível para sua instalação. O exemplo atual do Nextcloud Collabora Docker ainda orienta os administradores a instalar o aplicativo “Nextcloud Office” e, em seguida, configurar o servidor externo nas configurações de administração do Office, embora a visão geral do Nextcloud 35 agora distinga os produtos Euro-Office e Collabora.

Se a sua versão do Nextcloud usar rótulos ligeiramente diferentes, siga os nomes dos produtos exibidos na sua interface de administração, em vez de presumir que uma captura de tela mais antiga corresponde exatamente.

Etapa 6: Aponte o Nextcloud para o servidor CODE externo.

Abra as configurações de Administração → Office . Selecione a opção Servidor externo de Colaboração/Office e insira:

https://office.example.com

Salve a configuração e aguarde a verificação de conexão do Nextcloud. O Nextcloud recomenda o uso do mesmo protocolo em ambas as extremidades, com HTTPS como preferencial. Uma verificação bem-sucedida significa que o Nextcloud consegue alcançar o endpoint do Collabora, mas isso ainda não garante que todas as rotas WebSocket do navegador e solicitações WOPI funcionarão durante uma sessão de edição real.

Etapa 7: Restringir solicitações WOPI

Após a conexão básica estar funcionando, refine a configuração do WOPI. O guia de configuração atual do Nextcloud recomenda fortemente restringir as solicitações WOPI aos endereços IP dos servidores Collabora que devem solicitar arquivos. Em Configurações de administração → Office , utilize o campo Lista de permissões para solicitações WOPI, quando disponível.

Este é um importante controle de segurança, pois o fluxo WOPI é como o Collabora recupera e grava documentos em nome dos usuários do Nextcloud. Use endereços IP ou redes que realmente representem o caminho do seu servidor CODE, conforme exigido pela sua implementação; não cole um nome de host em um campo de lista de permissões de IP apenas porque ele se parece com o campo de URL do servidor. Consulte as orientações de configuração do Collabora e do WOPI do Nextcloud para obter informações sobre as opções atuais.

Passo 8: Abra um documento real e confirme o salvamento.

Crie um pequeno arquivo ODT ou DOCX no Nextcloud, abra-o, digite uma frase, feche o editor e abra o arquivo novamente. Isso verifica toda a cadeia: navegador → nome do host CODE público → proxy reverso → CODE → solicitação WOPI para o Nextcloud → salvar de volta no armazenamento.

A configuração não está concluída apenas porque a página de configurações do Office indica que o servidor está acessível. Um resultado ideal é que o editor carregue sem avisos de conexão, o documento possa ser editado e as alterações salvas sejam mantidas após a reabertura. Se o editor carregar, mas a edição for interrompida, verifique primeiro a /cool/.../wsconexão com o WebSocket. Se o editor não conseguir carregar o arquivo, verifique os logs do CODE, os logs do Nextcloud, a resolução de DNS entre os dois servidores e as regras da lista de permissões do WOPI.

Lista de verificação rápida para solução de problemas

Mantenha o CODE atualizado sem que as atualizações se tornem surpresas.

A Collabora publica atualizações de código com frequência. A página oficial do Docker Hub mostra as tags que estão sendo mantidas ativamente, e as orientações de atualização do Nextcloud indicam que as implantações do Docker são atualizadas baixando uma imagem mais recente e recriando o contêiner. Para um servidor doméstico, o acompanhamento latestpode ser razoável. Para uso comercial, fixe uma tag testada, leia as notas de versão, faça backup da sua configuração e atualize durante uma janela de manutenção.

Tenha em mente também o escopo do CODE. O Docker Hub descreve o CODE como a edição de desenvolvimento voltada para usuários domésticos, enquanto a documentação do Nextcloud direciona implantações maiores ou que exigem alta confiabilidade para opções corporativas com suporte. Uma configuração do Docker de 10 minutos é excelente para uma nuvem pessoal, laboratório ou pequena equipe, mas não substitui o planejamento de capacidade, monitoramento, backups ou suporte corporativo.

Resultado final

Assim que o contêiner estiver em execução, o proxy HTTPS estiver correto e /hosting/discoveryrespondendo, a integração com o Nextcloud estiver configurada https://office.example.comcorretamente, o WOPI estiver restrito e um documento real puder ser aberto e salvo, a integração estará completa. O detalhe mais importante não é a quantidade de comandos, mas sim manter o caminho de rede consistente. O Nextcloud, o CODE, o proxy reverso e os navegadores dos usuários devem ser capazes de acessar os nomes de host HTTPS esperados com as rotas WebSocket e WOPI corretas.