| dc-dlvr spam/ham training system flow |
| ------------------------------------- |
| |
| An overview of the Maildir + inotify-based spam training system Eric |
| uses on his mail server. This idea may be implemented for kqueue-based |
| systems, too. |
| |
| The idea is to use inotify (via incron) to watch for new files appearing |
| in Maildirs. We only want to train seen messages as ham, and old (but |
| not necessarily seen) messages as spam. The overall goal of this is to |
| allow a user to train their filters without leaving his favorite mail |
| user agent. |
| |
| Every message written to Maildir involves a rename, so we only |
| have incron watch for IN_MOVED_TO events. |
| |
| The generic flow is as follows, all for a single Unix user account: |
| |
| incron -> report-spam +-> sendmail -> MTA -> dc-dlvr -> spamc -> spamd |
| | |
| V |
| ... |
| |
| For public-inbox, Eric uses a separate Unix account ("pi") to add a |
| layer of protection from fat-fingering something. So his report-spam |
| script delivers to a second recipient for training, the "pi" user: |
| ... |
| | |
| +-> sendmail -> MTA -> dc-dlvr |
| | |
| V |
| ~pi/.dc-dlvr.pre |
| | |
| V |
| public-inbox-learn |
| |
| public-inbox-learn will then internally handle the "spamc -> spamd" |
| delivery path as well as removing the message from the git tree. |
| |
| * incron - run commands based on filesystem events: http://incron.aiken.cz/ |
| |
| * sendmail / MTA - we use and recommend postfix, which includes a |
| sendmail-compatible wrapper: http://www.postfix.org/ |
| |
| * spamc / spamd - SpamAssassin: http://spamassassin.apache.org/ |
| |
| * report-spam / dc-dlvr - distributed with public-inbox in the scripts/ |
| directory: git clone https://public-inbox.org/public-inbox.git |
