diff --git a/README.md b/README.md
index a869fab..2569e62 100644
--- a/README.md
+++ b/README.md
@@ -30,6 +30,9 @@
-->
+
+
@@ -272,6 +275,9 @@
+
+
+
### Docker Compose(推荐)
diff --git a/README_EN.md b/README_EN.md
index d267c05..c096ca7 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -30,6 +30,9 @@ into one API Key, one endpoint, with automatic model discovery,
-->
+
+
diff --git a/docs/deployment.md b/docs/deployment.md
index 2af638e..b8fbf1e 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -9,6 +9,7 @@
| 场景 | 推荐方式 | 对外访问方式 | 数据位置 |
|------|----------|--------------|----------|
| 云服务器 / NAS / 家用主机长期运行 | Docker / Docker Compose / Zeabur | 固定服务地址,例如 `http://your-host:4000` 或反向代理域名 | 你挂载的 `DATA_DIR` / 持久化卷 |
+| 免费云部署(24h 在线) | Render + TiDB + UptimeRobot | Render 分配的 `.onrender.com` 域名或自定义域名 | TiDB Serverless(外部 MySQL 数据库) |
| 个人电脑本地使用 | 桌面版安装包 | 桌面窗口;如需本机客户端直连,使用日志中打印的 `http://127.0.0.1:` | Electron `app.getPath('userData')/data` |
| 二次开发 / 调试 | 本地开发 | 前端 `http://localhost:5173`,后端默认 `http://localhost:4000` | 仓库内 `./data` 或自定义 `DATA_DIR` |
@@ -44,6 +45,86 @@
---
+## Render 一键部署(免费 24h 运行)
+
+
+
+
+
+通过 **Render + TiDB + UptimeRobot** 组合,可以实现 **完全免费的 24 小时持续运行**:
+
+| 组件 | 作用 | 免费额度 |
+|------|------|----------|
+| [Render](https://render.com) | 运行 Metapi 容器 | Free Web Service(750 小时/月,闲置 15 分钟自动休眠) |
+| [TiDB Serverless](https://tidbcloud.com) | MySQL 兼容数据库,替代 SQLite 实现数据持久化 | 5 GiB 存储 + 5000 万 Request Units/月 |
+| [UptimeRobot](https://uptimerobot.com) | 每 5 分钟 ping 一次,防止 Render 免费实例休眠 | 50 个免费监控 |
+
+> [!IMPORTANT]
+> Render 免费版 **不支持持久化磁盘**,容器重启后本地文件会丢失。因此 **必须使用外部数据库**(推荐 TiDB Serverless),不能使用默认的 SQLite。
+
+### 步骤 1:注册 TiDB Serverless 并获取连接串
+
+1. 前往 [TiDB Cloud](https://tidbcloud.com) 注册账号
+2. 创建一个 **Serverless** 集群(免费)
+3. 在集群概览页点击 **Connect**,选择连接方式 **General**,获取连接参数
+4. 拼接为 Metapi 所需的 `DB_URL` 格式:
+
+ ```
+ mysql://:@:4000/?ssl={"rejectUnauthorized":true}
+ ```
+
+ > 将 ``、``、``、`` 替换为 TiDB 提供的实际值。
+
+> [!TIP]
+> 这里只是以TiDB作为示例,你也可以使用其他提供免费额度的云数据库方案(如 Neon、Supabase 等),只需将 `DB_TYPE` 设为对应的 `mysql` 或 `postgres`,并填入正确的连接串即可。什么?你不会其他的?把步骤复制给Gemini问他怎么改。
+
+### 步骤 2:部署到 Render
+
+**方式一:一键部署(推荐)**
+
+1. 点击上方 **Deploy to Render** 按钮
+2. 如果你 Fork 了仓库,也可以使用你自己的仓库地址
+3. 在 Render 界面中填写环境变量(见下表)
+
+**方式二:手动创建**
+
+1. 在 [Render Dashboard](https://dashboard.render.com) 点击 **New → Web Service**
+2. 连接你的 GitHub 仓库(或使用公开仓库地址 `https://github.com/cita-777/metapi`)
+3. 配置:
+ - **Environment**: Docker
+ - **Dockerfile Path**: `./docker/Dockerfile`
+ - **Docker Build Context**: `.`(仓库根目录)
+ - **Instance Type**: Free
+4. 添加环境变量(见下表)
+
+### 环境变量配置
+
+| 变量 | 说明 | 示例值 |
+|------|------|--------|
+| `AUTH_TOKEN` | 管理后台登录令牌(**必填**) | 你的强密码 |
+| `PROXY_TOKEN` | 代理接口 Bearer Token(**必填**) | 你的代理密钥 |
+| `DB_TYPE` | 数据库类型(**必填**) | `mysql` |
+| `DB_URL` | TiDB 连接串(**必填**) | `mysql://user:pass@host:4000/db?ssl=...` |
+| `DB_SSL` | 启用 SSL 连接 | `true` |
+| `TZ` | 时区 | `Asia/Shanghai` |
+| `PORT` | 服务端口(默认即可) | `4000` |
+
+### 步骤 3:配置 UptimeRobot 防休眠
+
+Render 免费实例在 15 分钟无流量后会自动休眠。使用 UptimeRobot 定时 ping 可以保持实例 24h 在线:
+
+1. 前往 [UptimeRobot](https://uptimerobot.com) 注册免费账号
+2. 添加新监控:
+ - **Monitor Type**: HTTP(s)
+ - **URL**: `https://your-app.onrender.com`(替换为 Render 分配的域名)
+ - **Monitoring Interval**: 5 minutes
+3. 保存即可,UptimeRobot 会每 5 分钟访问一次你的服务,防止休眠
+
+> [!TIP]
+> 部署完成后,通过 Render 分配的 `.onrender.com` 域名访问后台,使用 `AUTH_TOKEN` 登录即可。也可以在 Render 设置中绑定自定义域名。
+
+---
+
## Docker Compose 部署(推荐)
### 标准步骤
@@ -200,6 +281,7 @@ docker image prune -f
| 运行方式 | 数据目录 | 说明 |
|----------|----------|------|
| Docker / Docker Compose / Zeabur | 容器内 `DATA_DIR`(常见为 `/app/data`) | 需要映射到宿主机目录或平台持久化卷 |
+| Render + TiDB | TiDB Serverless(外部 MySQL) | 无本地持久化,数据全部存储在 TiDB 云端数据库 |
| 本地开发 | `DATA_DIR`,默认 `./data` | 位于当前仓库工作目录 |
| 桌面版 | `app.getPath('userData')/data` | 不在仓库目录里,升级桌面应用时会保留 |
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 8456504..0347b11 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -13,6 +13,7 @@
| 场景 | 推荐方式 | 需要准备 |
|------|----------|----------|
| 云服务器 / NAS / 家用主机长期运行 | Docker / Docker Compose | Docker 与 Docker Compose |
+| 免费云部署(24h 在线) | Render + TiDB + UptimeRobot | 注册 Render / TiDB Cloud / UptimeRobot 免费账号,详见 [Render 部署指南](./deployment.md#render-一键部署免费-24h-运行) |
| 个人电脑本地使用 | 桌面版安装包 | 从 [Releases](https://github.com/cita-777/metapi/releases) 下载对应系统的桌面安装包 |
| 二次开发 / 调试 | 本地开发 | Node.js 20+ 与 npm |
diff --git a/render.yaml b/render.yaml
new file mode 100644
index 0000000..fde4697
--- /dev/null
+++ b/render.yaml
@@ -0,0 +1,31 @@
+services:
+ - type: web
+ name: metapi
+ runtime: docker
+ repo: https://github.com/cita-777/metapi
+ dockerfilePath: ./docker/Dockerfile
+ dockerContext: .
+ plan: free
+ envVars:
+ - key: AUTH_TOKEN
+ sync: false
+ - key: PROXY_TOKEN
+ sync: false
+ - key: TZ
+ value: Asia/Shanghai
+ - key: PORT
+ value: "4000"
+ - key: DATA_DIR
+ value: /app/data
+ - key: NODE_ENV
+ value: production
+ - key: DB_TYPE
+ value: mysql
+ - key: DB_URL
+ sync: false
+ - key: DB_SSL
+ value: "true"
+ - key: CHECKIN_CRON
+ value: "0 8 * * *"
+ - key: BALANCE_REFRESH_CRON
+ value: "0 * * * *"