New API + CLI Proxy API Plus 中转站部署说明

博主：灿烂
发布时间：2026 年 06 月 01 日
7 次浏览
暂无评论
15682字数
分类：学习笔记

最近折腾了一套自己的 AI 中转站，主要用到两个东西：New API 和 CLI Proxy API Plus。
New API 负责统一管理渠道、模型、令牌、用户和日志；CLI Proxy API Plus 负责把一些 CLI/OAuth 类模型能力转换成 OpenAI 兼容接口（例如将chat gpt套餐转化成兼容接口提供给New API作为渠道使用）。
以下是我自己整理的一套部署流程，尽量写成从零开始照着操作就能搭好的版本。
注意：文档里面的密码、密钥都用占位符，不要把真实密码直接写到博客里。

功能描述

简单来说，这套东西搭好后大概是这样：

本地客户端 / Codex / 其他调用方
        ↓
New API 统一入口
        ↓
CLI Proxy API Plus
        ↓
上游模型账号 / API Key / OAuth 登录态

New API 主要做这些事：

统一管理不同渠道。
统一生成下游调用令牌。
查看调用日志、用量、消耗。
给不同用户、不同分组设置可用模型。
对外暴露一个 OpenAI 兼容接口。

CLI Proxy API Plus 主要做这些事：

接收 OpenAI 兼容格式的请求。
转发到 Codex、Claude、Gemini、OpenAI 兼容服务等上游。
支持 API Key 和 OAuth 登录态。
支持模型别名、模型转发、重试、管理面板等。

我个人理解是：
CLI Proxy API Plus 更像“底层转发器”，New API 更像“后台管理系统”。

一、服务器准备

我这里以一台普通云服务器为例，阿里云、腾讯云、雨云、RackNerd、Vultr 都差不多。

1. 推荐配置

如果只是自己用，配置不用太高：

CPU：2 核
内存：2G 起步，4G 更舒服
硬盘：40G 起步
系统：Alibaba Cloud Linux / CentOS / Debian / Ubuntu 都可以
地区：尽量选择访问上游模型比较稳定的地区

如果你后面要给多人使用，建议至少：

CPU：2 核以上
内存：4G 以上
硬盘：60G 以上

2. 需要开放的端口

在云服务器安全组中开放以下端口：

22     SSH 登录服务器
3000   New API 后台
8317   CLI Proxy API Plus 接口，按需开放
80     如果后面要配域名和 Nginx
443    如果后面要配 HTTPS

注意：

3306 MySQL 不建议对公网开放
6379 Redis 不建议对公网开放

MySQL 和 Redis 给 Docker 内部用就行，不要随便暴露到公网。

3. 登录服务器

本地 Windows 可以用 Windows Terminal、XShell、FinalShell、Termius。

SSH 登录方式如下：

ssh root@你的服务器公网IP

如果 SSH 端口不是 22，比如改成了 2222：

ssh root@你的服务器公网IP -p 2222

登录后大概会看到：

[root@xxx ~]#

这就说明已经进服务器了。

二、安装基础环境

先安装一些常用工具：

yum install -y curl wget git vim unzip

有些系统没有 yum，比如 Debian/Ubuntu，可以用：

apt update
apt install -y curl wget git vim unzip

1. 安装 Docker

直接使用官方安装脚本：

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

启动 Docker：

systemctl enable docker
systemctl start docker

检查 Docker 是否正常：

docker version
docker compose version

能看到版本号就可以。

2. 创建统一目录和 Docker 网络

我建议把所有中转站相关的东西都放在 /opt/ai-gateway 下，后期找起来方便。

mkdir -p /opt/ai-gateway
cd /opt/ai-gateway

创建一个公共 Docker 网络，让 New API 可以直接通过容器名访问 CLI Proxy API Plus：

docker network create ai-gateway-network

如果提示已经存在，不用管，继续下一步。

三、部署 New API

New API 官方镜像是：

calciumion/new-api:latest

官方说明中支持 SQLite、MySQL、PostgreSQL，个人测试可以用 SQLite，但是长期使用建议直接 MySQL。
这里我用 MySQL + Redis + New API 的方式部署。

1. 创建目录

mkdir -p /opt/ai-gateway/new-api
cd /opt/ai-gateway/new-api

2. 创建 docker-compose.yml

执行：

vim docker-compose.yml

写入以下内容：

services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    command: --log-dir /app/logs
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
      - ./logs:/app/logs
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=root:你的MySQL密码@tcp(mysql:3306)/new-api
      - REDIS_CONN_STRING=redis://:你的Redis密码@redis:6379
      - ERROR_LOG_ENABLED=true
      - BATCH_UPDATE_ENABLED=true
      - NODE_NAME=new-api-node-1
    depends_on:
      - mysql
      - redis
    networks:
      - ai-gateway-network
    healthcheck:
      test: ["CMD-SHELL", "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' || exit 1"]
      interval: 30s
      timeout: 10s
      retries: 3

  mysql:
    image: mysql:8.2
    container_name: new-api-mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: 你的MySQL密码
      MYSQL_DATABASE: new-api
    volumes:
      - mysql_data:/var/lib/mysql
    networks:
      - ai-gateway-network

  redis:
    image: redis:latest
    container_name: new-api-redis
    restart: always
    command: ["redis-server", "--requirepass", "你的Redis密码"]
    networks:
      - ai-gateway-network

volumes:
  mysql_data:

networks:
  ai-gateway-network:
    external: true

注意几点：

1. docker-compose.yml 对缩进非常敏感，mysql、redis、new-api 必须同级缩进。
2. SQL_DSN 里的数据库名是 new-api，要和 MYSQL_DATABASE 保持一致。
3. 密码建议用复杂一点，但不要包含 @、#、&、?、/ 这种容易影响连接串解析的字符。
4. 如果密码里一定要用特殊符号，需要做 URL 编码，不然 New API 可能连不上 MySQL。

3. 启动 New API

docker compose up -d

查看容器：

docker ps

查看日志：

docker logs -f new-api

如果没报错，浏览器访问：

http://你的服务器公网IP:3000

4. 登录 New API

常见默认账号密码：

用户名：root
密码：123456

如果默认密码不对，就按页面提示注册或初始化。

第一次登录后先做三件事：

1. 修改 root 密码
2. 关闭不需要的公开注册
3. 检查系统设置和站点名称

New API 的登录页也可以直接访问：

http://你的服务器公网IP:3000/login

四、部署 CLI Proxy API Plus

CLI Proxy API Plus 是一个 OpenAI 兼容代理，官方文档里默认端口是 8317，配置文件是 config.yaml。

1. 创建目录

mkdir -p /opt/ai-gateway/cli-proxy-api-plus
cd /opt/ai-gateway/cli-proxy-api-plus

2. 准备配置文件

先生成两个密钥：

openssl rand -hex 32
openssl rand -hex 32

第一个作为：

API_KEY

第二个作为：

MANAGEMENT_KEY

创建配置文件：

vim config.yaml

写入：

host: ""
port: 8317

auth-dir: "/root/.cli-proxy-api"

api-keys:
  - "替换成你的API_KEY"

remote-management:
  allow-remote: true
  secret-key: "替换成你的MANAGEMENT_KEY"
  disable-control-panel: false

debug: false
request-retry: 3

routing:
  strategy: "round-robin"

# 如果服务器访问上游模型不稳定，可以配置代理。
# 没有代理就保持为空。
proxy-url: ""

# 示例：如果你有传统 API Key，可以写到这里。
# 没有就先注释掉，后面通过 OAuth 登录。
#
# claude-api-key:
#   - api-key: "sk-ant-xxx"
#
# gemini-api-key:
#   - api-key: "AIzaSyxxx"
#
# openai-compatibility:
#   - name: "openrouter"
#     base-url: "https://openrouter.ai/api/v1"
#     api-key-entries:
#       - api-key: "sk-or-v1-xxx"
#     models:
#       - name: "openai/gpt-4o-mini"
#         alias: "gpt-4o-mini"

注意：

API_KEY 是给 New API 调用 CLI Proxy API Plus 用的。
MANAGEMENT_KEY 是进 CLI Proxy API Plus 管理接口用的。
这两个不要写成一样。

3. 创建 docker-compose.yml

vim docker-compose.yml

写入：

services:
  cli-proxy-api-plus:
    image: eceasy/cli-proxy-api-plus:latest
    container_name: cli-proxy-api-plus
    restart: unless-stopped
    ports:
      - "127.0.0.1:18317:8317"
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml
      - ./auths:/root/.cli-proxy-api
      - ./logs:/CLIProxyAPI/logs
    networks:
      - ai-gateway-network

networks:
  ai-gateway-network:
    external: true

这里我把容器的 8317 映射到了服务器本机的 127.0.0.1:18317。

原因是：

1. New API 和 CLI Proxy API Plus 在同一个 Docker 网络里，可以直接访问 cli-proxy-api-plus:8317。
2. 服务器公网不直接暴露 8317，安全一点。
3. 如果后续确实要公网访问，再用 Nginx 单独代理。

启动：

docker compose up -d

查看日志：

docker logs -f cli-proxy-api-plus

测试接口：

curl -H "Authorization: Bearer 替换成你的API_KEY" \
  http://127.0.0.1:18317/v1/models

如果返回模型列表，说明 CLI Proxy API Plus 已经起来了。

4. 如果镜像拉取失败

有时候会遇到这种报错：

pull access denied for eceasy/cli-proxy-api-plus

这时候可以改成源码构建：

cd /opt/ai-gateway
git clone https://github.com/KooshaPari/cliproxyapi-plusplus.git
cd cliproxyapi-plusplus
docker build -t local/cli-proxy-api-plus:latest .

然后把 /opt/ai-gateway/cli-proxy-api-plus/docker-compose.yml 里的镜像改成：

image: local/cli-proxy-api-plus:latest

再启动：

cd /opt/ai-gateway/cli-proxy-api-plus
docker compose up -d

五、CLI Proxy API Plus 登录上游账号

CLI Proxy API Plus 有两种上游方式：

1. 直接填 API Key
2. 使用 OAuth 登录

如果你有传统 API Key，直接写进 config.yaml 最简单。

如果你要接 Codex、Claude Code、Gemini CLI 这类账号登录态，就需要运行登录命令。

1. Codex / OpenAI OAuth 登录

cd /opt/ai-gateway/cli-proxy-api-plus
docker compose exec cli-proxy-api-plus /CLIProxyAPI/CLIProxyAPI -no-browser --codex-login

它会输出一个登录地址。复制到浏览器打开，登录你的账号，完成授权后回到命令行看是否成功。

2. Claude 登录

cd /opt/ai-gateway/cli-proxy-api-plus
docker compose exec cli-proxy-api-plus /CLIProxyAPI/CLIProxyAPI -no-browser --claude-login

3. Gemini 登录

cd /opt/ai-gateway/cli-proxy-api-plus
docker compose exec cli-proxy-api-plus /CLIProxyAPI/CLIProxyAPI -no-browser --login

注意：

登录成功后，认证信息会保存在 ./auths 目录。
这个目录很重要，不要随便删除。
如果删除了，就要重新登录。

六、把 CLI Proxy API Plus 接入 New API

进入 New API 后台：

http://你的服务器公网IP:3000

进入：

渠道管理 -> 添加渠道

基础配置参考：

类型：OpenAI
名称：CLI Proxy API Plus
密钥：CLI Proxy API Plus 配置中的 API_KEY
API地址：http://cli-proxy-api-plus:8317/v1

这里重点注意：

如果 New API 和 CLI Proxy API Plus 在同一个 ai-gateway-network 里，
API 地址就写：
http://cli-proxy-api-plus:8317/v1

不要写：
http://127.0.0.1:8317/v1

因为在 New API 容器里面，127.0.0.1 指的是 New API 自己，不是宿主机，也不是 CLI Proxy API Plus。

1. 模型怎么填

模型必须填 CLI Proxy API Plus 实际支持的模型名。

比如 CLI Proxy API Plus 里能返回：

gpt-5
gpt-5-codex
gpt-5.1
gpt-5.2

那 New API 里就填这些模型。

不要凭感觉乱填，比如：

gpt-5.5-pro

如果上游没有这个模型，调用时会报：

unknown provider for model xxx

这种 502 一般不是 New API 坏了，而是模型名没有在 CLI Proxy API Plus 里配置成功。

2. 测试渠道

保存渠道后，点测试。

如果测试成功，就可以去：

令牌管理 -> 新建令牌

创建一个下游 API Key。

之后客户端就可以调用 New API：

curl http://你的服务器公网IP:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 你的NewAPI令牌" \
  -d '{
    "model": "gpt-5",
    "messages": [
      {
        "role": "user",
        "content": "你好"
      }
    ]
  }'

七、如果要让 CLI Proxy API Plus 外网访问

一般不建议直接开放 CLI Proxy API Plus。
如果只是给 New API 调用，不需要开放公网。

如果你确实要在外网直接访问，可以用 Nginx 代理，并加一层 Basic Auth。

1. 安装 Nginx

yum install -y nginx httpd-tools
systemctl enable nginx
systemctl start nginx

2. 创建 Basic Auth 密码

htpasswd -bc /etc/nginx/.cliproxy_htpasswd admin 你的访问密码

3. 添加 Nginx 配置

vim /etc/nginx/conf.d/cli-proxy-api-plus.conf

写入：

server {
    listen 8317;
    server_name _;

    client_max_body_size 50m;

    location / {
        auth_basic "CLI Proxy API Plus";
        auth_basic_user_file /etc/nginx/.cliproxy_htpasswd;

        proxy_pass http://127.0.0.1:18317;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

检查 Nginx 配置：

nginx -t

重载：

systemctl reload nginx

然后安全组开放 8317。

访问：

http://你的服务器公网IP:8317

会先要求输入 Basic Auth 账号密码。

八、客户端怎么用

1. 普通 OpenAI 兼容客户端

如果客户端支持填写 Base URL 和 API Key，就这样填：

Base URL：http://你的服务器公网IP:3000/v1
API Key：New API 里创建的令牌
模型：New API 里配置好的模型名

2. Codex CLI 直接接 CLI Proxy API Plus

如果你不想走 New API，想让 Codex 直接连 CLI Proxy API Plus，可以改本地：

~/.codex/config.toml

示例：

model_provider = "cliproxyapi"
model = "gpt-5-codex"
model_reasoning_effort = "high"

[model_providers.cliproxyapi]
name = "cliproxyapi"
base_url = "http://你的服务器公网IP:8317/v1"
wire_api = "responses"

再改：

~/.codex/auth.json

示例：

{
  "OPENAI_API_KEY": "sk-dummy"
}

如果你走的是 New API，则可以把 Codex 的 base_url 改成：

http://你的服务器公网IP:3000/v1

然后 OPENAI_API_KEY 填 New API 创建的令牌。

九、常用维护命令

1. 查看容器

docker ps

2. 查看 New API 日志

docker logs -f new-api

3. 查看 CLI Proxy API Plus 日志

docker logs -f cli-proxy-api-plus

4. 重启 New API

cd /opt/ai-gateway/new-api
docker compose restart

5. 重启 CLI Proxy API Plus

cd /opt/ai-gateway/cli-proxy-api-plus
docker compose restart

6. 更新镜像

New API：

cd /opt/ai-gateway/new-api
docker compose pull
docker compose up -d

CLI Proxy API Plus：

cd /opt/ai-gateway/cli-proxy-api-plus
docker compose pull
docker compose up -d

如果 CLI Proxy API Plus 是源码构建的：

cd /opt/ai-gateway/cliproxyapi-plusplus
git pull
docker build -t local/cli-proxy-api-plus:latest .
cd /opt/ai-gateway/cli-proxy-api-plus
docker compose up -d

7. 备份

建议至少备份这些目录：

/opt/ai-gateway/new-api
/opt/ai-gateway/cli-proxy-api-plus/config.yaml
/opt/ai-gateway/cli-proxy-api-plus/auths

打包备份：

cd /opt
tar -czvf ai-gateway-backup.tar.gz ai-gateway

下载到本地保存。

十、常见问题

1. docker compose up -d 报 YAML 错误

常见原因：

1. 缩进不对。
2. mysql、redis 没有和 new-api 对齐。
3. 冒号后面少空格。
4. 密码里有特殊符号，导致解析异常。

可以用：

docker compose config

检查 compose 文件是否能被正常解析。

2. New API 打不开

排查：

docker ps
docker logs -f new-api

再检查安全组是否开放 3000。

如果容器正常，但公网打不开，基本就是安全组或服务器防火墙问题。

3. New API 连接不上 MySQL

重点看 SQL_DSN：

root:你的MySQL密码@tcp(mysql:3306)/new-api

注意：

mysql 是容器名，不是服务器 IP。
new-api 是数据库名。
密码不要乱带特殊符号。

4. New API 渠道测试 502

如果报：

unknown provider for model xxx

通常是模型名不对。

处理方式：

1. 先请求 CLI Proxy API Plus 的 /v1/models。
2. 看实际返回了哪些模型。
3. New API 里只填写真实存在的模型。

5. CLI Proxy API Plus 登录后还是不能用

检查：

ls -la /opt/ai-gateway/cli-proxy-api-plus/auths
docker logs -f cli-proxy-api-plus

如果 auths 目录没有生成登录态文件，说明登录没有成功。

重新执行对应登录命令即可。

6. 服务器在新加坡，要不要开代理

这个要看你的上游服务。

如果服务器访问上游模型经常超时，可以在 config.yaml 里配置：

proxy-url: "socks5://127.0.0.1:7890"

如果服务器访问稳定，就不要多加代理，代理链路越长，越容易慢。

7. MySQL 要不要开放 3306

不建议。

New API 和 MySQL 在同一个 Docker 网络里，内部访问即可：

mysql:3306

公网开放 3306 风险很高，除非你明确知道自己在做什么。

十一、最终访问地址整理

部署完成后常用地址：

服务器登录：
ssh root@你的服务器公网IP

New API 后台：
http://你的服务器公网IP:3000

New API 接口：
http://你的服务器公网IP:3000/v1

CLI Proxy API Plus 内部地址：
http://cli-proxy-api-plus:8317/v1

CLI Proxy API Plus 宿主机本地地址：
http://127.0.0.1:18317/v1

CLI Proxy API Plus 外网地址，只有配置 Nginx 后才有：
http://你的服务器公网IP:8317/v1

登录方式：

服务器：SSH 用户名 + 密码，或者 SSH 密钥
New API：root / 初始密码，首次登录后必须修改
CLI Proxy API Plus：API 调用使用 Bearer API_KEY，管理接口使用 MANAGEMENT_KEY
Nginx 外网访问：Basic Auth 用户名 + 密码

十二、我的建议

如果只是自己用，推荐：

New API 对公网开放 3000
CLI Proxy API Plus 不直接对公网开放
New API 通过 Docker 网络访问 CLI Proxy API Plus
MySQL / Redis 不开放公网

这样最清晰，也相对安全。

如果后面要给公司同事或者多台电脑用，再考虑：

1. 给 New API 配域名和 HTTPS
2. 关闭公开注册
3. 每个人单独创建 New API 用户和令牌
4. 给不同用户限制模型和额度
5. 定期看日志和异常请求

这个东西最怕的不是部署不起来，而是部署起来后所有端口和密钥都裸奔。
能不暴露的端口就不要暴露，能用内部网络访问的就不要走公网。

参考资料

New API Docker 镜像说明：https://hub.docker.com/r/calciumion/new-api
New API 环境变量说明：https://doc.newapi.pro/installation/environment-variables/
New API 注册与登录说明：https://docs.newapi.pro/zh/docs/guide/feature-guide/user/auth
New API docker-compose 示例：https://github.com/QuantumNous/new-api/blob/main/docker-compose.yml
CLI Proxy API Plus GitHub：https://github.com/KooshaPari/cliproxyapi-plusplus
CLIProxyAPI Docker Compose 说明：https://help.router-for.me/cn/docker/docker-compose
CLIProxyAPI 配置项说明：https://help.router-for.me/configuration/options
CLIProxyAPI Codex 配置说明：https://help.router-for.me/cn/agent-client/codex

最后修改：2026 年 06 月 01 日

去码头整点薯片？

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

New API + CLI Proxy API Plus 中转站部署说明

灿烂 • 2026 年 06 月 01 日

<blockquote><p>最近折腾了一套自己的 AI 中转站，主要用到两个东西：<code>New API</code> 和 <code>CLI Proxy API Plus</code>。</p><p><code>New API</code> 负责统一管理渠道、模型、令牌、用户和日志；<code>CLI Proxy API Plus</code> 负责把一些 CLI/OAuth 类模型能力转换成 OpenAI 兼容接口（例如将chat gpt套餐转化成兼容接口提供给New API作为渠道使用）。</p><p>以下是我自己整理的一套部署流程，尽量写成从零开始照着操作就能搭好的版本。  <br>注意：文档里面的密码、密钥都用占位符，不要把真实密码直接写到博客里。</p></blockquote><h2>功能描述</h2><p>简单来说，这套东西搭好后大概是这样：</p><pre><code class="lang-text">本地客户端 / Codex / 其他调用方
        ↓
New API 统一入口
        ↓
CLI Proxy API Plus
        ↓
上游模型账号 / API Key / OAuth 登录态</code></pre><p><code>New API</code> 主要做这些事：</p><ul><li>统一管理不同渠道。</li><li>统一生成下游调用令牌。</li><li>查看调用日志、用量、消耗。</li><li>给不同用户、不同分组设置可用模型。</li><li>对外暴露一个 OpenAI 兼容接口。</li></ul><p><code>CLI Proxy API Plus</code> 主要做这些事：</p><ul><li>接收 OpenAI 兼容格式的请求。</li><li>转发到 Codex、Claude、Gemini、OpenAI 兼容服务等上游。</li><li>支持 API Key 和 OAuth 登录态。</li><li>支持模型别名、模型转发、重试、管理面板等。</li></ul><p>我个人理解是：  <br><code>CLI Proxy API Plus</code> 更像“底层转发器”，<code>New API</code> 更像“后台管理系统”。</p><h2>一、服务器准备</h2><p>我这里以一台普通云服务器为例，阿里云、腾讯云、雨云、RackNerd、Vultr 都差不多。</p><h3>1. 推荐配置</h3><p>如果只是自己用，配置不用太高：</p><pre><code class="lang-text">CPU：2 核
内存：2G 起步，4G 更舒服
硬盘：40G 起步
系统：Alibaba Cloud Linux / CentOS / Debian / Ubuntu 都可以
地区：尽量选择访问上游模型比较稳定的地区</code></pre><p>如果你后面要给多人使用，建议至少：</p><pre><code class="lang-text">CPU：2 核以上
内存：4G 以上
硬盘：60G 以上</code></pre><h3>2. 需要开放的端口</h3><p>在云服务器安全组中开放以下端口：</p><pre><code class="lang-text">22     SSH 登录服务器
3000   New API 后台
8317   CLI Proxy API Plus 接口，按需开放
80     如果后面要配域名和 Nginx
443    如果后面要配 HTTPS</code></pre><p>注意：</p><pre><code class="lang-text">3306 MySQL 不建议对公网开放
6379 Redis 不建议对公网开放</code></pre><p>MySQL 和 Redis 给 Docker 内部用就行，不要随便暴露到公网。</p><h3>3. 登录服务器</h3><p>本地 Windows 可以用 <code>Windows Terminal</code>、<code>XShell</code>、<code>FinalShell</code>、<code>Termius</code>。</p><p>SSH 登录方式如下：</p><pre><code class="lang-bash">ssh root@你的服务器公网IP</code></pre><p>如果 SSH 端口不是 22，比如改成了 2222：</p><pre><code class="lang-bash">ssh root@你的服务器公网IP -p 2222</code></pre><p>登录后大概会看到：</p><pre><code class="lang-bash">[root@xxx ~]#</code></pre><p>这就说明已经进服务器了。</p><h2>二、安装基础环境</h2><p>先安装一些常用工具：</p><pre><code class="lang-bash">yum install -y curl wget git vim unzip</code></pre><p>有些系统没有 <code>yum</code>，比如 Debian/Ubuntu，可以用：</p><pre><code class="lang-bash">apt update
apt install -y curl wget git vim unzip</code></pre><h3>1. 安装 Docker</h3><p>直接使用官方安装脚本：</p><pre><code class="lang-bash">curl -fsSL https://get.docker.com | bash</code></pre><p>启动 Docker：</p><pre><code class="lang-bash">systemctl enable docker
systemctl start docker</code></pre><p>检查 Docker 是否正常：</p><pre><code class="lang-bash">docker version
docker compose version</code></pre><p>能看到版本号就可以。</p><h3>2. 创建统一目录和 Docker 网络</h3><p>我建议把所有中转站相关的东西都放在 <code>/opt/ai-gateway</code> 下，后期找起来方便。</p><pre><code class="lang-bash">mkdir -p /opt/ai-gateway
cd /opt/ai-gateway</code></pre><p>创建一个公共 Docker 网络，让 <code>New API</code> 可以直接通过容器名访问 <code>CLI Proxy API Plus</code>：</p><pre><code class="lang-bash">docker network create ai-gateway-network</code></pre><p>如果提示已经存在，不用管，继续下一步。</p><h2>三、部署 New API</h2><p><code>New API</code> 官方镜像是：</p><pre><code class="lang-text">calciumion/new-api:latest</code></pre><p>官方说明中支持 SQLite、MySQL、PostgreSQL，个人测试可以用 SQLite，但是长期使用建议直接 MySQL。  <br>这里我用 <code>MySQL + Redis + New API</code> 的方式部署。</p><h3>1. 创建目录</h3><pre><code class="lang-bash">mkdir -p /opt/ai-gateway/new-api
cd /opt/ai-gateway/new-api</code></pre><h3>2. 创建 docker-compose.yml</h3><p>执行：</p><pre><code class="lang-bash">vim docker-compose.yml</code></pre><p>写入以下内容：</p><pre><code class="lang-yaml">services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    command: --log-dir /app/logs
    ports:
      - &quot;3000:3000&quot;
    volumes:
      - ./data:/data
      - ./logs:/app/logs
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=root:你的MySQL密码@tcp(mysql:3306)/new-api
      - REDIS_CONN_STRING=redis://:你的Redis密码@redis:6379
      - ERROR_LOG_ENABLED=true
      - BATCH_UPDATE_ENABLED=true
      - NODE_NAME=new-api-node-1
    depends_on:
      - mysql
      - redis
    networks:
      - ai-gateway-network
    healthcheck:
      test: [&quot;CMD-SHELL&quot;, &quot;wget -q -O - http://localhost:3000/api/status | grep -o '\&quot;success\&quot;:\\s*true' || exit 1&quot;]
      interval: 30s
      timeout: 10s
      retries: 3

mysql:
    image: mysql:8.2
    container_name: new-api-mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: 你的MySQL密码
      MYSQL_DATABASE: new-api
    volumes:
      - mysql_data:/var/lib/mysql
    networks:
      - ai-gateway-network

redis:
    image: redis:latest
    container_name: new-api-redis
    restart: always
    command: [&quot;redis-server&quot;, &quot;--requirepass&quot;, &quot;你的Redis密码&quot;]
    networks:
      - ai-gateway-network

volumes:
  mysql_data:

networks:
  ai-gateway-network:
    external: true</code></pre><p>注意几点：</p><pre><code class="lang-text">1. docker-compose.yml 对缩进非常敏感，mysql、redis、new-api 必须同级缩进。
2. SQL_DSN 里的数据库名是 new-api，要和 MYSQL_DATABASE 保持一致。
3. 密码建议用复杂一点，但不要包含 @、#、&amp;、?、/ 这种容易影响连接串解析的字符。
4. 如果密码里一定要用特殊符号，需要做 URL 编码，不然 New API 可能连不上 MySQL。</code></pre><h3>3. 启动 New API</h3><pre><code class="lang-bash">docker compose up -d</code></pre><p>查看容器：</p><pre><code class="lang-bash">docker ps</code></pre><p>查看日志：</p><pre><code class="lang-bash">docker logs -f new-api</code></pre><p>如果没报错，浏览器访问：</p><pre><code class="lang-text">http://你的服务器公网IP:3000</code></pre><h3>4. 登录 New API</h3><p>常见默认账号密码：</p><pre><code class="lang-text">用户名：root
密码：123456</code></pre><p>如果默认密码不对，就按页面提示注册或初始化。</p><p>第一次登录后先做三件事：</p><pre><code class="lang-text">1. 修改 root 密码
2. 关闭不需要的公开注册
3. 检查系统设置和站点名称</code></pre><p>New API 的登录页也可以直接访问：</p><pre><code class="lang-text">http://你的服务器公网IP:3000/login</code></pre><h2>四、部署 CLI Proxy API Plus</h2><p><code>CLI Proxy API Plus</code> 是一个 OpenAI 兼容代理，官方文档里默认端口是 <code>8317</code>，配置文件是 <code>config.yaml</code>。</p><h3>1. 创建目录</h3><pre><code class="lang-bash">mkdir -p /opt/ai-gateway/cli-proxy-api-plus
cd /opt/ai-gateway/cli-proxy-api-plus</code></pre><h3>2. 准备配置文件</h3><p>先生成两个密钥：</p><pre><code class="lang-bash">openssl rand -hex 32
openssl rand -hex 32</code></pre><p>第一个作为：</p><pre><code class="lang-text">API_KEY</code></pre><p>第二个作为：</p><pre><code class="lang-text">MANAGEMENT_KEY</code></pre><p>创建配置文件：</p><pre><code class="lang-bash">vim config.yaml</code></pre><p>写入：</p><pre><code class="lang-yaml">host: &quot;&quot;
port: 8317

auth-dir: &quot;/root/.cli-proxy-api&quot;

api-keys:
  - &quot;替换成你的API_KEY&quot;

remote-management:
  allow-remote: true
  secret-key: &quot;替换成你的MANAGEMENT_KEY&quot;
  disable-control-panel: false

debug: false
request-retry: 3

routing:
  strategy: &quot;round-robin&quot;

# 如果服务器访问上游模型不稳定，可以配置代理。
# 没有代理就保持为空。
proxy-url: &quot;&quot;

# 示例：如果你有传统 API Key，可以写到这里。
# 没有就先注释掉，后面通过 OAuth 登录。
#
# claude-api-key:
#   - api-key: &quot;sk-ant-xxx&quot;
#
# gemini-api-key:
#   - api-key: &quot;AIzaSyxxx&quot;
#
# openai-compatibility:
#   - name: &quot;openrouter&quot;
#     base-url: &quot;https://openrouter.ai/api/v1&quot;
#     api-key-entries:
#       - api-key: &quot;sk-or-v1-xxx&quot;
#     models:
#       - name: &quot;openai/gpt-4o-mini&quot;
#         alias: &quot;gpt-4o-mini&quot;</code></pre><p>注意：</p><pre><code class="lang-text">API_KEY 是给 New API 调用 CLI Proxy API Plus 用的。
MANAGEMENT_KEY 是进 CLI Proxy API Plus 管理接口用的。
这两个不要写成一样。</code></pre><h3>3. 创建 docker-compose.yml</h3><pre><code class="lang-bash">vim docker-compose.yml</code></pre><p>写入：</p><pre><code class="lang-yaml">services:
  cli-proxy-api-plus:
    image: eceasy/cli-proxy-api-plus:latest
    container_name: cli-proxy-api-plus
    restart: unless-stopped
    ports:
      - &quot;127.0.0.1:18317:8317&quot;
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml
      - ./auths:/root/.cli-proxy-api
      - ./logs:/CLIProxyAPI/logs
    networks:
      - ai-gateway-network

networks:
  ai-gateway-network:
    external: true</code></pre><p>这里我把容器的 <code>8317</code> 映射到了服务器本机的 <code>127.0.0.1:18317</code>。</p><p>原因是：</p><pre><code class="lang-text">1. New API 和 CLI Proxy API Plus 在同一个 Docker 网络里，可以直接访问 cli-proxy-api-plus:8317。
2. 服务器公网不直接暴露 8317，安全一点。
3. 如果后续确实要公网访问，再用 Nginx 单独代理。</code></pre><p>启动：</p><pre><code class="lang-bash">docker compose up -d</code></pre><p>查看日志：</p><pre><code class="lang-bash">docker logs -f cli-proxy-api-plus</code></pre><p>测试接口：</p><pre><code class="lang-bash">curl -H &quot;Authorization: Bearer 替换成你的API_KEY&quot; \
  http://127.0.0.1:18317/v1/models</code></pre><p>如果返回模型列表，说明 CLI Proxy API Plus 已经起来了。</p><h3>4. 如果镜像拉取失败</h3><p>有时候会遇到这种报错：</p><pre><code class="lang-text">pull access denied for eceasy/cli-proxy-api-plus</code></pre><p>这时候可以改成源码构建：</p><pre><code class="lang-bash">cd /opt/ai-gateway
git clone https://github.com/KooshaPari/cliproxyapi-plusplus.git
cd cliproxyapi-plusplus
docker build -t local/cli-proxy-api-plus:latest .</code></pre><p>然后把 <code>/opt/ai-gateway/cli-proxy-api-plus/docker-compose.yml</code> 里的镜像改成：</p><pre><code class="lang-yaml">image: local/cli-proxy-api-plus:latest</code></pre><p>再启动：</p><pre><code class="lang-bash">cd /opt/ai-gateway/cli-proxy-api-plus
docker compose up -d</code></pre><h2>五、CLI Proxy API Plus 登录上游账号</h2><p>CLI Proxy API Plus 有两种上游方式：</p><pre><code class="lang-text">1. 直接填 API Key
2. 使用 OAuth 登录</code></pre><p>如果你有传统 API Key，直接写进 <code>config.yaml</code> 最简单。</p><p>如果你要接 Codex、Claude Code、Gemini CLI 这类账号登录态，就需要运行登录命令。</p><h3>1. Codex / OpenAI OAuth 登录</h3><pre><code class="lang-bash">cd /opt/ai-gateway/cli-proxy-api-plus
docker compose exec cli-proxy-api-plus /CLIProxyAPI/CLIProxyAPI -no-browser --codex-login</code></pre><p>它会输出一个登录地址。复制到浏览器打开，登录你的账号，完成授权后回到命令行看是否成功。</p><h3>2. Claude 登录</h3><pre><code class="lang-bash">cd /opt/ai-gateway/cli-proxy-api-plus
docker compose exec cli-proxy-api-plus /CLIProxyAPI/CLIProxyAPI -no-browser --claude-login</code></pre><h3>3. Gemini 登录</h3><pre><code class="lang-bash">cd /opt/ai-gateway/cli-proxy-api-plus
docker compose exec cli-proxy-api-plus /CLIProxyAPI/CLIProxyAPI -no-browser --login</code></pre><p>注意：</p><pre><code class="lang-text">登录成功后，认证信息会保存在 ./auths 目录。
这个目录很重要，不要随便删除。
如果删除了，就要重新登录。</code></pre><h2>六、把 CLI Proxy API Plus 接入 New API</h2><p>进入 New API 后台：</p><pre><code class="lang-text">http://你的服务器公网IP:3000</code></pre><p>进入：</p><pre><code class="lang-text">渠道管理 -&gt; 添加渠道</code></pre><p>基础配置参考：</p><pre><code class="lang-text">类型：OpenAI
名称：CLI Proxy API Plus
密钥：CLI Proxy API Plus 配置中的 API_KEY
API地址：http://cli-proxy-api-plus:8317/v1</code></pre><p>这里重点注意：</p><pre><code class="lang-text">如果 New API 和 CLI Proxy API Plus 在同一个 ai-gateway-network 里，
API 地址就写：
http://cli-proxy-api-plus:8317/v1

不要写：
http://127.0.0.1:8317/v1</code></pre><p>因为在 New API 容器里面，<code>127.0.0.1</code> 指的是 New API 自己，不是宿主机，也不是 CLI Proxy API Plus。</p><h3>1. 模型怎么填</h3><p>模型必须填 CLI Proxy API Plus 实际支持的模型名。</p><p>比如 CLI Proxy API Plus 里能返回：</p><pre><code class="lang-text">gpt-5
gpt-5-codex
gpt-5.1
gpt-5.2</code></pre><p>那 New API 里就填这些模型。</p><p>不要凭感觉乱填，比如：</p><pre><code class="lang-text">gpt-5.5-pro</code></pre><p>如果上游没有这个模型，调用时会报：</p><pre><code class="lang-text">unknown provider for model xxx</code></pre><p>这种 502 一般不是 New API 坏了，而是模型名没有在 CLI Proxy API Plus 里配置成功。</p><h3>2. 测试渠道</h3><p>保存渠道后，点测试。</p><p>如果测试成功，就可以去：</p><pre><code class="lang-text">令牌管理 -&gt; 新建令牌</code></pre><p>创建一个下游 API Key。</p><p>之后客户端就可以调用 New API：</p><pre><code class="lang-bash">curl http://你的服务器公网IP:3000/v1/chat/completions \
  -H &quot;Content-Type: application/json&quot; \
  -H &quot;Authorization: Bearer 你的NewAPI令牌&quot; \
  -d '{
    &quot;model&quot;: &quot;gpt-5&quot;,
    &quot;messages&quot;: [
      {
        &quot;role&quot;: &quot;user&quot;,
        &quot;content&quot;: &quot;你好&quot;
      }
    ]
  }'</code></pre><h2>七、如果要让 CLI Proxy API Plus 外网访问</h2><p>一般不建议直接开放 CLI Proxy API Plus。  <br>如果只是给 New API 调用，不需要开放公网。</p><p>如果你确实要在外网直接访问，可以用 Nginx 代理，并加一层 Basic Auth。</p><h3>1. 安装 Nginx</h3><pre><code class="lang-bash">yum install -y nginx httpd-tools
systemctl enable nginx
systemctl start nginx</code></pre><h3>2. 创建 Basic Auth 密码</h3><pre><code class="lang-bash">htpasswd -bc /etc/nginx/.cliproxy_htpasswd admin 你的访问密码</code></pre><h3>3. 添加 Nginx 配置</h3><pre><code class="lang-bash">vim /etc/nginx/conf.d/cli-proxy-api-plus.conf</code></pre><p>写入：</p><pre><code class="lang-nginx">server {
    listen 8317;
    server_name _;

client_max_body_size 50m;

location / {
        auth_basic &quot;CLI Proxy API Plus&quot;;
        auth_basic_user_file /etc/nginx/.cliproxy_htpasswd;

proxy_pass http://127.0.0.1:18317;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection &quot;upgrade&quot;;
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}</code></pre><p>检查 Nginx 配置：</p><pre><code class="lang-bash">nginx -t</code></pre><p>重载：</p><pre><code class="lang-bash">systemctl reload nginx</code></pre><p>然后安全组开放 <code>8317</code>。</p><p>访问：</p><pre><code class="lang-text">http://你的服务器公网IP:8317</code></pre><p>会先要求输入 Basic Auth 账号密码。</p><h2>八、客户端怎么用</h2><h3>1. 普通 OpenAI 兼容客户端</h3><p>如果客户端支持填写 Base URL 和 API Key，就这样填：</p><pre><code class="lang-text">Base URL：http://你的服务器公网IP:3000/v1
API Key：New API 里创建的令牌
模型：New API 里配置好的模型名</code></pre><h3>2. Codex CLI 直接接 CLI Proxy API Plus</h3><p>如果你不想走 New API，想让 Codex 直接连 CLI Proxy API Plus，可以改本地：</p><pre><code class="lang-text">~/.codex/config.toml</code></pre><p>示例：</p><pre><code class="lang-toml">model_provider = &quot;cliproxyapi&quot;
model = &quot;gpt-5-codex&quot;
model_reasoning_effort = &quot;high&quot;

[model_providers.cliproxyapi]
name = &quot;cliproxyapi&quot;
base_url = &quot;http://你的服务器公网IP:8317/v1&quot;
wire_api = &quot;responses&quot;</code></pre><p>再改：</p><pre><code class="lang-text">~/.codex/auth.json</code></pre><p>示例：</p><pre><code class="lang-json">{
  &quot;OPENAI_API_KEY&quot;: &quot;sk-dummy&quot;
}</code></pre><p>如果你走的是 New API，则可以把 Codex 的 <code>base_url</code> 改成：</p><pre><code class="lang-text">http://你的服务器公网IP:3000/v1</code></pre><p>然后 <code>OPENAI_API_KEY</code> 填 New API 创建的令牌。</p><h2>九、常用维护命令</h2><h3>1. 查看容器</h3><pre><code class="lang-bash">docker ps</code></pre><h3>2. 查看 New API 日志</h3><pre><code class="lang-bash">docker logs -f new-api</code></pre><h3>3. 查看 CLI Proxy API Plus 日志</h3><pre><code class="lang-bash">docker logs -f cli-proxy-api-plus</code></pre><h3>4. 重启 New API</h3><pre><code class="lang-bash">cd /opt/ai-gateway/new-api
docker compose restart</code></pre><h3>5. 重启 CLI Proxy API Plus</h3><pre><code class="lang-bash">cd /opt/ai-gateway/cli-proxy-api-plus
docker compose restart</code></pre><h3>6. 更新镜像</h3><p>New API：</p><pre><code class="lang-bash">cd /opt/ai-gateway/new-api
docker compose pull
docker compose up -d</code></pre><p>CLI Proxy API Plus：</p><pre><code class="lang-bash">cd /opt/ai-gateway/cli-proxy-api-plus
docker compose pull
docker compose up -d</code></pre><p>如果 CLI Proxy API Plus 是源码构建的：</p><pre><code class="lang-bash">cd /opt/ai-gateway/cliproxyapi-plusplus
git pull
docker build -t local/cli-proxy-api-plus:latest .
cd /opt/ai-gateway/cli-proxy-api-plus
docker compose up -d</code></pre><h3>7. 备份</h3><p>建议至少备份这些目录：</p><pre><code class="lang-text">/opt/ai-gateway/new-api
/opt/ai-gateway/cli-proxy-api-plus/config.yaml
/opt/ai-gateway/cli-proxy-api-plus/auths</code></pre><p>打包备份：</p><pre><code class="lang-bash">cd /opt
tar -czvf ai-gateway-backup.tar.gz ai-gateway</code></pre><p>下载到本地保存。</p><h2>十、常见问题</h2><h3>1. docker compose up -d 报 YAML 错误</h3><p>常见原因：</p><pre><code class="lang-text">1. 缩进不对。
2. mysql、redis 没有和 new-api 对齐。
3. 冒号后面少空格。
4. 密码里有特殊符号，导致解析异常。</code></pre><p>可以用：</p><pre><code class="lang-bash">docker compose config</code></pre><p>检查 compose 文件是否能被正常解析。</p><h3>2. New API 打不开</h3><p>排查：</p><pre><code class="lang-bash">docker ps
docker logs -f new-api</code></pre><p>再检查安全组是否开放 <code>3000</code>。</p><p>如果容器正常，但公网打不开，基本就是安全组或服务器防火墙问题。</p><h3>3. New API 连接不上 MySQL</h3><p>重点看 <code>SQL_DSN</code>：</p><pre><code class="lang-text">root:你的MySQL密码@tcp(mysql:3306)/new-api</code></pre><p>注意：</p><pre><code class="lang-text">mysql 是容器名，不是服务器 IP。
new-api 是数据库名。
密码不要乱带特殊符号。</code></pre><h3>4. New API 渠道测试 502</h3><p>如果报：</p><pre><code class="lang-text">unknown provider for model xxx</code></pre><p>通常是模型名不对。</p><p>处理方式：</p><pre><code class="lang-text">1. 先请求 CLI Proxy API Plus 的 /v1/models。
2. 看实际返回了哪些模型。
3. New API 里只填写真实存在的模型。</code></pre><h3>5. CLI Proxy API Plus 登录后还是不能用</h3><p>检查：</p><pre><code class="lang-bash">ls -la /opt/ai-gateway/cli-proxy-api-plus/auths
docker logs -f cli-proxy-api-plus</code></pre><p>如果 <code>auths</code> 目录没有生成登录态文件，说明登录没有成功。</p><p>重新执行对应登录命令即可。</p><h3>6. 服务器在新加坡，要不要开代理</h3><p>这个要看你的上游服务。</p><p>如果服务器访问上游模型经常超时，可以在 <code>config.yaml</code> 里配置：</p><pre><code class="lang-yaml">proxy-url: &quot;socks5://127.0.0.1:7890&quot;</code></pre><p>如果服务器访问稳定，就不要多加代理，代理链路越长，越容易慢。</p><h3>7. MySQL 要不要开放 3306</h3><p>不建议。</p><p>New API 和 MySQL 在同一个 Docker 网络里，内部访问即可：</p><pre><code class="lang-text">mysql:3306</code></pre><p>公网开放 3306 风险很高，除非你明确知道自己在做什么。</p><h2>十一、最终访问地址整理</h2><p>部署完成后常用地址：</p><pre><code class="lang-text">服务器登录：
ssh root@你的服务器公网IP

New API 后台：
http://你的服务器公网IP:3000

New API 接口：
http://你的服务器公网IP:3000/v1

CLI Proxy API Plus 内部地址：
http://cli-proxy-api-plus:8317/v1

CLI Proxy API Plus 宿主机本地地址：
http://127.0.0.1:18317/v1

CLI Proxy API Plus 外网地址，只有配置 Nginx 后才有：
http://你的服务器公网IP:8317/v1</code></pre><p>登录方式：</p><pre><code class="lang-text">服务器：SSH 用户名 + 密码，或者 SSH 密钥
New API：root / 初始密码，首次登录后必须修改
CLI Proxy API Plus：API 调用使用 Bearer API_KEY，管理接口使用 MANAGEMENT_KEY
Nginx 外网访问：Basic Auth 用户名 + 密码</code></pre><h2>十二、我的建议</h2><p>如果只是自己用，推荐：</p><pre><code class="lang-text">New API 对公网开放 3000
CLI Proxy API Plus 不直接对公网开放
New API 通过 Docker 网络访问 CLI Proxy API Plus
MySQL / Redis 不开放公网</code></pre><p>这样最清晰，也相对安全。</p><p>如果后面要给公司同事或者多台电脑用，再考虑：</p><pre><code class="lang-text">1. 给 New API 配域名和 HTTPS
2. 关闭公开注册
3. 每个人单独创建 New API 用户和令牌
4. 给不同用户限制模型和额度
5. 定期看日志和异常请求</code></pre><p>这个东西最怕的不是部署不起来，而是部署起来后所有端口和密钥都裸奔。  <br>能不暴露的端口就不要暴露，能用内部网络访问的就不要走公网。</p><h2>参考资料</h2><ul><li>New API Docker 镜像说明：<span class="external-link"><a class="no-external-link" href="https://hub.docker.com/r/calciumion/new-api" target="_blank"><i data-feather="external-link"></i>https://hub.docker.com/r/calciumion/new-api</a></span></li><li>New API 环境变量说明：<span class="external-link"><a class="no-external-link" href="https://doc.newapi.pro/installation/environment-variables/" target="_blank"><i data-feather="external-link"></i>https://doc.newapi.pro/installation/environment-variables/</a></span></li><li>New API 注册与登录说明：<span class="external-link"><a class="no-external-link" href="https://docs.newapi.pro/zh/docs/guide/feature-guide/user/auth" target="_blank"><i data-feather="external-link"></i>https://docs.newapi.pro/zh/docs/guide/feature-guide/user/auth</a></span></li><li>New API docker-compose 示例：<span class="external-link"><a class="no-external-link" href="https://github.com/QuantumNous/new-api/blob/main/docker-compose.yml" target="_blank"><i data-feather="external-link"></i>https://github.com/QuantumNous/new-api/blob/main/docker-compose.yml</a></span></li><li>CLI Proxy API Plus GitHub：<span class="external-link"><a class="no-external-link" href="https://github.com/KooshaPari/cliproxyapi-plusplus" target="_blank"><i data-feather="external-link"></i>https://github.com/KooshaPari/cliproxyapi-plusplus</a></span></li><li>CLIProxyAPI Docker Compose 说明：<span class="external-link"><a class="no-external-link" href="https://help.router-for.me/cn/docker/docker-compose" target="_blank"><i data-feather="external-link"></i>https://help.router-for.me/cn/docker/docker-compose</a></span></li><li>CLIProxyAPI 配置项说明：<span class="external-link"><a class="no-external-link" href="https://help.router-for.me/configuration/options" target="_blank"><i data-feather="external-link"></i>https://help.router-for.me/configuration/options</a></span></li><li>CLIProxyAPI Codex 配置说明：<span class="external-link"><a class="no-external-link" href="https://help.router-for.me/cn/agent-client/codex" target="_blank"><i data-feather="external-link"></i>https://help.router-for.me/cn/agent-client/codex</a></span></li></ul>

功能描述

一、服务器准备

1. 推荐配置

2. 需要开放的端口

3. 登录服务器

二、安装基础环境

1. 安装 Docker

2. 创建统一目录和 Docker 网络

三、部署 New API

1. 创建目录

2. 创建 docker-compose.yml

3. 启动 New API

4. 登录 New API

四、部署 CLI Proxy API Plus

1. 创建目录

2. 准备配置文件

3. 创建 docker-compose.yml

4. 如果镜像拉取失败

五、CLI Proxy API Plus 登录上游账号

1. Codex / OpenAI OAuth 登录

2. Claude 登录

3. Gemini 登录

六、把 CLI Proxy API Plus 接入 New API

1. 模型怎么填

2. 测试渠道

七、如果要让 CLI Proxy API Plus 外网访问

1. 安装 Nginx

2. 创建 Basic Auth 密码

3. 添加 Nginx 配置

八、客户端怎么用

1. 普通 OpenAI 兼容客户端

2. Codex CLI 直接接 CLI Proxy API Plus

九、常用维护命令

1. 查看容器

2. 查看 New API 日志

3. 查看 CLI Proxy API Plus 日志

4. 重启 New API

5. 重启 CLI Proxy API Plus

6. 更新镜像

7. 备份

十、常见问题

1. docker compose up -d 报 YAML 错误

2. New API 打不开

3. New API 连接不上 MySQL

4. New API 渠道测试 502

5. CLI Proxy API Plus 登录后还是不能用

6. 服务器在新加坡，要不要开代理

7. MySQL 要不要开放 3306

十一、最终访问地址整理

十二、我的建议

参考资料

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

New API + CLI Proxy API Plus 中转站部署说明

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款