AbuseBox

ユーザーより先に、メールサーバーがブラックリストに登録されていることを把握しましょう。

運用中のIPとドメインのためのセルフホスト型モニタリング: 24のDNSブラックリスト、SSLとドメインの有効期限、SPF/DKIM/DMARC、稼働状況を監視し、変化があればアラートを通知します。

ウェブサイト  |  クイックスタート  |  変更履歴

クイックスタート

git clone https://github.com/bekkaze/abusebox.git && cd abusebox
docker compose up -d

http://localhost:3000 を開き、docker compose exec backend cat /app/data/initial_admin_password で取得したパスワードを使って admin としてサインインし、その後 Settings でパスワードを変更してください。その他のオプションはインストールを参照してください。

AbuseBox を選ぶ理由

• 信頼できる結果。 ブラックリストを信頼する前に、AbuseBox はそのテストアドレス（RFC 5782）に対してブラックリストを検証します。あなたのリゾルバーを拒否するリストは、誤った「クリーン」ではなく No answer と表示されます。試してみてください: Google DNS 経由では、Spamhaus はすべてに対して「未掲載」と返します。
• すべての掲載理由を説明。 Spamhaus SBL（スパム送信元）と PBL（エンドユーザー向けレンジ）は同じ問題ではありません。各掲載にはその意味と重大度が付属するため、何を最初に修正すべきかがわかります。
• メールサーバーの健全性を一か所で。 24 のブラックリスト、AbuseIPDB、SSL とドメインの有効期限、SPF/DKIM/DMARC のグレード、DMARC レポート、稼働状況。
• 実際に重要なもの順にランク付け。 すべてのアセットには 100 点満点のリスクスコアが付き、各ブラックリスト自身のリターンコードが示す重大度で重み付けされるため、1 件の重大な掲載が 3 件の表面的な掲載より上位になります。スコアはその根拠を示します: すべての要因、それが寄与した内容、そしてその配点。
• 何が変わったかを教えてくれます。 スケジュールされたチェック、アクティビティログ、そして何かが掲載・解除・ダウン・期限切れ間近になった際のメール、Slack、Discord、Webhook によるアラート。
• あなたのもの。 セルフホスト、MIT ライセンス、テレメトリーなし、有料プランなし。

AbuseBox がバウンスを 1 つでも防いだなら、スターが他のメール運用者の目に留まる助けになります。

機能

モニタリング

• IP とドメインをアセットとして追加し（1 件ずつ、最大 300 件のリスト、または /24 全体）、それぞれで実行するチェックを選択
• グローバルまたはアセットごとの間隔でのスケジュール再チェック、および「期限が来たアセットを今すぐチェック」ボタン
• 対応が必要なものから開くダッシュボード。各アセット自身の検出結果から構築された 0〜100 のリスクスコアで並べ替え
• アセットごとのリスクスコアとその要因の内訳: ブラックリスト、到達性、証明書、ドメイン、メール認証、レピュテーション
• すべての変更のアクティビティログ、チェック間の変更内容を含むチェック履歴、ブラックリスト履歴チャート
• 新規掲載、解除、障害、復旧、期限切れ警告のためのメール、Slack、Discord、Webhook によるアラート

チェック

• ブラックリスト: 24 の DNS ブラックリスト。各掲載はその意味と重大度でデコードされ、各リストはテストアドレスに対して検証されます
• AbuseIPDB: 不正利用信頼度スコア、レポート、ISP、国（無料 API キー）
• SSL: 有効性、発行者、有効期限、対象名、および TLS バージョンと暗号がまだ許容可能かどうか
• WHOIS: レジストラ、日付、ネームサーバー、不正利用連絡先（IPv6 または IPv4 経由）
• DNS: A、AAAA、MX、TXT、CNAME、NS、SOA、PTR レコード
• SPF / DKIM / DMARC: A〜F のグレード、カスタム DKIM セレクター対応、さらに DMARC 集約レポートの解析。メールサーバー自身のホスト名も処理されます: その SPF は公開されている場所で読み取られ、それが対象とする DMARC ポリシーと DKIM キーは所属するドメイン上で見つけられます
• サーバーステータス: DNS 解決、ポート 80 と 443、HTTP ステータス、応答時間
• 一括およびサブネットチェック: 最大 300 ターゲットを一度に、または /24 内のすべてのアドレス

日々の運用

• 各ブラックリストの削除ページへのリンク付きの解除追跡
• テーブルまたはカード表示。検索、フィルター、並べ替え、ページングはすべてサーバー側で行われるため、アセットがどれだけ多くても 1 ページ目が実際の順序の先頭です
• アセットごとのオーナー。ホスト名、タイプ、説明とともに検索可能
• 一括操作と CSV エクスポート
• コマンドパレット（Ctrl/Cmd + K）、ライトとダークのテーマ、モバイルレイアウト
• 管理者ロールを持つ複数ユーザー、オプションの履歴保持、Swagger ドキュメント付きの REST API
• アカウント不要の公開クイックチェックページ（レート制限あり）。それ以外はすべてサインインが必要

インストール

Docker（推奨）

git clone https://github.com/bekkaze/abusebox.git
cd abusebox
cp backend/.env.example .env    # optional: alerts, API keys, admin account
docker compose up -d            # pulls the prebuilt images (add --build to build from source)

http://localhost:3000 を開けばすぐに使えます。

初回サインイン: ユーザーは admin で、初回起動時にランダムなパスワードが生成されます。docker compose exec backend cat /app/data/initial_admin_password で読み取ってください。バックエンドのログにはファイル名が記録されますが、パスワード自体は出力されなくなったため、誰かと共有したログからアカウントを乗っ取られることはありません。サインイン後すぐに設定で変更してください。変更すると保存されたコピーは削除されます。自分でパスワードを決めたい場合は、初回起動前に .env で DEFAULT_ADMIN_PASSWORD を設定してください。データパスが書き込み可能でない場合、アカウントは作成されず、ログにはパスワードを書き込む代わりにその旨が記録されます。

UI は任意のホスト名で応答するため、別のマシンからすぐに開くことができます。信頼できないネットワークに公開する前に、自前の HTTPS リバースプロキシの背後に置いてください。

手動セットアップ

cd backend
cp .env.example .env
pip install -r requirements.txt
uvicorn app.main:app --host 127.0.0.1 --port 8100 --reload

cd frontend
cp .env.example .env
yarn install
yarn dev

Unraid

Unraid の Community Applications 用テンプレートは templates/unraid/ にあります。AbuseBox は 2 つのコンテナとして動作するため、両方をインストールします。

1. abusebox-backend.xml と abusebox-frontend.xml をサーバーの /boot/config/plugins/dockerMan/templates-user/ にコピーします（または Docker → Template repositories にこのリポジトリを追加します）。
2. 最初に AbuseBox-Backend を追加します。Data をバックアップするパス（例: /mnt/user/appdata/abusebox）に設定し、Allowed browser origins を AbuseBox を開くアドレス（例: http://192.168.1.10:3000）に設定します。
3. AbuseBox-Frontend を追加します。Backend URL をサーバーの LAN IP とバックエンドのポート（例: http://192.168.1.10:8100）に設定します。localhost は使用しないでください。フロントエンドコンテナ自身を指してしまいます。
4. http://<your-server>:3000 を開きます。管理者パスワードは選択したデータパス内の initial_admin_password にあります。AbuseBox-Backend のログにファイル名が記載されています。Docker → AbuseBox-Backend → Console で cat /app/data/initial_admin_password を実行するか、SMB 経由で共有から読み取ります。

Unraid には同梱のリゾルバがないため、Blacklist resolvers はデフォルトで空になり、サーバー自身のリゾルバが使用されます。ブラックリストに「No answer」と表示される場合は、「No answer」と表示されるブラックリストを参照してください。

Portainer

templates/portainer/ にはアプリテンプレートと自己完結型の compose ファイル（ビルドコンテキストなし、バインドマウントなし）があります。

• アプリテンプレート: Portainer で Settings → App Templates を開き、URL を https://raw.githubusercontent.com/bekkaze/abusebox/main/templates/portainer/template.json に設定し、App Templates から AbuseBox をデプロイします。
• またはスタックとして: Stacks → Add stack → Repository を開き、リポジトリ URL に https://github.com/bekkaze/abusebox、compose パスに templates/portainer/docker-compose.yml を指定します。

Allowed browser origins を AbuseBox を開くアドレスに設定し、http://<your-server>:3000 にアクセスします。管理者パスワードは、Portainer でバックエンドコンテナの Console を開き、cat /app/data/initial_admin_password を実行して確認します。

CasaOS

templates/casaos/docker-compose.yml は自己完結型の CasaOS アプリです。

1. CasaOS で App Store → Custom Install（右上の +）を開き、Import を選択してファイルの内容を貼り付けます。
2. インストールし、ダッシュボードからポート 3000 で AbuseBox を開きます。
3. アプリの設定で APP_CORS_ALLOWED_ORIGINS を AbuseBox を開くアドレス（例: http://192.168.1.10:3000）に設定します。設定しないとブラウザが API 呼び出しをブロックします。

データは /DATA/AppData/abusebox/data に保存されます。管理者パスワードはそのフォルダ内の initial_admin_password にあり、CasaOS のファイルマネージャーで開くことができます。

アップグレード

docker compose pull && docker compose up -d