SuperAPI AI 工具集

gemini-sandbox-configuration

部署与运维

查看项目

更新于 10-16 00:23

技能介绍

用途:该技能是配置 Gemini CLI 沙箱隔离的中枢(meta-skill),用于把可能有危险的操作与主机系统隔离。适用于首次启用沙箱、在多种沙箱方式间选择、配置 macOS Seatbelt 配置文件、排查沙箱问题,以及理解安全边界。

主要能力与沙箱方式:支持 Docker(全平台,完整容器隔离)、Podman(全平台,无根容器)、Seatbelt(macOS,进程沙箱)。

使用方式: 命令行标志启用:gemini -s -p "command" 环境变量启用:export GEMINI_SANDBOX=true,或指定方式 GEMINI_SANDBOX=docker、podman、sandbox-exec。 设置文件启用:在 settings.json 中加入 {"tools": {"sandbox": true}},或指定 {"tools": {"sandbox": "docker"}}。 macOS Seatbelt 通过 SEATBELT_PROFILE 环境变量设置:permissive-open(默认,受限写入、允许网络)、permissive-closed(受限写入、阻止网络)、permissive-proxied(受限写入、经代理)、restrictive-open(严格写入、允许网络)、restrictive-closed(严格写入、阻止网络)。 容器沙箱可注入自定义标志:export SANDBOX_FLAGS="--security-opt label=disable"。

直接使用时会解析参数中的 shell 命令,校验后在沙箱中执行,并报告 stdout、stderr、退出码及表现。

限制与注意:沙箱可降低但不能消除全部风险,应选用能满足工作的最严格配置;GUI 应用可能无法在沙箱中运行;容器首次构建后开销较小。常见问题:"Operation not permitted" 属沙箱限制的预期行为;"Docker not found" 需启动 Docker 守护进程;网络被阻止多因严格配置;缺少命令则需加入自定义 Dockerfile。官方收费、价格等信息暂未提供。