Perguntas Frequentes do ServBay

Ao utilizar o ambiente local de desenvolvimento web do ServBay, desenvolvedores podem encontrar alguns desafios. Este documento tem como objetivo responder duas dúvidas frequentes: como atualizar o ServBay Runtime e como resolver o problema de acesso a sites locais quando se utiliza ferramentas de proxy como o ClashX Pro.

Como atualizar o ServBay Runtime?

O ServBay Runtime é um componente central do ServBay, essencial para garantir o funcionamento estável do ServBay e dos serviços hospedados. Quando uma nova versão é lançada, o ServBay notificará o usuário no momento da inicialização. Manter o Runtime atualizado ajuda a melhorar o desempenho, a estabilidade e a compatibilidade geral do ServBay.

Para atualizar o ServBay Runtime, siga os passos abaixo:

1. Abra o aplicativo ServBay.
2. No menu de navegação à esquerda da janela do ServBay, selecione Pacotes > Serviços Gerais.
3. No painel à direita, localize a entrada ServBay Runtime.
4. Se houver uma atualização disponível para o ServBay Runtime, será exibido um aviso amarelo de atualização ou um botão de upgrade. Clique no botão amarelo de atualização.
5. O ServBay iniciará o download e a instalação da versão mais recente do Runtime. Aguarde até que o processo de atualização seja concluído.

Depois de concluir a atualização, o ServBay Runtime estará rodando na versão mais recente, proporcionando maior estabilidade e desempenho.

Por que, ao usar o ClashX Pro (ou outras ferramentas de proxy), não consigo acessar meus sites locais do ServBay?

Muitos desenvolvedores utilizam o ServBay para desenvolvimento e testes locais, frequentemente configurando domínios personalizados para o ambiente local (por exemplo, servbay.demo, myproject.servbay.demo etc.), que geralmente apontam para o endereço de loopback 127.0.0.1.

Ao utilizar o ClashX Pro ou outras ferramentas de VPN/proxy (como Surge, Quantumult X etc.), essas ferramentas podem interceptar ou redirecionar as solicitações de DNS para forçar que toda a resolução de domínios passe pelos servidores de proxy. Esse comportamento contorna o fluxo normal de resolução DNS do sistema operacional e ignora as configurações do arquivo hosts local (que normalmente são usadas pelo ServBay para resolução de domínios locais), impedindo que os domínios de desenvolvimento configurados no ServBay sejam resolvidos corretamente para o endereço IP local. Assim, não é possível acessar seus sites locais.

Para solucionar este problema, é necessário adicionar regras de exceção na configuração da ferramenta de proxy, instruindo-a a não fazer proxy nem interceptar as solicitações DNS dos seus domínios locais de desenvolvimento. Normalmente, isso é feito configurando “bypass do proxy”, “ignorar proxy”, “lista branca” ou “lista de exclusão”.

Usando o ClashX Pro como exemplo, siga as etapas abaixo:

1. Abra o aplicativo ClashX Pro.
2. Na barra de menu do macOS, localize o ícone do ClashX Pro, clique nele e selecione Mais configurações.
3. Na janela de configurações que será exibida, acesse a aba Geral.
4. Procure pelo campo chamado Hosts e domínios sem proxy (ou nomenclatura semelhante).
5. Adicione os domínios locais de desenvolvimento nessa lista. Para cobrir os domínios mais comuns utilizados no ServBay, recomenda-se adicionar localhost, 127.0.0.1 e também os domínios específicos ou curingas utilizados por você no ServBay. Por exemplo, se você usa .servbay.demo como sufixo de domínio, adicione *.servbay.demo. Normalmente, os diferentes itens são separados por vírgula , ou por quebras de linha. Um exemplo típico ficaria assim:

   localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo

6. Salve as configurações e, caso haja uma solicitação do ClashX Pro, recarregue ou aplique as alterações para que entrem em vigor.

(Imagem: Configuração dos hosts e domínios sem proxy no ClashX Pro)

Após essa configuração, o ClashX Pro deixará de interferir na resolução dos domínios locais especificados, e seus sites do ServBay deverão funcionar normalmente. Caso o problema persista, confirme se o domínio está corretamente configurado nas Configurações de site do ServBay e se os serviços relevantes do ServBay (como Caddy ou Nginx) estão em execução normalmente. Você também pode usar comandos no terminal como ping yourproject.servbay.demo ou dig yourproject.servbay.demo para diagnosticar a resolução do domínio.