Guia de Solução de Problemas para Servidores Web

O ServBay suporta Caddy, NGINX e Apache como servidores web padrão. Durante o uso diário, os usuários podem encontrar problemas como sites que não abrem. A seguir, estão algumas soluções para problemas comuns.

Usando as Ferramentas de Diagnóstico do ServBay

O ServBay vem com uma ferramenta de diagnóstico muito poderosa. Recomendamos que você utilize a ferramenta de solução de problemas integrada ao ServBay para auto-diagnóstico e resolução de problemas.

Abra o aplicativo ServBay e encontre Diagnóstico na navegação à esquerda para acessar a ferramenta de diagnóstico do ServBay.

Verificando o Arquivo de Configuração

Verificação do Caddyfile

Use a funcionalidade de validação integrada 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 (Configuração válida), tudo está normal. Se retornar outros códigos de erro, siga as instruções fornecidas conforme o código de erro. (Observação: o comando acima gerará uma quantidade significativa de saídas INFO e WARN; isso é normal e não afetará a operação do serviço)

Erro de Certificado

Se você encontrar um erro como loading certificates: open xxxxx: no such file or directory, significa que o arquivo do certificado não existe. Verifique se o endereço do arquivo do 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 configuração adaptada 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 manutenção do cache tls iniciada em segundo plano {"cache": "0x1400121f300"}
2024/12/09 17:24:17.006 INFO manutenção do cache tls parada {"cache": "0x1400121f300"}

Error: loading http app module: provision http: getting tls app: loading tls app module: provision tls: loading certificates: open /Applications/ServBay/ssl/private/tls-certs/mail.servbay.host/mail.servbay.host.1crt: no such file or directory

Erro de Diretório do Site

Se você encontrar 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 bastante comum.

Por exemplo, root * /Applications/ServBay/www/public web, onde há um espaço entre public e web. Isso será interpretado como dois argumentos, causando erro. A maneira correta de configurar é usar aspas duplas (") para envolver o caminho. Por exemplo, root * "/Applications/ServBay/www/public web".

Recomendamos fortemente que você não inclua espaços ou símbolos especiais em nomes de arquivos e caminhos. Para separar palavras, pode-se utilizar os símbolos - ou _, como: public-folder, public_dir.

2024/12/09 17:26:37.371 INFO usando configuração do arquivo {"file": "/Applications/ServBay/etc/caddy/Caddyfile"}

Error: adapting config using caddyfile: parsing caddyfile tokens for 'root': too many arguments; should only be a matcher and a path, at /Applications/ServBay/etc/caddy/Caddyfile:1388

Erro nas Regras de Rewrite

Usar regras de Rewrite incorretas no Caddy, como diretamente regras do NGINX, também causará erros.

Verificação da Configuração do NGINX

Use o seguinte comando para verificar se a configuração do NGINX está correta:

$ /Applications/ServBay/bin/nginx -t

Se a configuração estiver correta, será exibido:

nginx: the configuration file /Applications/ServBay/etc/nginx/nginx.conf syntax is ok
nginx: configuration file /Applications/ServBay/etc/nginx/nginx.conf test is successful

Erros comuns incluem:

1. Erros de sintaxe (como falta de ponto e vírgula)
2. Caminho de arquivo incorreto
3. Conflitos de porta

Verificação da Configuração do Apache

Use o seguinte comando para verificar a configuração do Apache:

$ /Applications/ServBay/bin/apachectl configtest

Erros comuns incluem:

1. Falha ao carregar módulos
2. Erros de sintaxe no arquivo .htaccess
3. Configuração inadequada de permissões de diretório

Tratamento de Erros 500

O erro 500 de servidor interno é um erro comum em servidores web, podendo ser causado por diversos motivos:

Passos Gerais de Solução

1. Verifique os logs de erro do servidor:

   • Caddy: /Applications/ServBay/var/logs/caddy/error.log
   • NGINX: /Applications/ServBay/var/logs/nginx/error.log
   • Apache: /Applications/ServBay/var/logs/apache/error.log

2. Verifique se o serviço PHP está em execução:

   ps aux | grep php-fpm

3. Verifique os erros do PHP (se usar PHP):

   • /Applications/ServBay/var/logs/php/php_error.log

4. Verifique as permissões dos arquivos:

   $ ls -la /Applications/ServBay/www/your-site

   Certifique-se de que o usuário do servidor web tenha permissões de leitura.

Erros 500 Específicos ao Caddy

1. Verifique se a configuração do FastCGI está correta.
2. Assegure-se de que o serviço PHP-FPM está em execução.
3. Verifique as configurações do proxy reverso.

Erros 500 Específicos ao NGINX

1. Verifique se a configuração do fastcgi_pass está correta.
2. Verifique se client_max_body_size é grande o suficiente.
3. Verifique a configuração da diretiva try_files.

Erros 500 Específicos ao Apache

1. Verifique se o mod_rewrite está ativado.
2. Confira o conteúdo do arquivo .htaccess.
3. Verifique a configuração de AllowOverride.

Gestão de Serviços

Reiniciar Serviços

Se você fez modificações na configuração, será necessário reiniciar os serviços correspondentes:

# Caddy
$ servbayctl restart caddy -all

# NGINX
$ servbayctl restart nginx -all

# Apache
$ servbayctl restart apache -all

Verificar o Status dos Serviços

# Caddy
$ servbayctl status caddy -all

# NGINX
$ servbayctl status nginx -all

# Apache
$ servbayctl status apache -all

Solução de Problemas Avançada

Se as soluções acima não resolverem o problema, você pode tentar:

1. Desativar temporariamente o firewall para testes.
2. Usar curl -v para ver detalhes das requisições.
3. Testar em diferentes navegadores/dispositivos.
4. Verificar se a resolução DNS está correta.

Se precisar de mais ajuda, entre em contato com a equipe de suporte técnico da ServBay.