deploy to HF Spaces

Dockerfile

@@ -8,6 +8,12 @@ RUN pip install --no-cache-dir --root-user-action=ignore -r requirements.txt
 
 COPY . .
 
-EXPOSE 8000
+# HF Spaces 持久化存储目录
+ENV DATA_DIR=/data
+RUN mkdir -p /data
+
+# HF Spaces 要求端口 7860
+ENV PORT=7860
+EXPOSE 7860
 
 CMD ["python", "main.py"]

config/setting.toml

@@ -12,7 +12,7 @@ max_poll_attempts = 200
 
 [server]
 host = "0.0.0.0"
-port = 8000
+port = 7860
 
 [debug]
 enabled = false

config/setting_example.toml

@@ -12,7 +12,7 @@ max_poll_attempts = 200
 
 [server]
 host = "0.0.0.0"
-port = 8000
+port = 7860
 
 [debug]
 enabled = false

src/core/config.py

@@ -1,4 +1,5 @@
 """Configuration management for Flow2API"""
+import os
 import tomli
 from pathlib import Path
 from typing import Dict, Any, Optional
@@ -74,6 +75,10 @@ class Config:
 
     @property
     def server_port(self) -> int:
+        # 优先使用环境变量 PORT（HF Spaces 等云平台通过此变量指定端口）
+        env_port = os.environ.get("PORT")
+        if env_port:
+            return int(env_port)
         return self._config["server"]["port"]
 
     @property

src/core/database.py

@@ -1,4 +1,5 @@
 """Database storage layer for Flow2API"""
+import os
 import aiosqlite
 import json
 from datetime import datetime
@@ -12,9 +13,13 @@ class Database:
 
     def __init__(self, db_path: str = None):
         if db_path is None:
-            # Store database in data directory
-            data_dir = Path(__file__).parent.parent.parent / "data"
-            data_dir.mkdir(exist_ok=True)
+            # 优先使用环境变量 DATA_DIR（HF Spaces 持久化目录为 /data）
+            env_data_dir = os.environ.get("DATA_DIR")
+            if env_data_dir:
+                data_dir = Path(env_data_dir)
+            else:
+                data_dir = Path(__file__).parent.parent.parent / "data"
+            data_dir.mkdir(parents=True, exist_ok=True)
             db_path = str(data_dir / "flow.db")
         self.db_path = db_path
 

src/main.py

@@ -197,6 +197,11 @@ app.add_middleware(
 app.include_router(routes.router)
 app.include_router(admin.router)
 
+# 健康检查端点（供 UptimeRobot 等保活服务 ping，无需认证）
+@app.get("/health")
+async def health_check():
+    return {"status": "ok"}
+
 # Static files - serve tmp directory for cached files
 tmp_dir = Path(__file__).parent.parent / "tmp"
 tmp_dir.mkdir(exist_ok=True)