Utilizzare RoundCube Webmail Con ISPConfig 3 Su Debian Wheezy (nginx)

Questa guida spiega come installare l’applicazione webmail RoundCube su un server Debian Wheezy che esegue ISPConfig e nginx, e come abilitare i plugin ISPConfig 3 per RoundCube in modo che gli utenti possano eseguire azioni come cambiare le proprie password email direttamente da RoundCube. Roundcube webmail è un client IMAP multilingue basato su browser con un’interfaccia utente simile a un’applicazione; include funzioni come supporto MIME, rubrica, manipolazione delle cartelle, ricerca dei messaggi e controllo ortografico.

Non fornisco alcuna garanzia che questo funzionerà per te!

1 Nota Preliminare

Questo tutorial presuppone che tu stia utilizzando nginx come server web sul tuo server ISPConfig 3; questo tutorial non funzionerà per Apache. Installerò RoundCube dai repository di Debian Wheezy - è una versione ragionevolmente recente (0.7.2.9 vs 0.9.1 (versione stabile attuale)).

Mostrerò come configurare un vhost per RoundCube in modo che possa essere accessibile tramite l’alias /webmail (ad esempio http://www.example.com/webmail).

2 Creazione Di Un Utente Remoto In ISPConfig

I plugin ISPConfig 3 per RoundCube funzionano tramite l’API remota di ISPConfig. Per utilizzare questa API, abbiamo bisogno di un utente remoto. Per creare un tale utente, vai su Sistema > Gestione Utenti > Utenti Remoti e fai clic sul pulsante Aggiungi nuovo utente:

Fornisci un nome utente e una password per l’utente…

… e abilita le seguenti funzioni:

Funzioni del server
Funzioni del client
Funzioni dell’utente email
Funzioni dell’alias email
Funzioni dell’utente filtro spam email
Funzioni della politica filtro spam email
Funzioni fetchmail email
Funzioni whitelist filtro spam email
Funzioni blacklist filtro spam email
Funzioni filtro utente email

Poi fai clic su Salva.

3 Installazione Di RoundCube

Possiamo installare RoundCube come segue:

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

Vedrai le seguenti domande:

Configurare il database per roundcube con dbconfig-common? <– Sì
Tipo di database da utilizzare per roundcube: <– mysql
Password dell’utente amministrativo del database: <– yourrootsqlpassword (la password dell’utente root di MySQL)
Password dell’applicazione MySQL per roundcube: <– roundcubesqlpassword
Conferma password: <– roundcubesqlpassword

Questo creerà un database MySQL chiamato roundcube con l’utente MySQL roundcube e la password roundcubesqlpassword.

Successivamente vai sul tuo sito web in ISPConfig. Nella scheda Opzioni, vedrai il campo Direttive nginx:

Compila le seguenti direttive e fai clic su Salva (non importa se hai PHP abilitato per questo vhost o meno perché questo frammento di codice utilizza il PHP predefinito del sistema che viene eseguito sotto l’utente e il gruppo www-data, il che è importante perché RoundCube è installato al di fuori della radice del documento del vhost - in /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; # Per accedere a SquirrelMail, deve essere utilizzato l'utente predefinito (come www-data su 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 questa configurazione, RoundCube sarà accessibile agli URL http://www.example.com/webmail e http://www.example.com/roundcube.

4 Configurazione Di RoundCube

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

vi /etc/roundcube/main.inc.php

… e imposta $rcmail_config[‘default_host’] = ‘localhost’; (o il nome host o l’indirizzo IP del tuo server di posta se si trova su una macchina remota):

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

Altrimenti RoundCube chiederà un nome host prima di ogni accesso, il che potrebbe sovraccaricare i tuoi utenti - vogliamo rendere l’uso il più semplice possibile.

Successivamente installa i plugin ISPConfig 3 per 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/

Apri ispconfig3_account/config/config.inc.php…

vi ispconfig3_account/config/config.inc.php

… e compila i dettagli di accesso del tuo utente remoto ISPConfig e l’URL dell’API remota - la mia installazione ISPConfig è in https://192.168.0.100:8080, quindi l’URL dell’API remota è https://192.168.0.100:8080/remote/:

| |

Infine apri di nuovo /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… e abilita il plugin jquerui più i plugin ISPConfig 3…

| [...] // ---------------------------------- // PLUGIN // ---------------------------------- // Elenco dei plugin attivi (nella directory plugins/) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… e cambia la skin da default a classic (altrimenti i plugin ISPConfig 3 non funzioneranno):

| [...] // nome skin: cartella da skins/ $rcmail_config['skin'] = 'classic'; [...] |

Ecco fatto; ora puoi accedere a RoundCube sotto l’alias /webmail (ad esempio www.example.com/webmail). Accedi con l’indirizzo email e la password di un’email creata tramite ISPConfig: