Corrija a verificação de host WOPI do CODE fazendo a correspondência da origem do host.

Quando o Collabora Online CODE reportar “Host WOPI não autorizado”, adicione o host de armazenamento de arquivos real — geralmente sua origem Nextcloud — à lista de permissões de host WOPI do CODE. O host deve corresponder à origem que o CODE recebe na solicitação WOPI, e não à URL pública do servidor Collabora. No Docker, isso geralmente é configurado com a aliasgroup1variável de ambiente.

Qual código está sendo rejeitado?

WOPI significa Web Application Open Platform Interface, o protocolo que um servidor de escritório usa para abrir e salvar arquivos por meio de uma plataforma de armazenamento. O host WOPI é essa plataforma de armazenamento, como o Nextcloud. O CODE verifica o host especificado na solicitação WOPI em relação aos hosts nos quais confia. Se a solicitação especificar um host cloud.example.com, mas o CODE estiver configurado para confiar apenas em um host específico office.example.com, o editor pode recusar a sessão antes que ela seja aberta.

Em uma configuração auto-hospedada, o nome do host na solicitação pode ser um nome interno do Docker, como `docker-compose.yml`, nextcloudem vez do nome do host visível no navegador. Um proxy reverso, uma porta diferente ou URLs públicas e internas separadas também podem fazer com que a origem seja diferente. Configure o que a solicitação realmente usa, e não o que parece ser o nome do servidor "principal".

Descubra que o código do host está rejeitando.

1. Reproduza a falha uma vez e, em seguida, inspecione o log do contêiner CODE nesse momento. Com o Docker Compose, execute `docker-compose up` docker compose logs --since=10m collabora, substituindo `< collaboranome_do_serviço>` pelo nome do seu serviço.
2. Procure por uma mensagem como esta No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Anote o host de destino mostrado entre colchetes. Não copie nem compartilhe um URL WOPI completo: ele pode conter um token de acesso de curta duração.
3. Compare o nome do host e o esquema com a URL que sua integração de armazenamento anuncia para o CODE. No Nextcloud, as orientações de solução de problemas recomendam verificar se a URL configurada é a URL do Nextcloud e se o CODE consegue acessá-la. Verifique o WOPISrchost, se disponível nos seus logs de integração, mantendo o token de consulta em sigilo.

Permitir a origem correta no CÓDIGO

Para a imagem Docker oficial do CODE, defina aliasgroup1a origem WOPI confiável exata. Para uma única instalação do Nextcloud, um serviço Compose pode incluir:

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

Substitua o exemplo pelo seu host Nextcloud real e pelo esquema e porta que a solicitação WOPI utiliza. Mantenha a tag de imagem, as configurações de administrador, a rede e outras opções de serviço existentes no seu arquivo Compose. O exemplo usa uma origem HTTPS com a porta 443; uma implementação diferente pode usar outra porta ou uma origem interna.

Após editar o arquivo Compose, recrie o contêiner CODE para que ele receba o ambiente atualizado:

docker compose up -d --force-recreate collabora

Use o nome real do seu serviço Compose no lugar de collabora. Uma reinicialização simples pode não carregar os valores alterados do ambiente do contêiner; recriar o serviço aplica a configuração atualizada. Se você configurar o CODE por meio de seu arquivo XML, verifique os storage.wopigrupos de aliases na configuração efetiva. O manual oficial do SDK da Collabora documenta os grupos de aliases do Docker e os aliases de host WOPI; siga a sintaxe da versão do CODE que você está executando.

Mantenha as duas listas de permissões separadas.

O Collabora e o Nextcloud podem impor restrições relacionadas ao WOPI, mas respondem a perguntas diferentes:

Alterar a lista de permissões de IP de origem do Nextcloud não corrigirá a rejeição de um nome de host pelo CODE. Por outro lado, adicionar um nome de host ao CODE não autoriza o IP de origem do CODE no Nextcloud. A documentação do Nextcloud recomenda restringir as solicitações WOPI aos endereços IP do servidor Collabora; use o endereço observado pelo Nextcloud, que pode ser diferente quando contêineres ou um proxy reverso estão envolvidos.

Verificações rápidas antes de encerrar o incidente.

• O objetivo é cloud.example.compermitir esse host do Nextcloud e a origem apropriada no CÓDIGO.
• O Target indica nextcloud: O CODE provavelmente está recebendo um nome de host da rede Docker; determine se essa origem interna é a pretendida, configure o host confiável correspondente e assegure a acessibilidade de DNS/rede.
• A correspondência é encontrada, mas a mesma rejeição persiste: confirme se a variável editada pertence ao serviço CODE em execução, se o Compose recriou o contêiner e se nenhuma configuração posterior de ambiente ou XML substitui a configuração.
• As alterações no log indicam falha de DNS, TLS, tempo limite ou CheckFileInfo: a verificação de autorização do host pode agora estar sendo bem-sucedida. Investigue a resolução de nomes, a confiança no certificado, o roteamento ou a resposta file-info da integração de armazenamento em vez de ampliar a lista de hosts WOPI.
• O Nextcloud reporta um endereço de requisição não autorizado: verifique a lista de permissões de IP de origem do Nextcloud e o IP do cliente que ele realmente vê.

Não resolva uma incompatibilidade confiando em todos os hosts ou usando um curinga irrestrito em um ambiente de produção. Limite a lista de permissões às origens de armazenamento conhecidas. Se houver múltiplos hosts de armazenamento intencionais, configure os grupos de aliases documentados para a sua versão do CODE instalada, em vez de tentar adivinhar o comportamento do curinga.

Verifique a correção

Abra um documento através da mesma integração com o Nextcloud que apresentou falha. Em seguida, verifique os logs atualizados do CODE: a mensagem de erro “Nenhum host WOPI aceitável” deve ter desaparecido. Confirme se o documento carrega e pode ser salvo; se um novo erro aparecer, use a mensagem para identificar a próxima etapa. Para as duas verificações de host e o fluxo de solução de problemas do Nextcloud, consulte a seção Solução de problemas do Nextcloud Office e Configuração do Nextcloud Office . Para grupos de aliases do Docker no CODE, consulte o manual do SDK do Collabora Online 25.04 ; use a documentação correspondente à sua versão instalada, caso a configuração seja diferente.