tamakiramimy/traecn-proxy repository overview

⁠trancn-proxy

容器独立运行，不需要安装或启动 Trae CN IDE。 在管理台完成网页 OAuth 授权后，代理直接以 HTTP/SSE 调用上游对话接口。

• 源码 / Issue / Release：https://github.com/tamakiramimy/traecn-proxy⁠
• 镜像构建：由仓库的 Release workflow⁠ 基于 GitHub Release 中的 .NET 8 自包含产物自动构建
• 许可证：MIT⁠

⁠支持的标签

架构：linux/amd64、linux/arm64。

镜像同时发布到 GitHub Container Registry，Docker Hub 拉不动时可以换源：

docker pull ghcr.io/tamakiramimy/traecn-proxy:latest

如果 docker pull 报 EOF 或 TLS 超时，通常是本机 Docker 守护进程没有走代理（浏览器能打开 Docker Hub 不代表 daemon 能出网）。在 Docker Desktop 的 Settings → Resources → Proxies 里手动填入代理地址后重启即可。

⁠能力与限制（请先阅读）

已在容器内实测可用（企业账号，chat_v3 通道直连上游）：模型目录、精确选模、OpenAI / Anthropic 端点、流式输出、多账号管理。上游实际模型与所选不符时会直接报错，不会静默降级。

限制：

• SOLO / 消费版服务面（solo_work_lite）按 config_name 选模，与企业面的 __dev / __max ID 不通用；该面在容器内尚未做完整回归。
• 仅验证了基础文本对话；工具调用、多模态、完整 Anthropic 交错消息规则尚未实现。
• 镜像内默认关闭 IdeBridge，它只服务于开发期协议取证，不影响对话链路。
• 本项目与 Trae、字节跳动无隶属关系。使用前请确认符合组织 IT 政策、账号授权范围与服务条款。

⁠快速开始

docker run -d --name trancn-proxy \
  -p 127.0.0.1:9220:9220 \
  -v trancn-data:/data \
  -e TRANCN_API_KEY=替换为强随机网关密钥 \
  -e TRANCN_ADMIN_KEY=替换为强随机管理密钥 \
  tamakiramimy/traecn-proxy:latest

首次启动后容器里还没有账号，打开管理台 http://127.0.0.1:9220/admin⁠ ，填入 TRANCN_ADMIN_KEY 连接后，在「添加网页登录账号」填一个别名并完成 Trae CN 授权。重复该步骤可添加多个账号，凭据保存在 /data 卷中，重启不丢。

管理台还支持按账号启停、优先级、Token 刷新与校验、逐个模型发一句测试对话（会回显上游实际模型）、JSON 批量导入。

验证服务：

curl -H "Authorization: Bearer $TRANCN_API_KEY" http://127.0.0.1:9220/v1/models

⁠镜像内的默认配置

镜像基于 mcr.microsoft.com/dotnet/runtime-deps:8.0-jammy，以非 root 用户 app 运行，并对发布产物中的 appsettings.json 做了三处容器化调整：

• 端口：9220
• 数据卷：/data（accounts.json、instance.lock 等）

⁠环境变量

也可以挂载自己的配置覆盖默认值：

-v ./appsettings.json:/app/appsettings.json:ro

命令行参数同样可用，直接追加在镜像名之后即可，例如 --account-list、--port 9300。

⁠API

curl http://127.0.0.1:9220/v1/chat/completions \
  -H "Authorization: Bearer $TRANCN_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"glm-5.3__dev","messages":[{"role":"user","content":"你好"}]}'

建议先调用 /v1/models 获取当前账号可用的精确模型 ID。

⁠docker compose

services:
  trancn-proxy:
    image: tamakiramimy/traecn-proxy:latest
    restart: unless-stopped
    ports:
      - "9220:9220"
    environment:
      TRANCN_API_KEY: ${TRANCN_API_KEY:?set a strong key}
      TRANCN_ADMIN_KEY: ${TRANCN_ADMIN_KEY:?set a strong key}
    volumes:
      - trancn-data:/data

volumes:
  trancn-data:

⁠安全提示

• 容器监听 0.0.0.0，必须设置 TRANCN_API_KEY 与 TRANCN_ADMIN_KEY 后再映射端口，公网暴露请额外配置反向代理与访问控制。
• /data 中保存的是 Trae CN 的 access / refresh token，请按凭据资产对待，不要备份到公开位置。
• 镜像不包含任何账号或密钥，所有授权数据都在你自己的卷里。