简体中文 | English
不要用公开 issue 报安全问题,也不要在 issue / PR / 讨论里贴出可复现的生产凭据、群聊正文、成员档案、协议端原始报文、日志片段或截图。
请私下联系仓库所有者(GitHub 上 @ZhaoJun233),或在仓库的 Security 页使用 "Report a vulnerability" 私密通道。报告请尽量给出:
- 受影响的功能与入口(哪个端点 / 哪条命令 / 哪个插件路径);
- 触发条件与最小复现步骤(用合成数据,不要用线上会话);
- 影响判断(读到什么、改到什么、能不能持久化);
- 你认为的修复方向(可选)。
本项目是个人维护的项目,不承诺响应时限,也不承诺修复时间。收到报告后会尽力确认、评估影响并安排修复,但不构成 SLA。
- 插件没有沙箱。 插件是在宿主进程内加载的 .NET 程序集(
PluginPackageLoader是可回收的AssemblyLoadContext,直接LoadFromAssemblyPath+Activator.CreateInstance)。也就是说,任何被启用的插件都能执行任意代码、读写宿主可访问的一切(数据库、密钥、日志、网络)。因此:- 插件来源的可信度就是宿主的可信度;
- 安装 / 启用插件属于高权限操作,默认关闭,需要管理员显式开启;安装、更新与启停会热应用到运行中的宿主,不需要为此重启进程(升级与排障仍建议放在维护窗口内操作);
- "这个插件会不会干坏事" 不是沙箱能回答的问题,只能靠来源审查。
- SHA256 只证明字节完整性,不证明代码安全。 清单里的哈希能保证"下到的包和作者发布的是同一份字节",不能保证这份字节没有恶意行为。签名与哈希都不改变第 1 条。
- 权限声明只是信息披露,不是强制约束。 插件清单里的 permissions 字段用于展示与审核提示,宿主不会因为声明了少权限就限制它能做什么。
- 凭据与会话数据是最高价值目标。 模型 API Key、面板令牌、ZBA 令牌、官方通道 App Secret 都在宿主进程内存与 SQLite 里;数据库文件与
secrets表在宿主可读的位置上。能执行代码的攻击者(包括恶意插件)可以拿走它们 —— 这也是为什么插件默认禁用。 - 默认失败关闭。 没有配置 ZBA 令牌时管理端点返回 503,只有
/zba/v1/health可读;面板令牌缺失时管理写入口不可用。如果你发现某个入口在缺令牌时仍然可用,那是安全缺陷,请按上面的渠道报告。
- 上游依赖(.NET 运行时、NuGet 包、NapCat、Caddy、Cloudflare 隧道、模型网关)自身漏洞:请报给对应项目;本项目通过 NuGet 审计门(
NU1903/NU1904作为还原错误)与钉版本处理已知项。 - 你自己部署环境的加固(反向代理、防火墙、主机权限、备份介质保管):属于部署方责任,仓库只提供回滚与备份的操作口径。
- 拿真实群聊数据做出来的任何结论或外传:见 AGENTS.md 的隐私红线。
- 面板与协议端只绑回环,经反向代理对外;
- 数据库文件权限 600(Unix),备份文件同等对待;
- 不把
.env、数据库、日志纳入镜像或公开快照; - 升级前按 docs/operations/rollback-playbook.md 做快照;
- 容器默认不挂载 docker socket(compose 的
volumes只有./data,#131)://的 docker 能力与 面板一键部署因此不可用,宿主会如实回读这一点(工具表里不出现 docker、状态面标出不可用)。 要启用必须由部署方显式挂载/var/run/docker.sock—— 那等于把宿主 root 交给容器里的进程 (见本文威胁模型第 1 条),请自行评估后再打开对应开关。 - 只启用来源可信的插件。