Instalação RoundCube · 8 min read · Feb 09, 2026

Instalação do RoundCube webmail no Debian 8 (Jessie)

Este tutorial mostra a instalação do mais recente RoundCube webmail no Debian 8. Roundcube é um cliente de webmail fácil de usar com suporte a IMAP e SMTP que pode ser estendido com plugins. No Debian 7, o RoundCube estava disponível como pacote .deb, não era a versão mais recente, mas pelo menos era fácil de instalar com apt. Para a versão atual do Debian, não há mais pacote RoundCube disponível, então descreverei a instalação a partir do código-fonte aqui. Este tutorial contém um capítulo opcional que descreve os passos para conectar o RoundCube com o Painel de Controle de Hospedagem ISPConfig 3.

Pré-requisitos

  • Sistema Operacional Debian 8.
  • Servidor web Apache com mod_php instalado. Se ainda não houver apache instalado, então dê uma olhada em nosso guia LAMP ou configuração de Servidor Perfeito para instalar um ambiente adequado.
  • Um servidor de email (SMTP + IMAP) ao qual o Roundcube deve se conectar. Isso pode ser o servidor local (por exemplo, quando você usa uma das configurações de servidor perfeito) ou um servidor remoto.
  • O nome do host do servidor que usarei neste tutorial é server1.example.com com o endereço IP 192.168.1.100. Por favor, substitua isso pelo IP e nome do host do seu servidor.

Instalação do RoundCube

Vou instalar o RoundCube no diretório /opt/roundcube para garantir que esta instalação não colida com nenhum pacote do sistema Debian. O primeiro passo é instalar o wget, criar o diretório /opt/roundcube e baixar a versão mais recente do RoundCube com wget para este diretório. A versão atual do RoundCube é 1.1.3 no momento em que escrevo este tutorial, dê uma olhada no site do RoundCube para verificar se há uma versão mais recente que você pode usar.

Faça login como usuário root no shell do seu servidor, então instale wget e o editor nano:

apt-get install wget nano

Crie o diretório e entre nele com o comando “cd”:

mkdir /opt/roundcube  
cd /opt/roundcube

Baixe o arquivo tar.gz do RoundCube e descompacte-o:

wget https://downloads.sourceforge.net/project/roundcubemail/roundcubemail/1.1.3/roundcubemail-1.1.3-complete.tar.gz  
tar xfz roundcubemail-1.1.3-complete.tar.gz

Os arquivos do RoundCube estão agora na pasta /opt/roundcube/roundcubemail-1.1.3. O próximo passo é movê-los um diretório acima para /opt/roundcube.

mv roundcubemail-1.1.3/* .  
mv roundcubemail-1.1.3/.htaccess .

O ponto no final dos dois comandos é necessário e parte do comando, não o perca! Exclua o diretório vazio e o arquivo tar.gz.

rmdir roundcubemail-1.1.3  
rm roundcubemail-1.1.3-complete.tar.gz

E mude o proprietário de todos os arquivos para o usuário sob o qual o servidor Apache está sendo executado.

chown -R www-data:www-data /opt/roundcube

Instalar o Banco de Dados do RoundCube

O Roundcube requer um banco de dados para armazenar configurações de caixa de correio, contatos, etc. Vou usar MySQL (ou MariaDB) aqui como backend de banco de dados. Agora criaremos um banco de dados com o nome “roundcubemail” e um usuário com o nome “roundcube” no MySQL.

Faça login no servidor MySQL com o seguinte comando:

mysql --defaults-file=/etc/mysql/debian.cnf

Em seguida, execute os seguintes comandos no shell do banco de dados MySQL para criar o banco de dados e o usuário do banco de dados. Substitua a palavra “secretpassword” nos comandos abaixo por uma senha de sua escolha.

CREATE DATABASE roundcubemail;  
GRANT ALL PRIVILEGES ON roundcubemail.* TO roundcube@localhost IDENTIFIED BY 'secretpassword';  
flush privileges;  
quit

Agora importaremos as tabelas do RoundCube do arquivo mysql.initial.sql para nosso novo banco de dados.

Execute o seguinte comando no shell do Linux:

mysql --defaults-file=/etc/mysql/debian.cnf roundcubemail < /opt/roundcube/SQL/mysql.initial.sql

Configurar RoundCube e Apache

Neste passo, configuraremos os detalhes do banco de dados no RoundCube e adicionaremos um arquivo de configuração do RoundCube no Apache.

Começarei com a configuração do banco de dados no RoundCube. Execute os seguintes comandos para criar um novo arquivo config.inc.php com base no arquivo de configuração de exemplo e abri-lo no editor nano.

cd /opt/roundcube/config  
cp -pf config.inc.php.sample config.inc.php  
nano config.inc.php

Encontre a linha de configuração do banco de dados que começa com $config[‘db_dsnw’] e substitua-a pela seguinte linha:

$config['db_dsnw'] = 'mysql://roundcube:secretpassword@localhost/roundcubemail';

A palavra “secretpassword” deve ser substituída pela senha que você escolheu para o banco de dados.

Em seguida, procure a linha “smtp_server” e defina o nome do host do seu servidor SMTP aqui. No meu caso, o servidor de email é o servidor local, então configurarei o servidor como “localhost”.

$config['smtp_server'] = 'localhost';

Agora é hora de configurar o Apache. Vou criar um novo arquivo de configuração roundcube.conf na pasta /etc/apache2/conf-available/.

nano /etc/apache2/conf-available/roundcube.conf

Adicione as seguintes linhas a esse arquivo e salve-o.

Alias /roundcube /opt/roundcube  
Alias /webmail /opt/roundcube  
  
  
 Options +FollowSymLinks  
 # AddDefaultCharset UTF-8  
 AddType text/x-component .htc  
   
   
 AddType application/x-httpd-php .php  
 php_flag display_errors Off  
 php_flag log_errors On  
 # php_value error_log logs/errors  
 php_value upload_max_filesize 10M  
 php_value post_max_size 12M  
 php_value memory_limit 64M  
 php_flag zlib.output_compression Off  
 php_flag magic_quotes_gpc Off  
 php_flag magic_quotes_runtime Off  
 php_flag zend.ze1_compatibility_mode Off  
 php_flag suhosin.session.encrypt Off  
 #php_value session.cookie_path /  
 php_flag session.auto_start Off  
 php_value session.gc_maxlifetime 21600  
 php_value session.gc_divisor 500  
 php_value session.gc_probability 1  
   
  
   
 RewriteEngine On  
 RewriteRule ^favicon\.ico$ skins/larry/images/favicon.ico  
 # regras de segurança:  
 # - negar acesso a arquivos que não contêm um ponto ou que começam com um ponto  
 # em todos os locais, exceto o diretório do instalador  
 RewriteRule ^(?!installer)(\.\?[^\.]+)$ - [F]  
 # - negar acesso a alguns locais  
 RewriteRule ^/?(\.git|\.tx|SQL|bin|config|logs|temp|tests|program\/(include|lib|localization|steps)) - [F]  
 # - negar acesso a alguns arquivos de documentação  
 RewriteRule /?(README\.md|composer\.json-dist|composer\.json|package\.xml)$ - [F]  
   
  
   
 SetOutputFilter DEFLATE  
   
  
   
 ExpiresActive On  
 ExpiresDefault "access plus 1 month"  
   
  
 FileETag MTime Size  
  
   
 Options -Indexes  
   
  
 AllowOverride None  
 Require all granted  
  
  
  
 Options -FollowSymLinks  
 AllowOverride None  
 Require all denied  
  
  
  
 Options -FollowSymLinks  
 AllowOverride None  
 Require all denied  
  
  
  
 Options -FollowSymLinks  
 AllowOverride None  
 Require all denied  
  
  
  
 Options -FollowSymLinks  
 AllowOverride None  
 Require all denied

As 2 linhas Alias nas duas primeiras linhas tornam o RoundCube disponível como /roundcube e /webmail em seu servidor.

Ative a configuração e recarregue o apache:

a2enconf roundcube  
service apache2 reload

É isso, o RoundCube agora está totalmente instalado em seu servidor, e você pode acessá-lo pelo IP e nome do host do servidor através dos aliases /roundcube e /webmail. O IP do meu servidor é 192.168.1.100; para isso posso abrir o RoundCube com http://192.168.1.100/webmail

O login do RoundCube.

Roundcube - a primeira página.

Instalação do plugin RoundCube do ISPConfig (opcional)

Quando seu servidor tem o iSPConfig 3 instalado, é altamente recomendável instalar o plugin RoundCube do ISPConfig. Isso permite que seus usuários de email gerenciem seus respostas automáticas, filtros de email e outras configurações de caixa de correio a partir do RoundCube.

O plugin RoundCube do ISPConfig 3 está conectado ao ISPConfig 3 com a API remota do ISPConfig. Para usar essa API, precisamos de um usuário remoto.

Faça login no ISPConfig como usuário “admin”.

Para criar um usuário assim, vá para Sistema > Gerenciamento de Usuários > Usuários Remotos e clique no botão Adicionar novo usuário:

Digite um Nome de Usuário e senha para o novo usuário remoto. Vou escolher o nome de usuário “roundcube” e a senha “!fdWEacBOG1d”.

A configuração do usuário remoto permite um controle de acesso detalhado; as seguintes funções devem ser habilitadas:

  • Funções do servidor
  • Funções do cliente
  • Funções do usuário de email
  • Funções do alias de email
  • Funções do usuário do filtro de spam de email
  • Funções da política de filtro de spam de email
  • Funções do fetchmail de email
  • Funções da lista branca do filtro de spam de email
  • Funções da lista negra do filtro de spam de email
  • Funções do filtro de usuário de email

Finalmente clique em Salvar.

Os próximos passos foram realizados no shell do seu servidor. Faça login como usuário root.

Agora vamos instalar o certificado SSL do ISPConfig no armazenamento de certificados SSL do Debian.

cp /usr/local/ispconfig/interface/ssl/ispserver.crt /usr/local/share/ca-certificates/  
update-ca-certificates

Abra o arquivo /etc/php5/cgi/php.ini

nano /etc/php5/apache2/php.ini

Role para baixo até ver a seção [openssl] do arquivo e lá adicione a seguinte linha:

openssl.cafile=/etc/ssl/certs/ca-certificates.crt

Em seguida, reinicie o apache.

service apache2 restart

Para baixar o complemento, instale primeiro o cliente Git.

apt-get install git

Obtenha a versão mais recente do plugin ISPConfig do RoundCube:

cd /tmp  
git clone https://github.com/w2c/ispconfig3_roundcube.git  
cd /tmp/ispconfig3_roundcube/

E mova o plugin para o diretório de plugins do roundcube.

mv ispconfig3_* /opt/roundcube/plugins  
cd /opt/roundcube/plugins

Crie um novo arquivo config.inc.php para o plugin com base na configuração de exemplo e abra o arquivo no editor nano.

mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php  
nano ispconfig3_account/config/config.inc.php

Preencha os detalhes do usuário remoto e salve o arquivo.

Substitua server1.example.com pelo nome do host do servidor. Quando SSL (HTTPS) é usado para a conexão da API Remota, é importante que o nome do host na configuração do RoundCube corresponda ao nome do host do certificado SSL da interface do ISPConfig. Você pode verificar o nome do host do certificado SSL do ISPConfig com o comando:

openssl x509 -in /usr/local/share/ca-certificates/ispserver.crt -text -noout | grep Subject:

O resultado é, no meu caso:

Subject: C=DE, ST=Niedersachsen, L=Lueneburg, O=ISPConfig UG, OU=IT, CN=server1.example.com/[email protected]

Portanto, o nome do host “server1.example.com” no arquivo de configuração do plugin corresponde ao nome do host no certificado SSL.

Agora ativaremos os novos plugins no RoundCube. Abra o arquivo de configuração em um editor:

nano /opt/roundcube/config/config.inc.php

e adicione a seguinte linha ao final do arquivo:

$rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter");

Agora você pode fazer login no RoundCube, as novas opções podem ser encontradas em Configurações > Conta.

Conta geral.

Configuração do filtro de email.

Configuração do fetchmail.

Links

  • Debian
  • Roundcube
  • Plugin ISPConfig do Roundcube
Share: X/Twitter LinkedIn
#Instalação RoundCube

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.