MindOS安全设计全解析：Bearer Token认证、路径沙箱、写保护与原子写入如何守护本地隐私

【免费下载链接】MindOSMindOS is a Human-AI Collaborative Mind System, where human thinks and agents act. Globally sync your mind for all agents: transparent, controllable, and evolving symbiotically.项目地址https://gitcode.com/gh_mirrors/mi/MindOS点击查看免费下载MindOS 是一个人负责思考、AI Agent 负责行动的人机协作心智系统你的笔记、项目与知识全部以本地 Markdown 形式存储。当 AI Agent 可以直接读写你的文件时安全边界就成了核心命题MindOS 通过 Bearer Token 认证、路径沙箱、Agent 写保护与原子写入四道防线在保证 Agent 高效干活的同时确保你的本地隐私和数据始终处于自己的掌控之中。一、Bearer Token 认证给每次 API 请求上身份锁MindOS 的 Web 服务默认端口 3456和 MCP 接口默认端口 8781都可能暴露到局域网甚至远程网络。为了防止未授权访问MindOS 采用Bearer Token 认证机制所有对App /api/*和 MCP/mcp端点的请求都必须携带Authorization: Bearer token请求头。Token 从哪里来执行mindos onboard初始化时会自动生成保存在本地配置文件中你也可以随时用mindos token命令查看当前 Token它会同时打印出给各 AgentClaude Code、Gemini CLI 等接入用的 MCP 配置片段。相关源码服务端认证逻辑packages/mindos/src/server/auth.ts客户端自动附带 Tokenpackages/mindos/src/client.tsToken 管理命令packages/mindos/bin/commands/token.js认证机制的三个细节1️⃣ 常量时间比较防时序攻击服务端使用 safeTokenEquals 做 Token 比对底层调用 Node.js 的timingSafeEqual——无论 Token 匹配到第几位才失败耗时都相同避免攻击者通过响应时间差逐字节猜出 Token。2️⃣ 本地浏览器同域豁免本机浏览器打开的 Web UI 发起的请求若来自回环地址127.0.0.1/localhost可以免 Token 通过但一旦请求经由反代从远程机器转发进来通过X-Forwarded-For等头识别豁免立即失效。这个设计让本地体验流畅又不给局域网内其他设备留后门。3️⃣ 网页密码与 Token 双轨独立webPassword保护浏览器登录authToken保护 API/MCP 调用二者相互独立。配置项说明见 docs/zh/configuration.md如果你的 MindOS 暴露到网络建议务必设置authToken。二、路径沙箱把一切文件操作锁进~/.mindos围栏MindOS 桌面端负责运行时runtime的下载、替换和清理这是最容易发生路径穿越攻击的地方。为此packages/desktop/src/safe-paths.ts 实现了一个严格的路径沙箱核心函数validateRuntimePath对每个路径做四重校验校验项防御的攻击① 拒绝空路径与\0空字节空字节注入截断路径② 拒绝包含..的段路径穿越如../../etc/passwd③ 解析后必须落在~/.mindos/内绝对路径逃逸④ 顶层目录必须在白名单内越权操作无关目录白名单仅包含runtime、runtime-downloading、runtime-old、config.json等少数更新所需条目——哪怕路径格式合法只要不在这个清单里直接抛出SECURITY: Subdirectory not whitelisted错误。此外还有配套的目录名消毒机制isValidDirName 会拒绝包含路径分隔符、空字节、以.开头的隐藏目录名sanitizeDirName 则把可疑字符替换为安全形式从源头上阻止非法目录名进入文件系统。三、写保护给 Agent 的手腕上权限铐在 MindOS 中Agent 通过知识库KB工具操作你的笔记。能读和能写是完全不同的权限等级。packages/mindos/src/agent/tool/kb-tools.ts 把工具划分成三组权限策略READONLY_TOOL_NAMES只读策略下的工具集Agent 只能查询、检索、浏览KNOWLEDGE_WRITE_TOOL_NAMES受限写策略下的工具集——可以写入但会跳过破坏性的移动/删除操作WRITE_TOOLS全部写操作工具名单由 Agent 会话在beforeToolCall钩子中逐一拦截校验见 packages/mindos/src/agent/mindos-pi/session.ts每次写操作都会被审核并记入审计日志。这意味着当你对某个任务使用只读模式对话时Agent 物理上拿不到任何写工具即便授予了写入权限危险操作也仍需经过写保护拦截器。权限最小化而不是事后追责。四、原子写入与符号链接防护数据落盘零损坏先写临时文件再原子改名无论是服务器端文件写入atomicWriteFile写.tmp-pid-时间戳后renameSync原子替换还是知识库元数据更新atomicMetadatawx标志独占创建 0o600权限 重命名MindOS 都遵循同一个模式绝不直接覆盖原文件——新内容先写进临时文件成功后用rename一步替换。同一文件系统内rename是原子操作你看到的要么是旧版本、要么是完整的新版本绝不会出现写了一半的损坏文件。即使进程在写入中途崩溃原文件也毫发无损finally块还会清理残留的临时文件。符号链接攻击安全删除器的必修课rename、删除操作最危险的陷阱是符号链接攻击者可以把runtime-old软链指向你的用户数据目录诱导更新流程清理旧版本时误删真实数据。packages/desktop/src/safe-rm.ts 提供的assertNotSymlink、assertNoSymlinksInPath、safeRmSync会逐层检查路径链发现软链立即中止并抛出SECURITY错误。这些防线不是纸面设计而是有完整的对抗性测试护航的tests/security-hardening.test.ts 模拟了软链指向用户数据、../../../../etc/passwd路径穿越、更新中断后回滚等端到端攻击场景逐一验证防御生效、数据无损。五、安全设计速查表防线机制核心源码身份认证Bearer Token 常量时间比较 本地同域豁免auth.ts路径沙箱~/.mindos边界 白名单 穿越/空字节拦截safe-paths.tsAgent 写保护只读/受限写/全量写三级工具策略 调用前拦截kb-tools.ts数据完整性临时文件 原子 rename 软链防护删除operations.ts回归验证攻击场景端到端测试security-hardening.test.ts总结透明、可控、可验证的安全MindOS 的安全理念可以浓缩为一句话Agent 拥有完成工作所需的最小权限且每道防线都可被测试验证。对外Bearer Token 让远程调用持证上岗本地访问依然丝滑对内路径沙箱和写保护把 Agent 关进权限围栏你的笔记目录结构不会越界敏感操作不会失控对数据原子写入和软链防护保证每一次落盘都是完整且可预期的。如果你想亲自体验可参考 README_zh.md 完成安装用mindos token拿到 Token再通过 docs/zh/configuration.md 配置authToken与webPassword即可拥有一个既开放协作又守口如瓶的本地 AI 心智系统 赞分享【免费下载链接】MindOSMindOS is a Human-AI Collaborative Mind System, where human thinks and agents act. Globally sync your mind for all agents: transparent, controllable, and evolving symbiotically.项目地址https://gitcode.com/gh_mirrors/mi/MindOS点击查看免费下载相关推荐CartCut 安全设计详解MCP Bearer Token、扩展沙箱与Webview防护策略CartCut 安全设计详解MCP Bearer Token、扩展沙箱与Webview防护策略 CartCut 是一款面向 AI 代理的开源视频编辑器允许Arbor安全机制深度解析本地回环免认证、Bearer Token与远程守护进程防护策略Arbor安全机制深度解析本地回环免认证、Bearer Token与远程守护进程防护策略 Arbor 是一个用于运行 agentic coding 工作流的完AOCI-CODE 写路径原理深度剖析原子写入、CAS、跨进程锁与 fail-closed 如何保证安全AOCI CODE 写路径原理深度剖析原子写入、CAS、跨进程锁与 fail closed 如何保证安全 AOCI CODE 是一个本地优先的 MCP 服务器开发工具MCP 服务CLI代码智能体人工智能Agent 记忆上一篇解决跨系统通信难题RabbitMQ多协议消息格式无缝转换实战指南下一篇如何用Akagi雀魂助手提升你的麻将水平3大核心功能全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考