honoki/bbrf-server

BBRF Server Docker镜像文档

![*** Follow]([***]

概述

BBRF（漏洞赏金侦察框架）旨在促进安全研究人员跨多设备的工作流。本Docker镜像包含部署BBRF服务器的预配置环境，基于CouchDB数据库，为BBRF客户端提供后端支持。

有关BBRF的更多信息，请阅读博客文章：[***]

部署BBRF服务器后，请前往https://github.com/honoki/bbrf-client/%E3%80%82

核心功能

• 预配置的CouchDB环境，专为BBRF框架优化
• 包含Docker Compose配置，支持一键部署
• 内置反向代理，默认使用自签名证书（可替换为有效证书）
• 数据持久化存储到本地卷，确保数据不丢失

使用场景

• 漏洞赏金猎人需要在多设备间同步侦察数据和工作进度
• 安全研究团队协作进行漏洞侦察和信息收集
• 需要集中管理和共享侦察结果的安全研究工作流

安装与使用

基本部署步骤

1. 克隆仓库：

bash
git clone https://github.com/honoki/bbrf-server/
cd bbrf-server

2. 重要：修改docker-compose.yml中的默认密码（务必更改默认密码以确保安全）

3. 启动容器：

bash
sudo docker-compose up -d

验证安装

容器启动后，BBRF服务器会暴露443端口（HTTPS）。Docker Compose会生成自签名证书并持久化到./keys/卷中。

通过访问以下地址验证安装： https://127.0.0.1/_utils/#database/bbrf/_all_docs

配置Let's Encrypt证书

如需使用有效证书避免证书警告，可通过certbot生成证书并替换默认证书：

1. 确保已将域名指向BBRF服务器
2. 如容器正在运行，先停止：sudo docker-compose down
3. 安装certbot：sudo apt install certbot
4. 允许HTTP流量（如需）：ufw allow 80/tcp
5. 生成证书：certbot -d yourdomain.com certonly（按照提示完成）
6. 复制证书到keys目录：

bash
cp /etc/letsencrypt/live/yourdomain.com/{fullchain.pem,privkey.pem} ./keys/

7. 重启容器：sudo docker-compose up -d

通过访问https://yourdomain.com/_utils/#database/bbrf/_all_docs验证证书配置。