跳转到内容

安全

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 已移除。

类别 理由
开启服务端后的访问 启用服务端模式后,API 可被访问是预期行为
权限系统的“逃逸” 那套系统本身不是沙箱(见上)。内核级沙箱是另一套独立机制
请求了沙箱却未生效 已记录的行为:on_unavailable 默认 "warn";设为 "fail" 可拒绝
LLM 供应商的数据处理 发送给你所配置供应商的数据由他们的策略约束
MCP 服务端行为 你自己配置的外部 MCP 服务端不在我们的信任边界内
恶意配置文件 配置由你自己掌控,修改它不构成攻击途径

请使用 GitHub Security Advisory 的 “Report a Vulnerability” 入口。在公开之前,它一直是私密的。

你会收到一封回信说明后续如何推进,之后也会同步修复的进展。这里没有安全团队,也没有承诺的响应时限 —— 如果一周内没有收到答复,请在同一线程里再问一次。


Synced from mttydev/miao@284be7f.