Installare e configurare VPopMail

• Versione di vpopmail: 5.6.8
• github: sagredo-dev/vpopmail
• Scarica
• Changelog completo
• README.vdelivermail
• Pagina originale di Inter7

Vpopmail fornisce un modo semplice di gestire indirizzi di posta su domini virtuali e account email diversi da quelli su /etc/passwd.

Changelog

• defaultdelivery feature (--enable-defaultdelivery) changes (more info here, commit):
  • vdelivermail is installed by default in .qmail-default of newly created domains with option 'delete' as in the previous version.
  • if no user's valiases and no .qmail are found, then the message is sent to the control/defaultdelivery file, so that dovecot-lda (or whatelse) can store the mail into inbox and execute the sieve rules.
  • if vdelivermail is found in control/defaultdelivery, then it is ignored. The delivery remains in charge to vdelivermail, to avoid loops.
  • v. 5.6.8 is backward compatible. The users having .qmail from previous versions of the defauldelivery feature are not affected by this change.
• Mar 23, 2025 (v. 5.6.7)
  - bug fix in vpopmaild.c: Crypted[64] enlarged to Crypted[128] to make room for SHA-512 passwords. This restores the usability of the RoundCube's 'password' plugin (commit)
  - fixed quota calculation in sql procedures for dovecot (tx Hakan Cakiroglu) (commit)
  - minor changes to the usage function of vmakedotqmail.c (commit)
• Feb 15, 2025 (v. 5.6.6)
  - bug fix: pwstr.h was not installed by Makefile (tx Bai Borko)
• Feb 9, 2025
  - added pwd strength check also for vadduser.c
  - removed -std=c99 -D_XOPEN_SOURCE=500 arguments from CFLAGS in configure.ac to make clang happy
  - several changes to compile on FreeBSD clang v. 18.1.6
• Dec 20, 2024 (v. 5.6.4)
  - Password strength enforcement PR #5 (grabbed from Matt Brookings' 5.5.0-dev version)
  - Dropped min pwd length feature.
  - vmysql.h: tables' layout changed in order to have VARCHAR instead of CHAR. Fields containing ip addresses enlarged to VARCHAR(39), to create room for ipv6. Unix timestamps definition changed from BIGINT(20) to INT(11). (commit 44bad58) Have a look to the upgrade notes below.
• Oct 14, 2024 (v. 5.6.3)
  - fixed a configure break where a trivial C test program exits on error with gcc-14.1 due to missing headers
  - vusaged/domain.c: fixed -Wimplicit-function-declaration compilation warning
  - vmysql.h: dropped the multicolumn PRIMARY KEY in valias table to allow multiple forwards for a given alias.
     In case one already has the valias table defined, this is the sql query for the upgrade:
     ALTER TABLE `vpopmail`.`valias` DROP PRIMARY KEY, ADD INDEX (`alias`, `domain`, `valias_type`) USING BTREE;
     ALTER TABLE `vpopmail`.`valias` ADD `id` INT NOT NULL AUTO_INCREMENT FIRST, ADD PRIMARY KEY (`id`);

Aggiornare alla versione 5.6.x

Quando si passa dalla versione 5.4.33 alla versione 5.6.x, se si hanno gli account su SQL, è necessario aumentare le dimensioni della colonna vpopmail.pw_passwd del database, poichè il meccanismo di criptaggio delle password è ora basato su SHA512, che è più lungo del vecchio MD5; si può comunque scegliere di disabilitare le SHA512 pwd con --disable-sha512-passwords al momento della configurazione. La colonna vpopmail.pw_passwd dovrebbe essere ora impostata a una dimensione di 128; questa la query:

ALTER TABLE `vpopmail` CHANGE `pw_passwd` `pw_passwd` CHAR(128) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL;

/* vpopmail */
ALTER TABLE `vpopmail` CHANGE `pw_name` `pw_name` VARCHAR(64) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL; 
ALTER TABLE `vpopmail` CHANGE `pw_domain` `pw_domain` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL; 
ALTER TABLE `vpopmail` CHANGE `pw_passwd` `pw_passwd` VARCHAR(128) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL;
ALTER TABLE `vpopmail` CHANGE `pw_gecos` `pw_gecos` VARCHAR(64) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL;
ALTER TABLE `vpopmail` CHANGE `pw_dir` `pw_dir` VARCHAR(160) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL;
ALTER TABLE `vpopmail` CHANGE `pw_shell` `pw_shell` VARCHAR(20) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL; 

/* vlog */
ALTER TABLE `vlog` CHANGE `user` `user` VARCHAR(32) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL; 
ALTER TABLE `vlog` CHANGE `passwd` `passwd` VARCHAR(32) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL;
ALTER TABLE `vlog` CHANGE `domain` `domain` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL; 
ALTER TABLE `vlog` CHANGE `remoteip` `remoteip` VARCHAR(39) CHARACTER SET latin1 COLLATE latin1_swedish_ci NULL DEFAULT NULL; 
ALTER TABLE `vlog` CHANGE `error` `error` TINYINT(1) NULL DEFAULT NULL;
ALTER TABLE `vlog` CHANGE `timestamp` `timestamp` INT NOT NULL DEFAULT '0'; 

/* lastauth */
ALTER TABLE `lastauth` CHANGE `user` `user` VARCHAR(32) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL; 
ALTER TABLE `lastauth` CHANGE `domain` `domain` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL; 
ALTER TABLE `lastauth` CHANGE `remote_ip` `remote_ip` VARCHAR(39) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL;
ALTER TABLE `lastauth` CHANGE `timestamp` `timestamp` INT NOT NULL DEFAULT '0'; 

/* limits */
ALTER TABLE `limits` CHANGE `domain` `domain` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL; 

/* alias */
ALTER TABLE `valias` CHANGE `alias` `alias` VARCHAR(32) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL;
ALTER TABLE `valias` CHANGE `domain` `domain` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL;

/* dir_control */
ALTER TABLE `dir_control` CHANGE `domain` `domain` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL;

/* aliasdomains */
ALTER TABLE `aliasdomains` CHANGE `alias` `alias` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL;
ALTER TABLE `aliasdomains` CHANGE `domain` `domain` VARCHAR(96) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL;

Mie modifiche al programma

Questo l'insieme delle mie patch che sono incluse in vpopmail a partire dalla versione 5.6.0:

• la patch sql-aliasdomains, che fa in modo che VPopMail salvi gli aliasdomains su mysql. Questo consente al driver sql di dovecot di fare l'autenticazione non solo con i domini reali ma anche con gli alias, a condizione che si modifichi anche la query all'interno del driver, come verrà spiegato dopo. Ciò è ora importante, dato che dovecot ha eliminato il driver per VPopMail.
• la patch defaultdelivery (--enable-defaultdelivery):
  • vdelivermail è installato per default nel .qmail-default dei nuovi domini con l'opzione 'delete'.
  • se nessun utente e nessun .qmail sono stati trovati viene eseguito quanto contenuto nel file control/defaultdelivery, di modo che dovecot-lda possa salvare la mail ed eseguire le regole sieve.
  • se vdelivermail è stato trovato nel file control/defaultdelivery, allora control/defaultdelivery viene ignorato e la consegna del messaggio rimane a carico di vdelivermail, per evitare loop.
  Per informazioni precise leggere qui. Dare anche una occhiata al file doc/README.defaultdelivery nel codice sorgente.
• dovecot-sql-procedures patch. Se si vuole usare il driver sql di dovecot con la configurazione "una tabella per un dominio) (--disable-many-domains) è necessario personalizzare in modo pesante le query sql. Con questo aggiustamento vpopmail installerà in modo autonomo la procedura e le funzioni sql nel database quando si crea un nuovo dominio. La procedura può essere chiamata da dovecot per fare l'autenticazione.
  Il codice sql supporta gli aliasdomains e i mysql limits, e sarà caricato dal file ~/vpopmail/etc/disable-many-domains_procedures.sql che si può ovviamente personalizzare.
  E' necessario configurare vpopmail con --enable-mysql-bin=PATH poichè dobbiamo installare la procedura chiamando mysql con un comando shell.
• vusaged configure patch
  Almeno su Debian 11 sembra che vusaged si rifiuti di terminare la configurazione (comando configure) a causa di un mancato link alle librerie mysql (configure: error: No vauth_getpw in libvpopmail). Ovviamente ho spulciato lo script e il link sembra impostato correttamente, e ciò è al momento molto strano. Dopo un po' di prove, ho notato che facendo in modo che il configure superi il problema senza bloccarsi con un messaggio di errore, la compilazione susseguente vada a buon fine linkando corrrettamente libmysqlclient e terminando con successo la compilazione.
  NB: è necessario dare un autoreconf -f -i nella directory vusaged prima della configurazione, dal momento che il file configure.ac è stato modificato.
• s/qmail cdb patch. Questa patch, che consente a vpopmail di localizzare correttamente il file assign.cdb di qmail per gli utenti s/qmail, nell'attuale pacchetto perchè rimpiazzata da una analoga. Gli utenti di s/qmail dovrebbero configurare vpopmail con l'opzione --enable-qmail-cdb-name=assign.cdb
• recipient check patch. Da usare con s/qmail di Erwin Hoffmann al fine di validare il destinatario della mail. Questa patch non è importante nella presente installazione. Si veda il file  doc/README.vrcptcheck per maggiori informazioni.
• vuserinfo-D_newline, una piccola patch che migliora la leggibilità quando si utilizza il comando vuserinfo -D, introducendo una nuova linea
• la patch gcc-10-compat, con il la quale VPopMail è compatibile con gcc-10.
• Una patch che risolve i seguenti problemi (Ali Erturk TURKER):
  - vdelivermail.c controlla i permessi di spamassassin anzichè di maildrop.
  - vopen_smtp_relay() restituisce il valore corretto, di modo che open_smtp_relay() possa rilevare e riportare gli errori di connessione al database (vmysql.c, voracle.pc, vpgsql.c)
  - vdel_limits() esegue un core-dump se la connessione al database non è disponibile. (vmysql.c, voracle.pc)

Setup

Creare ora l'utente e il gruppo vpopmail. E' importante tener presente che la cartella home scelta sarà quella dove vpopmail verrà poi installato, quindi è necessario prendere ora la decisione se installarlo nella posizione classica oppure no. E' anche possibile decidere di assegnare a vpopmail degli uid/gid diversi da 89:89, dato che qmail sarà in grado di determinarli dinamicamente al momento della compilazione.

groupadd -g 89 vchkpw
useradd -m -g vchkpw -u 89 -d /home/vpopmail vpopmail

Nel seguente comando di configurazione, modificare le opzioni --enable-incdir e --enable-libdir a seconda di dove il sistema operativo in uso ha installato le librerie mysql e le sue intestazioni.

VPOPMAIL_VERSION=5.6.8
wget https://github.com/sagredo-dev/vpopmail/archive/refs/tags/v${VPOPMAIL_VERSION}.tar.gz
tar xzf v${VPOPMAIL_VERSION}.tar.gz
cd vpopmail-${VPOPMAIL_VERSION}
chown -R root:root .

# freebsd users may have t issue an 'autoreconf -f -i' here
./configure \
        --enable-qmaildir=/var/qmail/ \
        --enable-qmail-newu=/var/qmail/bin/qmail-newu \
        --enable-qmail-inject=/var/qmail/bin/qmail-inject \
        --enable-qmail-newmrh=/var/qmail/bin/qmail-newmrh \
        --disable-roaming-users \
        --enable-auth-module=mysql \
        --enable-incdir=/usr/include/mysql \
        --enable-libdir=/usr/lib64 \
        --enable-logging=e \
        --disable-clear-passwd \
        --enable-auth-logging \
        --enable-sql-logging \
        --disable-passwd \
        --enable-qmail-ext \
        --enable-learn-passwords \ 
        --enable-mysql-limits \
        --enable-valias \
        --enable-sql-aliasdomains \
        --enable-defaultdelivery

--disable-roaming-users i roaming users saranno disabilitati, dal momento che non dobbiamo qui usare l'autenticazione  POP before SMTP. Invece applicheremo una patch per l'autenticazione lato smtp.

--enable-auth-module=mysql mette su il supporto mysql e salva gli account utente in un database mysql.

--enable-incdir=/usr/include/mysql è la directory include di MySQL (usare in caso si sia installato mysql dai binari o dai sorgenti in una locazione non standard. Montare mysql da qualche parte se è il server è installato in un'altra macchina..

--enable-libdir=/usr/lib64 La directory lib di MySQL. Naturalmente sarà /usr/lib nei sistemi 32b

--disable-passwd Non includere il supporto per /etc/passwd. Personalmente non voglio gestire gli utenti reali e userò questa opzione, dato che questo è solo un web server.

--enable-clear-passwd Una copia delle password NON verrà salvata su DB anche in chiaro. Se si vogliono evitare i soliti problemi dell'amministratore quando gli utenti dimenticano la password e si vuole ripristinarla rapidamente, oppure per fare test, abilitare --enable-clear-passwd. Ho notato, pensando di disabilitare questa opzione per maggior sicurezza, che il programma per il cambio password non funziona più (testato con la versione 5.4.33, commenti graditi su questo).

--enable-logging=e Logga i tentativi falliti su syslog (le password sbagliate non verranno mostrate).

--enable-sql-logging Lascia i vlog in una tabella di MySQL (vengono mostrate le richieste di accesso fallite).

--enable-auth-logging Crea una tabella MySQL con il log dell'ultimo accesso (lastauth).

--disable-roaming-users Non supportare gli utenti roaming.

--enable-mysql-limits MySQL salva i limiti in alternativa ai file .qmailadmin-limits.

--enable-valias Salva gli alias su MySQL.

--enable-sql-aliasdomains (default) salva gli alias domains su MySQL al fine di consentire l'autenticazione IMAP anche per gli alias domain nel caso si usi il driver di autenticazione sql di dovecot (è necessario modificare la query di consenguenza come sarà spiegato più avanti).

--enable-defaultdelivery abilità la possibilità di installare nel .qmail-default di ogni nuovo dominio il delivery agent salvato preventivamente in /var/qmail/control/defaultdelivery.

Compilare e installare:

make install-strip

vusaged

vusaged cerca gli utenti sotto VPopMail e conteggia quanto spazio disco essi usano. Richiede libev.

Installazione di libev

• Pagina ufficiale

E' necessario installare gli header file in /usr/local/include/libev per evitare conflitti con la libreria libevent, che è probabilmente già installata nel sistema operativo (event.h ha stesso nome ma diverso per le due librerie).

cd /usr/local/src
wget http://dist.schmorp.de/libev/libev-4.33.tar.gz
tar xzvf libev-4.33.tar.gz
cd libev-4.33
chown -R root:root .
./configure --includedir=/usr/local/include/libev
make
make install
ldconfig

Installazione e configurazione di vusaged

cd /usr/local/src/vpopmail-${VPOPMAIL_VERSION}/vusaged
LDFLAGS=-L/usr/local/lib CFLAGS=-I/usr/local/include/libev LIBS=`head -1 /home/vpopmail/etc/lib_deps` \
./configure --with-vpopmail=/home/vpopmail 
make
cp -f vusaged /home/vpopmail/bin
cp -f etc/vusaged.conf /home/vpopmail/etc

Troubleshooting

Se si ottiene un errore come questo dopo il comando configure

configure: error: No vauth_getpw in libvpopmail

provare a rostruire lo script configure in questo modo:

autoreconf -f -i

e quindi procedere alla configurazione e alla compilazione. Come spiegato sopra nella patch combinata è presente una patch che evita che il confdigure si blocchi. Questa patch non risolve il problema, ma almeno porta a casa la compilazione del programma. Se riesci a risolvere meglio il problema del collegamento della libreria fammelo sapere con un commento.

Dare una occhiata ai commenti. Luca ha suggerito un modo di linkare la libreria, che per me non ha funzionato ma che sto suggerendo comunque sopra in questa guida.

Configurazione quota warning

Non è più necessario configurare quanto segue per la gestione dei messaggi di quota warning, in quanto Dovecot sarà in grado di occuparsi della cosa in modo anche più efficiente. Lascerò qui le vecchie indicazioni nel caso possano ancora essere utili a qualcuno.

Ora prepariamo un messaggio di avviso di imminente esaurimento della quota concessa, che verrà inviato agli utenti quando superano il 90% del massimo consentito:

> nano ~vpopmail/domains/.quotawarn.msg

From: SomeCompany Postmaster <postmaster@yourdomain.com>
Reply-To: postmaster@yourdomain.com
To: SomeCompany User:;
Subject: Mail quota warning
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 7bit

La tua mailbox nel server è superato il 90% della sua capacità.

Per continuare a ricevere messaggi, 
dovresti cancellare dei messaggi dalla tua mailbox.

Se ti occorre assistenza al riguardo, sei pregato di contattare
l'amministratore qui:

email : support@yourdomain.com
Tel : xx xxxx xx

chmod 600 ~vpopmail/domains/.quotawarn.msg
chown vpopmail:vchkpw ~vpopmail/domains/.quotawarn.msg

Ora sistemiamo ~vpopmail/etc/vlimits.default. Questa riga limita a 400MB (in bytes) la quota per l'utente di default:

default_quota 419430400

Creazione del database e configurazione della connessione MySQL

Creiamo l'utente vpopmail e il database, assegniamogli tutti i privilegigrant e salviamo l'account nel file vpopmail.mysql:

> mysql [-h mysql-IP] -u root -p

CREATE USER 'vpopmail'@'mailserver-IP' IDENTIFIED BY 'vpopmailpwd';

GRANT USAGE ON * . * TO 'vpopmail'@'mailserver-IP' IDENTIFIED BY 'vpopmailpwd' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;
CREATE DATABASE IF NOT EXISTS vpopmail;
GRANT ALL PRIVILEGES ON `vpopmail` . * TO 'vpopmail'@'mailserver-IP';

> echo "mysql-IP|0|vpopmail|vpopmailpwd|vpopmail" > ~vpopmail/etc/vpopmail.mysql

dove mysql-IP è l'indirizzo IP del server dove gira mysql, mentre mailserver-IP è l'indirizzo IP del server della posta. Solitamente questi due IP sono entrambi quelli della macchina locale, ovvero 0.0.0.0.

Creazione dei domini e degli utenti virtuali

cd ~vpopmail/bin/

Per aggiungere/cancellare un dominio virtuale

./vadddomain yourdomain.net [./vdeldomain yourdomain.net]

Per aggiungere/cancellare un utente virtuale

./vadduser user@yourdomain.net [./vdeluser user@yourdomain.net]

Per visualizzare le informazioni su un utente:

./vuserinfo user@yourdomain.net

name: user
passwd: xxxxxxxxxxxx
clear passwd: xxxxxxxxx
comment/gecos: Name Surname
uid: 0
gid: 0
flags: 0
gecos: Name Surname
limits: No user limits set.
dir: /home/vpopmail/domains/yourdomain.net/user
quota: 104857600S

La gestione dei domini e degli account sarà molto più agevole una volta installate le interfacce web vqadmin e qmailadmin.

Potresti essere interessato a questo punto a dare un'occhiata alla pagina di test riguardante vpopmail.

Alias domains con il driver di autenticazione sql di dovecot

Se non si hanno alias domains oppure questa è una nuova installazione si può saltare questa sezione.

Se invece si hanno degli alias domains e sta migrando al driver sql di dovecot è necessario leggere con attenzione la pagina seguente dopo aver terminato l'installazione di dovecot, perchè sarà necessario salvare su database con le coppie alias/domains già esistenti.

In breve, è possibile salvare tutti i propri domain alias su MySQL in questo modo:

vsavealiasdomains -A

Digitare

vsavealiasdomains -h

per vedere tutte le opzioni.

I record del database saranno da ora in poi creati da vpomail quando si creeranno nuovi alias.

Controllo della robustezza delle password

A partire dalla versione 5.6.4 abbiamo la possibilità di abilitare il controllo della robustezza delle password, una cosa che andrebbe indirizzata agli utenti finali oppure agli amministratori di dominio, più che a noi amministratori del server. Ho accomodato il codice prendendolo dall'ultima versione di sviluppo, poi mai pubblicata dai vecchi sviluppatori di vpopmail. Per vedere come funziona è sufficiente leggere il file di configurazione, che non deve essere rinominato.

Come sappiamo, abbiamo già un controllo della password via cracklib su qmailadmin, pertanto si potrebbe decidere di disabilitare questa funzionalità lasciando il file di configurazione così com'è. Oppure si può abilitare questo controllo aggiuntivo se si vuole mettere in sicurezza anche il plugin per il cambio della password presente nella webmail (come il password plugin di Roundcube).

./vadddomain testdomain testpwd
config: line 2: error: syntax error: invalid label declaration
config: failed reading contents of /home/vpopmail/etc/vusagec.conf
config: line 2: error: syntax error: invalid label declaration
config: failed reading contents of /home/vpopmail/etc/vusagec.conf

Server:Disable=True;

cat > ~vpopmail/etc/vusagec.conf << __EOF__
Server:
Disable = True;
__EOF__

Error - no authentication database connection. Initial open.

> /usr/local/mysql/bin/mysql -u root -p

CREATE USER 'vpopmail'@'localhost' IDENTIFIED BY 'vpopmailpwd';

GRANT USAGE ON * . * TO 'vpopmail'@'localhost' IDENTIFIED BY 'vpopmailpwd' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0 ;
CREATE DATABASE IF NOT EXISTS `vpopmail` ;
GRANT ALL PRIVILEGES ON `vpopmail` . * TO 'vpopmail'@'localhost';

> echo "localhost|0|vpopmail|vpopmailpwd|vpopmail" > ~vpopmail/etc/vpopmail.mysql

> /usr/local/mysql/bin/mysql -u vpopmail -p vpopmailpwd

mysql> USE vpopmail