# Parancssor ```text spamscanner [options] ``` | Parancs | Mit csinál | | ------------------------------------------ | --------------------------------------------------------------------------------------- | | `scan [file\|-]` | Levél vizsgálata fájlból vagy a szabványos bemenetről | | `filter -f -- ` | Postfix-tartalomszűrő: a szabványos bemenet vizsgálata, fejlécek hozzáadása, továbbadás | | `milter` | Milter a Postfixhez és a Sendmailhez, 7831-es port | | `http` | HTTP API, 7832-es port | | `server` | Egyszerű TCP-szerver, 7830-as port | | `spamd` | SpamAssassin-kompatibilis spamd szerver, 783-as port | | `train` | Modell tanítása mbox-fájlokból, Maildirekből, mappákból vagy adatkészletekből | | `eval` | Modell mérése címkézett leveleken | | `learn spam\|ham [file\|-] --model ` | Egy levél megtanítása egy modellnek | | `llm-test` | A nyelvimodell-beállítások ellenőrzése három mintalevéllel | | `models` | Az ajánlott nyílt modellek listája | | `version`, `help` | | ## scan ```sh 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 ``` | Kapcsoló | Jelentés | | -------------------------- | ----------------------------------------------------------------------- | | `--json` | A teljes eredmény kiírása JSON-ként | | `--headers` | A levél kiírása a hozzáadott `X-Spam-*` fejlécekkel | | `--subject-tag ` | A spam tárgyának előtaggal való ellátása is | | `--verbose` | Minden teszt és az osztályozó legerősebb jeleinek megjelenítése | | `--threshold ` | Az a pontszám, amelytől a levél spam (alapértelmezés: 5) | | `--reject-threshold ` | Az a pontszám, amelytől a levél elutasításra kerül (alapértelmezés: 15) | | `--model ` | Modellfájl a beépített helyett | | `--no-classifier` | Az osztályozó mellőzése | | `--config ` | [Könyvtári beállításokat](https://spamscanner.net/hu/docs/api/#options) tartalmazó JSON-fájl | | `--allow-language ` | Elfogadott nyelvek, például `en,de,fr` | Kilépési kódok: 0 ham, 1 spam, 2 hiba. ### SMTP-munkamenet | Kapcsoló | Jelentés | | ------------------- | ----------------------------------------------- | | `--ip
` | A levelet küldő kliens IP-címe | | `--hostname ` | A kliens ellenőrzött fordított DNS-neve | | `--helo ` | A HELO vagy EHLO parancsban megadott név | | `--from
` | A boríték szerinti feladó (MAIL FROM) | | `--to
` | A boríték szerinti címzett; többhöz ismételhető | ### Ellenőrzések | Kapcsoló | Jelentés | | --------------------- | ----------------------------------------------------------------------------- | | `--auth` | SPF, DKIM, DMARC és ARC ellenőrzése (a `--ip` szükséges hozzá) | | `--dnsbl ` | IP-tiltólista, például `zen.spamhaus.org`; ismételhető | | `--uribl ` | Domain-tiltólista a hivatkozásokhoz, például `dbl.spamhaus.org`; ismételhető | | `--dns-server ` | Névszerver a DNS-ellenőrzésekhez; ismételhető | | `--no-cloudflare` | A Cloudflare szűrő DNS-feloldóinak mellőzése a hivatkozásoknál | | `--clamav [socket]` | Mellékletek vizsgálata clamd-vel, az alapértelmezett vagy a megadott socketen | | `--allowlist ` | Ennek az IP-címnek, domainnek vagy címnek mindig elfogadása; ismételhető | | `--denylist ` | Ennek az IP-címnek, domainnek vagy címnek mindig elutasítása; ismételhető | ### Nyelvi modell | Kapcsoló | Jelentés | | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `--llm ` | `ollama`, `clef-flash`, `jev`, `openai`, `anthropic` és mások ([lista](https://spamscanner.net/hu/docs/llm/#providers)) | | `--llm-model ` | Modell, például `qwen3.5:4b` vagy `claude-haiku-4-5` | | `--llm-method ` | `decision` (valószínűség minden ítéletre, egy lépésben; ahol elérhető, ez az alapértelmezés) vagy `generate` ([módszerek](https://spamscanner.net/hu/docs/llm/#decision-or-generation)) | | `--llm-account ` | Cloudflare-fiókazonosító a `clef` és a `clef-flash` szolgáltatóhoz | | `--llm-url ` | Alap-URL, például `http://10.0.0.5:11434` | | `--llm-host`, `--llm-port`, `--llm-path`, `--llm-protocol` | A szolgáltató URL-jének egy részét módosítja | | `--llm-api-key ` | API-kulcs; lásd még az alábbi környezeti változókat | | `--llm-auth ` | `bearer`, `x-api-key`, `api-key`, `basic`, `header` vagy `none` | | `--llm-auth-header ` | A kulcs fejléce, a `--llm-auth header` beállítással | | `--llm-username`, `--llm-password` | A `--llm-auth basic` beállításhoz | | `--llm-header "Name: value"` | További kérésfejléc; ismételhető | | `--llm-mode ` | `auto` (csak a kétes esetek, alapértelmezés) vagy `always` | | `--llm-timeout ` | Alapértelmezés: 30000 | | `--llm-policy ` | További szabályok a modellnek, például „Soha nem küldünk számlát” | | `--llm-redact`, `--no-llm-redact` | A személyes adatok előzetes eltávolítása; távoli szolgáltatóknál alapértelmezetten bekapcsolva | ## filter [Postfix-tartalomszűrő](https://spamscanner.net/hu/docs/postfix/#content-filter). Beolvas egy levelet a szabványos bemenetről, hozzáadja az `X-Spam-*` fejléceket, és ugyanazzal a borítékkal átadja a sendmailnek. ```sh spamscanner filter -f "$sender" -- "$recipient" ``` | Kapcsoló | Jelentés | | --------------------- | ----------------------------------------------------------------------- | | `--sendmail ` | Alapértelmezés: `/usr/sbin/sendmail` | | `--subject-tag ` | A spam tárgyának előtaggal való ellátása | | `--reject` | Az elutasítási küszöböt elérő levél visszapattintása továbbadás helyett | | `--discard` | Az elutasítási küszöböt elérő levél eldobása továbbadás helyett | A kilépési kódok a sendmail konvencióit követik, amelyeket a Postfix értelmez: 0 kézbesítve (vagy eldobva), 64 nincs megadva címzett, 69 spamként elutasítva (a Postfix visszapattintja), 75 bármilyen hiba, így a Postfix megtartja a levelet, és később újra próbálkozik. ## milter, http, server és spamd ```sh spamscanner milter --port 7831 --reject --subject-tag "[SPAM]" spamscanner http --port 7832 --token "$SPAMSCANNER_TOKEN" spamscanner server --port 7830 spamscanner spamd --port 783 ``` A 783-as port az, amelyet a SpamAssassin-kliensek alapértelmezetten használnak. Az 1024 alatti portokhoz root jogosultság vagy a `CAP_NET_BIND_SERVICE` képesség szükséges; ehelyett használható egy másik port, például `--port 7833`, amelyet a kliensnek is meg kell adni. | Kapcsoló | Jelentés | | --------------------- | ----------------------------------------------------------------------------- | | `--port ` | TCP-port | | `--host ` | A figyelési cím (alapértelmezés: 127.0.0.1) | | `--socket ` | Figyelés ehelyett Unix-socketen | | `--reject` | Milter: az elutasítási küszöböt elérő levelek visszautasítása | | `--reject-code ` | Milter: 451, próbálja később (alapértelmezés), vagy 550 | | `--quarantine` | Milter: a spam visszatartása a levelezőszerver karanténjában | | `--name ` | Milter: ennek a szervernek a neve az Authentication-Results fejlécben | | `--token ` | HTTP: `Authorization: Bearer ` megkövetelése; a `/learn` igényli | | `--allow-tell` | spamd: TELL kérések (`spamc -L spam`) elfogadása tanuláshoz | | `--out ` | HTTP és spamd: a tanultak mentése ebbe a modellfájlba | | `--subject-tag ` | Milter és spamd: a spam tárgyának előtaggal való ellátása | | `--verbose` | Milter: minden vizsgálat naplózása. TCP-szerver: válasz egyetlen szövegsorban | A fenti vizsgálati kapcsolók a szerverekre is vonatkoznak. [A milter](https://spamscanner.net/hu/docs/postfix/#milter), [a HTTP API, a TCP-szerver és a spamd](https://spamscanner.net/hu/docs/http-api/). ## train, eval és learn ```sh 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 ``` | Kapcsoló | Jelentés | | ----------------------------------------------- | ------------------------------------------------------------------------------ | | `--spam ` | Spam: mbox-fájl, Maildir vagy `.eml` fájlokat tartalmazó mappa; ismételhető | | `--ham ` | Ham, ugyanígy; ismételhető | | `--dataset ` | Szöveg- és címkeoszlopot tartalmazó CSV- vagy JSON Lines-fájl; ismételhető | | `--text-column `, `--label-column ` | Oszlopnevek, ha nem ismeri fel őket | | `--out ` | A modell kimeneti helye (alapértelmezés: `spamscanner-model.json`) | | `--merge` | Indulás a beépített modellből (vagy a `--model` modellből) üres modell helyett | A `learn` helyben frissíti a modellfájlt, első alkalommal a beépített modellből hozza létre. [Tanítás](https://spamscanner.net/hu/docs/training/) ## llm-test és models ```sh spamscanner models spamscanner llm-test --llm ollama --llm-model qwen3.5:4b ``` Az `llm-test` egy hétköznapi levelet és két csalást küld a modellnek angolul és olaszul, kiírja az ítéleteit, az egyes ítéletek idejét, a használt módszert és a hardvert, és csak akkor lép ki 0-s kóddal, ha mindhárom helyes. ## Konfigurációs fájl A `--config file.json` (vagy a `SPAMSCANNER_CONFIG` környezeti változó) [könyvtári beállításokat](https://spamscanner.net/hu/docs/api/#options) tölt be. A parancssori kapcsolók felülírják a fájlt. ```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} } ``` ## Környezeti változók | Változó | Jelentés | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | | `SPAMSCANNER_CONFIG` | Konfigurációs fájl | | `SPAMSCANNER_MODEL` | A beépített helyett használt modellfájl | | `SPAMSCANNER_TOKEN` | Token a HTTP API-hoz | | `SPAMSCANNER_LLM_API_KEY` | API-kulcs bármely nyelvimodell-szolgáltatóhoz | | `CLOUDFLARE_API_TOKEN` és `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_KEY` | Az egyes szolgáltatók saját kulcsa | | `NODE_DEBUG=spamscanner*` | Hibakeresési naplózás |