SquirrelMail · 3 min read · Jan 03, 2026

Habilitando o SquirrelMail Para Seus Sites Em Um Servidor ISPConfig 3 (Debian Lenny)

Muitas pessoas relataram problemas (como receber erros 404 Not Found) ao usar o pacote de webmail SquirrelMail em seus sites criados através do ISPConfig 3. Se você seguiu os guias “Servidor Perfeito” para o ISPConfig 3, você já tem o SquirrelMail instalado, mas se você ainda está tendo os mesmos problemas, então este guia é para você. Este guia explica como configurar o SquirrelMail em um servidor Debian Lenny para que você possa usá-lo a partir de seus sites (criados através do ISPConfig).

Configurando o SquirrelMail

A configuração do Apache para o SquirrelMail está no arquivo /etc/squirrelmail/apache.conf, mas este arquivo não é carregado pelo Apache porque não está no diretório /etc/apache2/conf.d/. Portanto, criamos um symlink chamado squirrelmail.conf no diretório /etc/apache2/conf.d/ que aponta para /etc/squirrelmail/apache.conf e recarregamos o Apache em seguida:

cd /etc/apache2/conf.d/  
ln -s ../../squirrelmail/apache.conf squirrelmail.conf  
/etc/init.d/apache2 reload

É isso - /etc/apache2/conf.d/squirrelmail.conf define um alias chamado /squirrelmail que aponta para o diretório de instalação do SquirrelMail /usr/share/squirrelmail.

Agora vá para o campo open_basedir do PHP na aba Opções do seu site no ISPConfig e adicione os diretórios /usr/share/squirrelmail e /etc/squirrelmail (esse é o diretório onde a configuração do SquirrelMail é armazenada) à linha, por exemplo, da seguinte forma:

Aguarde dois ou três minutos até que o ISPConfig tenha atualizado a configuração do site. Agora você pode acessar o SquirrelMail a partir do seu site da seguinte forma:

http://www.example.com/squirrelmail

Você também pode acessá-lo a partir do painel de controle do ISPConfig vhost da seguinte forma (isso não precisa de nenhuma configuração no ISPConfig):

http://server1.example.com:8080/squirrelmail

Se você gostaria de usar o alias /webmail em vez de /squirrelmail, basta abrir /etc/apache2/conf.d/squirrelmail.conf…

vi /etc/apache2/conf.d/squirrelmail.conf

… e adicionar a linha Alias /webmail /usr/share/squirrelmail:

Alias /squirrelmail /usr/share/squirrelmail
Alias /webmail /usr/share/squirrelmail


  Options Indexes FollowSymLinks
  
    php_flag register_globals off
  
  
    php_flag register_globals off
  
  
    DirectoryIndex index.php
  

  # o acesso ao configtest é limitado por padrão para evitar vazamento de informações
  
    order deny,allow
    deny from all
    allow from 127.0.0.1
  


# os usuários preferirão uma URL simples como http://webmail.example.com
#
#  DocumentRoot /usr/share/squirrelmail
#  ServerName webmail.example.com
#

# redirecionar para https quando disponível (obrigado [email protected])
#
#  Nota: Existem várias maneiras de fazer isso, e qual delas é adequada para
#  a configuração do seu site depende. Consulte a documentação do apache se
#  você não tiver certeza, pois este exemplo pode não funcionar em todos os lugares.
#
#
#  
#    
#      RewriteEngine on
#      RewriteCond %{HTTPS} !^on$ [NC]
#      RewriteRule . https://%{HTTP_HOST}%{REQUEST_URI}  [L]
#    
#  
#

Então recarregue o Apache:

service apache2 reload

Agora você pode acessar o Squirrelmail da seguinte forma:

http://www.example.com/webmail  
http://server1.example.com:8080/webmail

Se você gostaria de definir um vhost como webmail.example.com onde seus usuários possam acessar o SquirrelMail, você teria que adicionar a seguinte configuração de vhost ao /etc/apache2/conf.d/squirrelmail.conf:

nano /etc/apache2/conf.d/squirrelmail.conf
[...]

  DocumentRoot /usr/share/squirrelmail
  ServerName webmail.example.com

Certifique-se de substituir 1.2.3.4 pelo endereço IP correto do seu servidor. Claro, deve haver um registro DNS para webmail.example.com que aponte para o endereço IP que você usa na configuração do vhost. Também certifique-se de que o vhost webmail.example.com não exista no ISPConfig (caso contrário, ambos os vhosts irão interferir um no outro!).

Agora recarregue o Apache…

service apache2 reload

… e você pode acessar o SquirrelMail em http://webmail.example.com!

Links

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.