VPS 部署 Codex 教程：如何丝滑接入第三方 API 供应商？

最近 AI 火得一塌糊涂，很多朋友都想在服务器上搭个自己的 AI 助手。不过官方接口价格不菲，对于我们这种爱折腾的“垃圾佬”来说，还得找点性价比高的路子。这不，今天就来聊聊怎么在 VPS 上安装 Codex（注意不是 GitHub 那个 Copilot，而是一个开源类 AI 客户端/前端），并且配置第三方的 API 供应商，这样既能享受 AI 的便利，又能把成本压下去。

为什么选择 Codex + 第三方 API？

官方的 GPT-4 虽然强，但按 Token 计费刷起来也是肉疼。很多第三方 API 供应商提供了中转服务，或者是使用其他开源模型（如 Llama 3、Claude 等）的接口，价格往往只有官方的几分之一。Codex 作为一个轻量级的前端项目，界面清爽，部署简单，非常适合挂在 VPS 上当私人的 AI 工作台。

准备工作：不要忽视环境检查

在开始敲命令之前，确保你的 VPS 条件还过得去：

系统建议：Ubuntu 20.04 或 Debian 11+（这类系统教程多，坑少）。
配置要求：既然只是做个转发前端或轻量化本地模型（如果支持），1核1G其实也能跑得动，但如果要顺便跑点本地推理，建议 2核4G 起步。
域名准备：虽然可以直接用 IP 访问，但为了安全和日后的 HTTPS，建议准备个域名，并解析到 VPS IP。

Docker Compose 配置文件示例

docker-compose.yml 文件配置示例，用于部署 Codex 服务

第一步：安装 Docker 与 Docker Compose

Codex 最爽的部署方式就是 Docker，省去了配 Python 环境的各种依赖地狱。

如果你的服务器还没装 Docker，执行下面这条“一键命令”（适用于 Ubuntu/Debian）：

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

Caddy 反向代理配置文件示例

Caddyfile 配置示例，用于设置 HTTPS 反向代理

装好后，别忘了把当前用户加进 docker 组，不然每次都要 sudo 很烦：

sudo usermod -aG docker $USER
newgrp docker

第二步：拉取并配置 Codex

接下来就是拉取代码和配置文件了。常规操作是先找个目录存放项目：

mkdir -p /data/codex
cd /data/codex

这里我们需要创建一个 docker-compose.yml 文件。Codex 的官方镜像通常在 Docker Hub 或者 GitHub 上能找到。这里以通用配置为例，搭建一个基础服务：

version: '3.8'

services:
  codex:
    image: your-codex-image-name  # 替换为实际的 Codex 镜像名，如 specific/codex:latest
    container_name: my_codex
    restart: always
    ports:
      - "8080:80"  # 左边是宿主机端口，右边是容器端口，视具体情况调整
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/app/data  # 挂载数据目录，防止配置重启丢失

注意：具体的镜像名称请以项目最新文档为准，有些项目可能不需要 volumes 映射，而是直接通过环境变量读配置。

启动它：

docker-compose up -d

如果一切顺利，这时候访问 http://你的VPS_IP:8080 应该就能看到 Codex 的界面了。

第三步：配置第三方 API 供应商（核心干货）

这是很多新手容易卡住的地方。默认情况下，很多这类前端项目可能会指向官方 API，或者需要你手动填入 Key。

1. 获取第三方 API Key

市面上有很多聚合 API 服务商（比如 OpenAI-AI、One-API 等中转站）。注册账号后，在控制台创建一个新的 Token。记得选择支持的模型，比如 gpt-3.5-turbo 或者 claude-3-opus。

2. 在 Codex 中填入 Key

回到 Codex 的界面，通常会有一个 “Settings” 或者 “设置” 按钮。

找到 API Keys 或 模型设置 选项。
将刚才获取的第三方 Key 粘贴进去。

3. 修改 API Base URL（关键步骤）

如果第三方供应商不是直接兼容 OpenAI 官方的域名，你需要手动修改接口地址。设置里寻找 API Endpoint、Base URL 或者 API 地址。

官方默认通常是 https://api.openai.com/v1
你需要把它改成你的供应商地址，例如：https://api.your-third-party-provider.com/v1

如果不改这一步，你填了 Key 也会报错，提示验证失败。

第四步：反向代理与 HTTPS

直接暴露 8080 端口既不安全也不方便。推荐装个 Nginx 或者用 Caddy 自动搞定 HTTPS。

这里推荐用 Caddy，配置极其简单：

# 安装 Caddy
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

编辑配置文件 /etc/caddy/Caddyfile：

your-domain.com {
    reverse_proxy localhost:8080
}

重启 Caddy：

sudo systemctl restart caddy

现在，你就可以通过 https://your-domain.com 舒服地用你的 Codex 了。

常见问题排查

连接超时/错误：检查你的 VPS 防火墙（ufw 或云厂商的安全组）是否放行了 8080 端口。如果是用了反向代理，则只需放行 80 (HTTP) 和 443 (HTTPS)。
API 报错 401 / 403： 99% 是 Key 错了，或者 API Base URL 没改对。有些第三方供应商要求你在请求头里加特定的参数，具体看供应商的文档。
Docker 容器起不来：看日志！一定要学会看日志：
```
docker-compose logs -f
```
通常是端口冲突（容器里的 80 端口被占用了），把 docker-compose.yml 里的端口映射改成 "8081:80" 试试。

写在最后

VPS 除了做站、跑梯子，现在还能当 AI 终端用。配合第三方低价 API，折腾一次，受益很久。Codex 只是一个工具，更重要的是学会这种“容器化部署 + 接口替换”的思路，以后遇到类似的新项目（如 anything-llm、MaxKB 等），也能举一反三，快速上手。

如果你在配置过程中遇到什么奇葩的报错，欢迎在评论区留言，咱们一起研究研究！