[功能] 支持 PostgreSQL 数据库，添加数据库迁移逻辑并更新相关文档

docs/app-config.md

@@ -33,14 +33,17 @@ go run . --port 3000 --log-dir ./logs
 | `LOG_LEVEL` | 日志等级 | `info` |
 | `SESSION_SECRET` | Session 签名密钥 | 启动时随机生成 |
 | `SQLITE_PATH` | SQLite 数据库文件路径 | `openflare.db` |
-| `SQL_DSN` | MySQL DSN，设置后优先于 SQLite | 空 |
+| `DSN` | PostgreSQL DSN，设置后优先于 SQLite | 空 |
+| `SQL_DSN` | 兼容旧命名的 PostgreSQL DSN，优先级低于 `DSN` | 空 |
 | `REDIS_CONN_STRING` | Redis 连接串 | 空 |
 | `UPLOAD_PATH` | 上传目录 | `upload` |
 | `AGENT_TOKEN` | 兼容旧部署的全局 Agent Token | 空 |
 
 说明：
 
-* `SQL_DSN` 与 `SQLITE_PATH` 同时存在时优先使用 `SQL_DSN`
+* `DSN` 与 `SQL_DSN` 同时存在时优先使用 `DSN`
+* `DSN` 或 `SQL_DSN` 与 `SQLITE_PATH` 同时存在时优先使用 PostgreSQL
+* 当目标 PostgreSQL 数据库为空且本地 `SQLITE_PATH` 文件存在时，Server 启动阶段会自动迁移 SQLite 数据，并在日志中输出按表迁移进度
 * `SESSION_SECRET` 生产环境必须显式配置
 * `REDIS_CONN_STRING` 未配置时，相关能力回退为进程内实现
 

docs/deployment.md

@@ -8,7 +8,7 @@
 
 * Go 1.24+
 * Node.js 18+
-* 可写 SQLite 文件目录
+* 可写 SQLite 文件目录，或可访问的 PostgreSQL 实例
 
 ### 1.2 Agent
 
@@ -37,6 +37,9 @@ cd openflare_server
 export SESSION_SECRET='replace-with-random-string'
 export SQLITE_PATH='./openflare.db'
 export LOG_LEVEL='info'
+# 可选：设置后优先使用 PostgreSQL。
+# 如果 PostgreSQL 为空且本地 SQLite 文件存在，启动时会自动迁移数据。
+# export DSN='postgres://openflare:secret@127.0.0.1:5432/openflare?sslmode=disable'
 go run .
 ```
 
@@ -46,21 +49,41 @@ go run .
 
 ```yaml
 services:
+  postgres:
+    image: postgres:17-alpine
+    restart: unless-stopped
+    environment:
+      POSTGRES_DB: openflare
+      POSTGRES_USER: openflare
+      POSTGRES_PASSWORD: replace-with-strong-password
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U openflare -d openflare"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
   openflare:
     image: ghcr.io/rain-kl/openflare:latest
     container_name: openflare
     restart: unless-stopped
+    depends_on:
+      postgres:
+        condition: service_healthy
     ports:
       - "3000:3000"
     environment:
       SESSION_SECRET: replace-with-random-string
       SQLITE_PATH: /data/openflare.db
+      DSN: postgres://openflare:replace-with-strong-password@postgres:5432/openflare?sslmode=disable
       GIN_MODE: release
       LOG_LEVEL: info
     volumes:
       - openflare-data:/data
 
 volumes:
+  postgres-data:
   openflare-data:
 ```
 

docs/design.md

@@ -53,7 +53,7 @@ OpenFlare 是一套自托管的 OpenResty 控制面，面向单团队或单组
 
 * Gin
 * GORM
-* SQLite
+* SQLite / PostgreSQL
 * 现有登录与 Session 体系
 * 托管 `openflare_server/web` 静态构建产物
 
@@ -79,7 +79,7 @@ OpenFlare 是一套自托管的 OpenResty 控制面，面向单团队或单组
 ## 4. 总体架构
 
 ```text
-OpenFlare Server (Gin + SQLite + Web UI)
+OpenFlare Server (Gin + SQLite/PostgreSQL + Web UI)
         |
         | HTTP API / Config Pull
         v

docs/development-guidelines.md

@@ -13,7 +13,7 @@
 * Go 1.24+
 * Gin
 * GORM
-* SQLite
+* SQLite / PostgreSQL
 * 现有登录体系
 
 ### 1.2 Agent