O que verificar quando o site ownCloud abre em uma página em branco

Quando o ownCloud Web abrir em uma página em branco, tente primeiro acessar o mesmo URL em uma janela anônima usando um navegador compatível. Se o problema persistir, abra as ferramentas de desenvolvedor do navegador e verifique os painéis Console e Rede; use a solicitação com falha para decidir se deve limpar os dados do site no navegador, reparar um recurso da web ausente ou inspecionar os serviços do Infinite Scale e do proxy reverso. Evite excluir dados do servidor ou reinstalar a instância antes dessa verificação.

O ownCloud Web é a interface web fornecida com o Infinite Scale, embora os administradores possam substituir seus recursos compilados por uma versão personalizada. Uma página em branco pode, portanto, ser resultado do navegador, de um recurso JavaScript ausente ou incompatível ou de uma resposta do servidor/proxy que impede o carregamento da interface. As etapas abaixo separam esses casos. Os painéis da interface são exemplos ilustrativos; compare-os com a saída real do navegador e da implantação.

1. Descubra se o problema é local ou se afeta todo o servidor.

Peça a outro usuário para abrir o mesmo URL público e tente você mesmo em uma janela anônima. Por exemplo, se um funcionário vir uma página em branco enquanto um colega consegue navegar pelos arquivos, comece investigando as causas específicas do navegador. Se todos virem a mesma página, passe diretamente para as verificações de rede e servidor.

  1. Use um navegador de desktop compatível com o ownCloud Web. A página de requisitos atual lista as versões mais recentes do Chrome, Firefox e Edge, e o Safari 16 ou posterior, em sistemas operacionais de desktop compatíveis.
  2. Abra a instância em uma janela anônima. Se a interface carregar, desative as extensões uma de cada vez no perfil normal e, em seguida, limpe os dados do site apenas para o hostname do ownCloud. Limpar os dados do site pode desconectá-lo; isso não remove os arquivos armazenados no servidor.
  3. Atualize a página em branco com o cache do navegador desativado e as ferramentas de desenvolvedor abertas. Se o mesmo erro persistir em vários navegadores compatíveis e para vários usuários, é mais provável que seja um problema no servidor ou na implantação.

Janela ilustrativa do navegador mostrando uma página completamente branca no exemplo de nome de host da nuvem.

Ilustração do sintoma: um navegador acessou o servidor na nuvem, mas a área de conteúdo da página permanece em branco.

2. Use a solicitação com falha para escolher uma solução.

Abra as ferramentas de desenvolvedor (geralmente F12 ou Ctrl+Shift+I no Windows/Linux, ou Option+Command+I no macOS). Selecione Console para ver os erros de JavaScript, depois selecione Rede , recarregue a página e procure por solicitações com falha. O código de status e o tipo de solicitação são mais úteis do que apenas a tela branca.

  • Uma requisição JavaScript ou CSS retorna um erro 404: o navegador solicitou um recurso que não foi encontrado naquele URL. Se isso ocorrer apenas em um perfil de navegador, limpe os arquivos em cache desse site e recarregue a página. Se o mesmo recurso falhar para todos, verifique o caminho do recurso, o roteamento do proxy reverso e qualquer configuração personalizada da página web.
  • Uma solicitação retorna 502, 503 ou um erro de conexão: o proxy não conseguiu obter uma resposta utilizável de um serviço upstream ou o serviço estava indisponível. Verifique o status de implantação e os registros antes de alterar as configurações do navegador.
  • O console reporta uma solicitação bloqueada, erro de certificado ou aviso de conteúdo misto: compare o nome do host público e o esquema HTTPS usados ​​pelo navegador com a URL e a configuração do proxy. Se você alterou recentemente o domínio, a terminação TLS ou as regras do proxy, teste essa alteração primeiro.
  • A página carrega os recursos com respostas 200, mas o JavaScript ainda falha: registre o primeiro erro no console e as versões do ownCloud Web/Infinite Scale. Um erro de sintaxe ou de tempo de execução pode indicar uma compilação ou extensão personalizada incompatível; não tire essa conclusão apenas com base em uma resposta 200.

Ferramentas de desenvolvedor do navegador ilustrativas. Console mostrando um exemplo de resposta 404 para um recurso JavaScript.

Exemplo de ilustração diagnóstica: um erro 404 para um recurso JavaScript é uma pista para verificar o URL e o caminho de serviço do recurso, e não uma prova de uma causa específica.

3. Verifique os ativos da web e a integridade do serviço.

Se a solicitação com falha for um recurso, primeiro verifique se sua instância usa os arquivos web do ownCloud incluídos ou arquivos compilados personalizados. O guia do administrador do ownCloud 8.2 indica que WEB_ASSET_PATHo caminho aponta para recursos do cliente web compilados personalizados. Se você o configurou, verifique se o caminho existe dentro da implantação em execução, se contém a compilação completa e se é legível pelo processo que serve a interface web. Se você não usa recursos personalizados, não adicione essa variável como uma solução paliativa.

Para uma implantação do Docker Compose, execute estes comandos a partir do diretório que contém o arquivo Compose:

docker compose ps
docker compose logs --tail=100 ocis

O primeiro comando mostra se os serviços estão em execução; o segundo imprime os logs recentes do serviço especificado ocis. Se o seu arquivo Compose usa um nome de serviço diferente ou executa o frontend separadamente, substitua o nome do serviço pelo nome correto e inspecione também os logs do proxy/frontend. Para uma instalação manual ou implantação orquestrada, use os comandos de serviço e log da plataforma correspondente. Procure por falhas de inicialização, erros de caminho de recursos ou erros de conexão com o servidor no momento da falha no carregamento da página.

Terminal ilustrativo mostrando os comandos `docker compose ps` e `docker compose logs` sem exemplo de saída.

Ilustração das duas verificações do Compose; os nomes reais dos serviços e as mensagens de log variam conforme a implementação.

4. Verifique o URL público e a rota do proxy.

Se as solicitações apontarem para um nome de host antigo, esquema incorreto ou caminho que o proxy não suporta, verifique a configuração da URL pública e as regras do proxy. O ownCloud documenta OCIS_URLa URL usada para definir como o Infinite Scale é acessado. Em uma implantação que utiliza um proxy reverso, certifique-se de que o endereço HTTPS visível no navegador, o nome DNS e as regras de roteamento correspondam à URL pública configurada. Se o proxy ou domínio foi alterado recentemente, compare a configuração atual com a última versão funcional e corrija apenas o valor que não corresponde.

Verifique WEB_ASSET_PATHapenas se os recursos personalizados estão configurados. Verifique OCIS_URLas configurações de proxy/TLS quando o navegador for redirecionado para um host inesperado ou solicitar recursos da origem errada. Essas configurações variam de acordo com a implantação, portanto, não copie um valor genérico de exemplo para um ambiente de produção. O guia oficial de recursos personalizados do ownCloud Web , a documentação do serviço de proxy e o guia de TLS descrevem essas áreas de configuração.

Editor de configuração ilustrativo destacando WEB_ASSET_PATH e OCIS_URL para verificações de implantação.

Ilustração dos valores de configuração a serem inspecionados; os valores corretos dependem do URL público e se recursos personalizados estão sendo usados.

Verifique a correção

Recarregue o site em uma janela normal do navegador e confirme se a interface é renderizada corretamente, se o Console não apresenta erros JavaScript bloqueantes e se as solicitações JavaScript/CSS necessárias não retornam mais respostas 404 ou 5xx. Peça a um segundo usuário para testar o mesmo endereço público. Se a página ainda estiver em branco, mesmo com o carregamento dos recursos concluído com sucesso, preserve o primeiro erro do console, os detalhes da solicitação com falha, a versão do Infinite Scale e os logs de serviço relevantes para o seu administrador ou para o suporte do ownCloud. Oculte cookies, cabeçalhos de autorização e tokens antes de compartilhar as capturas de tela do navegador.

Deixar um comentário

Elimine os timeouts de bloqueio de arquivos do ownCloud com o backend correto.

Diferencie a disputa de bloqueio de banco de dados dos bloqueios WebDAV expirados e, em seguida, escolha e configure a correção adequada para o ownCloud 10.

O que verificar quando o site ownCloud abre em uma página em branco

O que verificar quando o site ownCloud abre em uma página em branco

Rastreie uma tela em branco do ownCloud Web até a causa, como cache do navegador, recursos da web ausentes, erros de serviço ou configurações de URL de proxy reverso, com verificações direcionadas.

Limpar o aviso de memória PHP do ownCloud no ambiente de execução correto

Defina o limite de memória PHP da web do ownCloud, reinicie o serviço correspondente e verifique o valor ativo sem confundi-lo com as configurações da CLI ou os limites de upload.

Solução de problemas de falhas de conexão MySQL no ownCloud 10

Descubra se o MySQL, o PHP, as configurações de socket ou as permissões do banco de dados estão bloqueando o ownCloud 10 e, em seguida, verifique se há uma solução segura.

Defina um prazo de expiração fixo para os links públicos do ownCloud.

Defina um prazo de expiração fixo para os links públicos do ownCloud.

Torne obrigatória a expiração de links públicos no ownCloud Classic, defina um tempo de vida máximo e verifique os compartilhamentos existentes que podem precisar de limpeza separada.

Adicione autenticação de dois fatores TOTP ao ownCloud escale infinitamente com o Keycloak.

Adicione autenticação de dois fatores TOTP ao ownCloud escale infinitamente com o Keycloak.

Habilite o TOTP por meio do Keycloak, inscreva usuários com segurança e entenda quando as configurações de MFA em nível de rota do Infinite Scale se aplicam.

Restaure a sincronização do ownCloud associando o cliente ao seu servidor.

Verifique se o problema é uma quebra de compatibilidade entre o OC10 e o 7.x ou um registro CSync corrompido e, em seguida, aplique a correção adequada sem excluir os arquivos sincronizados.

Coloque o ownCloud em HTTPS com Let's Encrypt e Nginx

Coloque o ownCloud em HTTPS com Let's Encrypt e Nginx

Escolha HTTP-01 ou DNS-01, configure um proxy reverso ownCloud e verifique se o Certbot renova os certificados HTTPS automaticamente.

Conecte o ownCloud Infinite Scale ao LDAP para login do usuário.

Configure o login LDAP do oCIS, alinhe as pesquisas de usuários e grupos e verifique as configurações de TLS e esquema antes da implementação.

Conecte um bucket S3 ao ownCloud 10 como armazenamento externo.

Conecte um bucket S3 ao ownCloud 10 como armazenamento externo.

Adicione um bucket do Amazon S3 ao ownCloud 10, prepare credenciais e endpoints compatíveis e verifique o acesso sem confundir a montagem com o armazenamento primário.