如何安全运行AI代理Agent of Empires容器沙箱Docker、Podman与Apple Containers指南【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empiresAgent of EmpiresAoE是一款AI代理管理工具支持从 TUI 或 Web 仪表盘统一管理 Claude Code、OpenCode、Codex CLI、Gemini CLI 等多个编程AI代理其核心安全能力是容器沙箱Container Sandbox让AI代理在独立的 Docker、Podman 或 Apple Containers 容器中运行代理能访问你的项目代码却碰不到本机其余文件实现安全运行AI代理的隔离目标。为什么AI代理需要容器沙箱AI代理编程Agent会执行命令、读写文件、安装依赖默认情况下它们拥有和你一样的主机权限。容器沙箱提供了天然的隔离层代码可达系统隔离项目目录挂载到容器内的/workspace代理可以修改代码但删不掉你主机上的其他文件凭证自动注入代理登录凭证被注入到每个会话私有的存储中容器内无需重新登录资源可控可设置 CPU、内存上限防止代理失控占满机器清理彻底删除会话时容器一并删除不留残留相关设计实现可在 src/containers/ 目录的运行时模块中查看官方指南位于 docs/guides/sandbox.md。快速上手一条命令创建沙箱会话安装好 tmux 和任意容器运行时后Docker 为默认只需一条命令aoe add --sandbox . # 使用官方默认沙箱镜像 aoe add --sandbox-image myregistry/custom:v1 . # 使用自定义镜像 aoe remove session # 删除会话时一并删除容器在 TUI 或 Web 向导中创建会话时直接勾选Sandbox 开关即可——只有检测到容器运行时后该选项才会出现。官方提供两款沙箱镜像镜像内容aoe-sandbox:latest默认所有受支持的代理 CLI ACP 适配器、git、ripgrep、fzfaoe-dev-sandbox:latest基础镜像 Rust、uv、Node LTS、GitHub CLI需要项目专属依赖时基于任一镜像扩展后通过--sandbox-image指定即可。三大容器运行时Docker、Podman、Apple Containers 怎么选Docker默认运行时开箱即用无需任何配置。[sandbox]下的所有运行策略选项 Docker 全部支持。PodmanLinux 用户友好替代Podman 是无守护进程、支持 rootless 的 Docker 替代品。安装后只需一行配置[sandbox] container_runtime podman使用要点独立镜像存储先用podman pull拉取沙箱镜像或让 AoE 首次使用时自动拉取rootless 网络1024 以上的端口直接可用SELinux 拦截挂载若容器内出现 Permission denied设置selinux_relabel true即可Apple ContainersmacOS 原生运行时Apple Containers 基于 Apple 虚拟化框架需要 Apple 芯片和 macOS 26Tahoe或更新版本brew install container container system start # 可能需要下载 Linux 内核然后配置[sandbox] container_runtime apple_containerTUI 的沙箱开关会自动使用该运行时container守护进程未启动时会明确报错。注意两点每个容器独占一个 VM已占用的主机内存在重启或删除前不会释放不支持只读挂载只读卷会自动降级为读写并给出日志警告。沙箱配置选项速查在 Web 仪表盘的Settings → Sandbox页面或config.toml中常用选项如下选项默认值说明enabled_by_defaultfalse新会话是否自动启用沙箱default_imageaoe-sandbox:latest使用的沙箱镜像container_runtimedockerdocker/podman/apple_container仅全局生效auto_cleanuptrue删除会话时自动删除容器cpu_limit/memory_limit无单容器资源上限如4与8genvironment[]注入容器的环境变量mount_sshfalse只读挂载~/.ssh/default_terminal_modehost配对终端运行位置环境变量支持三种写法密钥可以留在 shell 配置文件中而不写入配置文件[sandbox] environment [ ANTHROPIC_API_KEY, # 从主机透传同名变量 GH_TOKEN$AOE_GH_TOKEN, # 读主机变量 AOE_GH_TOKEN注入为 GH_TOKEN CUSTOM_API_KEYsk-sandbox-key, # 字面量 ]安全细节代理能碰到什么、碰不到什么自动挂载清单这是沙箱的信任边界主机路径容器路径模式项目目录/workspace读写~/.gitconfig/root/.gitconfig只读~/.ssh/开启mount_ssh时/root/.ssh/只读会话工件目录/aoe/artifacts读写会话私有代理配置/root/.claude/等读写几个值得了解的安全设计每会话私有代理存储每个沙箱会话拥有独立的sandbox-v2/instance-id配置目录会话的对话记录、缓存、日志彼此隔离也绝不导入你主机的历史数据文件夹预信任容器内的工作区对代理而言是陌生目录AoE 会在下发给容器的配置中预先信任它避免代理因信任提示而卡住共享凭证链Claude Code 的刷新令牌会轮换失效因此所有 Claude 会话共享一份sandbox-v2/.credentials.json任一容器刷新后全体可见登录一次即可清理有兜底aoe sandbox reclaim先报告再删除避免误删包含代理凭证的存储常见问题排查 容器被 OOM 杀掉docker inspect显示OOMKilled: true。macOS 上 Docker 运行在内存上限固定默认 2GB的 Linux VM 中请在 Docker Desktop 的Settings → Resources中调高 VM 内存编程代理建议 8GB 以上并设置[sandbox] memory_limit给每个容器明确配额。沙箱镜像升级后 OpenCode 会话启动失败报 drizzle/SQLite 迁移错误。删除该会话沙箱数据库位于~/.local/share/opencode/sandbox-v2/instance-id/opencode.db*并重启即可主机上的 OpenCode 状态不受影响。Podman 下podman info失败通常是存储未初始化或缺少 rootless 模式所需的/etc/subuid、/etc/subgid条目。完整排查方案见 docs/guides/sandbox.md运行时探测逻辑实现于 src/containers/runtime.rs。小结需求推荐运行时macOS 开发机Apple Containers原生或 DockerLinux 日常开发Docker默认或 Podmanrootless无 root 权限环境PodmanAgent of Empires 的沙箱机制让把代码交给AI代理这件事变得可控代码在容器内自由修改主机保持干净凭证按会话隔离资源有明确上限。一条aoe add --sandbox .即可体验 【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empires创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
余姚做轴承网站避坑指南：从零搭建全流程拆解 余姚做轴承网站避坑指南：从零搭建全流程拆解 在余姚开轴承厂或做轴承贸易，找建站公司报价从几千到几万不等，心里没底怕被坑高价是常态。别急着签单，先看看从零搭建一个能带来询盘的轴承网站，到底需要哪些硬指标。… · 2026/9/26 22:22:28
揭秘网站策划薪资真相:3个最佳实践避坑指南 揭秘网站策划薪资真相:3个最佳实践避坑指南 找建站公司怕被坑高价？别急，今天咱们掰开揉碎了讲清楚。很多老板看到“网站策划薪资”这个词就犯迷糊，觉得这跟我有啥关系？其实，了解这个岗位的真实行情，是你防止被销售忽悠、避开隐性消费的最佳实践。不懂… · 2026/9/26 22:22:28
Windows 本地安装 Redis7 全攻略：移植版与 WSL2 选型及配置 1. 为什么要在 Windows 上折腾 Redis7很多人第一次接触 Redis 都是在 Linux 服务器上，apt install redis或者yum install redis一行命令就完事了。但现实工作中，大量开发同学的日常主力机就是 Windows，本地调试、写单元测试、跑小型 Demo 的时… · 2026/9/26 22:51:15
WorkBuddy + Flask + SQLite：轻量级独立站快速搭建与日更实践 1. 为什么我选择 WorkBuddy Flask SQLite 这套组合1.1 从零建站这件事，工具选型决定了后面三个月的幸福感做独立站这件事，我前前后后折腾过不少方案。最早用 WordPress，插件装了一堆，主题换了七八套，结果页面加载速度… · 2026/9/26 22:51:15
通达信强龙战法：三重过滤识别主升浪买点 1. 这套指标到底在解决什么问题？——从实盘痛点出发的真实需求“通达信强龙战法抄底先锋捕捉主升浪买点全套指标公式”，光看标题，很多人第一反应是“又一个万能战法”“是不是割韭菜的？”——我完全理解这种警惕。但作为连续十年盯… · 2026/9/26 22:51:06
50+营销Skill装进AI Agent：从Prompt到可调度技能单元 1. 这个项目到底解决了什么问题第一次看到“把 50 多种营销 Skill 装进 AI Agent”这个说法，我脑子里冒出来的第一个念头是：又是一个把提示词打包成“技能库”的仓库吧。但真正把项目拉下来跑了一遍之后，我发现它想做的事情比“提示词合集”要… · 2026/9/26 22:51:05
Windows iTunes备份迁移：用mklink重定向C盘路径 1. 为什么 iTunes 备份会死死咬住 C 盘？——从 Apple 设计逻辑看路径锁定的底层原因你刚给 iPhone 做完一次完整备份，打开资源管理器一看：C:\Users\你的用户名\AppData\Roaming\Apple Computer\MobileSync\Backup 下，多出了一个 3… · 2026/9/26 22:50:57
深度学习人脸识别系统实战：检测、特征提取与比对的完整解析 简介：面向毕业设计与课程设计的深度学习人脸识别项目，融合卷积神经网络与YOLO检测思路，覆盖人脸检测、特征提取到身份识别的完整流程。资源共5个文件，包含主程序main.py、训练脚本train.py、人脸数据集dataset.zip、OpenCV的Haar级… · 2026/9/26 22:50:57
数据库课后习题答案别硬背：当测试用例集刷，效率翻倍 简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21
OpenClaw 替代品？Hermes Agent 踩坑实录：macOS 飞书接入 TaoToken 配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 0:00:40
向下兼容与向上兼容：接口设计中的兼容性策略与工程实践 一次版本升级事故，是很多团队绕不过去的坎。线上环境里，服务端明明已经上线了新版接口，老的移动端还在照着旧文档传参数。请求一到网关，校验直接拒绝，用户操作失败，客服群炸了锅，开发群里开始互… · 2026/9/26 0:00:46
