File size: 1,883 Bytes
0208fd2 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 | ---
title: Grok2API
emoji: 🛰️
colorFrom: gray
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
license: mit
---
# Grok2API on Hugging Face Spaces
个人用 Docker Space 部署（**v3.0.7**，已适配 HF 端口与 Secrets）。
> 仅供个人学习研究。请遵守 Grok 使用条款与当地法律；不要把管理员密码、API Key、账号凭据写进公开 README。
## 快速开始
1. Space SDK 选 **Docker**，建议 **Private**
2. 用本仓库 `scripts/push-to-hf.ps1` 推送（会排除大图与嵌套目录）
3. Settings → Secrets 配置：
| Secret | 必须 | 说明 |
| --- | --- | --- |
| `BOOTSTRAP_ADMIN_PASSWORD` | 是 | 管理端初始密码 |
| `JWT_SECRET` | 强烈建议 | ≥32 字符；与现网一致可解密旧会话 |
| `CREDENTIAL_ENCRYPTION_KEY` | 强烈建议 | Base64 32 字节；**写入账号后不要改** |
4. 等待 Building → Running
5. 打开 `https://<user>-<space>.hf.space`，用 `admin` + 密码登录
## 数据持久化
- 尽量开启 **Persistent Storage**，挂载到 `/data`
- 入口脚本会自动把 SQLite / 媒体写到 `/data`（无盘时回退 `/app/data`）
- 监听：HF 注入 `PORT` 时用 `0.0.0.0:$PORT`，否则 HF 环境默认 `7860`
## 环境变量（可选）
| 变量 | 默认 | 作用 |
| --- | --- | --- |
| `BOOTSTRAP_ADMIN_USERNAME` | `admin` | 初始管理员 |
| `PUBLIC_API_BASE_URL` | `https://$SPACE_HOST` | 公开 API 基址 |
| `GROK2API_DATA_DIR` | `/data` 优先 | 数据根目录 |
| `SECURE_COOKIES` | HF 下 `true` | Cookie Secure |
| `SWAGGER_ENABLED` | `false` | Swagger |
完整说明见仓库内 `docs/HUGGINGFACE.md` / `docs/HF_DEPLOY_手把手.md`。
## 健康检查
`/healthz`
## 上游项目
基于 [chenyme/grok2api](https://github.com/chenyme/grok2api) **v3.0.7**，并保留本仓库的 HF 启动适配（环境变量生成配置、7860/PORT、`/data`）。
|