Dspam

From QmailToaster
Revision as of 19:02, 26 March 2024 by Ebroch (talk | contribs)
Jump to navigation Jump to search
Install Dspam:
wget https://raw.githubusercontent.com/qmtoaster/dspam/master/dspamdb.sh
chmod 755 dspamdb.sh
./dpsamdb.sh
Running the script 'dspamdb.sh' creates the dspam database, installs dspam, and starts the dspam service.
If dspam is implemented for a domain, every email received by that domain will have a dspam signature in the header and a
matching signature will automatically be entered in the dspam maria/mysql database. At this point there has been no training.
To train I have users create a spam and notspam folder in their IMAP account. All spam will be placed into the spam folder and
all ham into the notspam folder. I run a bash script enumerating all mail in these folders and dumping each to dspam. 
If there are spam filters in front of dspam that insert header signatures dspam's configuration file must enumerate them
so that they can be ignored for training purposes. Below are the Spamassassin signatures with the proper configuration syntax:
IgnoreHeader X-Spam-Checker-Version
IgnoreHeader X-Spam-Level
IgnoreHeader X-Spam-Status
IgnoreHeader X-Spam-Flag
IgnoreHeader X-Spam-Report
IgnoreHeader X-Spam-Prev-Subject
Here's a list of headers to ignore for your config file: https://raw.githubusercontent.com/qmtoaster/dspam/master/IgnoreHeader
Training:
  Flag options:
     SOURCE=corpus/error 
     CLASS=spam/innocent
     MODE=toe/teft/unlearn
  Dspam call:
     cat $email | dspam --user $USER@$DOMAIN --mode=$MODE --class=$CLASS --source=$SOURCE
  Source: Depending on email source, corpus or error, dspam must be called with the flags set below.
     1) Corpus (no dspam signature present in header) Depending on type of corpus, ham or spam, class appropriately.
        SOURCE=corpus
        CLASS=spam or innocent
        MODE=teft
     2) Error (dspam signature present in header) dspam catagorizes spam as ham
        SOURCE=error
        CLASS=spam
        MODE=toe
     3) Error (dspam signature present in header) dspam catagorized ham as spam, dspam must be called twice, to unlearn and
                                                  train.
        A) 
           SOURCE=error
           CLASS=spam
           MODE=unlearn
        B)
           SOURCE=error
           CLASS=innocent
           MODE=toe
Server side filtering 2 options 1) Before queue, 2) after queue :
Option 1)
 https://www.qmailtoaster.org/simscan.html


Option 2a Domain level)
 If dspam is enabled at domain level in .qmail-default use this file:
 # cd /home/vpopmail/'dspam-enabled-domain'
 # mv .qmail-default .qmail-default.bak
 # chmod 600 .qmail-default && chown vpopmail:vchkpw .qmail-default
 # wget https://raw.githubusercontent.com/qmtoaster/dspam/master/.qmail-default
Option 2b User level)
 If dspam is enabled at user level you must install maildrop and download and install two files 
 .qmail and .mailfilter.dspam (or .mailfilter) in each user directory for which Dspam will be enabled.
 # cd /home/vpopmail/'dspam-enabled-domain'/'user'
 # wget https://raw.githubusercontent.com/qmtoaster/dspam/master/.qmail
 # wget https://raw.githubusercontent.com/qmtoaster/dspam/master/.mailfilter.dspam
 # chown vpopmail:vchkpw .qmail
 # chown vpopmail:vchkpw .mailfilter.dspam
 # chmod 600 .qmail
 # chmod 600 .mailfilter.dspam
Mail should flow and be logged
 # cat /var/log/maildrop/maildrop-'user'@'dspam-enabled-domain'.log
At this point in your email client you must create the 'spam' and 'notspam' folders and start placing spam in the spam folder to be learned by the script.