opencode+omniroute+zen方案

一、定案总览

  • 本串为 docker 实例配置开发优化专用,终案只做两部分:agent(opencode)+ 中转网关(omniroute),适配器以 sidecar 挂网关
  • 不要 ollama;外部 OpenAI 兼容容器解耦接入,不进本 compose,只在网关加一条 channel
  • OMO 零容器:只是 opencode 内角色文件,分极简档 / 完整档两步上
  • 并行能力 opencode 原生自带(主调度 + 子代理后台并行),OMO 只是角色包

二、容器与目录清单

目录container_name角色实例数
max2/opencodeopencode主 agent(调用方)1
max2/omnirouteomniroute唯一网关(三个 Combo 全在这)1
max2/cpa-zenomniroute-cpa-zenZen 专用适配器(末端链路)1
(待定)max2/gemini-chat2apiomniroute-gemini-chatchat 会员转算力(有可用组件才建)0
(待定)max2/trae2apiomniroute-traetrae pro 转算力(有可用组件才建)0
  • 命名约定:只给主容器用的副容器一律 主-副(omniroute-cpa-zen),ps 一眼归属
  • 文件:薄入口 docker-compose.yml(只写 include)+ 3 个 scene(opencode.yml / omniroute.yml / cpa-zen.yml)+ .env;共拉起 3 容器
  • 操作按目录(stack)down/up,不按容器名前缀批量删

三、数据流与网关能力

opencode → omniroute(别名→优先级链)
  ├─ 直连:自建 llama serve / Groq / OpenRouter(标准 OpenAI 口)
  ├─ omniroute-cpa-zen 本地口(Zen/Go 补充池)
  ├─ (待定)gemini-chat / trae 本地口
  └─ 全部耗尽则报错,不设本地兜底(用户另有容器按需以 channel 接入)
  • 网关对下游同时暴露 OpenAI / Anthropic / Gemini 兼容口,任何 agent(opencode、Cline、裸 curl)都可接,不只给 opencode 用
  • 模型交互差异由网关 provider 适配器翻译,下游永远 OpenAI 形状;thinking 开关与 tool_call 可靠性仍需按角色配置
  • 策略只用 cost-optimized / fill-first,不用 auto(防跳到付费)

四、Key 落点

Key配在哪说明
OPENCODE_SERVER_PASSWORDmax2/opencode 的 .envserve 的 basic auth,自设强口令
Go/Zen key(opencode go 套餐)max2/cpa-zen 侧omniroute 只填内网地址 + 占位 key,不见真 key
标准上游(Groq/OpenRouter/llama)omniroute channel有几个填几个,缺的链自动跳过
chat 会员 / trae 会员身份各自适配器cookie/session 放适配器,过期只死单链
  • 单 Go key 即可开局:base_url https://opencode.ai/inference/go/openai/v1,模型列表 .../inference/go/v1/models
  • Muse Spark 需在 Console Privacy 开“Allow paid endpoints that train on request data”;DeepSeek 需 Regions 选 Global,否则 403/限区

五、镜像与数据干净约定

  • opencode 自建镜像:debian:bookworm-slim + 官方 linux-x64 二进制(约 115MB 压缩包),成品约 350–450MB,无 node / node_modules
  • data-opencode 只放三样:opencode.jsonc、agent/角色文件、日志;依赖层留在镜像内
  • 业务挂载:项目目录单挂 → /work(读写,宿主与容器共改);/s500data/envs → /opt/envs:ro(uv 环境只读复用)
  • daemon 实测为 rootful(/run/docker.sock,dockerd 用户 root,无 user/1000 socket);目录须预建 + compose 写死 user: "1000:100",ls -ln 保持 1000:100
  • 端口全绑 127.0.0.1,多设备经 tailscale,不新开公网口;与 clash 的 host-netns 互斥,本 stack 独立 bridge

六、版本 Pin

组件版本来源
opencodev2.3.0(anomalyco/opencode,原 sst 已迁移)npm / GitHub release 实测 2026-11-15
omniroutev3.8.53(cheaper-inference/OmniRoute)GitHub release 实测 2026-11-15
cpa-zen 镜像zen-v8.0.33-r5(smyhlin/cpa-zen,不跟 latest)Docker Hub 实测 2026-11-15;GitHub 同名仓不可查,按特殊节点对待

七、下一步

  • 定网关:OmniRoute(默认)还是 new-api(calciumion/new-api:v1.0.0-rc.51)二选一
  • 给 /work 首批挂载的项目目录(只挂点名的)
  • 给 gemini-chat / trae 适配器的具体组件名(仓库或镜像),验过再建目录;.env 模板我给、用户本地填 key