Installazione di RoundCube webmail su Debian 8 (Jessie)

Questo tutorial mostra l’installazione dell’ultima RoundCube webmail su Debian 8. Roundcube è un client webmail facile da usare con supporto IMAP e SMTP che può essere esteso con plugin. Su Debian 7, RoundCube era disponibile come pacchetto .deb, non era l’ultima versione ma almeno era facile da installare con apt. Per l’attuale rilascio di Debian, non è più disponibile alcun pacchetto RoundCube, quindi descriverò l’installazione da sorgente qui. Questo tutorial contiene un capitolo facoltativo che descrive i passaggi per connettere RoundCube con il Pannello di Controllo Hosting ISPConfig 3.

Prerequisiti

Sistema Operativo Debian 8.
Server web Apache con mod_php installato. Se non è ancora installato apache, dai un’occhiata alla nostra guida LAMP o alla configurazione del Server Perfetto per installare un ambiente adatto.
Un server di posta (SMTP + IMAP) a cui Roundcube deve connettersi. Questo può essere il server locale (ad es. quando utilizzi una delle configurazioni del server perfetto) o un server remoto.
L’hostname del server che utilizzerò in questo tutorial è server1.example.com con l’indirizzo IP 192.168.1.100. Si prega di sostituirlo con l’IP e l’hostname del proprio server.

Installazione di RoundCube

Installerò RoundCube nella directory /opt/roundcube per garantire che questa installazione non confligga con i pacchetti di sistema Debian. Il primo passo è installare wget, creare la directory /opt/roundcube e scaricare l’ultima versione di RoundCube con wget in questa directory. L’attuale versione di RoundCube è 1.1.3 al momento in cui scrivo questo tutorial, dai un’occhiata al sito web di RoundCube per controllare se c’è una versione più recente che puoi utilizzare.

Accedi come utente root nella shell del tuo server, quindi installa wget e l’editor nano:

apt-get install wget nano

Crea la directory ed entra in essa con il comando “cd”:

mkdir /opt/roundcube  
cd /opt/roundcube

Scarica il file tar.gz di RoundCube e decomprimilo:

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

I file di RoundCube sono ora nella cartella /opt/roundcube/roundcubemail-1.1.3. Il passo successivo è spostarli di una directory verso l’alto in /opt/roundcube.

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

Il punto alla fine dei due comandi è richiesto ed è parte del comando, non dimenticarlo! Elimina la directory vuota e il file tar.gz.

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

E cambia il proprietario di tutti i file all’utente con cui il server Apache è in esecuzione.

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

Installa il Database di RoundCube

Roundcube richiede un database per memorizzare le impostazioni della casella di posta, i contatti, ecc. Utilizzerò MySQL (o MariaDB) qui come backend del database. Ora creeremo un database con il nome “roundcubemail” e un utente con il nome “roundcube” in MySQL.

Accedi al server MySQL con il seguente comando:

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

Quindi esegui i seguenti comandi nella shell del database MySQL per creare il database e l’utente del database. Sostituisci la parola “secretpassword” nei comandi qui sotto con una password a tua scelta.

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

Ora importeremo le tabelle di RoundCube dal file mysql.initial.sql nel nostro nuovo database.

Esegui il seguente comando nella shell di Linux:

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

Configura RoundCube e Apache

In questo passaggio, configureremo i dettagli del database in RoundCube e aggiungeremo un file di configurazione di RoundCube in Apache.

Inizierò con la configurazione del database in RoundCube. Esegui i seguenti comandi per creare un nuovo file config.inc.php basato sul file di configurazione di esempio e aprilo nell’editor nano.

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

Trova la riga di configurazione del database che inizia con $config[‘db_dsnw’] e sostituiscila con la seguente riga:

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

La parola “secretpassword” deve essere sostituita con la password che hai scelto per il database.

Successivamente, cerca la riga “smtp_server” e imposta qui l’hostname del tuo server SMTP. Nel mio caso, il server di posta è il server locale, quindi imposterò il server su “localhost”.

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

Ora è il momento di configurare Apache. Creerò un nuovo file di configurazione roundcube.conf nella cartella /etc/apache2/conf-available/.

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

Aggiungi le seguenti righe a quel file e salvalo.

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  
 # regole di sicurezza:  
 # - negare l'accesso a file che non contengono un punto o che iniziano con un punto  
 # in tutte le posizioni tranne la directory dell'installer  
 RewriteRule ^(?!installer)(\.\?[^\.]+)$ - [F]  
 # - negare l'accesso ad alcune posizioni  
 RewriteRule ^/?(\.git|\.tx|SQL|bin|config|logs|temp|tests|program\/(include|lib|localization|steps)) - [F]  
 # - negare l'accesso ad alcuni file di documentazione  
 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

Le 2 righe Alias nelle prime due righe rendono RoundCube disponibile come /roundcube e /webmail sul tuo server.

Abilita la configurazione e ricarica apache:

a2enconf roundcube  
service apache2 reload

Questo è tutto, RoundCube è ora completamente installato sul tuo server e puoi raggiungerlo sull’IP e hostname del server tramite gli alias /roundcube e /webmail. L’IP del mio server è 192.168.1.100; per questo posso aprire RoundCube con http://192.168.1.100/webmail

Il login di RoundCube.

Roundcube - la prima pagina.

Installazione del plugin RoundCube di ISPConfig (opzionale)

Quando il tuo server ha installato iSPConfig 3, è altamente raccomandato installare il plugin RoundCube di ISPConfig. Questo consente ai tuoi utenti di posta di gestire i loro risponditori automatici, filtri email e altre impostazioni della casella di posta all’interno di RoundCube.

Il plugin RoundCube di ISPConfig 3 è collegato a ISPConfig 3 con l’API remota di ISPConfig. Per utilizzare questa API, abbiamo bisogno di un utente remoto.

Accedi a ISPConfig come utente “admin”.

Per creare un tale utente, vai su Sistema > Gestione Utenti > Utenti Remoti e fai clic sul pulsante Aggiungi nuovo utente:

Inserisci un Nome utente e una password per il nuovo utente remoto. Sceglierò il nome utente “roundcube” e la password “!fdWEacBOG1d”.

La configurazione dell’utente remoto consente un controllo degli accessi fine; le seguenti funzioni devono essere abilitate:

Funzioni del server
Funzioni del client
Funzioni utente di posta
Funzioni alias di posta
Funzioni utente filtro spam di posta
Funzioni politica filtro spam di posta
Funzioni fetchmail di posta
Funzioni whitelist filtro spam di posta
Funzioni blacklist filtro spam di posta
Funzioni filtro utente di posta

Infine fai clic su Salva.

I passaggi successivi sono stati eseguiti nella shell del tuo server. Accedi come utente root.

Installeremo ora il certificato SSL di ISPConfig nello store dei certificati SSL di Debian.

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

Apri il file /etc/php5/cgi/php.ini

nano /etc/php5/apache2/php.ini

Scorri verso il basso fino a vedere la sezione [openssl] del file e lì aggiungi la seguente riga:

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

Quindi riavvia apache.

service apache2 restart

Per scaricare l’addon, installa prima il client Git.

apt-get install git

Ottieni l’ultima versione del plugin RoundCube ISPConfig:

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

E sposta il plugin nella directory dei plugin di roundcube.

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

Crea un nuovo file config.inc.php per il plugin basato sul file di configurazione di esempio e apri il file nell’editor nano.

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

Compila i dettagli dell’utente remoto e salva il file.

Sostituisci server1.example.com con l’hostname del server. Quando SSL (HTTPS) è utilizzato per la connessione dell’API remota, è importante che l’hostname nella configurazione di RoundCube corrisponda all’hostname del certificato SSL dell’interfaccia ISPConfig. Puoi controllare l’hostname del certificato SSL di ISPConfig con il comando:

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

Il risultato è nel mio caso:

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

Quindi l’hostname “server1.example.com” nel file di configurazione del plugin corrisponde all’hostname nel certificato SSL.

Ora attiveremo i nuovi plugin in RoundCube. Apri il file di configurazione in un editor:

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

e aggiungi la seguente riga alla fine del file:

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

Ora puoi accedere a RoundCube, le nuove opzioni possono essere trovate sotto Impostazioni > Account.

Account generale.

Impostazione del filtro email.

Impostazione di fetchmail.

Link

Debian
Roundcube
Plugin Roundcube ISPConfig