如何用Docker把CodexManager部署到服务器：All-in-One与分离部署完整指南

如何用Docker把CodexManager部署到服务器All-in-One与分离部署完整指南【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-ManagerCodexManager 是一个开源的 Codex CLI 账号管理与切换工具它为 Codex CLI 提供本地网关转发支持账号池轮询、额度监控与 OpenAI 兼容接口。本文是一份面向新手的 CodexManager Docker 部署指南带你用 5 分钟完成 All-in-One 单容器部署并了解 Service Web 分离部署、Nginx 反向代理与 Codex CLI 接入服务器的完整方法。一、部署前了解CodexManager 是什么部署完成后你可以得到一个部署在服务器上的Codex 账号池管理面板仪表盘实时查看网关状态、账号池余额与用量趋势平台密钥生成 API Key供 Codex CLI / ccswitch 等客户端调用模型与路由配置可用模型与账号命中规则请求日志按时间、账号、模型筛选每一次请求部署到服务器后多台设备都能通过同一个网关地址接入账号池这就是部署到服务器相比桌面端的最大价值。二、准备工作服务器与 Docker 环境开始之前请确认你的服务器满足以下条件项目建议配置操作系统LinuxDebian / Ubuntu 均可资源1 核 2G 内存起步软件Docker 20.10、Docker Compose v2端口对外开放48761Web 管理页面按需开放48760直连网关 如果服务器在境外且时区不是北京时间记得在 compose 里设置TZ例如Europe/London否则用量统计时间可能错位。获取代码git clone https://gitcode.com/gh_mirrors/co/Codex-Manager.git cd Codex-Manager三、方式一All-in-One 单容器部署新手首选All-in-One 模式把网关服务和 Web 管理面板打进同一个容器只暴露一个端口是当前最简单的 CodexManager Docker 部署方式。1. 一键启动docker compose -f docker/docker-compose.all-in-one.yml up -d --build启动成功后浏览器打开http://你的服务器IP:48761/2. 关键行为说明单容器模式下有几个值得理解的细节配置见 docker/docker-compose.all-in-one.yml只暴露 48761 端口。管理页面、/api/rpc和 OpenAI 兼容网关路径/v1/responses、/v1/chat/completions等都从 48761 进入48760 仅在容器内部使用容器内由codexmanager-start进程同时拉起 service 与 web 两个组件数据库、RPC token、Web 密码和运行设置统一保存在/data卷中容器删除重建数据也不会丢镜像内置健康检查会定期探测/health与__auth_status挂了会自动重启restart: unless-stopped。3. 首次登录与验证打开http://服务器IP:48761/完成 Web 端首次设置进入OpenAI 账号池添加你的账号并授权回到仪表盘确认右上角显示服务已连接、网关运行正常在平台密钥页新建一个 Gateway Key后面接 Codex CLI 会用到。四、方式二Service Web 分离部署分离部署把codexmanager-service网关服务和codexmanager-web管理面板拆成两个容器适合希望独立扩容、独立重启或对端口做不同访问控制的场景。1. 用 compose 双容器启动docker compose -f docker/docker-compose.yml up -d --build这个文件docker/docker-compose.yml会自动先启动 service监听 48760并等待其健康检查通过再启动 web监听 48761并设置CODEXMANAGER_SERVICE_ADDRcodexmanager-service:48760让 web 通过容器网络访问 service而不是走宿主机映射端口。2. 拉取官方预构建镜像免编译如果不想在服务器上从源码编译首次--build需要编译 Rust 后端耗时较长可以直接用 Release 发布的预构建镜像docker compose -f docker/docker-compose.release.yml up -ddocker/docker-compose.release.yml 默认拉取stable标签固定版本可设置CODEXMANAGER_RELEASE_TAGv0.6.0再执行。3. 分离部署的两个易错点两个容器必须共享同一个/data卷否则 Web 密码、设置项与网关状态会对不上web 容器访问 service 要写容器名codexmanager-service:48760不要写成localhost:48760。五、把 Codex CLI 接入服务器网关服务跑起来后在本地电脑的 Codex CLI 配置中指向服务器即可。~/.codex/config.toml关键配置model_provider cm [model_providers.cm] name OpenAI base_url http://你的服务器IP:48761/v1 wire_api responses注意走 All-in-One 或 Web 入口时base_url用48761 /v1不要写容器内的localhost:48760auth.json中填入在平台密钥页生成的 Keyauth_mode设为apikey修改配置后重启 Codex CLI 使其生效。这样本地 Codex CLI 的每一条请求都会经由服务器上的 CodexManager 网关转发账号池、额度与日志全部集中在面板里管理。六、进阶Nginx 反向代理与 HTTPS服务器长期运行建议上 HTTPS 域名。仓库自带一份经过调优的 Nginx 配置docker/nginx/nginx.conf有三个关键要点必须开启underscores_in_headers on;和ignore_invalid_headers off;—— CodexManager 依赖带下划线的自定义头conversation_id、session_id维持会话锚点默认 Nginx 会直接丢弃它们导致会话错乱关闭代理缓冲proxy_buffering off;并放宽client_max_body_size保证 SSE 流式响应和大上下文请求不被截断网关端口48760可只对反向代理开放Web 面板48761单独配置访问策略减少公网扫描面。生产环境的完整环境变量模板可参考 config/production/codexmanager.env.example。七、常见问题速查症状原因与解决打不开48761页面服务器安全组 / 防火墙未放行 48761 端口页面能开但网关不通检查 service 容器健康状态docker compose ps再看docker logs中/health是否失败Codex CLI 报 401确认auth.json填的是平台密钥且base_url结尾带/v1时间、用量统计错位容器未设置TZ在 composeenvironment中补充时区流式输出中途断开反向代理层缓冲未关闭参考上文 Nginx 配置更多排障思路可阅读官方文档docs/zh-CN/report/最小排障手册.md、docs/zh-CN/report/运行与部署指南.md。八、总结✅个人使用 / 快速体验→ 选All-in-One一条命令docker compose -f docker/docker-compose.all-in-one.yml up -d --build只开 48761 一个端口✅多端口管控 / 独立运维→ 选分离部署service 与 web 双容器共享/data卷✅生产环境→ 拉取stable预构建镜像 Nginx 反向代理 HTTPS 域名部署完成后在平台密钥页生成 Key将 Codex CLI 的base_url指向http://服务器IP:48761/v1即可在任意设备接入你的账号池。照本文操作你只需要几分钟就能拥有一个 7×24 稳定运行的 Codex 网关服务器。【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-Manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考