Memulai

Spam Scanner memerlukan Node.js 18 atau lebih baru, atau tidak memerlukan apa pun jika memakai binary mandiri.

Instal#

Sebagai alat baris perintah:

npm install --global spamscanner
spamscanner version

Sebagai pustaka dalam proyek Node.js:

npm install spamscanner

Sebagai binary mandiri untuk Linux atau macOS, dengan Node.js dan model yang sudah tertanam:

curl -fsSL https://github.com/spamscanner/spamscanner/releases/latest/download/install.sh | bash

Binary untuk Linux (x64 dan arm64), macOS (Intel dan Apple silicon), dan Windows dilampirkan pada setiap rilis.

Pindai sebuah pesan#

Simpan pesan sebagai file (sebagian besar program email menyebutnya "Save as" atau "Show original") lalu pindai:

spamscanner scan message.eml

SPAM  score 16.3 (spam at 5.0, reject at 15.0)  action: reject  language: en
     +6.3  BAYES_999                    Classifier spam probability 99.9%
     +5.0  PHISHING_LOOKALIKE_DOMAIN    "paypa1-secure.top" imitates paypal by swapping characters
     +3.0  DECEPTIVE_LINK               A link shows "https://www.paypal.com/signin" but goes to paypa1-secure.top
     +2.0  FROM_NAME_BRAND              Display name says "paypal" but the message is from paypa1-secure.top

Kode keluar adalah 0 untuk hamEmail yang diinginkan: kebalikan dari spam., 1 untuk spam, dan 2 untuk galat, sehingga skrip dapat langsung menggunakannya. --json mencetak hasil lengkap dan --headers mencetak pesan dengan header X-Spam-* yang ditambahkan.

Pesan juga dapat berasal dari input standar:

cat message.eml | spamscanner scan -

Gunakan dari Node.js#

import SpamScanner from 'spamscanner';
import {readFile} from 'node:fs/promises';

const scanner = new SpamScanner();
const result = await scanner.scan(await readFile('message.eml'));

console.log(result.isSpam, result.score, result.action);
for (const test of result.tests) {
  console.log(test.name, test.score, test.description);
}

CommonJS juga berfungsi:

const SpamScanner = require('spamscanner');

scan() menerima pesan mentah sebagai Buffer, string, Uint8Array, atau readable stream. String selalu dianggap sebagai teks pesan: Spam Scanner tidak pernah membaca file hanya karena sebuah string terlihat seperti path. Gunakan scanner.scanFile(path) untuk file.

Beri tahu tentang sesi SMTP#

Alamat IP klien, hostname yang terverifikasi, nama HELO, dan envelope membuat hasil lebih akurat: autentikasi memerlukan alamat IP, dan aturan pemalsuan domain sendiri memerlukan daftar penerima.

const result = await scanner.scan(raw, {
  session: {
    remoteAddress: '203.0.113.5',
    resolvedClientHostname: 'mail.example.com',
    helo: 'mail.example.com',
    envelope: {
      mailFrom: {address: 'alice@example.com'},
      rcptTo: [{address: 'bob@example.org'}],
    },
  },
});

Hal yang sama dari baris perintah:

spamscanner scan message.eml --ip 203.0.113.5 --helo mail.example.com \
  --from alice@example.com --to bob@example.org --auth

Aktifkan pemeriksaan tambahan#

Tidak satu pun dari pemeriksaan ini aktif secara bawaan, karena masing-masing memerlukan layanan atau keputusan:

Resolver penyaring Cloudflare (1.1.1.2 untuk malware, 1.1.1.3 untuk konten dewasa) ditanya tentang host tautan secara bawaan. Nonaktifkan dengan phishing: {cloudflare: false} atau --no-cloudflare. Apa yang keluar dari mesin

Spamhaus dan beberapa daftar blokir lain tidak menjawab kueri yang dikirim melalui resolver publik seperti 8.8.8.8 atau 1.1.1.1. Gunakan dengan resolver cache lokal, dan periksa ketentuan penggunaannya untuk volume Anda.

Langkah berikutnya#

• Pasang di depan server email: Postfix dan Sendmail, server lain.
• Ajari dengan email Anda sendiri: pelatihan.
• Tambahkan model bahasa untuk kasus yang meragukan: model bahasa.