O /etc/sysconfig/apache2 controla algumas configurações globais do Apache, como módulos para carregar, arquivos de configuração adicionais para incluir, flags com os quais o servidor deve ser iniciado e flags que devem ser adicionados à linha de comando. Como toda opção de configuração desse arquivo está amplamente documentada, não são citadas aqui. No caso de um servidor Web de finalidade geral, as configurações em /etc/sysconfig/apache2 devem bastar para as necessidades de configuração.

	Nenhum módulo SuSEconfig do Apache
O módulo SuSEconfig do Apache foi removido do SUSE Linux. Ele deixou de ser necessário para a execução do SuSEconfig após a mudança de /etc/sysconfig/apache2.

/etc/apache2/ hospeda todos os arquivos de configuração do Apache. O propósito de cada arquivo é explicado a seguir. Cada um deles inclui várias opções de configuração (também chamadas de diretivas). Como todas as opções de configuração desses arquivos estão amplamente documentadas, não são citadas aqui.

Os arquivos de configuração do Apache são organizados da seguinte maneira:

 /etc/apache2/
 |
 |- charset.conv 
 |- conf.d/
 |   |
 |   |- *.conf
 |
 |- default-server.conf
 |- errors.conf
 |- httpd.conf
 |- listen.conf
 |- magic
 |- mime.types
 |- mod_*.conf
 |- server-tuning.conf
 |- ssl-global.conf
 |- ssl.*
 |- sysconfig.d
 |   |
 |   |- global.conf
 |   |- include.conf
 |   |- loadmodule.conf . .
 |
 |- uid.conf
 |- vhosts.d
 |   |- *.conf
     

No caso de hosts virtuais identificados por nome, cada endereço IP atende mais de um site da Web. O Apache usa o campo host no cabeçalho HTTP enviado pelo cliente para conectar a solicitação a uma entrada ServerName correspondente de uma das declarações do host virtual. Se não for encontrada nenhuma entrada ServerName, o primeiro host virtual especificado será usado como padrão.

A diretiva NameVirtualHost informa o Apache em qual endereço IP e, opcionalmente, em qual porta escutar solicitações de clientes que contêm o nome de domínio no cabeçalho HTTP. Essa opção é definida no arquivo de configuração /etc/apache2/listen.conf.

O primeiro argumento pode ser um nome de domínio completo, mas é recomendável usar o endereço IP. O segundo argumento é a porta (opcional). Por padrão, a porta 80 é usada e configurada através da diretiva Listen.

O curinga * pode ser usado para que o endereço IP e o número da porta recebam solicitações em todas as interfaces. Os endereços IPv6 devem ser colocados entre colchetes.

 
# NameVirtualHost Endereço IP[:Porta] NameVirtualHost 192.168.1.100:80 
NameVirtualHost 192.168.1.100 
NameVirtualHost *:80 
NameVirtualHost * 
NameVirtualHost [2002:c0a8:164::]:80 
      

A tag VirtualHost de abertura usa o endereço IP (ou nome de domínio completo) declarado anteriormente com NameVirtualHost como um argumento na configuração de host virtual identificado por nome. Um número de porta anteriormente declarado com a diretiva NameVirtualHost é opcional.

O curinga * também é permitido como substituto do endereço IP. Esta sintaxe somente é válida quando combinada ao curinga em NameVirtualHost *. Ao usar endereços IPv6, inclua o endereço entre colchetes.

 <VirtualHost 192.168.1.100:80> ... </VirtualHost>

<VirtualHost 192.168.1.100> ... </VirtualHost>

<VirtualHost *:80> ... </VirtualHost>

<VirtualHost *> ... </VirtualHost>

<VirtualHost [2002:c0a8:164::]> ... </VirtualHost> 

Esta configuração de host virtual alternativa requer a configuração de vários IPs para uma máquina. Uma instância do Apache hospeda vários domínios, a cada qual é atribuído um IP diferente.

O servidor físico deve ter um endereço IP para cada host virtual identificado por IP. Se a máquina não tiver várias placas de rede, interfaces de rede virtuais (álias de IP) também poderão ser usadas.

O seguinte exemplo mostra o Apache em execução em uma máquina com o IP 192.168.0.10, hospedando dois domínios nos IPs adicionais 192.168.0.20 e 192.168.0.30. É necessário um bloco VirtualHost separado para cada servidor virtual.

 <VirtualHost 192.168.0.20> ... </VirtualHost>

<VirtualHost 192.168.0.30> ... </VirtualHost> 

Aqui, as diretivas VirtualHost somente são especificadas para interfaces que não sejam 192.168.0.10. Quando uma diretiva Listen também é configurada para 192.168.0.10, é necessário criar um host virtual identificado por IP separado para responder aos pedidos HTTP àquela interface, caso contrário, serão aplicadas as diretivas encontradas na configuração do servidor padrão (/etc/apache2/default-server.conf).

É preciso que pelo menos as diretivas a seguir estejam presentes na configuração de cada host virtual para compor um host virtual. Consulte /etc/apache2/vhosts.d/vhost.template para conhecer mais opções.

Conforme mencionado acima, devido a motivos de segurança, é proibido o acesso ao sistema de arquivos inteiro por padrão. Portanto, desbloqueie explicitamente o diretório DocumentRoot no qual você colocou os arquivos a serem atendidos pelo Apache:

 <Directory "/srv/www/example.com_htdocs"> Order allow,deny Allow from all </Directory> 

O arquivo de configuração completo tem a seguinte aparência:

 
<VirtualHost 192.168.0.10> 
  ServerName www.exemplo.com 
  DocumentRoot /srv/www/exemplo.com_htdocs 
  ServerAdmin webmaster@exemplo.com 
  ErrorLog /var/log/apache2/www.exemplo.com_log 
  CustomLog /var/log/apache2/www.exemplo.com-access_log common 
  <Directory "/srv/www/exemplo.com"> 
    Order allow,deny 
    Allow from all 
  </Directory> 
</VirtualHost> 
      

Especifique aqui as interfaces e portas de rede usadas pelo Apache para escutar as solicitações recebidas. Você pode selecionar qualquer combinação de interfaces de rede existentes e seus respectivos endereços IP. As portas de todas as três faixas (portas conhecidas, portas registradas e portas dinâmicas ou privadas) que não forem reservadas por outros serviços poderão ser usadas. A configuração padrão é escutar em todas as interfaces de rede (endereços IP) pela porta 80.

Marque Abrir Firewall nas Portas Selecionadas para abrir as portas no firewall em que o servidor Web escuta. É necessário disponibilizar um servidor Web na rede, que pode ser uma LAN, uma WAN ou a Internet. Manter a porta fechada é útil somente nas situações de teste em que não é necessário nenhum acesso externo ao servidor Web.

Clique em Próximo para continuar a configuração.

A opção de configuração Módulos propicia a ativação ou desativação das linguagens de script para as quais o servidor Web deverá ter suporte. Para obter informações sobre a ativação ou desativação de outros módulos, consulte Seção 26.2.2.2.2, “Módulos do Servidor”. Clique em Próximo para avançar para a caixa de diálogo seguinte.

Esta opção pertence ao servidor Web padrão. Como explicado na Seção 26.2.1.2, “Configuração do host virtual”, o Apache pode atender a vários hosts virtuais a partir de uma única máquina física. O primeiro host virtual declarado no arquivo de configuração é normalmente conhecido como host padrão. Cada host virtual herda a configuração do host padrão.

Para editar as configurações do host (também chamadas de diretivas), escolha a entrada adequada na tabela e clique em Editar. Para adicionar novas diretivas, clique em Adicionar. Para apagar uma diretiva, selecione-a e clique em Excluir.

Figura 26.1. Assistente de Servidor HTTP: Host Padrão

Esta é a lista das configurações padrão do servidor:

Após concluir a etapa do Host Padrão, clique em Próximo para continuar a configuração.

Nesta etapa, o assistente exibe uma lista dos hosts virtuais já configurados (consulte Seção 26.2.1.2, “Configuração do host virtual”). Se você não tiver feito mudanças manualmente antes de iniciar o assistente de HTTP do YaST, somente um host virtual estará presente (idêntico ao host padrão configurado na etapa anterior). Ele está marcado como padrão (com um asterisco ao lado do nome do servidor).

Para adicionar um host, clique em Adicionar para abrir uma caixa de diálogo na qual inserir informações básicas sobre o host. Identificação de Servidor contém o nome do servidor, a raiz do conteúdo do servidor (DocumentRoot) e o e-mail do administrador. Resolução do Servidor é usado para determinar como um host é identificado (por nome ou por IP). Essas opções são explicadas em Seção 26.2.2.1.3, “Host Padrão”.

Clique em Próximo para avançar para a segunda parte da caixa de diálogo de configuração do host virtual.

Na parte 2 da configuração do host virtual especifique se os scripts CGI serão habilitados e os diretórios a serem usados para eles. Também é possível habilitar SSL. Para isso, é necessário especificar também o caminho para o certificado. Consulte a Seção 26.6.2, “Configurando o Apache com SSL” para obter detalhes sobre SSL e certificados. Com a opção Índice de Diretório, você pode especificar o arquivo a exibir quando o cliente solicita um diretório (por padrão, index.html). Adicione um ou mais nomes de arquivos (separados por espaços) se desejar mudar essa definição. Com a opção Habilitar HTML Público, o conteúdo dos diretórios públicos dos usuários (~user/public_html/) é disponibilizado no servidor em http://www.example.com/~user.

	Criando hosts virtuais
Não é possível adicionar hosts virtuais à vontade. Quando se usa hosts virtuais identificados por nome, cada nome de host deverá ser resolvido na rede. No caso de hosts virtuais identificados por IP, você só pode designar um host para cada endereço IP disponível.

Esta é a etapa final do assistente. Determine como e quando o servidor Apache deve ser iniciado: durante a inicialização ou manualmente. Consulte também um breve resumo sobre a configuração feita até o momento. Se você estiver satisfeito com as configurações, clique em Concluir para concluir a configuração. Para mudar algo, clique em Anterior até chegar à caixa de diálogo desejada. Clique em Configuração Especialista de Servidor HTTP para abrir a caixa de diálogo descrita em Seção 26.2.2.2, “Configuração de Servidor HTTP”.

Figura 26.2. Assistente de Servidor HTTP: Resumo

Em Serviço HTTP, defina se o Apache deverá estar em execução (Habilitado) ou parado (Desabilitado). Em Escutar nas Portas, Adicione, Edite, ou Apague endereços e portas nos quais o servidor deverá estar disponível. O padrão é escutar em todas as interfaces pela porta 80. Sempre marque a opção Abrir Firewall nas Portas Selecionadas, senão o servidor Web não poderá ser alcançado do exterior. Manter a porta fechada é útil somente nas situações de teste em que não é necessário nenhum acesso externo ao servidor Web.

Com Arquivos de Registro, observe o registro de acesso ou o registro de erros. Isso é útil para testar a configuração. O arquivo de registro abre uma janela separada, na qual você também pode reiniciar ou recarregar o servidor Web (consulte a Seção 26.3, “Iniciando e parando o Apache” para obter detalhes). Esses comandos são efetivados imediatamente.

Figura 26.3. Configuração de Servidor HTTP: Escutar Portas e Endereços

Você pode mudar o status (habilitado ou desabilitado) dos módulos do Apache2 clicando em Toggle Status. Clique em Adicionar Módulo para adicionar um novo módulo que já esteja instalado mas não relacionado. Saiba mais sobre módulos na Seção 26.4, “Instalando, ativando e configurando módulos”.

Figura 26.4. Configuração de Servidor HTTP: Módulos do Servidor

Essas caixas de diálogo são idênticas às que já foram descritas. Consulte Seção 26.2.2.1.3, “Host Padrão” e Seção 26.2.2.1.4, “Hosts Virtuais”.