db

README.md

@@ -72,6 +72,8 @@ cp .env.example .env
 
 2. 编辑 `.env`：
 
+- `DATABASE_URL` 默认可用 `sqlite:////app/data/app.db`
+- `APP_DATA_DIR` 建议指向仓库外目录，例如 `../sub-provider-data`
 - `PUBLIC_PATH` 改成足够长的随机字符串
 - `PUBLIC_BASE_URL` 建议填写你反代后的最终访问地址，例如 `https://sub.example.com`
 - `AIRPORT_A_URL` / `AIRPORT_B_URL` / `AIRPORT_C_URL` 都可以直接填订阅地址，项目会自动判断是 YAML 还是 URI 订阅
@@ -87,13 +89,27 @@ cp .env.example .env
 - `rules.yaml`：规则绑定
 - `clients.yaml`：客户端模板
 
-4. 启动：
+4. 如需切换到数据库配置源，先执行一次导入：
+
+```bash
+python -m app.import_config --replace
+```
+
+导入完成后，运行时会优先读取数据库；当数据库内没有配置时，仍会回退到 `config/` 下的 YAML 文件。
+
+说明：
+
+- `app.db`、抓取缓存等运行态数据默认写入 `/app/data`
+- `docker-compose` 已将 `/app/data` 挂载到 `APP_DATA_DIR`
+- 建议把这个目录放在仓库外，避免 `git pull`、切分支时碰到本地状态文件
+
+5. 启动：
 
 ```bash
 docker compose up -d --build
 ```
 
-5. 访问检查：
+6. 访问检查：
 
 - 健康检查：`http://YOUR_HOST:18080/healthz`
 - 单 provider：