DEPLOY_GUIDE.md

CLIProxyAPI 部署到 Hugging Face Spaces 说明

已完成的准备工作

已在 c:\Users\asemx\.gemini\antigravity\playground\deep-crab 目录下创建了以下文件：

1. Dockerfile - 适配 HF Spaces 的 Docker 配置

   • 使用 7860 端口（HF Spaces 要求）
   • 设置非 root 用户运行
   • 自动从 GitHub 克隆 CLIProxyAPI 源码并编译

2. README.md - HF Spaces 元数据配置文件

   • 设置 SDK 为 Docker
   • 包含基本说明

手动部署步骤

步骤 1：创建 HF Space

1. 访问 https://huggingface.co/new-space
2. 登录您的 Hugging Face 账户
3. 填写表单：
   • Space name: CLIProxyAPI（或其他可用名称）
   • SDK: 选择 Docker
   • Visibility: 按需选择
4. 点击 Create Space

步骤 2：推送代码

创建 Space 后，HF 会显示 git 仓库地址，格式类似：

https://huggingface.co/spaces/YOUR_USERNAME/CLIProxyAPI

在 PowerShell 中执行以下命令：

cd c:\Users\asemx\.gemini\antigravity\playground\deep-crab

# 添加 HF Spaces 远程仓库（替换 YOUR_USERNAME）
git remote add origin https://huggingface.co/spaces/YOUR_USERNAME/CLIProxyAPI

# 推送代码
git push -u origin master

如果提示输入凭据，使用：

• 用户名：您的 HF 用户名
• 密码：您的 HF Access Token（在 https://huggingface.co/settings/tokens 生成）

步骤 3：等待构建

推送后，HF Spaces 会自动开始构建 Docker 镜像。您可以在 Space 页面查看构建日志。

步骤 4：配置环境变量（可选）

在 Space 的 Settings 页面，您可以添加以下环境变量：

• API_KEYS: 逗号分隔的 API 密钥列表

验证部署

构建完成后，访问您的 Space URL：

https://YOUR_USERNAME-cliproxyapi.hf.space

API 端点示例：

• Health check: GET /
• OpenAI 兼容: POST /v1/chat/completions