新闻详情

新闻详情

首页 / 资讯中心 / 详情

OpenClaw-China-Docker沙箱模式实战:开启Docker-in-Docker隔离,守护宿主机安全

发布时间:2026/11/16 22:37:30来源:尧图网络
OpenClaw-China-Docker沙箱模式实战:开启Docker-in-Docker隔离,守护宿主机安全
OpenClaw-China-Docker沙箱模式实战开启Docker-in-Docker隔离守护宿主机安全【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-docker如果你担心 AI 助手在服务器上放飞执行脚本那么 OpenClaw-China-Docker 的沙箱模式就是你必须了解的安全开关。OpenClaw-China-Docker 是预装飞书、钉钉、QQ机器人、企业微信插件的中国 IM AI 机器人网关本文用 3 步实战教你开启 Docker-in-Docker 沙箱隔离让 Python 代码与 Shell 脚本全部在一次性容器中运行彻底守护宿主机安全。为什么建议开启沙箱模式AI 机器人最大的风险之一是它执行工具时可能产生不可预期的操作——安装依赖、写文件、跑脚本。如果这些工具直接跑在网关主容器里一旦 AI 生成了一段危险命令影响范围就是整个主容器。沙箱模式的作用就是给工具执行加一道隔离墙不开沙箱开启沙箱Python / Shell 直接运行在主容器在独立的openclaw-sandbox容器中运行危险命令可能影响网关与数据目录沙箱销毁即干净主容器不受波及适合完全可信环境推荐生产 / 长期运行环境默认开启一句话理解沙箱把AI 动手的部分关进了笼子笼子的钥匙Docker Socket只交给网关不交给 AI。开启沙箱前理解 Docker-in-Docker 的工作原理本镜像本身就是 Docker 容器它通过挂载宿主机的/var/run/docker.sock获得容器内再启动容器的能力这就是 Docker-in-DockerDinD的轻量实现宿主机 Docker 守护进程 ↑docker.sock 挂载 openclaw-gateway 主容器预装 docker.io 客户端 ↓按需拉起 openclaw-sandbox 沙箱容器bookworm-slim 最小镜像镜像构建时已预装docker.io客户端见 Dockerfile启动脚本init.sh检测到 Socket 后还会自动修复其权限无需你手动处理init.shif [ -S /var/run/docker.sock ]; then echo 检测到 Docker Socket正在尝试修复权限以支持沙箱... chmod 666 /var/run/docker.sock || true fi⚠️ 安全提示挂载 Socket 意味着网关容器可管理宿主 Docker因此请在可信宿主机上开启沙箱不要直接对公网暴露网关端口。三步开启沙箱的完整步骤步骤一克隆仓库并准备环境变量git clone https://gitcode.com/gh_mirrors/op/openclaw-china-docker cd openclaw-china-docker cp .env.example .env完整模板参考 .env.example其中已包含全部沙箱相关变量及注释说明。步骤二在 .env 中设置沙箱模式在.env中配置默认off必须显式开启OPENCLAW_SANDBOX_MODEall # 所有 Agent 的工具都进沙箱 # OPENCLAW_SANDBOX_MODEnon-main # 仅非主 Agent 进沙箱更保守的折中步骤三取消 docker.sock 挂载的注释打开 docker-compose.yml在openclaw-gateway服务的volumes中取消最后一行注释volumes: - ${OPENCLAW_DATA_DIR}:/home/node/.openclaw - openclaw-extensions:/home/node/.openclaw/extensions # 沙箱支持如需启用 Docker 沙箱请取消下面一行的注释并确保 .env 中 OPENCLAW_SANDBOX_MODE 不为 off - /var/run/docker.sock:/var/run/docker.sock然后强制重建容器并重启docker compose up -d --force-recreate验证沙箱是否生效启动日志中会打印当前沙箱状态看到沙箱模式: all即代表配置成功输出逻辑见 init.sh沙箱模式: all 沙箱范围: agent 沙箱访问权限: none最终这些配置会被写入agents.defaults.sandbox节点结构示例可参考 openclaw.json.exampleagent: { defaults: { sandbox: { mode: all, scope: agent, workspaceAccess: none, docker: { image: openclaw-sandbox:bookworm-slim } } } }沙箱核心配置参数速查表参数可选值默认值说明OPENCLAW_SANDBOX_MODEoff/non-main/alloff沙箱总开关与生效范围OPENCLAW_SANDBOX_SCOPEsession/agent/sharedagent沙箱复用粒度按会话 / 按 Agent / 全局共享OPENCLAW_SANDBOX_WORKSPACE_ACCESSnone/ro/rwnone沙箱对工作区的访问权限OPENCLAW_SANDBOX_DOCKER_IMAGE任意镜像openclaw-sandbox:bookworm-slim沙箱容器使用的镜像OPENCLAW_SANDBOX_JOIN_NETWORKtrue/falsefalse让沙箱加入主容器网络解决无外网问题OPENCLAW_SANDBOX_JSONJSON 字符串留空全量覆盖 / 合并自定义沙箱配置工作区访问权限怎么选none默认沙箱看不到你的工作区文件最安全工具只能在~/.openclaw/sandboxes下活动ro在/agent处只读挂载适合读文档、答问题类场景rw在/workspace处读写挂载适合需要 AI 修改工作区文件的场景进阶技巧解决沙箱无外网的问题沙箱容器默认是独立网络部分环境里会出现沙箱内工具访问不了外网的情况。在.env中开启OPENCLAW_SANDBOX_JOIN_NETWORKtrue开启后沙箱会自动以docker.network: container:网关容器ID的方式加入主容器网络。由于该操作涉及容器命名空间共享init.sh会自动为你开启dangerouslyAllowContainerNamespaceJoin: true无需手工干预。如果你有更细粒度的需求例如自定义沙箱资源限制可以直接用OPENCLAW_SANDBOX_JSON注入OPENCLAW_SANDBOX_JSON{docker:{dangerouslyAllowContainerNamespaceJoin:true}}常见坑与安全建议❌改了.env不生效容器只在配置文件不存在时重新生成配置已有旧配置时请删除~/.openclaw/openclaw.json后重启详见 docs/configuration.md 的修改环境变量后为什么不生效一节❌只改了.env没取消 Socket 挂载注释缺少docker.sock沙箱容器拉不起来✅最小权限原则不需要工作区访问时保持WORKSPACE_ACCESSnone✅网关绑定内网生产环境建议DOCKER_BIND127.0.0.1避免 18789 端口暴露公网✅定期同步仓库升级前先同步README.md、docker-compose.yml与.env.example防止遗漏新增变量相关文档索引快速部署与沙箱开启步骤docs/quick-start.md沙箱完整配置说明docs/configuration.mdCompose 编排与 Socket 挂载docker-compose.yml启动与配置生成逻辑init.sh进阶与故障排查docs/advanced.md、docs/faq.md掌握沙箱模式后你就可以放心地让 AI 机器人放手跑代码了——宿主机安全交给 Docker-in-Docker 隔离来守护。【免费下载链接】openclaw-china-dockerOpenClaw 的中国IM平台整合Docker版本预装并配置了飞书、钉钉、QQ机器人、企业微信等主流中国IM软件的插件让您可以快速部署一个支持多个中国IM平台的 AI 机器人网关项目地址: https://gitcode.com/gh_mirrors/op/openclaw-china-docker创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/15 4:54:16

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/15 2:04:12

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/16 19:23:38

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/16 6:47:19

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/14 16:35:50

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/16 17:28:18

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉