搜「codex 反代理中转站建立」的人,多半已经在本地装好了 codex,手里也有一个能用的上游 key,卡住的地方很具体:地址填哪一格、协议走哪个口、base_url 后面要不要带版本号、环境变量和配置文件哪个优先。这篇不铺概念,按动手顺序给一条能走通的路径,每一步都写清验收标准,哪一步没过就别往下走。
搜「codex 反代理中转站建立」的人,通常已经装好本地 codex,手上也有一个能用的上游 key,真正卡住的地方特别具体:地址到底填哪一格、协议走哪个口、base_url 后面要不要带版本号、环境变量和配置文件谁优先。这篇不铺概念,按动手顺序给一条能走通的路径,每一步都写验收标准,哪一步没过就停在那一步。
先说清楚反代在这儿是干什么的:本地 codex 不直接连上游,中间放一台你能控制的机器转发请求,key 留在服务端,客户端只认你自己的入口。这样做的好处是切换上游、多人共用、留日志都方便;代价是多了一段路要维护。下面的步骤都围绕这条路走。
先判断这件事该不该你做
自建不是默认选项。自己长期高频用、要接多个上游做切换、对请求日志和隐私有明确要求,这三类情况值得自己搭。偶尔用几次、主要想省点钱,接现成站点反而省事,折腾一晚上的时间成本比省下的多。这话不好听,但能帮你少走弯路。
反过来说,有三条占任意一条就别急着自建:没有能长期在线的机器、不愿意维护证书和续期、出了问题没人盯着。这三件事都不难,难在要持续做,断一次就是全线不可用。
- 上游是官方 key 还是第三方,决定你要不要做多路切换和限额控制
- 要不要多人共用,决定入口鉴权和用量统计做到什么程度
- 日志留不留、留多久,决定机器磁盘和隐私处理方式
- 有没有人能在一小时内响应故障,没有的话先别上生产
算成本时别只算机器钱,域名、证书、监控和排障的时间一起算进去。租机器的常见口径可以到 /compute/platforms 对照当时的数字,别凭印象估。
动手前要备齐的四样东西
第一样是一台能从你所在网络稳定访问的机器。先确认系统版本、防火墙状态和要用到的端口,别等配完才发现端口被封、或者运营商对某个端口有限制。这一步十分钟能做完,省掉后面两小时。
第二样是上游地址、key 和它要求的鉴权头格式。这三项抄在同一个地方,格式照原文复制,不要凭记忆重写。后面填错的地方九成出在这一组信息上,尤其是鉴权头名字和前缀有没有空格。
- 上游地址
- 通常是带版本前缀的完整路径,结尾有无斜杠要按上游文档来
- 鉴权头
- 确认是 Authorization 还是自定义头,前缀是 Bearer 还是别的
- 本地配置入口
- 先弄清 codex 读环境变量还是读配置文件,两者同时存在时一般环境变量优先
- 最小验证请求
- 一句「回一个字」就够,别拿长 prompt 联调
按这个顺序配,每一步都有验收
配置顺序比配置内容更容易出错。四步走:反代先跑通静态响应、再接上游、再改本地 base_url、最后加入口鉴权。每步都有明确的验收动作,不过就停,别跳步。
- 跑通反向代理本身先让反代返回一个固定响应,用 curl 或浏览器访问域名能拿到内容,说明解析、证书、端口这条路是通的
- 接上游把上游地址填进转发目标,重点确认鉴权头有没有被代理吃掉;用 curl 带上一次真实请求,看返回结构对不对
- 改本地 base_url把 codex 指向你的入口,注意结尾斜杠和版本前缀;改完发一次最小请求,看返回里有没有模型名和用量字段
- 加入口鉴权本地用你自己的 key,上游 key 只留服务端;这一步做完再谈多人共用和用量统计
第三步最容易卡住。base_url 多了或少了一段路径,报错往往指向认证失败,看着像 key 的问题,其实是路径没对上。把上游文档里的完整路径和你的配置逐字对一遍,别用眼睛扫。
跑通之后怎么确认它真的可用
返回 200 不代表能用。用一个真实任务跑一遍,检查返回里的模型名、用量字段是否和上游对得上,字段缺失或被改写,说明中间某层在改包。
稳定性也要看。连续发几次请求,再在高峰时段发几次,看延迟波动。基线可以到 /tools/speed-test 量一下,用自己机器的数字做参照,别拿别人的截图当标准。
| 检查项 | 合格的样子 | 不合格先查哪 |
|---|---|---|
| 真实任务 | 返回内容可用,字段完整 | 代理有没有改包 |
| 连续性 | 多次请求都能回来 | 连接数或超时设置 |
| 切换上游 | 换 key 后立刻生效 | 配置有没有缓存 |
| 重装恢复 | 备份配置能直接还原 | 备份是否含完整路径 |
换一次上游或换一次 key,确认切换路径是通的。这一步决定你以后出问题能不能快速绕开,配的时候多花五分钟,出事时少慌半小时。
报错时按这个顺序排,别乱改
先分清是连不上还是连上了被拒。连不上查域名、证书、端口;连上了被拒查鉴权头和路径。这两类的排查方向完全相反,混在一起改只会越改越乱。
401 和 403 要分开看:一个是凭证没带对或格式不对,一个是带了但没权限。前者改头,后者改权限配置,改错地方等于白忙。404 多半是 base_url 路径多了或少了一段,把完整路径逐字对一遍。
- 超时:先量本地到机器的延迟,再量机器到上游的延迟,两段分开测才知道换哪一段
- 证书错误:确认证书覆盖的域名和你访问的域名一致,续期任务有没有真的跑过
- 鉴权失败:打印实际发出的请求头,看有没有前缀空格、大小写、重复头
- 切换不生效:查环境变量是否覆盖了配置文件,重启进程再试
还有一种误判:配完发现网页能打开,就以为整条链通了。网页走的是浏览器路径,codex 走的是另一条,两者鉴权和路径都可能不同,必须单独发一次请求验证。
下一步想先看看现成站点怎么暴露入口、怎么标可信度,再去动手也不迟;站内 /sites 有中转站的对照信息,配合 /price-watch 看价格变动口径,心里有底再自建。→常见问题
自建 codex 反代理中转站需要会写代码吗?
不需要写业务代码,但得看得懂配置文件和会敲几条 curl。真正花时间的是排错,不是写程序。如果连改配置、看日志都觉得吃力,先用现成站点跑通流程,再回头考虑自建,顺序反过来通常更省时间。
配好了但 codex 一直报鉴权失败,先查哪里?
先把请求头原样打出来看,确认 Authorization 有没有被代理吞掉、前缀格式对不对。再看上游要不要额外的组织或项目标识头。这两项都没问题,再去核对 key 本身有没有过期或额度耗尽。
自建之后还需要买现成中转站吗?
两条路不冲突。自建适合固定场景长期用,现成站点适合临时补量或做备份线路。建议自建也留一条外部线路做兜底,上游挂了能立刻切过去,这个习惯比多省一点钱有用。