安全
miao 是运行在你本机的 AI 编程助手。它提供一套代理系统,可访问能力很强的工具,包括执行 shell、 操作文件和访问网络。
默认情况下,miao 不对代理做沙箱隔离。 权限系统是一项体验功能 —— 它在执行命令、写入文件等操作前 请求确认,帮助你了解代理在做什么。但它不是用来提供安全隔离的。
此外还有一个需要手动开启的内核级沙箱,用于 V2 的 bash 工具;不开启则不生效。它在 macOS 上为
sandbox-exec 构建 seatbelt 策略,在 Linux 上应用 Landlock;miao-sandbox 在 Windows 上报告没有
可用后端。
{ "sandbox": { "mode": "workspace-write", "network": true } }MIAO_SANDBOX=1 与 MIAO_SANDBOX_DENY_NETWORK=1 会覆盖配置。有三条性质属于威胁模型,必须写明:
- 不开启就不生效。
mode默认为"off"。 - 它默认“失败即放行”。 请求了沙箱但没有可用后端时,
on_unavailable默认为"warn",命令会在 没有沙箱的情况下执行。想让它直接拒绝,设为"fail"。 workspace-write限制的是写入,不是读取。 写入被限制在活动 Location、命令的工作目录、临时 目录、writable_roots,以及在被拦截后你批准过的路径(随后会用新增的目录重跑该命令)。网络默认 允许,除非显式禁止。
如果你需要真正的隔离,请在 Docker 容器或虚拟机中运行 miao。
普通 CLI/TUI 每次调用都在同一进程中拥有独立的窗口级 Runtime。本地监听器绑定
127.0.0.1 的临时端口,不通过 mDNS 广播,并使用每次新生成的私有凭据与 Runtime ID。
关闭窗口会结束该窗口的执行与远程连接。私有 miao runtime access 桥接必须指定正在运行的
Runtime ID,不会启动守护进程。见运行时生命周期。
miao serve 是显式启动的前台 API 服务。默认监听 127.0.0.1,但 --hostname 或服务端配置
可以将它暴露到网络;--mdns 开启发现,在没有显式覆盖时会将监听地址改为 0.0.0.0。
设置 MIAO_SERVER_PASSWORD 可启用 HTTP Basic Auth,用户名可通过
MIAO_SERVER_USERNAME 指定。未设置密码时仍会启动,并提示监听器未受保护;能访问所配置
网络接口的进程或主机都可能连接,因此不能将它笼统视为“仅本机可访问”。
Remote Control 通过 /remote-control 为某个窗口显式启用。本地 Agent 主动连接你配置的 Hub。
Hub 登录负责中继访问,本地批准的设备公钥和限定范围、带有效期的授权负责会话操作。
关闭访问或退出所属窗口会断开连接;撤销设备会使其授权失效。Hub 只转发加密帧,不执行本地会话。
旧 IM 桥接与 miao remote 已移除。
不在受理范围内
Section titled “不在受理范围内”| 类别 | 理由 |
|---|---|
| 开启服务端后的访问 | 启用服务端模式后,API 可被访问是预期行为 |
| 权限系统的“逃逸” | 那套系统本身不是沙箱(见上)。内核级沙箱是另一套独立机制 |
| 请求了沙箱却未生效 | 已记录的行为:on_unavailable 默认 "warn";设为 "fail" 可拒绝 |
| LLM 供应商的数据处理 | 发送给你所配置供应商的数据由他们的策略约束 |
| MCP 服务端行为 | 你自己配置的外部 MCP 服务端不在我们的信任边界内 |
| 恶意配置文件 | 配置由你自己掌控,修改它不构成攻击途径 |
报告安全问题
Section titled “报告安全问题”请使用 GitHub Security Advisory 的 “Report a Vulnerability” 入口。在公开之前,它一直是私密的。
你会收到一封回信说明后续如何推进,之后也会同步修复的进展。这里没有安全团队,也没有承诺的响应时限 —— 如果一周内没有收到答复,请在同一线程里再问一次。
Synced from mttydev/miao@284be7f.