Spam Scanner

Riga di comando

Text
spamscanner <command> [options]
ComandoCosa fa
scan [file|-]Analizza un messaggio da un file o dallo standard input
filter -f <sender> -- <recipients...>Content filter di Postfix: analizza lo standard input, aggiunge le intestazioni e lo inoltra
milterMilter per Postfix e Sendmail, porta 7831
httpAPI HTTP, porta 7832
serverSemplice server TCP, porta 7830
spamdServer spamd compatibile con SpamAssassin, porta 783
trainAddestra un modello da file mbox, Maildir, cartelle o dataset
evalMisura un modello su posta etichettata
learn spam|ham [file|-] --model <file>Insegna un messaggio a un modello
llm-testVerifica le impostazioni del modello linguistico con tre messaggi di esempio
modelsElenca i modelli aperti consigliati
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
OpzioneSignificato
--jsonStampa il risultato completo in JSON
--headersStampa il messaggio con le intestazioni X-Spam-* aggiunte
--subject-tag <tag>Aggiunge anche un prefisso all'oggetto dello spam
--verboseMostra ogni test e gli indizi più forti del classificatore
--threshold <n>Punteggio a cui la posta è spam (predefinito 5)
--reject-threshold <n>Punteggio a cui la posta viene rifiutata (predefinito 15)
--model <file>Un file di modello al posto di quello incluso
--no-classifierNon usa il classificatore
--config <file>Un file JSON con le opzioni della libreria
--allow-language <codes>Lingue accettate, ad esempio en,de,fr

Codici di uscita: 0 hamPosta desiderata: il contrario dello spam., 1 spam, 2 errore.

Sessione SMTP#

OpzioneSignificato
--ip <address>Indirizzo IP del client che ha inviato il messaggio
--hostname <name>Il nome DNS inverso verificato del client
--helo <name>Il nome fornito in HELO o EHLO
--from <address>Mittente dell'envelope (MAIL FROM)
--to <address>Destinatario dell'envelope; ripetibile per più destinatari

Controlli#

OpzioneSignificato
--authVerifica SPF, DKIM, DMARC e ARC (richiede --ip)
--dnsbl <zone>Blocklist di IP, ad esempio zen.spamhaus.org; ripetibile
--uribl <zone>Blocklist di domini per i link, ad esempio dbl.spamhaus.org; ripetibile
--dns-server <ip>Name server per i controlli DNS; ripetibile
--no-cloudflareNon interroga i resolver con filtraggio di Cloudflare sui link
--clamav [socket]Analizza gli allegati con clamd, sul suo socket predefinito o su quello indicato
--allowlist <value>Accetta sempre questo indirizzo IP, dominio o indirizzo; ripetibile
--denylist <value>Rifiuta sempre questo indirizzo IP, dominio o indirizzo; ripetibile

Modello linguistico#

OpzioneSignificato
--llm <provider>ollama, clef-flash, jev, openai, anthropic e altri (elenco)
--llm-model <name>Modello, ad esempio qwen3.5:4b o claude-haiku-4-5
--llm-method <method>decision (una probabilità per ogni verdetto, in un solo passaggio; il valore predefinito dove disponibile) o generate (metodi)
--llm-account <id>ID dell'account Cloudflare, per clef e clef-flash
--llm-url <url>URL di base, ad esempio http://10.0.0.5:11434
--llm-host, --llm-port, --llm-path, --llm-protocolModifica una parte dell'URL del provider
--llm-api-key <key>Chiave API; vedi anche le variabili d'ambiente più sotto
--llm-auth <type>bearer, x-api-key, api-key, basic, header o none
--llm-auth-header <name>Intestazione per la chiave, con --llm-auth header
--llm-username, --llm-passwordPer --llm-auth basic
--llm-header "Name: value"Intestazione aggiuntiva della richiesta; ripetibile
--llm-mode <mode>auto (solo casi dubbi, il valore predefinito) o always
--llm-timeout <ms>Predefinito 30000
--llm-policy <text>Regole aggiuntive per il modello, ad esempio "Non inviamo mai fatture"
--llm-redact, --no-llm-redactRimuove prima i dati personali; attivo per impostazione predefinita per i provider remoti

filter#

Un content filter di Postfix. Legge un messaggio dallo standard input, aggiunge le intestazioni X-Spam-* e lo passa a sendmail con lo stesso envelope.

Shell
spamscanner filter -f "$sender" -- "$recipient"
OpzioneSignificato
--sendmail <path>Predefinito /usr/sbin/sendmail
--subject-tag <tag>Aggiunge un prefisso all'oggetto dello spam
--rejectRimanda al mittente la posta che raggiunge la soglia di rifiuto invece di inoltrarla
--discardScarta la posta che raggiunge la soglia di rifiuto invece di inoltrarla

I codici di uscita seguono le convenzioni di sendmail, che Postfix legge: 0 consegnato (o scartato), 64 nessun destinatario indicato, 69 rifiutato come spam (Postfix lo rimanda al mittente), 75 qualsiasi errore, quindi Postfix conserva il messaggio e riprova più tardi.

milter, http, server e 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

La porta 783 è quella usata per impostazione predefinita dai client SpamAssassin. Le porte sotto 1024 richiedono root o la capability CAP_NET_BIND_SERVICE; usa un'altra porta, come --port 7833, e indicala al client.

OpzioneSignificato
--port <n>Porta TCP
--host <ip>Indirizzo su cui restare in ascolto (predefinito 127.0.0.1)
--socket <path>Resta invece in ascolto su un socket Unix
--rejectMilter: rifiuta la posta che raggiunge la soglia di rifiuto
--reject-code <n>Milter: 451, riprova più tardi (il valore predefinito), o 550
--quarantineMilter: trattiene lo spam nella quarantena del server di posta
--name <hostname>Milter: il nome di questo server in Authentication-Results
--token <secret>HTTP: richiede Authorization: Bearer <secret>; necessario per /learn
--allow-tellspamd: accetta le richieste TELL (spamc -L spam) per l'apprendimento
--out <file>HTTP e spamd: salva ciò che viene appreso in questo file di modello
--subject-tag <tag>Milter e spamd: aggiunge un prefisso all'oggetto dello spam
--verboseMilter: registra ogni analisi. Server TCP: risponde con una riga di testo

Le opzioni di analisi descritte sopra valgono anche per i server. Il milter, l'API HTTP, il server TCP e spamd.

train, eval e 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
OpzioneSignificato
--spam <path>Spam: un file mbox, una Maildir o una cartella di file .eml; ripetibile
--ham <path>Ham, allo stesso modo; ripetibile
--dataset <file>Un file CSV o JSON Lines con colonne di testo e di etichetta; ripetibile
--text-column <name>, --label-column <name>Nomi delle colonne, quando non vengono rilevati
--out <file>Dove scrivere il modello (predefinito spamscanner-model.json)
--mergeParte dal modello incluso (o da --model) invece che da un modello vuoto

learn aggiorna il file di modello sul posto, creandolo dal modello incluso la prima volta. Addestramento

llm-test e models#

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

llm-test invia al modello un messaggio normale e due truffe, in inglese e in italiano, stampa i suoi verdetti, il tempo impiegato per ciascuno, il metodo usato e l'hardware, ed esce con 0 solo se tutti e tre sono corretti.

File di configurazione#

--config file.json (o la variabile d'ambiente SPAMSCANNER_CONFIG) carica le opzioni della libreria. Le opzioni della riga di comando hanno la precedenza sul file.

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}
}

Variabili d'ambiente#

VariabileSignificato
SPAMSCANNER_CONFIGFile di configurazione
SPAMSCANNER_MODELFile di modello usato al posto di quello incluso
SPAMSCANNER_TOKENToken per l'API HTTP
SPAMSCANNER_LLM_API_KEYChiave API per qualsiasi provider di modelli linguistici
CLOUDFLARE_API_TOKEN e 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_KEYLa chiave specifica di ciascun provider
NODE_DEBUG=spamscanner*Log di debug

Modifica questa pagina su GitHub · Markdown ·