# Dokumentasjon for Spam Scanner

Spam Scanner er et spamfilter for Node.js og kommandolinjen, med kildekoden på GitHub. Det leser en rå e-postmelding og avgjør om den er spam, phishing eller svindel, eller om den inneholder skadevare, på alle språk. Det kjører som et bibliotek, et kommandolinjeverktøy, en milter for Postfix eller Sendmail, et innholdsfilter for Postfix, en SpamAssassin-kompatibel spamd-server, et HTTP API eller en TCP-server.

Det er laget av [Forward Email](https://forwardemail.net) for selskapets egne e-postservere.


## Slik vurderes en melding

Hver sjekk legger til eller trekker fra poeng. Summen avgjør utfallet:

| Poengsum   | Handling | Hva en e-postserver gjør     |
| ---------- | -------- | ---------------------------- |
| Under 5    | `accept` | Leverer meldingen            |
| 5 til 14,9 | `tag`    | Leverer den merket som spam  |
| 15 og over | `reject` | Avviser den under SMTP-økten |

Begge tersklene kan endres. Hvert resultat lister opp testene som slo ut, med poeng og en begrunnelse, så en avgjørelse alltid kan forklares.

Sjekkene:

* **En trent klassifiserer** leser ordene i meldingen i alle skriftsystemer, formen på lenkene, avsenderen og vedleggene. Den leveres trent på offentlige datasett og lærer av din egen e-post. [Slik virker klassifisereren](https://spamscanner.net/no/docs/how-it-works/#the-classifier)
* **Phishing-sjekker** fanger forvekslingsdomener (`paypa1.com`, `pаypal.com` med en kyrillisk а), lenker der teksten viser én adresse og målet er en annen, og visningsnavn som utgir seg for å være et merkenavn. [Phishing](https://spamscanner.net/no/docs/how-it-works/#phishing)
* **Vedleggssjekker** finner kjørbare filer, kjørbare filer omdøpt til dokumenter, doble filendelser, triks med høyre-til-venstre-tegn i filnavn, kjørbare filer i ZIP-filer, Office-makroer og aktivt PDF-innhold. ClamAV kan skanne vedlegg for virus. [Vedlegg](https://spamscanner.net/no/docs/how-it-works/#attachments)
* **Autentisering**: SPF, DKIM, DMARC og ARC, når klientens IP-adresse er kjent. [Autentisering](https://spamscanner.net/no/docs/how-it-works/#authentication)
* **DNS-blokkeringslister** for klientens IP-adresse og domenene i lenker, og Cloudflares filtrerende resolvere for kjent skadevare og voksennettsteder. [Blokkeringslister](https://spamscanner.net/no/docs/how-it-works/#blocklists)
* **Regler** for mønstre ingen klassifiserer trenger å lære: GTUBE-teststrengen, emnelinjer for sextortion, fakturasvindel via PayPal, forfalskning av eget domene og instruksjoner skjult for KI-filtre. [Regler](https://spamscanner.net/no/docs/scoring/#rules)
* **En språkmodell**, valgfri, gir en ekstra vurdering av vanskelige tilfeller: en lokal modell via Ollama eller en hvilken som helst OpenAI-kompatibel server, en beslutningsmodell som Cloudflares Clef, eller Claude, ChatGPT, Gemini og andre. Som standard gir den en sannsynlighet for hver vurdering i ett steg i stedet for å skrive et svar. [Språkmodeller](https://spamscanner.net/no/docs/llm/)


## Hvor du begynner

* [Kom i gang](https://spamscanner.net/no/docs/getting-started/): installer det og skann en første melding.
* [Kommandolinje](https://spamscanner.net/no/docs/cli/): alle kommandoer og alternativer.
* [Postfix og Sendmail](https://spamscanner.net/no/docs/postfix/): filtrer en e-postserver med milteren eller et innholdsfilter.
* [Andre e-postservere](https://spamscanner.net/no/docs/mail-servers/): Exim, Haraka, Dovecot, procmail og alt som kan kalle et HTTP API.
* [Trening](https://spamscanner.net/no/docs/training/): lær det opp på din egen e-post og mål resultatet.
* [Språkmodeller](https://spamscanner.net/no/docs/llm/): beslutning og generering, målt treffsikkerhet og hastighet, beslutningsmodeller, leverandører, anbefalte åpne modeller, personvern og prompt injection.
* [Språk](https://spamscanner.net/no/docs/languages/): hvordan det leser kinesisk, arabisk, thai og alle andre skriftsystemer.
* [Forward Email](https://spamscanner.net/no/docs/forward-email/): hvordan Forward Email bruker det, og oppgradering fra versjon 5 eller 6.
* [API-referanse](https://spamscanner.net/no/docs/api/) og [tester og poeng](https://spamscanner.net/no/docs/scoring/).
* [Sikkerhet og personvern](https://spamscanner.net/no/docs/security/): hva som forlater maskinen, og hvordan du stopper det.