Usando RoundCube Webmail Com ISPConfig 3 No Debian Wheezy (nginx)

Este guia explica como instalar o aplicativo de webmail RoundCube em um servidor Debian Wheezy executando ISPConfig e nginx, 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, pesquisa 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 nginx como servidor web em seu servidor ISPConfig 3; este tutorial não funcionará para Apache. 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)).

Vou mostrar como configurar um vhost para o RoundCube para que ele possa ser acessado pelo alias /webmail (por exemplo, http://www.example.com/webmail).

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 de 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 de 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-extra

Você 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, vá para seu site no ISPConfig. Na aba Opções, você verá o campo Diretrizes do nginx:

Preencha as seguintes diretrizes e clique em Salvar (não importa se você tem PHP habilitado para este vhost ou não, porque este trecho de código usa o PHP padrão do sistema que é executado sob o usuário e grupo www-data, o que é importante porque o RoundCube está instalado fora do diretório raiz do documento do vhost - em /var/lib/roundcube):

| client_max_body_size 100M; location /roundcube { root /var/lib/; index index.php index.html index.htm; location ~ (.+\.php)$ { try_files $uri =404; include /etc/nginx/fastcgi_params; # Para acessar o SquirrelMail, o usuário padrão (como www-data no Debian/Ubuntu) deve ser usado #fastcgi_pass 127.0.0.1:9000; fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_index index.php; fastcgi_intercept_errors on; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_buffer_size 128k; fastcgi_buffers 256 4k; fastcgi_busy_buffers_size 256k; fastcgi_temp_file_write_size 256k; } location ~* /.svn/ { deny all; } location ~* /README|INSTALL|LICENSE|SQL|bin|CHANGELOG$ { deny all; } } location /webmail { rewrite ^ /roundcube last; } |

Com esta configuração, o RoundCube será acessível sob os URLs http://www.example.com/webmail e http://www.example.com/roundcube.

4 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_* /usr/share/roundcube/  
cd /usr/share/roundcube/  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php  
ln -s /usr/share/roundcube/ispconfig3_* /var/lib/roundcube/plugins/

Abra 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.example.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: