本文最后更新于 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,不用容器)
- 创建一个单独低权限用户,专门跑Agent进程,无管理员、无sudo
- 只给这个用户:目标文件夹 读/写权限;其它所有目录全部拒绝
- 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