【免费下载链接】codex-proxy-rs基于 Rust 的低风控、高性能、自托管多账号透明代理网关项目地址https://gitcode.com/gh_mirrors/co/codex-proxy-rs点击查看免费下载Codex Proxy RS 是一款基于 Rust 的低风控、高性能自托管多账号透明代理网关使用 Docker Compose 部署时只需启动一个网关容器加 PostgreSQL 和 Redis 两个依赖容器即可把多个上游 AI 账号汇聚成一个带管理界面的代理入口。本文按步骤带你完成安装、启动、验证和客户端接入全程命令可直接复制执行。一、部署前了解 Codex Proxy RSCodex Proxy RS 的核心价值多账号聚合统一管理多个上游账号自动调度、自动容错透明代理网关对客户端暴露 Responses API/v1路径真实账号凭据由服务端托管完整管理端账号、分组、密钥、代理、用量统计、错误诊断都有 Web 界面自托管数据全部存在你自己的服务器Docker 一键拉起官方部署架构非常简单网关默认只绑定本机数据库和缓存不对公网开放客户端/管理浏览器 → 反向代理(可选) → 网关(单副本) → PostgreSQL / Redis → 上游服务⚠️ 注意本项目提供 Responses API不支持/v1/chat/completions接入前请确认你的客户端支持 Responses 协议。二、环境准备安装 Docker Compose 依赖部署适用于Linux amd64/arm64需要以下 4 个工具工具用途检查命令Docker Engine运行容器docker versionDocker Compose Plugin编排多容器docker compose versioncurl下载部署文件curl --versionOpenSSL生成随机密码openssl version另外请确认当前用户能访问 Docker并且可以通过sudo或 root 设置目录权限。三、一键安装最快的上手方式官方提供了安装脚本 deploy/install.sh它会自动下载同一 Release 的部署文件、生成密码、设置目录权限并启动服务。curl -fsSL https://raw.githubusercontent.com/zyycn/codex-proxy-rs/main/deploy/install.sh -o install.sh bash install.sh脚本默认安装到当前目录下的codex-proxy-rs/支持 3 个可选环境变量变量用途默认值INSTALL_DIR安装目录建议用绝对路径当前目录的codex-proxy-rs/CPR_RELEASE_TAG指定发布标签最新正式版本ADMIN_PASSWORD管理员初始密码≥12 位不能含$随机生成自定义安装目录示例INSTALL_DIR$HOME/services/codex-proxy-rs bash install.sh完成后务必保存终端显示的访问地址和管理员密码。再次重复运行脚本时请使用同一安装目录脚本检测到已有deploy/config.yaml会保留现有配置不会执行版本升级。四、手动安装逐步配置详解想理解每一步在做什么或想指定发布版本可以走手动流程。核心部署文件位于 deploy/ 目录文件作用deploy/compose.yaml镜像、容器网络、端口、挂载与资源限制deploy/config.example.yaml配置模板复制为config.yaml后填写deploy/Dockerfile源码构建网关镜像时使用4.1 下载部署文件mkdir -p codex-proxy-rs/deploy cd codex-proxy-rs # 解析一次最新正式版本确保两个文件来自同一 Release CPR_RELEASE_URL$(curl -fsSL -o /dev/null -w %{url_effective} https://github.com/zyycn/codex-proxy-rs/releases/latest) CPR_RELEASE_TAG${CPR_RELEASE_URL##*/} curl -fsSL https://github.com/zyycn/codex-proxy-rs/releases/download/${CPR_RELEASE_TAG}/compose.yaml \ -o deploy/compose.yaml curl -fsSL https://github.com/zyycn/codex-proxy-rs/releases/download/${CPR_RELEASE_TAG}/config.example.yaml \ -o deploy/config.example.yaml也可以把CPR_RELEASE_TAG设为指定发布标签。请保持compose.yaml与镜像版本配套不要混用开发分支模板与已发布镜像。4.2 设置目录权限应用容器以10001:10001用户运行需要为持久化目录预先授权install -d -m 0750 .runtime/postgres .runtime/redis sudo install -d -m 0770 -o $(id -u) -g 10001 .runtime/data .runtime/logs sudo install -m 0640 -o $(id -u) -g 10001 deploy/config.example.yaml deploy/config.yaml这 4 个.runtime目录就是全部持久化数据所在目录内容.runtime/postgresPostgreSQL 持久化数据.runtime/redisRedis AOF.runtime/data会话锚点、更新状态、备份暂存区.runtime/logs应用文件日志、请求转储4.3 生成密码并填写配置为 PostgreSQL 和 Redis 各生成一个随机密码openssl rand -hex 24 # PostgreSQL 密码 openssl rand -hex 24 # Redis 密码编辑deploy/config.yaml把两个密码分别写入store.database.passwordstore.redis.password再单独设置管理员初始密码admin.default_password至少 12 个字符不能包含$。关键提示密码只维护在config.yaml的store段Compose 通过凭据桥接区自动引用不要把密码写进连接 URL也不需要额外导出环境变量。4.4 启动服务并验证docker compose -f deploy/compose.yaml config --quiet # 校验配置 docker compose -f deploy/compose.yaml pull # 拉取镜像 docker compose -f deploy/compose.yaml up -d --no-build --wait docker compose -f deploy/compose.yaml ps # 查看状态健康检查curl -i http://127.0.0.1:8080/healthz返回204 No Content表示应用、PostgreSQL、Redis 和后台任务健康检查全部通过。首次启动会执行数据库迁移历史数据多时 HTTP 端口要等迁移完成后才监听请耐心等待宽限期默认 5 分钟不要反复重启。五、登录管理端添加账号与客户端密钥打开http://127.0.0.1:8080用admincpr.local和管理员密码登录在「账号」中添加上游账号完成授权或导入按需建立账号分组再创建客户端密钥并选择可用分组不选分组 可用全部账号打开密钥的「使用密钥」复制客户端配置API Key 持有者也可以在登录页切换身份查看自己的用量与额度。六、接入 Codex 客户端在「使用密钥」中按操作系统复制config.toml合并到 Codex 配置目录Linux/macOS 为~/.codex/Windows 为%USERPROFILE%\.codex\完全退出并重启 Codex 即可。关键配置项[model_providers.OpenAI] base_url http://127.0.0.1:8080/v1 wire_api responses requires_openai_auth false experimental_bearer_token client-api-key其他支持 Responses API 的客户端则只需两样东西配置值Base URLhttp://127.0.0.1:8080/v1远程接入用服务器 HTTPS 地址API Key管理端创建的客户端密钥七、日常运维速查7.1 镜像升级docker compose -f deploy/compose.yaml pull codex-proxy-rs docker compose -f deploy/compose.yaml up -d --no-build --wait codex-proxy-rs升级时先下载目标 Release 的部署附件对比模板不要用模板覆盖config.yaml。管理端「系统更新」也支持官方构建的在线更新与回滚。7.2 停止与重启docker compose -f deploy/compose.yaml down # 停止不会删除数据 docker compose -f deploy/compose.yaml up -d # 重新启动⚠️ 不要删除.runtime目录那会永久清除本地状态。普通docker compose down是安全的。7.3 备份要点需要保留的内容备份方式账号、Key、设置、插件、额度管理端 S3/R2 业务备份完整请求、诊断、审计历史独立整库备份或停库后备份.runtime/postgres部署配置与凭据单独备份deploy/config.yaml应用日志单独备份.runtime/logs不要在 PostgreSQL 写入期间直接复制数据目录当备份。八、常见问题FAQQ1其他设备如何访问管理端Compose 默认只绑定127.0.0.1。从其他设备访问时请配置 HTTPS 反向代理反向代理需保留Authorization头、支持 WebSocket Upgrade、关闭 SSE 缓冲。切记不要把 PostgreSQL/Redis 暴露到公网。Q2401错误是什么检查代理密钥是否正确、是否启用。密钥由客户端配置提供不需要另写auth.json。Q3426错误是什么客户端版本低于管理员设置的最低版本更新客户端即可。Q4能复制容器横向扩容吗不能。当前应用只支持单副本请通过纵向升级服务器配置提升容量。Q5改了config.yaml不生效修改配置后需要重启网关部分环境变量类修改需要重建容器docker compose up -d --force-recreate codex-proxy-rs单纯restart不会更新容器环境变量。九、延伸阅读资料路径部署与运维完整文档deploy/README.md客户端配置详解deploy/README.mdAPI 参考docs/api.md系统架构docs/architecture.md数据库迁移说明backend/migrations/README.md按照以上步骤你应该已经完成了 Codex Proxy RS 的 Docker Compose 部署一键安装或手动配置、/healthz健康检查通过、管理端登录成功、账号与客户端密钥就位。接下来只需把客户端指向你的网关地址就可以体验多账号透明代理的完整能力了。赞分享【免费下载链接】codex-proxy-rs基于 Rust 的低风控、高性能、自托管多账号透明代理网关项目地址https://gitcode.com/gh_mirrors/co/codex-proxy-rs点击查看免费下载相关推荐如何快速上手Qwen-Image 2.1ComfyUI本地AI绘图3步部署完全教程新手友好如何快速上手Qwen Image 2.1ComfyUI本地AI绘图3步部署完全教程新手友好 Qwen Image 2.1 是通义千问团队推出的新一代 AI媒体生成大模型计算机视觉本地部署快速上手wangEditor v5新手友好的完整教程快速上手wangEditor v5新手友好的完整教程 wangEditor v5 是一款轻量级、易扩展的富文本编辑器基于 TypeScript 开发提供了如何3步完成PrivateGPT本地化部署新手友好指南如何3步完成PrivateGPT本地化部署新手友好指南 PrivateGPT是一款能够让你使用GPT强大能力与文档交互的工具而且100%私密不会有数据泄露人工智能AI 应用RAGLLM 网关AI Agent后端上一篇深入理解AuthlibPython生态中的OAuth与OpenID Connect终极解决方案下一篇winpty完全指南让Windows控制台程序拥有Unix终端体验的终极解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考