RoundCube Webmail No Seu Servidor ISPConfig Em 10 Passos Fáceis

Versão 2.1
Autor: [at] bb-hosting [dot] org>

Existem pacotes legais do RoundCube disponíveis para ISPConfig em http://www.ispconfig.org/downloads.htm

O pacote RoundCube de sua escolha pode ser instalado com o Gerenciador de Atualizações do ISPConfig. No entanto, se você preferir configurar o RoundCube em seu servidor ISPConfig no espaço da web de sua escolha rodando na porta 80, você pode usar este “Como fazer” como uma alternativa.

Neste como fazer, usarei como exemplo:

nome do domínio webmail.minhaempresa.tld
nome do banco de dados MySQL: web_db1
nome de usuário MySQL: web1_u1
senha do usuário MySQL: senhadomysql
versão do RoundCube 0.1.1

Quando você terminar com este “Como fazer”, terá um bom cliente de webmail na URL http://webmail.minhaempresa.tld.

O passo 2 não é realmente necessário, mas pode ser muito prático se você quiser fazer upload/download do seu site usando FTP. Isso é muito útil se você quiser personalizar o site do RoundCube em sua área de trabalho local.

Aqui vamos nós:

Passo 1 - Criar um site:

No ISPConfig, crie um site através de “Novo site” no menu principal.
Na aba chamada “Base”, use webmail para o nome do host e minhaempresa.tld para o nome do domínio. Ative MySQL e scripts PHP para este site, mas desative o Modo Seguro do PHP. O RoundCube faz uso de arquivos .htaccess. Para permitir esses arquivos dentro do seu site, adicione as seguintes linhas no campo de diretiva Apache do seu site:

  
Options FollowSymLinks  
AllowOverride All

Passo 2 – Criar um usuário Administrador para o site:

No ISPConfig, crie um usuário Administrador, para que você possa fazer upload do site mais tarde via FTP:
No menu principal, selecione “Gerenciador ISP”, selecione seu novo site chamado webmail.minhaempresa.tld na árvore de estrutura e pressione a aba “Usuário e Email”.
Pressione “novo” e defina um novo usuário e seu endereço de e-mail. Dê a esse usuário direitos de administrador e pressione “Salvar”.

Passo 3 - Criar um banco de dados MySQL para o site:

Clique na aba chamada “Opções” e crie um novo banco de dados para o site.
O ISPConfig mostrará:
Nome do banco de dados: web1_db1 (exemplo)
Usuário do banco de dados: web1_u1 (exemplo)
Em seguida, defina uma senha para o usuário do banco de dados e pressione “Salvar”.

Passo 4 – Baixar/extrair os pacotes e remover alguns arquivos:

Faça login no seu servidor como root.
A versão mais estável neste momento é a 0.1.1.
Mude para a web onde você deseja baixar o RoundCube dando o comando:

cd /var/www/web1/web/
wget http://downloads.sourceforge.net/roundcubemail/roundcubemail-0.1.1.tar.gz

Extraia o RoundCube com o comando:

tar xzf roundcubemail-0.1.1.tar.gz

Remova os arquivos tar.gz:

rm *.tar.gz

Passo 5 - Mover os arquivos para o diretório da web e deletar o diretório vazio:

cd roundcubemail-0.1.1
mv * ../
cd ../
rmdir roundcubemail-0.1.1

Passo 6 – tornando o diretório temp e logs legível/gratável para o Apache:

Dentro da sua pasta web /var/www/web1/web, você dá ao processo do seu servidor web privilégios de leitura/gravação para todas as pastas no diretório temp e logs dando esses comandos:

chown -R www-data:www-data temp  
chown -R www-data:www-data logs

(Isto é como funciona no Debian Linux, outras distribuições podem diferir).
Também é possível chmod os diretórios temp e logs para 777, mas isso não é seguro.

Se você usar php5-cgi com suPHP habilitado em seu servidor ISPConfig, execute os seguintes comandos:

cd /var/www/web1/

chown -R -v -f webadmin:web1 web/

(Lembre-se que “web1” e o nome de usuário “webadmin” são de acordo com meu exemplo, use seu próprio número de web e nome de usuário em vez disso!)

Passo 7 – Configurar o RoundCube (manualmente):

Com este método, você tem mais opções disponíveis!
Navegue até a pasta de configuração com o comando:

cd config

Aqui você encontrará dois arquivos, db.inc.php.dist e main.inc.php.dist.
Renomeie main.inc.php.dist e db.inc.php.dist removendo .dist.
Agora você tem dois arquivos db.inc.php e main.inc.php.

Modificações a serem feitas no arquivo db.inc.php:

Abra db.inc.php em um editor de texto.
Damos ao RoundCube uma maneira de acessar nosso banco de dados recém-criado alterando a linha:

$rcmail_config[’db_dsnw’]=’mysql:// roundcube:pass@localhost/roundcubemail’;

para:

$rcmail_config[’db_dsnw’]=’mysql:// web1_u1:senhadomysql@localhost/web1_db1’;

Certifique-se de que você tenha a seguinte linha também:

$rcmail_config[‘db_backend’] = ‘mdb2’;

Modificações a serem feitas no arquivo main.inc.php:

Abra seu arquivo main.inc.php com um editor de texto:

Mudanças a serem feitas em main.inc.php:

Altere a linha:

$rcmail_config[’default_host’] = ‘’;

para

$rcmail_config[’default_host’] = ‘localhost’;

ou para:

$rcmail_config[’default_host’] = ‘’;

se você preferir escolher um nome de servidor no login.

Você pode manter todas as configurações de configuração como padrão, mas certifique-se de ter as seguintes linhas:

$rcmail_config[‘default_port’] = 143;

$rcmail_config[‘virtuser_file’] = ‘/etc/postfix/virtusertable’;

$rcmail_config[‘smtp_server’] = ‘’;

$rcmail_config[‘smtp_port’] = 25;

$rcmail_config[‘create_default_folders’] = TRUE;

$rcmail_config[‘prefer_html’] = TRUE;

$rcmail_config[‘htmleditor’] = FALSE;

$rcmail_config[‘preview_pane’] = TRUE;

$rcmail_config[‘enable_spellcheck’] = TRUE;

A próxima linha precisa de atenção extra por razões de segurança:

$rcmail_config[‘des_key’] = ‘’;

Substitua ‘’ por uma string de exatamente 24 caracteres!

Quando um usuário faz login com o endereço de e-mail pela primeira vez, dentro da seção de identidades do RoundCube, o endereço de e-mail será exibido como: [email protected]. Como queremos que o endereço de e-mail seja exibido como [email protected], faça o seguinte:

Altere a linha 709 dentro do arquivo /program/include/main.inc de:

709 $line = trim($line);

para:

709 $line = trim(str_replace(“www.”, “”, $line));

Certifique-se de que você tenha a seguinte linha dentro do seu arquivo php.ini:

; Magic quotes para dados GET/POST/Cookie recebidos.
magic_quotes_gpc = Off

Se foi necessário alterar a linha de

magic_quotes_gpc = On

para

magic_quotes_gpc = Off

então reinicie o Apache2 depois com o comando:

/etc/init.d/apache2 restart

Passo 8 – Configurar o RoundCube (forma alternativa usando o script de instalação):

O RoundCube vem com um bom script de instalação. Este método alternativo é uma maneira muito fácil de configurar o RoundCube. Dentro do seu navegador, visite seu novo site RoundCube em http://webmail.seuempresa.tld/installer/index.php.

Imagem do RoundCube 1

Leia os requisitos básicos e pressione o botão “INICIAR INSTALAÇÃO”.
Na tela “Verificar Ambiente”, os requisitos do sistema são verificados.

Se um ou mais requisitos do sistema forem exibidos na cor vermelha, a configuração precisa ser alterada para garantir que o RoundCube funcione corretamente.

Em um servidor ISPConfig padrão, tudo deve estar ok, provavelmente você só precisa desativar magic_quotes_gpc dentro do seu arquivo php.ini.
Se os requisitos do sistema estiverem bons, pressione o botão “PRÓXIMO”.

Na tela “Criar configuração”, você pode definir a configuração do sistema necessária.
Defina as configurações de configuração, como fizemos antes no Passo 7 deste como fazer.
Defina as configurações do banco de dados de acordo com nosso banco de dados MySQL, conforme definimos no ISPConfig:

Imagem do RoundCube 2

Finalmente, pressione o botão “CRIAR CONFIGURAÇÃO”.

Duas configurações são exibidas.
Copie a primeira configuração dentro do arquivo main.inc.php e a segunda configuração dentro do arquivo db.inc.php. Salve esses arquivos dentro do diretório config/ da sua instalação do RoundCube.
Pressione o botão “Continuar”

Imagem do RoundCube 3

Os resultados são exibidos.
Agora testamos a configuração SMTP e IMAP.
Após concluir a instalação e os testes finais, remova toda a pasta do instalador do diretório raiz da sua instalação do RoundCube.

Finalmente, altere a linha 709 dentro do arquivo /program/include/main.inc conforme descrito no passo 7 deste como fazer.

Passo 9 – acesse seu novo cliente de webmail:

Agora você pode apontar para seu novo cliente de webmail com seu navegador favorito. O endereço de acordo com meu como fazer é: http://webmail.minhaempresa.tld

Você pode fazer login com qualquer combinação válida de nome de usuário/senha ou endereço de e-mail/senha, conforme definido no ISPConfig.

Após seu primeiro login, você deve fazer algumas configurações antes de começar a usar o RoundCube. Aqui, a primeira coisa que você deve fazer é definir sua identidade. Você pode definir mais de uma identidade para um endereço de e-mail, mas precisa de pelo menos uma. Quando você cria uma identidade, altere também @localhost para @seudominio.tld, se necessário.

PASSO 10 – Personalizando o RoundCube:

Se você deseja personalizar o RoundCube webmail, recomendo o como fazer de Paul Stamatiou na URL: http://paulstamatiou.com/2005/10/29/how-to-setup-roundcube-webmail-on-your-server/

Antes de começar a personalizar o RoundCube, recomendo que você o baixe primeiro usando sua conta de administrador, conforme mencionado no PASSO 2. Personalizar o RoundCube webmail em sua área de trabalho local é mais confortável.

Informações:

Mais informações sobre o RoundCube: http://www.roundcube.net/

Agradecimentos especiais a:

Pauls Stamatiou, que escreveu e publicou um bom como fazer para configurar o RoundCube http://paulstamatiou.com/2005/10/29/how-to-setup-roundcube-webmail-on-your-server/

Os membros do Howtoforge por suas contribuições úteis!