uberspace-tools

Attention: This mailfilter does only work for Uberspace 6, because Uberspace 7 doesn't ship with DSPAM (unmaintained), SpamAssassin and runwhen. A mailfilter configuration for Uberspace 7 can be found here.

This script can be used for setting up a customized mailfilter config with SpamAssassin and DSPAM on an Uberspace 6 server. Every message will be filtered by these two services. Custom rules can be added too. If messages from known spammers are not correctly recognised as spam by DSPAM, they can be manually taught as spam by setting up a blocklist.

The main goal of this filter is a more intuitive workflow with less special folders (like Learn as Spam and Learn as Ham) when showing messages to DSPAM via a customized dspam-learn script so it can learn. This is realized by marking messages, recognised or reclassified as spam, with the header X-Spam-Folder: YES, which is removed for messages that are reclassified as ham. All reclassified messages will be re-delivered via maildrop. Finally, teaching spam or ham works like this:

When moving a message from 'Junk | Spam | Junk-E-Mail' to 'Inbox' it will be learned by DSPAM as Ham

When moving a message from 'Inbox' to 'Junk | Spam | Junk-E-Mail' it will be learned by DSPAM as Spam

Please Note: Only messages of the last 24 hours are interpreted by dspam-learn to prevent slow scanning due to big folders.

Installation of Mailfilter

Core Files

Set up .qmail and maildrop before (see uberspace Wiki for setting up .qmail and Maildrop)
Rename .mailfilter to .mailfilter-EXT (replace EXT by your namespace) before, if you are using vmailmgr.
Put the file .mailfilter (or .mailfilter-EXT) and the folder .mailfilters in the home directory of your uberspace.
Remember to set the correct file permissions: chmod 600 ~/.mailfilter (or .mailfilter-EXT)
Create directory ~/var/log - it will be used as path for mailfilter logfile
dspam-learn goes to ~/bin (its logfile and database will later be found in ~/.dspam)

Adding `dspam-learn` as a service

Run this code to add dspam-learn as a service that is running once per hour:

  test -d ~/service || uberspace-setup-svscan
  runwhen-conf ~/etc/run-dspam-learn "$HOME/bin/dspam-learn"
  sed -i -e "s/^RUNWHEN=.*/RUNWHEN=\",M=`awk 'BEGIN { srand(); printf("%d\n",rand()*60) }'`\"/" ~/etc/run-dspam-learn/run
  ln -s ~/etc/run-dspam-learn ~/service/dspam-learn

Cleaning DSPAM database periodically

Run this code to add a service for cleaning DSPAM database periodically (once a day):

  test -d ~/service || uberspace-setup-svscan
  runwhen-conf ~/etc/run-dspam_clean_hashdb "/usr/local/bin/dspam_clean_hashdb"
  sed -i -e "s/^RUNWHEN=.*/RUNWHEN=\",H=`awk 'BEGIN { srand(); printf("%d\n",rand()*24) }'`\"/" ~/etc/run-dspam_clean_hashdb/run
  ln -s ~/etc/run-dspam_clean_hashdb ~/service/dspam_clean_hashdb

Credits and used code (snippets)

Feedback

This is work in progress, so do not hesitate to give feedback and/or provide pull requests.

bhopmann/uberspace-tools