Comece verificando a conexão WebSocket e a acessibilidade entre os dois servidores. Um editor do Collabora Online que abre com uma tela preta, uma página branca ou uma área de trabalho vazia geralmente apresenta falhas antes que a interface do documento termine de carregar. Se o problema afetar todos os arquivos, inspecione primeiro a rota do navegador para o Collabora, o proxy reverso e a conexão do Nextcloud para o Collabora. Se apenas um arquivo apresentar falhas, teste outro documento e verifique as permissões e o formato desse arquivo antes de alterar as configurações do servidor.
Siga esta ordem: verifique o navegador, teste os endpoints de descoberta do Collabora, leia os logs de integração e do servidor e, em seguida, corrija apenas a configuração de proxy ou WOPI que as evidências indicarem. Uma redefinição do cache do navegador pode ajudar com recursos desatualizados, mas não corrigirá um WebSocket corrompido ou um host WOPI inacessível. As imagens da interface abaixo são exemplos esquemáticos; os rótulos e caminhos de solicitação exatos variam de acordo com o navegador, a plataforma de nuvem, o proxy e a versão do Collabora.
| O que você vê | Primeiro lugar para verificar | Próxima ação provável |
|---|---|---|
| Todos os documentos permanecem em branco ou continuam carregando. | Aba Rede do navegador e proxy do Collabora | Inspecionar solicitações de descoberta /cool/…/ws, /browser, ou com falha |
| O URL de colaboração funciona, mas o Nextcloud não consegue abrir um arquivo. | URL do Nextcloud Office, lista de permissões WOPI e registros do servidor. | Confirme se o URL público está correto e se a conectividade bidirecional com o servidor está funcionando. |
| Apenas um documento está em branco. | Permissões de arquivo, estado de compartilhamento, formato e integridade do arquivo | Antes de alterar as configurações globais de proxy, tente usar um documento que você sabe que funciona bem. |
| Funciona em um navegador, mas não em outro. | Console do navegador, extensões e dados de sites em cache | Teste uma janela privada e compare as solicitações com falha. |
Primeiro, abra um segundo documento que você sabe que é legível e tente abrir o mesmo arquivo em um navegador diferente ou em uma janela anônima. Se um documento não abrir enquanto outros abrirem, verifique se o usuário ainda consegue baixá-lo ou visualizá-lo na plataforma de arquivos. Um arquivo corrompido, um formato não suportado, um compartilhamento expirado ou a falta de permissão podem parecer um problema do editor, mas alterar o proxy reverso não resolverá um problema específico do arquivo.
Para uma verificação no navegador, abra as Ferramentas do Desenvolvedor antes de recarregar o documento em branco. Em navegadores baseados no Chromium, pressione Ctrl+Alt F12+F ou Ctrl+Shift+ICtrl+Alt+F, selecione Rede , ative Preservar registro e recarregue. Filtre por <script> ws, cool<script> ou browser<script>. Verifique também a guia Console em busca de scripts bloqueados, avisos de certificado ou erros de política de segurança de conteúdo.
Uma solicitação com falha indica /cool/…/wsum problema no handshake do WebSocket ou no proxy. 502Geralmente, um erro 400 significa que o proxy não conseguiu obter uma resposta utilizável do servidor upstream; um erro 400 404pode significar que o caminho não está roteado; e um erro 400 403pode indicar um host ou regra de acesso rejeitada. Esses códigos de status restringem a busca, mas os logs correspondentes do proxy e do Collabora são necessários para identificar a causa exata. Se as solicitações com falha forem arquivos JavaScript ou CSS em /etc/csv/ /browser, verifique se o proxy está encaminhando esses recursos estáticos para o serviço Collabora.
Se as requisições de rede forem bem-sucedidas em uma janela anônima, desative temporariamente as extensões do navegador que bloqueiam scripts ou requisições entre sites e, em seguida, limpe os dados do site apenas para os nomes de host da nuvem e do Collabora. Teste novamente antes de alterar a configuração do servidor. Não tente resolver o problema limpando o cache se a mesma requisição continuar falhando na guia Rede.
Para a integração com o Nextcloud, verifique o URL do servidor Collabora Online nas configurações de administração do Office. Use o URL público acessível pelos navegadores, com o nome do host e a porta corretos. As diretrizes atuais do Nextcloud recomendam que os serviços Collabora e Nextcloud utilizem o mesmo protocolo; HTTPS é o mais indicado. Uma incompatibilidade, como um serviço configurado com um endereço IP http://enquanto o outro é acessado por outro endereço, https://pode causar o bloqueio de solicitações com conteúdo misto ou falhas em callbacks.
A partir de um navegador no cliente afetado, abra `/var/www/html` https://office.example.com/hosting/discoverye https://office.example.com/hosting/capabilities`/var/www/html`, substituindo o nome do host de exemplo pelo seu próprio. O endpoint de descoberta deve retornar XML descrevendo as ações de documento suportadas; o endpoint de capacidades deve retornar uma resposta do servidor Collabora. Um erro de navegador, página de login, erro 404 com a marca do proxy ou erro de gateway significa que a rota pública não está alcançando o endpoint Collabora esperado.
Em seguida, faça o teste a partir do host do Nextcloud, pois o teste no navegador por si só não comprova que os servidores conseguem se comunicar entre si:
curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/discovery
curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/capabilitiesSubstitua office.example.compelo nome de host do Collabora configurado. Uma resposta HTTP bem-sucedida é uma verificação útil de acessibilidade, enquanto um tempo limite, falha de DNS, erro TLS ou resposta 5xx precisa ser resolvido na camada de rede, certificado, DNS ou proxy correspondente. Para instalações em que o servidor Collabora precisa se comunicar com o Nextcloud, teste também a URL de status do Nextcloud a partir do host do Collabora:
curl -fsS https://cloud.example.com/status.phpUse o nome de host real do seu Nextcloud. Instalações CODE integradas podem usar um URL de proxy interno em vez de um nome de host Collabora público separado; portanto, siga as instruções para essa implantação em vez de aplicar o exemplo de servidor independente literalmente.
O Collabora serve recursos do navegador e sessões de documentos por meio de várias rotas. Um proxy reverso deve encaminhar os caminhos esperados pela versão instalada, incluindo os recursos do editor, os endpoints de descoberta e recursos, e a rota WebSocket do documento. A documentação atual do Collabora usa `/` /cool/…/ws; implantações mais antigas ainda podem ter configurações para /loolcaminhos legados. A documentação de migração do Nextcloud menciona especificamente as mudanças históricas de caminho de `/` loleafletpara `/ browser` e de `/` para lool`/` cool.
Na configuração do seu proxy, verifique se a localização do WebSocket corresponde às regras gerais de captura de exceções, se o proxy encaminha os cabeçalhos de atualização necessários para o seu software de proxy e se o upstream aponta para o serviço e a porta corretos do Collabora. Confirme também se o proxy preserva as informações de host e esquema esperadas e permite que conexões de longa duração permaneçam abertas. Se o TLS for encerrado no proxy, certifique-se de que as configurações de terminação SSL do Collabora correspondam a esse padrão.
O pequeno trecho de código acima mostra o tipo de cabeçalhos WebSocket que um proxy no estilo Nginx pode precisar; não se trata de uma configuração completa de proxy. Não o copie e cole isoladamente nem combine diretivas de diferentes versões. Compare sua configuração completa com o guia oficial de proxy reverso da Collabora para a versão do proxy e do Collabora que você utiliza. Após editar um arquivo de proxy, valide sua sintaxe com o comando `configuration-test` do servidor antes de recarregá-lo.
O Collabora utiliza o WOPI (Web Application Open Platform Interface) para solicitar um documento de um serviço de armazenamento conectado, como o Nextcloud. O servidor Collabora deve aceitar o host WOPI e o servidor de armazenamento deve ser capaz de acessar o serviço Collabora. No Nextcloud, verifique as configurações do Office e a lista de permissões para solicitações WOPI. Adicione apenas o endereço esperado do servidor Collabora; não desative a validação de host nem permita hosts arbitrários, pois isso pode causar o desaparecimento de uma tela em branco.
Leia os logs no momento em que o problema ocorrer. Para uma implantação em Docker, o guia de solução de problemas do Nextcloud documenta a verificação do log do contêiner; use o nome ou ID real do contêiner:
docker logs --tail 100 collaboraPara uma instalação baseada em pacotes, os nomes dos serviços e os destinos dos logs dependem do sistema operacional e da versão do pacote. Uma verificação comum do systemd é:
sudo journalctl -u coolwsd -n 100 --no-pagerProcure por um carimbo de data/hora correspondente e erros relacionados a um host WOPI não autorizado, CheckFileInfosolicitação com falha, verificação TLS, armazenamento indisponível ou falha no WebSocket. Uma mensagem indicando que nenhum host WOPI aceitável corresponde geralmente significa que o nome do host de armazenamento configurado para a integração não corresponde ao host permitido pelo Collabora. Corrija o nome do host ou a entrada da lista de permissões em vez de adicionar domínios não relacionados.
Verifique também o log da plataforma de arquivos para o mesmo horário da solicitação. Se o Collabora não conseguir acessar o Nextcloud, verifique a resolução de DNS a partir do host do Collabora, as regras do firewall, a rota pública ou interna e se o serviço está tentando se acessar por meio de um nome de host que é resolvido de forma diferente dentro da rede do contêiner. O manual de solução de problemas do Nextcloud recomenda verificar a conectividade em ambas as direções e usar os logs do servidor para identificar o lado com falha.
Após corrigir uma rota, URL, certificado ou entrada na lista de permissões, recarregue o proxy e os serviços afetados somente quando sua implantação exigir. Reabra as Ferramentas de Desenvolvedor, recarregue o arquivo e confirme se a solicitação anterior, que havia falhado, agora é concluída. O documento deve renderizar suas páginas ou folhas, aceitar uma pequena edição e salvar essa edição com sucesso. Uma página em branco que desaparece, mas não pode ser salva, ainda indica uma conexão WOPI ou de armazenamento não resolvida.
/loolou /loleafletos caminhos legados, conforme necessário.Um resultado confiável é mais do que apenas o aparecimento da barra de ferramentas do editor. O conteúdo do documento é renderizado, não há falhas persistentes nas requisições do editor ou do WebSocket, e uma edição de teste inofensiva é salva e permanece após uma atualização. Se o problema persistir, preserve um breve trecho anonimizado da saída de Rede/Console do navegador e as linhas de log correspondentes do Nextcloud, do proxy e do Collabora. Os logs podem conter nomes de host, nomes de usuário, identificadores de arquivo ou tokens; portanto, remova os valores confidenciais antes de compartilhá-los.
Para obter instruções específicas sobre a sua implementação atual, consulte o guia de solução de problemas do Nextcloud Office , a referência de configuração do Nextcloud Office e as notas de migração do Collabora . As verificações exatas para o ownCloud, outro host WOPI, um serviço CODE integrado ou uma plataforma de contêineres podem ser diferentes dos exemplos do Nextcloud.
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ê.
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.
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 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.
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.
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.
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.
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.
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.
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.
