Configurando o Serviço DNS do ServBay (dnsmasq)

O ServBay utiliza o serviço dnsmasq integrado para fornecer aos desenvolvedores uma poderosa e flexível capacidade de resolução de DNS local. Isso é essencial para gerenciar domínios locais de desenvolvimento (por exemplo, domínios com sufixo .servbay.demo) e para controlar o encaminhamento de outras solicitações DNS.

Este guia detalha como configurar o dnsmasq no ServBay, com ênfase na configuração recomendada via interface do usuário e na localização dos arquivos de configuração.

Aviso Importante

O ServBay gerencia automaticamente os arquivos de configuração do dnsmasq (como dnsmasq.conf e domains.conf). Por favor, não modifique esses arquivos manualmente. O ServBay irá atualizar e sobrescrever esses arquivos periodicamente, de acordo com as configurações feitas na interface do usuário ou pela sua lógica interna. Alterações manuais podem ser perdidas ou causar comportamentos inesperados.

Todas as configurações recomendadas do dnsmasq devem ser feitas através da interface do ServBay.

Localização dos Arquivos de Configuração do dnsmasq (Gerenciados pelo ServBay)

Os arquivos de configuração gerados automaticamente pelo ServBay para o dnsmasq encontram-se no diretório /Applications/ServBay/etc/dnsmasq. Conhecer esses locais ajuda a entender como o ServBay gerencia o DNS, mas lembre-se de não editá-los manualmente:

• dnsmasq.conf: Arquivo de configuração principal, gerado automaticamente pelo ServBay de acordo com suas configurações gerais.
• domains.conf: Gerenciado pelo ServBay e destinado exclusivamente aos registros de resolução de domínios locais adicionados pela interface do usuário.

Configurando o dnsmasq pela Interface do ServBay

O ServBay oferece uma interface do usuário intuitiva para gerenciar as principais configurações do dnsmasq.

Definindo o Servidor DNS Upstream

Ao definir servidores DNS upstream, você controla como o dnsmasq trata solicitações de domínios que não podem ser resolvidos localmente pelo ServBay (ou seja, domínios que não fazem parte dos domínios de desenvolvimento configurados localmente). Essas solicitações serão encaminhadas para os servidores DNS upstream especificados.

1. Abra a interface administrativa do ServBay.
2. Clique em Configurações na barra superior.
3. Selecione a aba Encaminhamento DNS.
4. Nesta tela, é possível adicionar, editar ou remover endereços de servidores DNS upstream.

Por padrão, o ServBay detecta automaticamente os endereços dos servidores DNS upstream do ambiente de rede atual (geralmente atribuídos via DHCP), como 192.168.0.1 ou 10.0.0.1. Você pode alterá-los conforme necessário para serviços DNS públicos (como Google DNS 8.8.8.8/8.8.4.4 ou Cloudflare DNS 1.1.1.1/1.0.0.1), ou para outros servidores DNS internos.

Gerenciando a Resolução de Domínios Locais

O ServBay permite configurar facilmente domínios personalizados para projetos de desenvolvimento local, mapeando-os para endereço IP local (normalmente, 127.0.0.1). Essas configurações são escritas automaticamente pelo ServBay no arquivo domains.conf.

Por exemplo, você pode mapear myproject.servbay.demo para 127.0.0.1, facilitando o acesso ao seu projeto local usando esse domínio no navegador.

Para ver o passo a passo detalhado para gerenciar a resolução de domínios locais, consulte o seguinte documento:

• Gerenciar serviço DNS local

Atenção: O método apresentado no documento Gerenciar serviço DNS local é a forma correta e recomendada para configurar domínios locais. Evite editar diretamente o arquivo domains.conf.

Reiniciando o Serviço dnsmasq

Sempre que você realizar alguma alteração nas configurações do dnsmasq pela interface do ServBay (como modificar DNS upstream ou adicionar domínios locais), é necessário reiniciar o serviço dnsmasq para aplicar as mudanças.

Você pode reiniciar via interface do ServBay ou pela ferramenta de linha de comando servbayctl.

Reiniciando pela Interface do ServBay

1. Abra a interface administrativa do ServBay.
2. No menu lateral, localize e clique em Pacotes.
3. Na lista de pacotes, encontre dnsmasq e clique no botão Reiniciar ao lado.

Reiniciando com a Ferramenta de Linha de Comando servbayctl

Abra o aplicativo Terminal e use o comando servbayctl para reiniciar facilmente o serviço dnsmasq:

servbayctl restart dnsmasq -all

O parâmetro -all garante que serviços dependentes (se houver) também sejam considerados, mas para um reinício independente do dnsmasq, reiniciará apenas o próprio processo do dnsmasq.

Conclusão

O ServBay oferece, por meio do dnsmasq integrado, uma funcionalidade essencial de resolução DNS local, indispensável para um desenvolvimento web eficiente. É altamente recomendado que todas as configurações principais do dnsmasq — como designação de servidores DNS upstream e gerenciamento de domínios de desenvolvimento locais — sejam feitas exclusivamente pela interface do ServBay. Evite modificar manualmente os arquivos de configuração do dnsmasq, já que o ServBay os gerencia automaticamente. Após qualquer alteração, reinicie o serviço dnsmasq pela interface do usuário ou pela ferramenta servbayctl para garantir que as configurações tenham efeito.