Skip to content

Security: LseKit/DeepSeekSearch

Security

SECURITY.md

安全策略

支持版本

只有最新发布版本接收安全修复。

版本 支持
v0.1.x(最新) ✅
更早版本 ❌ 请先升级

上报漏洞

请使用 GitHub 私密漏洞上报,不要开公开 issue:

https://github.com/LseKit/DeepSeekSearch/security/advisories/new

私密上报的内容至少包含:

  1. 受影响的版本(DeepSeekSearch --version 的完整输出)
  2. 传输方式(stdio 或 streamable-http)与相关配置片段(API Key 请替换成 sk-***)
  3. 复现步骤
  4. 影响描述:能做什么、需要什么前提

MUST NOT 在公开 issue、讨论区、社交媒体上披露未修复的漏洞。

响应时限

这是个人维护的开源项目,以下是尽力而为的承诺,不是 SLA:

阶段 时限
确认收到 72 小时内
初步评估(是否成立 / 严重度) 7 天内
Critical(远程可利用 / 密钥泄漏) 7 天内修复
High 30 天内修复
其他 90 天内或在下一个 minor 版本

哪些算安全问题

类型 例子
凭据泄漏 API Key / HTTP token 出现在日志、错误消息、/healthz、Resource 响应里
SSRF 绕过 用 IP 混淆写法(八/十/十六进制、IPv4-mapped IPv6)或重定向绕过私网黑名单,让服务端请求内网地址
鉴权绕过 auth_enabled=true 时无 token 仍能调用工具;token 比较存在时序侧信道
暴露面 host=0.0.0.0 且未开鉴权(启动期打 3092 warning,见 ADR-018);Origin / Host 校验缺失
注入 上游正文逃逸 <untrusted_content> 包裹,把 prompt injection 传给调用方
依赖漏洞 go.sum 中某个依赖的已知 CVE 影响本项目(CI 有 govulncheck job,见 .github/workflows/ci.yml)

哪些不算安全问题

下面这些是上游行为或设计决定,不当漏洞处理(提 issue 会被转成 wontfix):

现象 原因
DNS 重绑定「绕过私网黑名单」 🔴 本架构下这个攻击面不存在。两件事叠在一起:① 抓取由 DeepSeek 上游执行,我方进程从不直连目标 URL,所以「让服务端请求内网地址」里的「服务端」不是我们;② 我方故意不做 DNS 解析(只对字面量 host 判断),因为「先解析再连接」在解析与连接之间存在 TOCTOU,是个假防线。实测上游对 127.0.0.1、localhost、10.0.0.1、169.254.169.254、十进制混淆 IP 2130706433 一律返回 404(见 docs/Contract/23-上游能力实测报告.md §4.2)。
⚠️ 但请注意:上游的 404 与真 404 不可区分,所以我们不把「上游拦住了」当成安全保证 —— 本地黑名单是纵深防御(避免本服务被当作探测放大器、并覆盖 base_url 被指向自建代理的情形),不是唯一防线。
若将来改为我方直连目标 URL,MUST 用 net.Dialer.Control 在实际连接的 IP 上二次校验(这才是无 TOCTOU 的正解),届时本行 MUST 移回「哪些算安全问题」
搜索结果质量差、搜不到某个页面 DeepSeek 服务端的排序结果,本项目不做重排序
某个网页抓不到(返回 404) 上游把 403/404/500/不支持的内容类型统一塌缩成 404,见 docs/Contract/14-错误契约.md §2.3。实测 15 个主流站点里 6 个抓不到(维基百科中/英、知乎、Reddit、Hacker News、raw.githubusercontent.com),见 23 号 §4.3
超大单页抓取失败(返回 504) 上游 fetch 网关有 30 秒硬超时(实测 30.126s / 30.131s),超大单页必然超时,重试通常也无效。这是上游行为,不是本项目的 bug;504 会映射为 2504 且标记为可重试

| 正文里有反斜杠转义 | 上游对 Markdown 做了强制转义,用 unescape=true(默认)处理 | | 没有 SSE 传输 | MCP 2026-07-28 只定义 stdio 与 Streamable HTTP,见 docs/Decisions/ADR.md ADR-002 | | 缓存命中后看到旧内容 | ttl_fetch_s 默认 6 小时,调小即可 | | 免费额度 / 计费争议 | DeepSeek 账号侧问题,与本项目无关 |

本项目自身的安全基线

项 实现
密钥隔离 Config/.env(权限 600),config.toml 出现密钥类键名直接拒绝启动
暴露保护 暴露(host 非回环或 allow_non_local_host=true)时鉴权可选;auth_enabled=false 会打 3092 warning 并继续启动(ADR-018)
请求校验 Origin 白名单 + Host 校验 + 请求体大小上限
日志脱敏 API Key / token 永不进日志;配置输出前先 Redacted()
二进制 CGO_ENABLED=0 静态编译,发布附带 SHA256SUMS

There aren't any published security advisories