Dao Code 安全纵深防御:分层权限、危险命令拦截、SSRF 与沙箱机制全解析

原创2026-10-15 09:15:541,906 阅读

Dao Code 安全纵深防御:分层权限、危险命令拦截、SSRF 与沙箱机制全解析

Dao Code(命令 dao)是一个终端原生的 AI 编码助手,它不只是会写代码,更把"安全"做成了多层防线:allow/ask/deny 分层权限规则、危险命令拦截、SSRF 内网访问防护、OS 级沙箱与密钥扫描,层层兜底。本文带你从新手视角看懂这套安全纵深防御是如何工作的,以及如何在自己的项目里配置它。

Dao Code 终端 AI 编码助手演示:命令执行前需经过安全审批门

一、为什么 AI 编码助手需要"安全纵深"?

传统脚本出错最多浪费一次运行,而 AI 代理会自主执行 shell 命令、读写文件、访问网络——如果模型被提示注入诱导,或者简单"想错了",一条 rm -rf 就可能毁掉你的系统。Dao Code 的设计思路不是靠单点检查,而是层层设防:任何一层失守,下一层仍能拦截。

这套体系全部集中在 src/permissions/ 与 src/tools/ssrf.ts、src/tools/sandbox.ts 中实现,且每一层都有完整的端到端测试。

二、第一层:allow / ask / deny 三态权限规则

权限规则采用 Tool(说明符) 语法,例如 Bash(npm run test:*)、Read(//etc/**),支持三类:

规则 作用
deny 硬黑名单,任何模式(含 yolo)都拦截
ask 必须人工确认
allow 自动放行

配置支持五层优先级合并(低→高):~/.dao/settings.json(用户级)→ 项目 .dao/settings.json → .dao/settings.local.json(本地不提交)→ 命令行 --allow / --deny → 企业托管策略(不可被低层覆盖)。合并逻辑见 src/permissions/settings.ts。

裁决引擎 src/permissions/engine.ts 的优先级链值得记住:

deny 规则 > 危险 shell 命令 > yolo 放行 > 敏感目标 > ask 规则 > allow 规则 > 只读命令快速放行 > 模式默认

另外还有个容易忽略的细节:复合命令会逐段判定——cd /tmp && rm -rf x 会先按 &&、;、| 拆开,任一段命中 deny 就拦整条,无法绕过。Bash 命令更进一步走 AST 解析(src/permissions/bash/ast.ts),遇到无法静态分析的复杂写法会标记 too-complex 并 fail-closed(拿不准就转人工确认)。

三、第二层:危险命令拦截黑名单

src/permissions/bash_safety.ts 内置一份"不可逆破坏"命令黑名单,命中即强制人工确认(即使在 yolo 模式下也不例外),典型拦截对象包括:

  • 🗑️ rm -rf 指向根目录/家目录/通配符、find -delete、git reset --hard、git push --force
  • 💥 写入裸磁盘设备(dd of=/dev/sd*)、mkfs 格式化、shred 抹除
  • 🔓 sudo 提权、chmod 000、递归改属主
  • ⚠️ curl | sh 这类下载即执行的远程代码执行、fork bomb

这份黑名单还是精心打磨过的启发式:例如 cd eval 这种"目录名撞词"会被先遮蔽再判断,避免把 eval 目录误认成动态执行;>/dev/null 这类消音重定向也不会计入"写系统目录"。宁可多问一次,绝不漏放一次。

还有一个防绕过的设计:在 auto 模式下,形如 Bash(python:*) 这种 allow 规则会被识别为危险规则(解释器/包运行器/ssh 等代码执行入口,见 src/permissions/dangerous_patterns.ts),自动降级为 ask,防止模型借白名单执行任意代码。

四、第三层:auto 模式的 AI 智能审批

Dao Code 提供四种权限模式,/mode 或 Shift+Tab 随时切换:

  • default:写/执行操作按需弹审批
  • auto:AI 分类器智能审批——确信安全的自动放行,拿不准的转人工
  • bypassPermissions(yolo):除 deny 与危险命令外全放行
  • plan:只读规划模式,写/exec 一律拒绝

auto 模式的分类器 prompt 采用三层架构(见 src/permissions/classifier.ts),按四步判断:相关性 → 凭证与外泄 → 远程代码执行 → 不可逆后果。它的原则是**"安全的自动过,拿不准的问你,绝不替你拒"**;分类器只会放行,拒绝一律升级给真人。

审批门 src/permissions/gate.ts 还内置了熔断机制:连续 3 次或累计 20 次被分类器拒绝时,自动回退到全人工审批(30 分钟后重置),避免分类器"抽风"时反复打扰或误放行。每次裁决的来源(rule / classifier / human)都会写入 perm-trace.jsonl 审计文件(src/permissions/perm_audit.ts),事后可复盘"到底打扰了几次人"。

Dao Code 自纠错反思循环演示:卡住时独立视角复盘

五、第四层:敏感目标拦截与密钥扫描

引擎把敏感目标分成两类(src/permissions/engine.ts):

  • 凭据/密钥类(~/.ssh/id_rsa、.aws/credentials、.npmrc、/etc/shadow 等):读也算泄漏,一律确认;
  • 只写敏感类(.git/、.bashrc、/etc/ 配置等):纯读放行,写/执行才拦截——防止往启动脚本里种持久化后门。

同时 src/permissions/secrets.ts 内置密钥指纹扫描(私钥块、AWS Key、GitHub Token、JWT、sk- 风格 API key 等),在写入记忆和落盘日志前检测,命中的内容直接丢弃或脱敏为 [已隐去:类型],防止 API key 被持久化外泄。

六、第五层:SSRF 内网访问防护

AI 助手联网抓取是常态,但恶意网页可能诱导它去访问内网服务或云元数据端点偷凭据。src/tools/ssrf.ts 对所有 WebFetch 请求做保守判定:

  • localhost、127/8 环回、::1
  • 10/8、192.168/16、172.16/12 内网段
  • 169.254.169.254 云元数据端点(metadata.google.internal 同理)
  • 非 http/https 协议(如 file://)一律拒绝

命中即返回明确原因(如"禁止访问云元数据端点"),从工具入口把 SSRF 攻击面直接掐断。

七、第六层:OS 级沙箱与系统钥匙串

前面都是应用层拦截,而 src/tools/sandbox.ts 是真正的操作系统级兜底——设置 DAO_SANDBOX=1 后,所有 shell 命令会被裹进:

  • macOS:sandbox-exec(Seatbelt),默认只读,仅工作区 + 临时目录可写
  • Linux:bwrap(bubblewrap),全盘只读挂载,仅工作区可写,/tmp 用 tmpfs

再加上可选的 DAO_SANDBOX_NO_NET=1 网络隔离,即便应用层判断全错、或者遭遇了提示注入,命令也只能写坏工作区里的文件,够不着系统和其他目录。

密钥存储同样讲究:src/config/keychain.ts 优先把 API key 写入 macOS Keychain / Linux libsecret 系统钥匙串,避免明文落盘,且带 8 秒超时兜底防止卡死启动流程。

八、新手上手:三步配好你的权限

  1. 安装并启动:npx dao-code 零安装试用,或 npm i -g dao-code 后运行 dao,按提示粘贴 DeepSeek API key 即可。
  2. 切换模式:默认 default 模式最稳;追求效率用 /mode auto 让 AI 分类器代批;plan 模式适合先规划后动手。
  3. 预置规则:在项目根目录创建 .dao/settings.json,写好 permissions.allow/ask/deny 三张表,团队成员共享同一套安全边界;本地个人规则放 .dao/settings.local.json。

审批弹出时你有四个选择:[y] 本次放行 / [s] 本会话放行 / [a] 记住(写入 allow 规则)/ [n] 拒绝。

总结

Dao Code 的安全模型可以浓缩为一句话:规则引擎管"该不该",命令黑名单管"危险不危险",AI 分类器管"拿不准",SSRF 与沙箱管"兜不住"。再加上密钥扫描、钥匙串存储与全量权限审计日志,它给新手和老用户都提供了"放手让代理干活、又睡得着觉"的底气。

更多细节可参考仓库中的 src/permissions/ 权限引擎源码与 SECURITY.md 漏洞上报指引。

登录后查看全文
dao-code