Caddy e Guia de Solução de Problemas de Serviço Web
ServBay usa Caddy como servidor web padrão, e durante o uso diário, os usuários podem encontrar problemas como a impossibilidade de abrir o site. Abaixo estão algumas soluções para problemas comuns.
Usando as Ferramentas de Diagnóstico da ServBay
A ServBay vem com uma ferramenta de diagnóstico muito poderosa, recomendamos que use a ferramenta de solução de problemas da própria ServBay para diagnóstico e solução.
Abra o aplicativo ServBay e encontre diagnóstico
na navegação à esquerda para acessar a ferramenta de diagnóstico da ServBay.
Verificando o Caddyfile
Se você deseja solucionar problemas manualmente, siga alguns dos passos abaixo.
Use a função de validação interna do Caddy para verificar se o Caddyfile está correto. Execute o seguinte comando:
$ /Applications/ServBay/bin/caddy validate -c /Applications/ServBay/etc/caddy/Caddyfile
Se retornar Valid configuration
, tudo está normal. Se retornar outros códigos de erro, siga as instruções indicadas pelo código de erro. (Nota: O comando acima gerará muitas saídas INFO e WARN, o que é normal e não afetará a operação do serviço)
Erro de Certificado
Se aparecer um erro como loading certificates: open xxxxx: no such file or directory
, isso significa que o arquivo de certificado não existe. Verifique se o endereço do arquivo de certificado está correto.
2024/12/09 17:24:16.970 INFO usando configuração do arquivo {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
2024/12/09 17:24:16.991 INFO adaptando configuração para JSON {"adapter": "caddyfile"}
2024/12/09 17:24:16.991 WARN a entrada do Caddyfile não está formatada; execute 'caddy fmt --overwrite' para corrigir inconsistências {"adapter": "caddyfile", "file": "/Applications/ServBay/etc/caddy/Caddyfile", "line": 8}
2024/12/09 17:24:16.999 INFO tls.cache.maintenance iniciou a manutenção de certificados em segundo plano {"cache": "0x1400121f300"}
2024/12/09 17:24:17.006 INFO tls.cache.maintenance parou a manutenção de certificados em segundo plano {"cache": "0x1400121f300"}
Erro: carregando módulo do app http: provisionando http: obtendo app tls: carregando módulo app tls: provisionando tls: carregando certificados: aberta /Applications/ServBay/ssl/private/tls-certs/mail.servbay.host/mail.servbay.host.1crt: no such file or directory
2
3
4
5
6
7
Erro de Diretório do Site
Se aparecer o erro parsing caddyfile tokens for 'root': too many arguments
, verifique se o caminho do diretório do site contém espaços. Este é um erro muito comum.
Por exemplo, root * /Applications/ServBay/www/public web
, há um espaço entre public
e web
, que será considerado dois argumentos, causando o erro. A forma correta de configurar é usar aspas duplas (") para envolver o caminho. Por exemplo, root * "/Applications/ServBay/www/public web"
.
Recomendamos fortemente que não inclua espaços ou símbolos especiais em nomes de arquivos ou caminhos. Para separar palavras, você pode usar o símbolo -
ou _
, por exemplo: public-folder
, public_dir
.
2024/12/09 17:26:37.371 INFO usando configuração do arquivo {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}
Erro: adaptando configuração usando caddyfile: parsing caddyfile tokens for 'root': too many arguments; deve haver apenas um matcher e um caminho, em /Applications/ServBay/etc/caddy/Caddyfile:1388
2
3
Erros de Reescrita de Regras
Usar regras de reescrita incorretas no Caddy, como usar diretamente as regras do NGINX, também pode causar erros.