Corrigir o erro “Host WOPI não autorizado” no Collabora Online CODE

A solução mais rápida e confiável é fazer com que o Collabora Online CODE confie no nome do host e na porta exatos que aparecem na URL de origem WOPI enviada pela sua plataforma de armazenamento. Para um único servidor Nextcloud, defina a lista de permissões de host do CODE para esse nome de host do Nextcloud, recrie o contêiner e teste novamente. Se você opera várias instâncias do Nextcloud, permita cada uma explicitamente. Não resolva o erro abrindo o acesso WOPI para todos os hosts.

A mensagem "Host WOPI não autorizado" geralmente significa que o Collabora rejeitou o host de armazenamento especificado na solicitação WOPI. Isso, por si só, não comprova que a senha do usuário, as permissões do documento, o certificado TLS ou o proxy reverso estejam incorretos. Esses componentes podem causar outras falhas de conexão, portanto, use os logs do Collabora para confirmar a causa específica antes de alterar as configurações.

Escolha a alteração que corresponde à sua implementação.

Os exemplos abaixo pressupõem o Nextcloud em `<hostname>` https://cloud.example.come o Collabora em `<porta>` https://office.example.com. Substitua os nomes e a porta pelos valores usados ​​em sua instalação. O guia de configuração do Docker do Nextcloud usa `<hostname>` aliasgroup1para um único host de armazenamento e descreve a adição de outro grupo de aliases para um segundo host do Nextcloud. A configuração WOPI do Collabora define a correspondência de hosts com base no nome do host e na porta; os aliases são para nomes alternativos do mesmo host de armazenamento.

1. Confirme qual host foi rejeitado pelo Collabora.

Comece pelos logs do contêiner CODE. Em uma implantação do Docker Compose, execute:

docker compose logs --since=10m collabora

Substitua collabora`<service-name>` pelo nome do serviço no seu arquivo Compose. Com o Docker padrão, use ` <service-name> docker logs --since 10m CONTAINER_NAME`. Procure perto da tentativa de abertura do documento que falhou por uma mensagem como ` No acceptable WOPI hosts found matching the target host [cloud.example.com] in config<service-name>`. O nome do host entre colchetes é a pista: adicione o host de armazenamento mostrado ali, não o nome do host público do servidor Collabora.

Registre também o host e a porta na URL WOPI, se exibida no log. Compare-os com a entrada configurada. Uma solicitação para cloud.example.com:443pode não corresponder a uma entrada para um nome de contêiner interno, como nextcloud, mesmo que ambos os nomes resolvam para a mesma máquina. Proxies reversos, DNS de horizonte dividido e várias URLs públicas podem fazer com que essa incompatibilidade passe despercebida.

Se os registros mostrarem um erro diferente, como uma falha na pesquisa de DNS, uma conexão recusada ou um erro de certificado, corrija esse problema em vez de ampliar a lista de hosts WOPI.

2. Atualize a configuração do host WOPI confiável do CODE.

Para uma instalação do Docker Compose que atenda a um host Nextcloud, a parte relevante do serviço pode ter a seguinte aparência:

services:
  collabora:
    image: collabora/code
    environment:
      - aliasgroup1=https://cloud.example.com:443

Mantenha as demais opções de serviço, segredos, volumes, portas e configurações de proxy reverso existentes. O exemplo mostra apenas a entrada da lista de permissões; não se trata de um arquivo Compose completo para produção. Utilize o estilo de configuração já compatível com a versão do CODE que você está executando e verifique a configuração renderizada ou de inicialização após a alteração. As imagens de contêiner e as interfaces de configuração podem mudar com o tempo.

Para um único host, uma entrada de host exata é mais fácil de auditar do que uma expressão regular genérica. Se a sua instalação depende da domainvariável de ambiente, verifique as regras de escape documentadas para a sua imagem e certifique-se de que a expressão corresponda apenas ao nome do host de armazenamento pretendido. Não copie um caractere curinga sem escape ou um padrão de domínio pai que corresponda a subdomínios não relacionados.

Para mais de uma instância do Nextcloud, adicione um grupo explícito separado para cada host independente usando o mecanismo compatível com a sua versão do CODE. Por exemplo, o guia de integração do Docker do Nextcloud mostra uma aliasgroup2entrada adicional para um segundo nome de host na nuvem. Adicione aliases somente quando um servidor Nextcloud for realmente acessado por vários nomes, como um nome interno e um nome público. Mantenha uma lista escrita desses nomes para que um nome de host antigo possa ser removido após uma migração.

3. Recrie o contêiner e verifique a lista de permissões separada do Nextcloud.

Após editar o arquivo Compose, recrie o serviço para que o novo ambiente seja aplicado:

docker compose up -d --force-recreate collabora

Use o nome de serviço correto. Em seguida, verifique se o contêiner inicia corretamente e se o host esperado aparece na configuração de inicialização ou nos logs. Evite colar dumps completos do ambiente em solicitações de suporte: eles podem expor senhas ou outros segredos.

O Nextcloud possui uma configuração separada chamada "Lista de permissões para solicitações WOPI" nas configurações de administração do Office. Essa lista restringe quais endereços IP podem fazer solicitações WOPI para o Nextcloud; a Collabora recomenda limitá-la aos endereços esperados do servidor Collabora. Se o Nextcloud exibir este aviso, adicione o endereço que o Nextcloud realmente vê para a solicitação, que pode ser diferente quando um proxy ou rede de contêineres estiver envolvido. Mantenha essa verificação separada da entrada de host do CODE: o CODE confia nos nomes de host de armazenamento, enquanto a lista de permissões do Nextcloud se refere ao IP do servidor solicitante.

Se você usa um proxy reverso, confirme se o nome do host que o Nextcloud publica nos links WOPI é o mesmo nome de host que o CODE configurou para confiar. Verifique o URL do servidor do Nextcloud Office e a configuração de host público do proxy reverso. Não adicione o nome do host do Office à lista de permissões de armazenamento do WOPI, a menos que ele seja de fato o host de armazenamento no URL do WOPI.

4. Verifique se a conexão está completa.

Primeiro, verifique os endpoints do serviço Collabora a partir de um navegador e do servidor Nextcloud. Substitua o nome do host de exemplo pela URL do seu Office:

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

Essas verificações comprovam que os endpoints respondem; elas não garantem que uma solicitação de documento WOPI será autorizada. Em seguida, verifique se o CODE consegue acessar o Nextcloud usando o mesmo host que o Nextcloud publica, por exemplo:

curl -fsS https://cloud.example.com/status.php

Por fim, abra um documento de teste e observe os logs do CODE e do Nextcloud simultaneamente. Um resultado positivo é o carregamento do editor, o desaparecimento da mensagem específica "Nenhum host WOPI aceitável" e o funcionamento correto ao salvar pequenas alterações. Teste a partir de uma conta de usuário normal com as mesmas permissões de compartilhamento e edição do usuário afetado.

Como se comparam as principais opções

Um host exato versus uma expressão regular

Um nome de host exato com a porta desejada geralmente é a melhor opção para uma implantação em nuvem única: é fácil de revisar e limita correspondências acidentais. Uma expressão regular pode ajudar quando um conjunto de nomes de host gerenciado deliberadamente compartilha um padrão, mas é mais difícil de auditar e pode autorizar subdomínios não intencionais se for escrita de forma muito ampla. Use a expressão mais específica que atenda a uma necessidade comprovada.

Uma instância de CODE versus instâncias separadas

Um serviço CODE compartilhado reduz o número de serviços a serem mantidos, e grupos explícitos podem suportar múltiplas instâncias do Nextcloud. Instâncias CODE separadas podem ser úteis quando as equipes precisam de maior isolamento de configuração ou janelas de manutenção independentes. A desvantagem é uma infraestrutura maior para corrigir, monitorar e rotear. Nenhuma das opções corrige automaticamente um nome de host WOPI incompatível; cada instância deve confiar no host de armazenamento correto.

Configurações de ambiente de contêiner versus edição de XML

Para uma implantação do Docker CODE, utilize a interface de configuração suportada pela imagem e mantenha-a no Compose ou em outra fonte de verdade da implantação. Isso torna as alterações repetíveis quando o contêiner for recriado. A edição coolwsd.xmldireta pode ser útil para um pacote gerenciado ou uma implantação personalizada deliberada, mas editar um arquivo gerado dentro de um contêiner em execução é frágil e pode desaparecer em caso de substituição ou atualização. Siga as instruções específicas para o pacote, gráfico Helm ou imagem que você estiver utilizando.

Erros comuns a evitar

• Permitir office.example.comquando o host de armazenamento WOPI rejeitado for cloud.example.com.
• Inserir um nome de contêiner privado quando a URL WOPI contém um nome DNS público, ou vice-versa.
• Partindo do pressuposto de que uma lista de permissões de IP WOPI do Nextcloud em branco e a configuração de host do CODE são o mesmo controle.
• Adicionar um caractere curinga amplo ou desativar a validação do host apenas para fazer o editor carregar.
• Alterar as regras de proxy, TLS e WOPI simultaneamente dificulta o diagnóstico do problema.
• Testar apenas o ponto de extremidade de descoberta e considerá-lo como prova de que a autorização de documentos funciona.

Quando usar uma solução diferente

Se o host rejeitado mudar entre as solicitações, inspecione o URL canônico do Nextcloud, os cabeçalhos de proxy confiáveis ​​e quaisquer diretórios raiz alternativos antes de adicionar mais nomes. Se todos os nomes de host corresponderem, mas o erro persistir, compare a configuração CODE ativa com o arquivo ou as configurações de ambiente que você editou e confirme se o contêiner foi recriado. Para Kubernetes ou Helm, edite os valores do gráfico ou a fonte de configuração gerenciada em vez de um pod em execução. Se os logs mostrarem erros de certificado, firewall, WebSocket ou DNS, solucione o problema nessa camada usando os logs do servidor e as verificações de rede apropriadas.

Estas etapas seguem o Manual de Administração do Nextcloud 35, disponível em 6 de outubro de 2026, e o esquema de configuração WOPI publicado pela Collabora. As chaves de configuração específicas podem variar de acordo com o método de implantação e a versão da imagem; portanto, verifique-as na documentação da sua versão instalada antes de aplicar qualquer alteração.

Referências oficiais

• Solução de problemas e verificações de conectividade do Nextcloud Office
• Exemplo de Docker do Nextcloud para Collabora, incluindo configurações de host WOPI
• Configuração do Nextcloud Office e orientações sobre a lista de permissões de IP do WOPI
• Esquema de configuração coolwsd.xml publicado pelo Collabora Online
• Documentação de configurações de proxy do Collabora Online