bbscope.com

用于聚合来自 HackerOne、Bugcrowd、Intigriti 和 YesWeHack 的漏洞赏金计划范围的 Web 界面和 API。

快速开始 (Docker)

cd website
cp .env.example .env
# 编辑 .env — 至少设置 POSTGRES_PASSWORD 和你的平台凭证
docker compose up -d --build

站点将通过 https://yourdomain.com 访问（Caddy 通过 Let's Encrypt 自动处理 HTTPS）。

Cloudflare DNS 挑战

如果你的服务器位于 Cloudflare 之后（代理 DNS），标准的 HTTP ACME 挑战将无法工作。请改用 Cloudflare compose 文件，它会构建一个包含 Cloudflare DNS 插件的自定义 Caddy：

docker compose -f docker-compose.cloudflare.yml up -d --build

在 .env 中设置 CF_API_TOKEN。在 https://dash.cloudflare.com/profile/api-tokens 创建令牌，并赋予你的域名 Zone:DNS:Edit 权限。

本地开发

要求：Go 1.24+，以及一个运行的 PostgreSQL 实例。

DB_URL="postgres://postgres:yourpassword@localhost:5432/bbscope?sslmode=disable" \
  go run *.go serve --dev --poll-interval 0 --listen localhost:7001

--dev 标志启用仅 HTTP 模式（无 TLS）。--poll-interval 0 禁用后台轮询，因此你不需要平台凭证。

服务命令标志

数据库连接从环境变量 DB_URL 或 ~/.bbscope.yaml 中的 db_url 读取。

配置

平台凭证

所有平台凭证均为可选。未配置的平台在轮询期间将被跳过。

AI 标准化（可选）

设置 OPENAI_API_KEY 和可选的 OPENAI_MODEL（默认为 gpt-4.1-mini）以启用基于 AI 的范围目标标准化。每个目标会缓存以减少 API 调用。

基本认证（可选）

要使用 HTTP 基本认证保护站点：

1. 生成密码哈希：

   root@kitploit:~

   docker run --rm caddy:2-alpine caddy hash-password --plaintext 'yourpassword'
   

2. 将示例配置复制到 conf.d/：

   root@kitploit:~

   cp basicauth.caddy.example conf.d/basicauth.caddy
   

3. 编辑 conf.d/basicauth.caddy 并添加你的用户名和哈希：

   root@kitploit:~

   basic_auth {
       myuser $2a$14$hashgoeshere...
   }
   

4. 重启 Caddy：docker compose restart caddy

要禁用，删除 conf.d/basicauth.caddy 并重启。

架构

caddy (ports 80/443) → bbscope-web (:8080) → postgres

• Caddy 处理 TLS 终止和反向代理。conf.d/*.caddy 中的额外配置片段会被自动导入。
• bbscope-web 提供站点服务并运行后台轮询器。
• PostgreSQL 存储项目、目标和范围变更历史。启动时会自动迁移模式。

API

站点提供了一个公开的 API：

查询参数：scope（in/out/both）、platform、type、raw（跳过 AI）、format（json/text）。

默认输出为换行分隔的文本；添加 format=json 以获取 JSON。响应会缓存 5 分钟。