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

Servidores

Como configurar VirtualHosts no Apache 2.4 para ambientes de desenvolvimento isolados

atualizado em 29/07/2026

Configurar VirtualHosts no Apache 2.4 é essencial para criar ambientes de desenvolvimento isolados. Isso permite que você execute múltiplos sites em uma única máquina, cada um com sua própria configuração.

Pré-requisitos

  • Apache 2.4 instalado
  • Acesso root ou sudo

Passo a Passo

1. Habilitar o Módulo de Virtual Hosts

Certifique-se de que o módulo mod_vhost_alias esteja habilitado:

sudo a2enmod vhost_alias

2. Criar Diretórios para os Sites

Crie diretórios para os sites que você deseja configurar:

sudo mkdir -p /var/www/site1/public_html
sudo mkdir -p /var/www/site2/public_html

3. Definir Permissões

Defina as permissões corretas para os diretórios:

sudo chown -R $USER:$USER /var/www/site1/public_html
sudo chown -R $USER:$USER /var/www/site2/public_html
sudo chmod -R 755 /var/www

4. Criar Arquivos de Configuração dos VirtualHosts

Crie arquivos de configuração para cada site:

sudo nano /etc/apache2/sites-available/site1.conf
<VirtualHost *:80>
    ServerAdmin [email protected]
    ServerName site1.local
    DocumentRoot /var/www/site1/public_html
    ErrorLog ${APACHE_LOG_DIR}/site1_error.log
    CustomLog ${APACHE_LOG_DIR}/site1_access.log combined
</VirtualHost>
sudo nano /etc/apache2/sites-available/site2.conf
<VirtualHost *:80>
    ServerAdmin [email protected]
    ServerName site2.local
    DocumentRoot /var/www/site2/public_html
    ErrorLog ${APACHE_LOG_DIR}/site2_error.log
    CustomLog ${APACHE_LOG_DIR}/site2_access.log combined
</VirtualHost>

5. Habilitar os VirtualHosts

Ative os sites criados:

sudo a2ensite site1.conf
sudo a2ensite site2.conf

6. Reiniciar o Apache

Reinicie o Apache para aplicar as mudanças:

sudo systemctl restart apache2

7. Adicionar Entradas no Hosts

Edite o arquivo /etc/hosts para adicionar os domínios locais:

sudo nano /etc/hosts
127.0.0.1 site1.local
127.0.0.1 site2.local

Conclusão

Agora você tem dois ambientes de desenvolvimento isolados configurados. Utilize esta configuração para testar diferentes versões de aplicativos sem interferências.

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.