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，以 admin 身份登录，密码从 docker compose exec backend cat /app/data/initial_admin_password 获取，然后在设置中修改密码。更多选项见安装。

为什么选择 AbuseBox

• 结果值得信赖。 在信任某个黑名单之前，AbuseBox 会用其测试地址（RFC 5782）对其进行验证。拒绝你的解析器的列表会显示 无应答，而不是虚假的“干净”。试试看：通过 Google DNS，Spamhaus 对所有内容都显示“未列入”。
• 每条记录都有解释。 Spamhaus SBL（垃圾邮件来源）和 PBL（终端用户地址段）不是同一个问题。每条记录都附带其含义和严重程度，让你知道该先修复什么。
• 邮件服务器健康状况集中呈现。 24 个黑名单、AbuseIPDB、SSL 和域名到期、SPF/DKIM/DMARC 评级、DMARC 报告和正常运行时间。
• 按真正重要的因素排序。 每个资产都会获得一个百分制风险评分，权重取决于各黑名单自身返回码所解码出的严重程度，因此一条严重记录会排在三条表面问题之前。评分会展示其计算过程：每个因素、其贡献值以及总分构成。
• 告诉你发生了什么变化。 定时检查、活动日志，以及在资产被列入、移出、宕机或即将到期时通过电子邮件、Slack、Discord 或 webhook 发送警报。
• 属于你自己。 自托管、MIT 许可、无遥测、无付费层级。

如果 AbuseBox 帮你避免了一次退信，点个 star 能帮助其他邮件运维人员发现它。

功能

监控

• 将 IP 和域名添加为资产（逐个添加、最多 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 中的每个地址

日常使用

• 移出跟踪，附有每个黑名单的移除页面链接
• 表格或卡片视图，搜索、筛选、排序和分页均在服务器端完成，因此无论你有多少资产，第一页都是真实排序的顶部
• 每个资产有一个所有者，可与主机名、类型和描述一起搜索
• 批量操作和 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 以两个容器运行，因此需要同时安装两者：

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 设置为服务器的局域网 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。
• 或作为 stack： 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

数据库会在启动时自动迁移，你的数据会保留。（从源码构建？git pull && docker compose up -d --build。）

大多数版本不需要其他操作。少数需要额外操作的版本列在下面，更新日志 中有每个版本的完整细节。