新闻详情

新闻详情

首页 / 资讯中心 / 详情

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

发布时间:2026/9/30 23:59:17来源:尧图网络
如何用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 等客户端调用模型与路由配置可用模型与账号命中规则请求日志按时间、账号、模型筛选每一次请求部署到服务器后多台设备都能通过同一个网关地址接入账号池这就是部署到服务器相比桌面端的最大价值。![CodexManager Docker部署后的仪表盘界面展示网关状态与用量趋势](https://raw.gitcode.com/gh_mirrors/co/Codex-Manager/raw/132efe3cc9cccaaa0b6ccac00e54c43a53d08a12/assets/images/dashboard .png?utm_sourcegitcode_repo_files)二、准备工作服务器与 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。![CodexManager平台密钥页面用于创建网关API Key供Codex CLI接入](https://raw.gitcode.com/gh_mirrors/co/Codex-Manager/raw/132efe3cc9cccaaa0b6ccac00e54c43a53d08a12/assets/images/platform-key .png?utm_sourcegitcode_repo_files)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),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

ClamAV在Linux下的下载与安装:在线与离线部署全指南 2026/10/1 2:10:40

ClamAV在Linux下的下载与安装:在线与离线部署全指南

做Linux运维这些年,总有人问我:Linux还需要装杀毒软件吗?我的回答永远是反问题式的一句:你先问问自己是干嘛用的。纯内网跑个静态页面,那确实不装也活得挺好;但只要你手里管着邮件服务器、文件共享、Web上传…

阅读更多 →
深入解读 Meslo LG Nerd Font:斜体变体的图标集集成与 NF/NFM/NFP 字体选择实战 2026/10/1 2:10:40

深入解读 Meslo LG Nerd Font:斜体变体的图标集集成与 NF/NFM/NFP 字体选择实战

开发工具CLI 【免费下载链接】nerd-fonts Iconic font aggregator, collection, & patcher. 3,600 icons, 50 patched fonts: Hack, Source Code Pro, more. Glyph collections: Font Awesome, Material Design Icons, Octicons, & more 项目地址: https://…

阅读更多 →
SQL注入靶场SqliLabs搭建:PHP版本与数据库连接避坑 2026/10/1 2:10:40

SQL注入靶场SqliLabs搭建:PHP版本与数据库连接避坑

搭建 SqliLabs 这件事,看起来就是"下载—解压—丢进网站根目录—打开浏览器"这四步,但真正动过手的人都知道,能一次跑通的概率大概跟抛硬币差不多。我第一次搭的时候折腾了整整一个下午:安装页面要么白屏,要…

阅读更多 →
Node.js 无状态化实践:让服务器像凤凰一样随时重生(nodebestpractices 生产环境指南) 2026/10/1 2:10:40

Node.js 无状态化实践:让服务器像凤凰一样随时重生(nodebestpractices 生产环境指南)

文档教程后端 【免费下载链接】nodebestpractices ✅ The Node.js best practices list (July 2026) 项目地址: https://gitcode.com/GitHub_Trending/no/nodebestpractices 点击查看 免费下载 在生产环境中,你是否遇到过某台服务器"独有"的数…

阅读更多 →
SeaweedFS Samba/FUSE 集成测试全解:在分布式存储上搭建与验证 SMB 文件服务 2026/10/1 2:10:39

SeaweedFS Samba/FUSE 集成测试全解:在分布式存储上搭建与验证 SMB 文件服务

分布式文件系统对象存储存储 【免费下载链接】seaweedfs SeaweedFS is a distributed storage system for object storage (S3), file systems, and Iceberg tables, designed to handle billions of files with O(1) disk access and effortless horizontal scaling. 项目地址…

阅读更多 →
Burp Suite 完整配置指南:证书导入与代理设置全流程 2026/10/1 2:10:32

Burp Suite 完整配置指南:证书导入与代理设置全流程

Burp Suite 在 Web 安全测试圈子里几乎是绕不开的工具,不管是刚入门的安全爱好者,还是在职的渗透测试工程师,日常抓包、改包、重放请求都离不开它。但这玩意有一个让不少新手卡住的门槛:装好之后不是马上就能用,证书得…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉