Spam Scanner

Kommandozeile

Text
spamscanner <command> [options]
BefehlWas er tut
scan [file|-]Eine Nachricht aus einer Datei oder von der Standardeingabe prüfen
filter -f <sender> -- <recipients...>Content-Filter für Postfix: Standardeingabe prüfen, Header hinzufügen, weitergeben
milterMilter für Postfix und Sendmail, Port 7831
httpHTTP-API, Port 7832
serverEinfacher TCP-Server, Port 7830
spamdSpamAssassin-kompatibler spamd-Server, Port 783
trainEin Modell aus mbox-Dateien, Maildirs, Ordnern oder Datensätzen trainieren
evalEin Modell an gelabelten E-Mails messen
learn spam|ham [file|-] --model <file>Einem Modell eine einzelne Nachricht beibringen
llm-testSprachmodell-Einstellungen mit drei Beispielnachrichten prüfen
modelsEmpfohlene offene Modelle auflisten
version, help

scan#

Shell
spamscanner scan message.eml
spamscanner scan - < message.eml
spamscanner scan message.eml --json
spamscanner scan message.eml --headers > tagged.eml
spamscanner scan message.eml --subject-tag "[SPAM]" > tagged.eml
OptionBedeutung
--jsonDas vollständige Ergebnis als JSON ausgeben
--headersDie Nachricht mit hinzugefügten X-Spam-*-Headern ausgeben
--subject-tag <tag>Zusätzlich dem Betreff von Spam ein Präfix voranstellen
--verboseAlle Tests und die stärksten Hinweise des Klassifikators zeigen
--threshold <n>Score, ab dem eine E-Mail Spam ist (Standard 5)
--reject-threshold <n>Score, ab dem eine E-Mail abgewiesen wird (Standard 15)
--model <file>Eine Modelldatei statt der mitgelieferten
--no-classifierDen Klassifikator nicht verwenden
--config <file>Eine JSON-Datei mit Bibliotheksoptionen
--allow-language <codes>Akzeptierte Sprachen, zum Beispiel en,de,fr

Exit-Codes: 0 Ham, 1 Spam, 2 Fehler.

SMTP-Sitzung#

OptionBedeutung
--ip <address>IP-Adresse des Clients, der die Nachricht gesendet hat
--hostname <name>Der verifizierte Reverse-DNS-Name des Clients
--helo <name>Der Name, den er bei HELO oder EHLO angegeben hat
--from <address>Absender im Umschlag (MAIL FROM)
--to <address>Empfänger im Umschlag; für mehrere wiederholen

Prüfungen#

OptionBedeutung
--authSPF, DKIM, DMARC und ARC prüfen (benötigt --ip)
--dnsbl <zone>IP-Blockliste, zum Beispiel zen.spamhaus.org; wiederholbar
--uribl <zone>Domain-Blockliste für Links, zum Beispiel dbl.spamhaus.org; wiederholbar
--dns-server <ip>Nameserver für DNS-Prüfungen; wiederholbar
--no-cloudflareDie filternden Resolver von Cloudflare nicht zu Links befragen
--clamav [socket]Anhänge mit clamd prüfen, über dessen Standard-Socket oder den angegebenen
--allowlist <value>Diese IP-Adresse, Domain oder Adresse immer annehmen; wiederholbar
--denylist <value>Diese IP-Adresse, Domain oder Adresse immer abweisen; wiederholbar

Sprachmodell#

OptionBedeutung
--llm <provider>ollama, clef-flash, jev, openai, anthropic und weitere (Liste)
--llm-model <name>Modell, zum Beispiel qwen3.5:4b oder claude-haiku-4-5
--llm-method <method>decision (eine Wahrscheinlichkeit für jedes Urteil, in einem Schritt; der Standard, wo verfügbar) oder generate (Methoden)
--llm-account <id>Cloudflare-Konto-ID, für clef und clef-flash
--llm-url <url>Basis-URL, zum Beispiel http://10.0.0.5:11434
--llm-host, --llm-port, --llm-path, --llm-protocolEinen Teil der URL des Anbieters ändern
--llm-api-key <key>API-Schlüssel; siehe auch die Umgebungsvariablen unten
--llm-auth <type>bearer, x-api-key, api-key, basic, header oder none
--llm-auth-header <name>Header für den Schlüssel, zusammen mit --llm-auth header
--llm-username, --llm-passwordFür --llm-auth basic
--llm-header "Name: value"Zusätzlicher Request-Header; wiederholbar
--llm-mode <mode>auto (nur knappe Fälle, der Standard) oder always
--llm-timeout <ms>Standard 30000
--llm-policy <text>Zusätzliche Regeln für das Modell, zum Beispiel „Wir versenden nie Rechnungen“
--llm-redact, --no-llm-redactPersonenbezogene Daten vorher entfernen; bei entfernten Anbietern standardmäßig an

filter#

Ein Content-Filter für Postfix. Er liest eine Nachricht von der Standardeingabe, fügt X-Spam-*-Header hinzu und übergibt sie mit demselben Umschlag an sendmail.

Shell
spamscanner filter -f "$sender" -- "$recipient"
OptionBedeutung
--sendmail <path>Standard /usr/sbin/sendmail
--subject-tag <tag>Dem Betreff von Spam ein Präfix voranstellen
--rejectE-Mails ab dem Ablehnungsschwellenwert zurückweisen statt sie weiterzugeben
--discardE-Mails ab dem Ablehnungsschwellenwert verwerfen statt sie weiterzugeben

Die Exit-Codes folgen den Konventionen von sendmail, die Postfix auswertet: 0 zugestellt (oder verworfen), 64 keine Empfänger angegeben, 69 als Spam abgewiesen (Postfix schickt eine Unzustellbarkeitsnachricht), 75 jeder andere Fehler, sodass Postfix die Nachricht behält und es später erneut versucht.

milter, http, server und spamd#

Shell
spamscanner milter --port 7831 --reject --subject-tag "[SPAM]"
spamscanner http --port 7832 --token "$SPAMSCANNER_TOKEN"
spamscanner server --port 7830
spamscanner spamd --port 783

Port 783 ist der Port, den SpamAssassin-Clients standardmäßig verwenden. Ports unter 1024 benötigen root oder die Capability CAP_NET_BIND_SERVICE. Verwenden Sie einen anderen Port, etwa --port 7833, und teilen Sie ihn dem Client mit.

OptionBedeutung
--port <n>TCP-Port
--host <ip>Adresse, auf der gelauscht wird (Standard 127.0.0.1)
--socket <path>Stattdessen auf einem Unix-Socket lauschen
--rejectMilter: E-Mails ab dem Ablehnungsschwellenwert abweisen
--reject-code <n>Milter: 451, später erneut versuchen (der Standard), oder 550
--quarantineMilter: Spam in der Quarantäne des Mailservers zurückhalten
--name <hostname>Milter: der Name dieses Servers in Authentication-Results
--token <secret>HTTP: Authorization: Bearer <secret> verlangen; nötig für /learn
--allow-tellspamd: TELL-Anfragen (spamc -L spam) zum Lernen annehmen
--out <file>HTTP und spamd: Gelerntes in dieser Modelldatei speichern
--subject-tag <tag>Milter und spamd: dem Betreff von Spam ein Präfix voranstellen
--verboseMilter: jede Prüfung protokollieren. TCP-Server: mit einer Textzeile antworten

Die obigen Scan-Optionen gelten auch für die Server. Der Milter, die HTTP-API, der TCP-Server und spamd.

train, eval und learn#

Shell
spamscanner train --spam ~/Mail/Junk --ham ~/Mail/Archive --out my-model.json
spamscanner eval --model my-model.json --spam test/spam.mbox --ham test/ham.mbox
spamscanner learn spam message.eml --model my-model.json
OptionBedeutung
--spam <path>Spam: eine mbox-Datei, ein Maildir oder ein Ordner mit .eml-Dateien; wiederholbar
--ham <path>Ham, ebenso; wiederholbar
--dataset <file>Eine CSV- oder JSON-Lines-Datei mit Spalten für Text und Label; wiederholbar
--text-column <name>, --label-column <name>Spaltennamen, wenn sie nicht erkannt werden
--out <file>Wohin das Modell geschrieben wird (Standard spamscanner-model.json)
--mergeMit dem mitgelieferten Modell (oder --model) statt einem leeren beginnen

learn aktualisiert die Modelldatei direkt und legt sie beim ersten Mal aus dem mitgelieferten Modell an. Training

llm-test und models#

Shell
spamscanner models
spamscanner llm-test --llm ollama --llm-model qwen3.5:4b

llm-test sendet eine gewöhnliche Nachricht und zwei Betrugsnachrichten, auf Englisch und Italienisch, an das Modell, gibt dessen Urteile, die Dauer jedes Urteils, die verwendete Methode und die Hardware aus und beendet sich nur dann mit 0, wenn alle drei richtig sind.

Konfigurationsdatei#

--config file.json (oder die Umgebungsvariable SPAMSCANNER_CONFIG) lädt Bibliotheksoptionen. Optionen auf der Kommandozeile haben Vorrang vor der Datei.

JSON
{
  "threshold": 6,
  "authentication": true,
  "dnsbl": {"ip": ["zen.spamhaus.org"], "domain": ["dbl.spamhaus.org"]},
  "dns": {"servers": ["127.0.0.1"]},
  "clamav": {"socket": "/var/run/clamav/clamd.ctl"},
  "llm": {"provider": "ollama", "model": "qwen3.5:4b"},
  "scores": {"deceptiveLink": 4, "FROM_NAME_BRAND": 3}
}

Umgebungsvariablen#

VariableBedeutung
SPAMSCANNER_CONFIGKonfigurationsdatei
SPAMSCANNER_MODELModelldatei, die statt der mitgelieferten dient
SPAMSCANNER_TOKENToken für die HTTP-API
SPAMSCANNER_LLM_API_KEYAPI-Schlüssel für jeden Sprachmodell-Anbieter
CLOUDFLARE_API_TOKEN und CLOUDFLARE_ACCOUNT_ID, TYPESAFE_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, MISTRAL_API_KEY, GROQ_API_KEY, OPENROUTER_API_KEY, DEEPSEEK_API_KEY, XAI_API_KEY, TOGETHER_API_KEY, FIREWORKS_API_KEY, CEREBRAS_API_KEY, HF_TOKEN, AZURE_OPENAI_API_KEYDer eigene Schlüssel jedes Anbieters
NODE_DEBUG=spamscanner*Debug-Protokollierung

Diese Seite auf GitHub bearbeiten · Markdown ·