Como instalar o Collabora Online CODE com Docker e Nextcloud

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.

Deixar um comentário

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O que é o Microsoft Access? Como funcionam suas ferramentas de banco de dados?

O Microsoft Access é um aplicativo de banco de dados para Windows que permite armazenar registros relacionados, criar consultas, elaborar formulários de entrada de dados e gerar relatórios. Saiba como ele funciona e quando é adequado para você.

Alterar a altura e a largura das linhas de grade no Word 2010

Alterar a altura e a largura das linhas de grade no Word 2010

Aprenda como ajustar a altura e a largura das linhas de grade no Word 2010, alterar a frequência das linhas visíveis e definir o espaçamento horizontal e vertical da grade de desenho subjacente.

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Importação e exportação do Office Outlook 2010: Mova dados com um arquivo PST

Aprenda como importar um arquivo PST para o Outlook 2010 ou exportar emails, contatos, calendário e tarefas. Siga os menus corretos e evite pastas ausentes ou duplicadas.

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere a senha de um arquivo PST do Outlook com o Nucleus Kernel

Recupere uma senha esquecida de um arquivo PST do Outlook seguindo os passos atuais do Kernel, incluindo como identificar o arquivo correto, fazer um backup e verificar as limitações da ferramenta.

Como inserir uma página da web em um slide do PowerPoint

Como inserir uma página da web em um slide do PowerPoint

Use o suplemento LiveWeb para inserir um site em um slide do PowerPoint, definir seu tamanho e comportamento de atualização e verificar a compatibilidade antes da apresentação.

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Contatos do Outlook 2010: Adicionar pessoas e usar a agenda de endereços

Aprenda como criar e organizar contatos no Outlook 2010, criar um grupo de contatos e selecionar pessoas salvas na Agenda de Endereços ao endereçar um e-mail.

Como criar um campo de hiperlink no Access 2010

Como criar um campo de hiperlink no Access 2010

Crie um campo de Hiperlink no Access 2010 no Modo de Exibição de Design e, em seguida, adicione e teste links para sites, e-mails ou arquivos compartilhados com os detalhes de destino corretos.

Como remover metadados e conteúdo ocultos de um documento do Word

Como remover metadados e conteúdo ocultos de um documento do Word

Use o Inspetor de Documentos do Word para revisar detalhes do autor, comentários, alterações controladas, texto oculto e outros dados antes de compartilhar, e descubra o que a verificação pode não detectar.

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Exportar e importar configurações da Faixa de Opções e da Barra de Ferramentas de Acesso Rápido no Office 2010

Mova guias personalizadas da Faixa de Opções e comandos da Barra de Ferramentas de Acesso Rápido no Office 2010 com um arquivo .exportedUI e proteja as configurações já existentes no seu computador de destino.

Converter uma planilha do Excel em papel quadriculado imprimível

Converter uma planilha do Excel em papel quadriculado imprimível

Crie papel quadriculado imprimível no Excel ajustando as dimensões das células, definindo uma área de impressão, escolhendo papel A4 e ativando a impressão de linhas de grade no Excel para desktop.