wils@web ~ $ cat ~/ajuda/como-configurar-virtualhosts-no-apache-2-4-para-ambientes-de-desenvolvimento-guia-passo-a-passo.md

Servidores

Como configurar VirtualHosts no Apache 2.4 para ambientes de desenvolvimento: Guia passo a passo

atualizado em 31/08/2026

Configurar VirtualHosts no Apache 2.4 é essencial para ambientes de desenvolvimento, permitindo que você hospede múltiplos sites em uma única máquina. Este guia passo a passo irá ajudá-lo a configurar VirtualHosts de forma eficaz.

Pré-requisitos

  • Apache 2.4 instalado
  • Acesso root ou sudo
  • Domínios ou subdomínios configurados no arquivo hosts

Passo 1: Habilitar o módulo de VirtualHost

O Apache já vem com o módulo de VirtualHost habilitado por padrão, mas é sempre bom verificar. Execute o seguinte comando:

sudo a2enmod vhost_alias

Passo 2: Criar arquivos de configuração para VirtualHosts

Crie um arquivo de configuração para cada VirtualHost em /etc/apache2/sites-available/. Por exemplo, para um site chamado meusite.local:

sudo nano /etc/apache2/sites-available/meusite.local.conf

Adicione o seguinte conteúdo ao arquivo:

<VirtualHost *:80> 
    ServerName meusite.local 
    DocumentRoot /var/www/meusite 
    ErrorLog ${APACHE_LOG_DIR}/meusite_error.log 
    CustomLog ${APACHE_LOG_DIR}/meusite_access.log combined 
</VirtualHost>

Passo 3: Criar o diretório do site

Crie o diretório onde os arquivos do seu site serão armazenados:

sudo mkdir /var/www/meusite

Adicione um arquivo index.html para testar:

echo '

Bem-vindo ao Meu Site!

' | sudo tee /var/www/meusite/index.html

Passo 4: Habilitar o VirtualHost

Habilite o VirtualHost que você criou:

sudo a2ensite meusite.local.conf

Passo 5: Atualizar o arquivo hosts

Adicione a seguinte linha ao seu arquivo /etc/hosts para que o domínio funcione localmente:

127.0.0.1 meusite.local

Passo 6: Reiniciar o Apache

Reinicie o Apache para aplicar as mudanças:

sudo systemctl restart apache2

Conclusão

Agora você pode acessar http://meusite.local no seu navegador. Para ambientes de desenvolvimento, você pode criar múltiplos VirtualHosts seguindo os mesmos passos. Dica: Sempre verifique os logs de erro se algo não funcionar como esperado, eles estão localizados em /var/log/apache2/.

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.