Uso de RoundCube Webmail con ISPConfig 3 en Debian Wheezy (nginx)

Esta guía explica cómo instalar la aplicación de webmail RoundCube en un servidor Debian Wheezy que ejecuta ISPConfig y nginx, y cómo habilitar los complementos de ISPConfig 3 para RoundCube para que los usuarios puedan realizar acciones como cambiar sus contraseñas de correo electrónico desde RoundCube. Roundcube webmail es un cliente IMAP multilingüe basado en navegador con una interfaz de usuario similar a una aplicación; viene con funciones como soporte MIME, libreta de direcciones, manipulación de carpetas, búsqueda de mensajes y corrección ortográfica.

¡No emito ninguna garantía de que esto funcione para ti!

1 Nota Preliminar

Este tutorial asume que estás utilizando nginx como el servidor web en tu servidor ISPConfig 3; este tutorial no funcionará para Apache. Voy a instalar RoundCube desde los repositorios de Debian Wheezy - es una versión razonablemente reciente (0.7.2.9 vs 0.9.1 (versión estable actual)).

Mostraré cómo configurar un vhost para RoundCube para que se pueda acceder a través del alias /webmail (por ejemplo, http://www.example.com/webmail).

2 Creando un Usuario Remoto en ISPConfig

Los complementos de ISPConfig 3 para RoundCube funcionan a través de la API remota de ISPConfig. Para usar esta API, necesitamos un usuario remoto. Para crear dicho usuario, ve a Sistema > Gestión de Usuarios > Usuarios Remotos y haz clic en el botón Agregar nuevo usuario:

Proporciona un nombre de usuario y una contraseña para el usuario…

… y habilita las siguientes funciones:

Funciones del servidor
Funciones del cliente
Funciones del usuario de correo
Funciones del alias de correo
Funciones del filtro de spam del usuario de correo
Funciones de política del filtro de spam de correo
Funciones de fetchmail de correo
Funciones de lista blanca del filtro de spam de correo
Funciones de lista negra del filtro de spam de correo
Funciones del filtro de usuario de correo

Luego haz clic en Guardar.

3 Instalando RoundCube

Podemos instalar RoundCube de la siguiente manera:

apt-get install roundcube roundcube-plugins roundcube-plugins-extra

Verás las siguientes preguntas:

¿Configurar base de datos para roundcube con dbconfig-common? <– Sí
Tipo de base de datos que se utilizará por roundcube: <– mysql
Contraseña del usuario administrativo de la base de datos: <– tucontraseñadeusuarioSQLroot (la contraseña del usuario root de MySQL)
Contraseña de la aplicación MySQL para roundcube: <– roundcubesqlpassword
Confirmación de contraseña: <– roundcubesqlpassword

Esto creará una base de datos MySQL llamada roundcube con el usuario MySQL roundcube y la contraseña roundcubesqlpassword.

A continuación, ve a tu sitio web en ISPConfig. En la pestaña Opciones, verás el campo Directivas de nginx:

Completa las siguientes directivas y haz clic en Guardar (no importa si tienes PHP habilitado para este vhost o no porque este fragmento de código utiliza el PHP predeterminado del sistema que se ejecuta bajo el usuario y grupo www-data, lo cual es importante porque RoundCube está instalado fuera de la raíz del documento del vhost - en /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 acceder a SquirrelMail, se debe usar el usuario predeterminado (como www-data en Debian/Ubuntu) #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; } |

Con esta configuración, RoundCube será accesible bajo las URLs http://www.example.com/webmail y http://www.example.com/roundcube.

4 Configurando RoundCube

Abre /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… y establece $rcmail_config[‘default_host’] = ‘localhost’; (o el nombre de host o dirección IP de tu servidor de correo si está en una máquina remota):

| [...] $rcmail_config['default_host'] = 'localhost'; [...] |

De lo contrario, RoundCube pedirá un nombre de host antes de cada inicio de sesión, lo que podría sobrecargar a tus usuarios; queremos hacer que el uso sea lo más fácil posible.

A continuación, instala los complementos de 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/

Abre ispconfig3_account/config/config.inc.php…

vi ispconfig3_account/config/config.inc.php

… y completa los detalles de inicio de sesión de tu usuario remoto de ISPConfig y la URL de la API remota - mi instalación de ISPConfig se ejecuta en https://192.168.0.100:8080, así que la URL de la API remota es https://192.168.0.100:8080/remote/:

| |

Finalmente, abre /etc/roundcube/main.inc.php nuevamente…

vi /etc/roundcube/main.inc.php

… y habilita el complemento jquerui más los complementos de ISPConfig 3…

| [...] // ---------------------------------- // PLUGINS // ---------------------------------- // Lista de complementos activos (en el directorio plugins/) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… y cambia la apariencia de predeterminada a clásica (de lo contrario, los complementos de ISPConfig 3 no funcionarán):

| [...] // nombre de la apariencia: carpeta de skins/ $rcmail_config['skin'] = 'classic'; [...] |

Eso es todo; ahora puedes acceder a RoundCube bajo el alias /webmail (por ejemplo, www.example.com/webmail). Inicia sesión con la dirección de correo electrónico y la contraseña de una cuenta de correo creada a través de ISPConfig: