怎么可以设置agent只可以访问特定的文件夹

67 次阅读

本文最后更新于 2026年11月9日。

重点:提示词约束只是软提醒,不可靠;真正强制限制,要在【工具层 / 沙箱层 / OS权限 / 容器挂载】四层控制

方案1:MCP 文件服务(最推荐,Cline / Continue / Goose / Lody / Orca 通用)

用独立的 filesystem MCP Server,直接在配置里写允许路径白名单,MCP服务自己拦截越界路径,模型绕不开。 示例 mcp.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-filesystem",
        "/opt/my-workspace/agent-only"
      ]
    }
  }
}
  • 只填你要放行的文件夹;多目录就多加路径参数
  • 它自带防护:../ 向上跳转、访问其它盘、上级目录直接拒绝
  • 还可以单独开一个只读版本:有些MCP fs支持read-only模式

方案2:框架内置沙箱(ollama-agent-kit、ollama-agent、VS Code Agent)

ollama-agent-kit

const agent = createAgent({
  workdir: "/home/xxx/agent_ws",
  // fullAccess: false 默认关闭,路径逃逸直接Access denied
  tools: [readFileTool,writeFileTool]
})

allow_traversal: false 是核心,文件工具会把 workdir 当成根,无法跳出

VS Code Agent 沙箱配置

settings.json

"chat.agent.sandbox.fileSystem.userConfiguredPaths": {
  "readwritePaths": ["D:/agent-write"],
  "readonlyPaths": ["D:/ref-docs"],
  "deniedPaths": ["C:/Users/xxx/Documents"]
}

优先级:denied > readonly > readwrite

方案3:Docker 容器隔离(最强硬隔离,适合服务化Agent)

只挂载目标文件夹进去,宿主机其它目录完全不进容器:

# 读写
docker run -v /host/agent-folder:/agent-ws your-agent-image
# 只读挂载(更安全)
docker run -v /host/agent-folder:/agent-ws:ro your-agent-image

容器内部看不到宿主机其它目录;不要挂载 /、/home、C:\Users

补充:Windows 也可以用 WSL2 + docker 这套;Windows原生容器同样支持 bind mount + ro

方案4:操作系统账号权限(原生ACL,不用容器)

  1. 创建一个单独低权限用户,专门跑Agent进程,无管理员、无sudo
  2. 只给这个用户:目标文件夹 读/写权限;其它所有目录全部拒绝
  • Linux:chown agentuser:agentuser /myagentdir && chmod 700 /myagentdir
  • Windows:文件夹安全选项,只添加这个用户,移除其他用户权限 缺点:如果Agent有shell执行能力,还是可能利用进程继承权限,适合配合工具层校验一起用

方案5:自己封装文件工具(代码层校验,自定义Agent)

所有 readFile / writeFile / listDir 工具,在执行前校验路径前缀,不要信任模型传过来的path: 伪代码:

ALLOW_ROOT = "/data/agent_workspace"
def safe_resolve(path):
    abs_path = os.path.abspath(os.path.join(ALLOW_ROOT, path))
    if not abs_path.startswith(ALLOW_ROOT):
        raise Exception("越界访问禁止")
    return abs_path

✅ 这是兜底,不管模型怎么写 ../../etc/passwd 都拦掉

❌ 不推荐:只靠system prompt

“你只能访问xxx文件夹,不许访问别的” 模型会prompt注入、幻觉、拼接路径绕过,没有强制拦截,只能辅助,不能作为安全边界

选型速查表

  • Cline / Continue / Goose / Lody / Orca:优先 MCP filesystem server
  • 自己写JS/Python Agent:工具层路径前缀校验
  • 部署成后台服务、高安全:Docker挂载 + 低权限用户
  • VS Code内置Agent:直接设置 chat.agent.sandbox.fileSystem