Files
blackbird/dnfs2/README.md
T
qing 117fc0241e fix(libhttp,dnfs2): HttpClient 新增超时接口,dnfs2 启用配置超时
修复 dnfs2 审计 L-3(P2-N5):

libhttp HttpClient 硬编码 CURLOPT_TIMEOUT=30L/CONNECTTIMEOUT=10L,
dnfs2 的 gateway_timeout/review_timeout 配置加载后从未使用,实际超时恒为 30s。

修复:
- libhttp HttpClient 新增 set_timeout/set_connect_timeout 接口
  (默认 30s/10s,向后兼容 gateway/core)
- request_stream_sync 使用成员变量替代硬编码值
- dnfs2 decode_token 设置 gateway_timeout
- dnfs2 review_content 设置 review_timeout

安全评级 A- → A,已知限制 6→5 项。
2026-08-08 01:33:57 +08:00

2.8 KiB
Raw Blame History

dnfs2 — C++20 树状网络文件系统

dnfs 的 C++ 重实现,接口与 Python dnfs 完全兼容,修复 P0/P1 安全问题。基于 libhttp + libmsg + boost::json。

架构

gateway (验签/转发)
   │  Bearer Token
   ▼
dnfs2 :8006 ──pymsg──► db2 :8005 (execute 路由) ──► SQLite
   │                     ▲
   │                  libmsg (RpcClient)
   └──HTTP──► ai_review :8007 (内容审核)
  • HTTP 服务: libhttp HttpServer(Boost.Beast 异步,多线程)
  • Token 验签: HttpClient POST gateway /whoami,fail-closed(503)
  • 数据操作: libmsg RpcClient 调 db2 execute 路由
  • 内容审核: HttpClient POST ai_review /review,fail-closed
  • 异步日志: libmsg AsyncQueue → db2 Logs 表

接口

路由 鉴权 说明
POST /get_notes 否(可选 Token,用于 can_operate) 返回子节点数组
POST /add_note 是 校验 Token → 父节点存在 → AI 审核 → 插入
POST /delete_note 是 校验 Token → 检查子节点 → 所有权 → 删除
POST /update_note 是 校验 Token → 所有权 → 父节点存在 → AI 审核 → 更新

请求/响应 JSON 格式与 Python dnfs 完全一致,前端零改动。

配置

从 confs 拉取 dnfs.ini,环境变量覆盖,命令行参数最高优先级。

[server]
host = 127.0.0.1
port = 8006

[database]
host = 127.0.0.1
port = 8005
timeout = 10

[ai_review]
url = http://127.0.0.1:8007/review
timeout = 10

[gateway]
url = http://127.0.0.1:8443/whoami
timeout = 5

环境变量: CONFS_HOST, CONFS_PORT, LISTEN_ADDR, LISTEN_PORT, DB_HOST, DB_PORT, REVIEW_URL, GATEWAY_URL

命令行: --addr, --port, --threads

构建

./_set.sh    # 编译
./_run.sh    # 运行

依赖: libhttp, libmsg, boost::json, OpenSSL, libcurl

安全修复(相比 Python dnfs)

编号 问题 修复方案
P0-4 父节点删除 TOCTOU + 未检查 success 统一封装 _call_db() 检查 success 后再访问 data
P1-6 请求体无限制 server.setMaxBodySize(10MB)
P1-7 log_client 配置不一致 日志客户端复用主配置
P1-8 update_note 改 pid 未校验父节点 pid≠0 时校验父节点存在
P1-9 db RPC 未启用启动等待 RpcClient(retry_on_refused=true)
P1-11 note_id 无强制类型转换 显式 as_int64() + 类型校验

已知限制(P2,设计决策不修复)

  • L-1: update_note 允许创建循环(需图遍历检测后代关系)
  • L-2: delete_note TOCTOU 残余(需 db2 事务支持)
  • L-4: 无速率限制(gateway/WAF 职责)
  • L-5: title/content 无最大长度校验
  • L-6: AI 审核不可用时阻断写入(fail-closed 设计决策)