sbx/opencode

镜像概述

sbx/opencode是遵循Docker Sandbox Kit v3实验规范的独立工作负载类型镜像，用于运行开源终端编码代理OpenCode，可替代原有内置在sbx工具中的opencode内置代理。该镜像将OpenCode作为入口程序，预定义了7种AI服务商的凭证规则，由沙盒代理在请求时自动解析注入，无需用户在容器内手动配置密钥即可对接对应大模型服务。

核心功能

1. 内置完整OpenCode终端编码代理运行环境，开箱即可使用AI辅助编码能力
2. 原生支持对接Anthropic、OpenAI、Google、Groq、OpenRouter、xAI、GitHub Copilot等主流大模型服务
3. 所有服务商凭证由宿主沙盒代理统一托管，容器内不会留存明文API密钥
4. 无内置遥测上报组件，所有网络访问行为完全透明可控
5. 内置Docker引擎支持，可在沙盒内直接使用容器相关能力
6. 兼容MCP网关自动注册，无需额外配置即可对接远程MCP服务

使用场景

1. 本地终端AI辅助代码生成、代码评审、项目分析场景
2. 沙盒隔离环境下的安全AI编码工作流搭建
3. 对接本地私有大模型的终端编码辅助方案部署
4. 开发团队统一标准化的AI编码代理环境分发

配置说明

服务商凭证配置

所有服务商密钥均非必填，沙盒启动后可直接通过OpenCode内置/login命令交互式登录，如需让沙盒代理自动托管对应服务商密钥，可在宿主侧执行对应命令绑定密钥：

console
sbx secret set anthropic <你的Anthropic密钥>
sbx secret set openai <你的OpenAI密钥>
sbx secret set google <你的Google生成式AI密钥>
sbx secret set groq <你的Groq密钥>
sbx secret set openrouter <你的OpenRouter密钥>
sbx secret set xai <你的xAI密钥>

可选环境变量配置

部署示例

1. 直接拉取远程镜像运行

console
sbx run "docker.io/sbx/opencode:latest"

2. 通过Git仓库直接运行

console
sbx run "git+https://github.com/docker/sbx-kits-contrib.git#dir=opencode"

3. 本地源码构建运行

首先在本地克隆项目仓库后执行构建：

console
docker buildx build opencode -f opencode/opencode.yaml \
  --build-arg version=1.18.31 --output type=cacheonly
sbx run ./opencode/

4. 非交互式批量执行命令

直接指定要执行的编码任务，无需进入交互终端：

console
sbx run opencode -- run "汇总当前项目的代码结构并生成项目说明文档"