本教程将介绍如何使用 Render 部署 CLI Proxy API，搭建一个供个人使用的 AI API 代理服务。在 Render 和 GitHub 的免费额度内，除调用 API 费用外，不产生额外费用。它适合个人开发者使用，以更方便地调用模型。

创建 Cli Ploxy API 仓库并生成 Access Token

登录 GitHub 并创建一个新仓库，仓库名称可按个人喜好设置，可见性选择“Private”，其他设置项保持默认即可，最好创建一个空仓库，以免仓库中已有文件影响后续初始化。

随后访问 https://github.com/settings/personal-access-tokens/new 创建 Fine-grained Personal Access Token，以便 Render 访问并更新这个 GitHub 仓库。

personal_access_token

其中，Token name 可自定义，Expiration 建议设置为满足使用需求的期限，并在到期前重新生成并更换 Token，以确保安全性。

随后设置仓库访问，在 Repository access 中选择 Only select repositories，并仅选中刚才创建的仓库。

如下图所示，在 Repository permissions 中，将 Contents 设置为 Read and write，并保留 Metadata 的默认 Read-only 权限。

permissions

确认权限无误后，点击 Generate token。在 Token 显示出来之后，请将其复制下来或保存到安全的地方。由于 Token 只显示一次，若不慎遗失 Token，只能将旧 Token 撤销，并生成新的 Token。

在 Render 上部署 Cli Ploxy API

访问 Render 并创建一个账号，可使用 GitHub 登录。

进入 Dashboard 之后，点击右上角的 “+ New”，选择 “Web Service”。

Render

随后进入类似下图所示页面，点击 “Existing Image”，Image URL 填写：eceasy/cli-proxy-api:latest

image

点击后进入配置选择页面，在 Region 中选择部署区域，建议选择距离主要使用者较近的区域。下方的 “Instance Type” 选择 Free 即可。需要注意的是，免费实例会在 15 分钟无流量后休眠，唤醒通常需要一段时间，并且每月有免费实例时长限制，因此更适合个人试用。

Region

接下来设置环境变量。在 “Environment Variables” 添加以下变量：

变量名值
GITSTORE_GIT_URL你的私有 GitHub 仓库 URL
GITSTORE_GIT_USERNAME你的 GitHub 用户名
GITSTORE_GIT_TOKEN此前创建的 Token
MANAGEMENT_PASSWORD设置一个面板后台登录密码

随后点击 “Deploy Web Service”，创建部署。

首次启动时，CLI Proxy API 会通过 Git 存储初始化配置，并将相关文件提交到 GitHub 仓库；此时可以在仓库中看到如下目录。

folder

第一次部署可能报错，可见控制台输出：

Example API key detected
The normal API server was not started because the top-level api-keys configuration still contains template values.

Replace these values before using the proxy:

your-api-key-1
your-api-key-2
your-api-key-3
Edit /CLIProxyAPI/gitstore/config/config.yaml, set strong random API keys, then restart CLIProxyAPI.

此时打开刚才创建的 GitHub 仓库中的 config/config.yaml，将其中默认的 API key 占位符替换为随机生成的密钥，以免他人使用默认密钥向你的公开服务发起未经授权的请求。这里的 API key 指的是客户端访问 CLI Proxy API 的代理访问密钥，不是上游 AI 服务商的 API key。

将 Key 值改成强随机字符串。可以使用命令：

openssl rand -hex 32

在修改完成配置后，重新部署位于 Render 上的 Cli Ploxy API 服务，随后，服务就会读取新的 API Key 并正常启动。如果你拥有自定义域名，可以在 Render 的 Custom Domains 中完成绑定，之后即可通过该域名访问服务。

配置上游服务并使用中转接口

Cli Ploxy API 管理面板地址为 https://你的域名/management.html 。使用此前在环境变量中设置的 MANAGEMENT_PASSWORD 登录控制面板，可在“AI 提供商”页面中接入对应提供商的 API key、OAuth 凭据或其他认证信息。具体流程参见相关服务商的 API 文档。

dashboard

调用中转站的 API

完成上述配置后，可以使用支持 OpenAI 兼容接口的 LLM 客户端测试服务是否正常工作。推荐选择的软件有：Cherry Studio 和 RikkaHub。

其中，API Base URL：https://你的域名/v1 。 API 路径：/chat/completions 。 API Key：填写此前写入 config.yaml 的 api-keys 列表中的任意一个代理访问密钥。这里填写的不是上游 AI 服务商的 API key。

本文中的部署面向个人自用场景，不涉及用户注册、权限管理、配额、计费和限流等多用户功能。由于中转站运营者通常可以通过模型别名或模型映射修改对外显示的模型名称，因此不能仅凭模型名称判断实际调用的模型。选择第三方中转服务时，建议考虑服务商信誉、计费透明度，警惕 API 投毒，并做好系列安全防范措施。