Codex Proxy RS 是面向 Codex 的自托管多账号 AI 网关,可通过网页管理账号、客户端密钥与用量,并让 Codex 或其他支持 Responses API 的客户端接入。它支持按账号分组限定密钥的可用范围,但不支持 /v1/chat/completions,选用前需确认客户端协议兼容。

适合需要为多个 Codex 接入用途划分账号范围的维护者 · 需要让密钥使用者自行查看消耗的网关维护者

亮点

  1. 自托管多账号网关

    面向 Codex 集中管理多个账号,并为客户端提供 Responses API 接入。

  2. 密钥持有者自查用量

    API Key 持有者可切换登录身份,查看自己的用量与额度。

功能说明

账号与客户端

  1. 账号授权与导入

    在管理端添加账号,通过授权或导入完成接入,并按需建立账号分组。

  2. 模型目录查询

    通过 /v1/models 接口查询当前客户端密钥可见的模型目录。

  3. 客户端接口接入

    其他 Responses API 客户端可使用网关地址和管理端创建的客户端密钥接入。

部署与管理

  1. Linux 容器化部署

    官方快速开始使用 Docker Compose 部署固定版本镜像,同时启动 PostgreSQL 和 Redis。所列命令适用于 Linux amd64/arm64,需要 Docker Engine、Docker Compose Plugin、curl 和 OpenSSL;当前用户须能访问 Docker,并能通过 sudo 或 root 设置目录权限。

  2. 手动安装部署文件

    除安装脚本外,也可按部署文档自行下载部署文件、配置密码并启动服务。

  3. macOS 与 Linux 发布包

    已提供的 3.29.7 发布资产包含 macOS ARM64、Linux amd64 和 Linux arm64 安装包。macOS 发布包是独立下载渠道,README 中的 Linux 一键部署命令不能直接视为 macOS 安装说明。

  4. 网页管理入口

    部署后可在浏览器登录管理端,添加账号并创建客户端密钥。

适合场景

  1. 需要为多个 Codex 接入用途划分账号范围的维护者

    可建立账号分组,并为不同客户端密钥选择可用分组。

  2. 需要让密钥使用者自行查看消耗的网关维护者

    API Key 持有者能以自己的身份查看用量与额度,适合提供自助查询入口。

取舍

选它的理由

  • 客户端密钥可限定账号分组创建密钥时可选择可用分组,便于区分不同接入用途;不选分组则表示该密钥可使用全部账号,配置时需注意这一默认行为。
  • 可复制 Codex 配置或通过 CCSwitch 导入管理端提供客户端配置入口,API Key 持有者也能通过自己的登录身份获取配置;合并配置后需重启 Codex。

先想清楚

  • 不适合只能调用 Chat Completions 的客户端

使用须知

  • 不支持 /v1/chat/completions项目提供 Responses API,接入客户端必须支持 Responses 协议,不能仅凭支持 OpenAI 风格接口就判断兼容。
  • 从其他设备访问需配置 HTTPS 反向代理默认访问地址只能在服务器本机使用,远程接入需要额外配置 HTTPS 地址。
  • 重复运行安装脚本不会执行版本升级重复运行时须使用同一安装目录;检测到已有 deploy/config.yaml 后,脚本保留现有配置和部署文件,忽略传入的管理员密码,也不执行版本升级。已有部署应按升级文档操作,不要覆盖原配置。

同分类软件

查看全部

更多「编程开发」软件

软鉴 SoftMemo

AI 整理的软件知识库

AI 整理软件资料、版本动态、更新通知、订阅权益与对比分析,沉淀可复用的工具知识。