Upload README.md
Browse files
README.md
CHANGED
|
@@ -1,8 +1,39 @@
|
|
| 1 |
---
|
| 2 |
-
title:
|
| 3 |
emoji: 🚀
|
| 4 |
colorFrom: indigo
|
| 5 |
colorTo: blue
|
| 6 |
sdk: docker
|
| 7 |
app_port: 8080
|
| 8 |
-
pinned: false
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
title: Sub2API HF Demo
|
| 3 |
emoji: 🚀
|
| 4 |
colorFrom: indigo
|
| 5 |
colorTo: blue
|
| 6 |
sdk: docker
|
| 7 |
app_port: 8080
|
| 8 |
+
pinned: false
|
| 9 |
+
---
|
| 10 |
+
|
| 11 |
+
# Sub2API on Hugging Face Spaces (Demo / Experimental)
|
| 12 |
+
|
| 13 |
+
> 这是一个 **演示性质** 的 Hugging Face Docker Space 模板：
|
| 14 |
+
>
|
| 15 |
+
> - `sub2api`、`PostgreSQL`、`Redis` 全部跑在 **同一个容器** 里。
|
| 16 |
+
> - PostgreSQL / Redis 只在容器内部使用，不对外暴露。
|
| 17 |
+
> - 数据库使用本地临时磁盘运行，**通过定时 `pg_dump` 备份到 Hugging Face Dataset Repo**。
|
| 18 |
+
>
|
| 19 |
+
> **注意**：免费 Space 会休眠，且默认磁盘是临时的；这个模板更适合测试 / 演示，不适合生产环境。
|
| 20 |
+
|
| 21 |
+
## 关键修复（v2）
|
| 22 |
+
|
| 23 |
+
本版本修复了 Debian / Bookworm 上常见的 `externally-managed-environment`（PEP 668）报错：
|
| 24 |
+
|
| 25 |
+
- 不再直接向系统 Python 安装依赖
|
| 26 |
+
- 改为创建独立虚拟环境 `/home/user/venv`
|
| 27 |
+
- `backup_worker.sh` 与 `supervisord.conf` 统一使用虚拟环境里的 Python
|
| 28 |
+
|
| 29 |
+
## 在 Space Settings → Variables / Secrets 中至少配置
|
| 30 |
+
|
| 31 |
+
```bash
|
| 32 |
+
POSTGRES_PASSWORD=强密码
|
| 33 |
+
JWT_SECRET=超长随机字符串
|
| 34 |
+
TOTP_ENCRYPTION_KEY=超长随机字符串
|
| 35 |
+
ADMIN_EMAIL=admin@example.com
|
| 36 |
+
ADMIN_PASSWORD=强密码
|
| 37 |
+
HF_TOKEN=你的 Hugging Face Write Token
|
| 38 |
+
DATASET_REPO_ID=你的用户名/sub2api-backups
|
| 39 |
+
```
|