前言

在 AI 大模型快速发展的今天，越来越多的开发者希望通过统一的 API 接口来调用不同厂商的模型，例如 Gemini、Claude、GPT 以及 Qwen 等。但不同平台之间的接口标准并不完全一致，这也给开发和集成带来了一定的复杂度。

CLIProxyAPI 正是为了解决这一问题而诞生的开源项目。它通过封装 Gemini CLI、Antigravity、ChatGPT Codex、Claude Code、Qwen Code 以及 iFlow 等工具，将它们统一转换为兼容 OpenAI / Gemini / Claude / Codex 的 API 服务。这样一来，开发者只需调用统一格式的 API，就可以在自己的应用中使用 Gemini 2.5 Pro、GPT-5、Claude、Qwen 等模型能力。

而在 CLIProxyAPI 的基础之上，社区又推出了 CLIProxyAPIPlus 版本。Plus 版本在保持主线项目功能和更新同步的同时，额外增加了对第三方 AI 提供商的支持，让可接入的模型来源更加丰富。需要注意的是，这些第三方提供商的支持主要由社区贡献者维护，如果在使用过程中遇到问题，通常需要联系对应的社区维护者进行解决。

在本篇教程中，我们将重点介绍如何在 VPS 上使用 Docker 快速部署 CLIProxyAPIPlus。通过简单的几步配置，就可以在服务器上搭建一个兼容多种主流 AI 接口标准的 API 服务，方便在各种应用、脚本或 AI 工具中进行调用。

项目简介

CLIProxyAPI项目：

将 Gemini CLI、Antigravity、ChatGPT Codex、Claude Code、Qwen Code 和 iFlow 封装成与 OpenAI/Gemini/Claude/Codex 兼容的 API 服务，让您可以通过 API 免费使用 Gemini 2.5 Pro、GPT 5、Claude 和 Qwen 模型。

CLIProxyAPIPlus项目：

这是CLIProxyAPI的 Plus 版本，在主线项目的基础上增加了对第三方提供商的支持。
所有第三方提供商的支持均由社区贡献者维护；CLIProxyAPI 不提供技术支持。如果您需要帮助，请联系相应的社区维护者。
Plus 版本与主线版本保持同步更新

https://help.router-for.me/cn/

有关截图

OAuth 登录页面

模型展示页面

管理中心

API秘钥

路由策略

默认使用轮询策略，我们可以添加多个账号，这边会轮询使用，避免某一个账号被限制

配合第三方AI工具使用

Cherry Studio使用

配置界面

使用界面

openclaw使用

API Base URL
参考以下格式

http://192.168.223.50:8317/v1

部署方法

使用Docker安装

本教程主要演示使用docker的方式安装部署,简单便捷
164b6ac419e23bc5390dc46601a202bf

准备条件

1）一台服务器

我们使用莱卡云服务器来演示，我们选择香港VPS主要是网络原因，
需要vps的可以看以下信息，配置可以参考以下资源占用情况
莱卡云
本期docker容器占用资源情况如下仅供参考,内存占用大约80M

2）本教程使用到的项目

本教程使用的官方github地址

CLIProxyAPI项目

https://github.com/router-for-me/CLIProxyAPI
目前有16.8k stars

CLIProxyAPIPlus项目

https://github.com/router-for-me/CLIProxyAPIPlus
目前有1.7k stars

3）域名

尽量绑定,不然不安全

一、Docker环境部署

在vps安装docker和docker-compose
Docker官方安装文档（英文）
https://duan.yyzq.eu.org/docker-001
Docker-Compose官方安装文档（英文)
https://duan.yyzq.eu.org/docker-002
Centos安装Docker和Docker-compose（中文）
https://duan.yyzq.eu.org//03
Ubuntu安装Docker和Docker-compose（中文）
https://duan.yyzq.eu.org//04

推荐直接用一键脚本

docker安装脚本

bash <(curl -sSL https://cdn.jsdelivr.net/gh/SuperManito/LinuxMirrors@main/DockerInstallation.sh)

执行以下命令查看docker版本

docker --version

Docker version 29.1.3, build f52814d

docker-compose安装脚本

curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && chmod +x /usr/local/bin/docker-compose

执行以下命令查看docker-compose版本

docker-compose --version

Docker Compose version v5.0.1

二、部署命令

登录服务器使用root账户执行以下步骤

docker-compose命令

mkdir cpa-plus; cd  cpa-plus

下载config.yaml文件

curl -o config.yaml https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml

修改config
1、remote-management下的allow-remote为true
2、remote-management下的secret-key输入密码

vim config.yaml

其他都不要动

然后再新建docker-compose.yml

vim docker-compose.yml

services:
  cli-proxy-api:
    image: eceasy/cli-proxy-api-plus:latest        # 使用的Docker镜像（cli-proxy-api-plus版本）
    container_name: cli-proxy-api-plus             # 容器名称
    ports:
      - "8317:8317"                               # 端口映射：宿主机8317 -> 容器8317
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml     # 挂载配置文件（本地config.yaml映射到容器内）
      - ./auths:/root/.cli-proxy-api               # 挂载认证数据目录，用于保存登录信息等
      - ./logs:/CLIProxyAPI/logs                   # 挂载日志目录（保存容器日志）
    environment:
      - TZ=Asia/Shanghai                          # 设置容器时区为上海
    restart: always                               # 容器异常退出时自动重启

三、执行容器运行命令

docker-compose up -d  #运行容器

docker-compose ps  #查看是否启动成功

正常启动如下所示

docker-compose ps  #查看是否启动成功
NAME                 IMAGE                              COMMAND               SERVICE         CREATED       STATUS       PORTS
cli-proxy-api-plus   eceasy/cli-proxy-api-plus:latest   "./CLIProxyAPIPlus"   cli-proxy-api   2 hours ago   Up 2 hours   0.0.0.0:8317->8317/tcp