Webmail Setup · 4 min read · Jan 14, 2026
Usando RoundCube Webmail Com ISPConfig 3 No Debian Wheezy (Apache2)
Este guia explica como instalar o aplicativo de webmail RoundCube em um servidor Debian Wheezy executando ISPConfig e Apache2, e como habilitar os plugins do ISPConfig 3 para RoundCube para que os usuários possam realizar ações como alterar suas senhas de e-mail a partir do RoundCube. O webmail RoundCube é um cliente IMAP multilíngue baseado em navegador com uma interface de usuário semelhante a um aplicativo; ele vem com funções como suporte a MIME, agenda, manipulação de pastas, busca de mensagens e verificação ortográfica.
Não dou nenhuma garantia de que isso funcionará para você!
1 Nota Preliminar
Este tutorial assume que você está usando Apache2 como o servidor web em seu servidor ISPConfig 3; este tutorial não funcionará para nginx. Vou instalar o RoundCube a partir dos repositórios do Debian Wheezy - é uma versão razoavelmente recente (0.7.2.9 vs 0.9.1 (versão estável atual)).
O RoundCube será configurado de tal forma que pode ser acessado de cada vhost através do alias /webmail (por exemplo, http://www.exemplo.com/webmail).
Se você já estiver usando outro aplicativo de webmail como SquirrelMail, certifique-se de desativá-lo completamente ou pelo menos o alias /webmail. Se você instalou o SquirrelMail como um pacote Debian, pode encontrar o alias em /etc/apache2/conf.d/squirrelmail.conf; comente o alias para desativar apenas o alias /webmail ou comente o arquivo inteiro para desativar completamente o SquirrelMail. Não se esqueça de reiniciar o Apache depois.
2 Criando Um Usuário Remoto No ISPConfig
Os plugins do ISPConfig 3 para RoundCube funcionam através da API remota do ISPConfig. Para usar esta API, precisamos de um usuário remoto. Para criar tal usuário, vá para Sistema > Gerenciamento de Usuários > Usuários Remotos e clique no botão Adicionar novo usuário:
Forneça um nome de usuário e senha para o usuário…
… e habilite as seguintes funções:
- Funções do servidor
- Funções do cliente
- Funções do usuário de e-mail
- Funções do alias de e-mail
- Funções do usuário do filtro de spam de e-mail
- Funções da política de filtro de spam de e-mail
- Funções do fetchmail de e-mail
- Funções da lista branca do filtro de spam de e-mail
- Funções da lista negra do filtro de spam de e-mail
- Funções do filtro do usuário de e-mail
Então clique em Salvar.
3 Instalando o RoundCube
Podemos instalar o RoundCube da seguinte forma:
apt-get install roundcube roundcube-plugins roundcube-plugins-extraVocê verá as seguintes perguntas:
Configurar banco de dados para roundcube com dbconfig-common? <– Sim
Tipo de banco de dados a ser usado pelo roundcube: <– mysql
Senha do usuário administrativo do banco de dados: <– sua_senha_sql_root (a senha do usuário root do MySQL)
Senha do aplicativo MySQL para roundcube: <– senha_sql_roundcube
Confirmação da senha: <– senha_sql_roundcube
Isso criará um banco de dados MySQL chamado roundcube com o usuário MySQL roundcube e a senha senha_sql_roundcube.
Em seguida, abra /etc/apache2/conf.d/roundcube…
vi /etc/apache2/conf.d/roundcube… e adicione a linha Alias /webmail /var/lib/roundcube. Além disso, adicione a configuração PHP à seção
| # Esses aliases não funcionam corretamente com vários hosts em seu servidor apache # Descomente-os para usá-los ou adapte-os à sua configuração Alias /roundcube/program/js/tiny_mce/ /usr/share/tinymce/www/ Alias /roundcube /var/lib/roundcube Alias /webmail /var/lib/roundcube # Acesso aos arquivos tinymce |
Reinicie o Apache depois:
/etc/init.d/apache2 restart4 Configurando o RoundCube
Abra /etc/roundcube/main.inc.php…
vi /etc/roundcube/main.inc.php… e defina $rcmail_config[‘default_host’] = ‘localhost’; (ou o nome do host ou endereço IP do seu servidor de e-mail se estiver em uma máquina remota):
| [...] $rcmail_config['default_host'] = 'localhost'; [...] |
Caso contrário, o RoundCube pedirá um nome de host antes de cada login, o que pode sobrecarregar seus usuários - queremos tornar o uso o mais fácil possível.
Em seguida, instale os plugins do ISPConfig 3 para RoundCube:
cd /tmp
git clone https://github.com/w2c/ispconfig3_roundcube.git
cd /tmp/ispconfig3_roundcube/
mv ispconfig3_* /var/lib/roundcube/plugins
cd /var/lib/roundcube/plugins
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.phpAbra ispconfig3_account/config/config.inc.php…
vi ispconfig3_account/config/config.inc.php… e preencha os detalhes de login do seu usuário remoto do ISPConfig e a URL da API remota - minha instalação do ISPConfig está em https://192.168.0.100:8080, então a URL da API remota é https://192.168.0.100:8080/remote/:
| |
Finalmente, abra /etc/roundcube/main.inc.php novamente…
vi /etc/roundcube/main.inc.php… e habilite o plugin jquerui além dos plugins do ISPConfig 3…
| [...] // ---------------------------------- // PLUGINS // ---------------------------------- // Lista de plugins ativos (no diretório plugins/) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |
… e mude o tema de default para classic (caso contrário, os plugins do ISPConfig 3 não funcionarão):
| [...] // nome do tema: pasta de skins/ $rcmail_config['skin'] = 'classic'; [...] |
É isso; agora você pode acessar o RoundCube sob o alias /webmail (por exemplo, www.exemplo.com/webmail). Faça login com o endereço de e-mail e a senha de uma conta de e-mail criada através do ISPConfig:
Assim é como o RoundCube se parece:
Em Configurações > Conta, você pode usar os plugins do ISPConfig 3 para RoundCube para modificar suas configurações, por exemplo…
… você pode definir uma nova senha para sua conta de e-mail sem usar o ISPConfig:
5 Links
- RoundCube: http://roundcube.net/
- Plugins do ISPConfig 3 para RoundCube: https://github.com/w2c/ispconfig3_roundcube
- ISPConfig: http://www.ispconfig.org/
- Debian: http://www.debian.org/
Receba novas postagens na sua caixa de entrada
Sem spam. Cancele a assinatura a qualquer momento.