[优化] 更换 JWT 认证机制

docs/reference/cli.md

@@ -8,7 +8,7 @@
 
 ```bash
 cd openflare_server
-export SESSION_SECRET='replace-with-random-string'
+export JWT_SECRET='replace-with-random-string'
 export SQLITE_PATH='./openflare.db'
 export LOG_LEVEL='info'
 go run .

docs/reference/configuration.md

@@ -64,7 +64,7 @@ go run . --port 3000 --log-dir ./logs
 | `PORT` | Server 监听端口 | `3000` |
 | `GIN_MODE` | Gin 运行模式 | 非 `debug` 时按 release |
 | `LOG_LEVEL` | 日志等级 | `info` |
-| `SESSION_SECRET` | 临时 Session 签名密钥，主要用于 OAuth 状态等非管理端 API 鉴权流程 | 启动时随机生成 |
+| `JWT_SECRET` | 管理端 API 登录令牌的 JWT 签名密钥，生产环境必须显式配置 | 启动时随机生成 |
 | `SQLITE_PATH` | SQLite 数据库文件路径 | `openflare.db` |
 | `DSN` | PostgreSQL DSN，设置后优先于 SQLite | 空 |
 | `SQL_DSN` | 兼容旧命名的 PostgreSQL DSN，优先级低于 `DSN` | 空 |
@@ -76,7 +76,7 @@ go run . --port 3000 --log-dir ./logs
 * `DSN` 与 `SQL_DSN` 同时存在时优先使用 `DSN`。
 * `DSN` 或 `SQL_DSN` 与 `SQLITE_PATH` 同时存在时优先使用 PostgreSQL。
 * 当目标 PostgreSQL 数据库为空且本地 `SQLITE_PATH` 文件存在时，Server 启动阶段会自动迁移 SQLite 数据，并在日志中输出按表迁移进度。
-* `SESSION_SECRET` 生产环境建议显式配置，避免 OAuth 授权状态等临时会话在重启后失效；管理端 API 登录凭证不再通过 Cookie Session 传递，而是使用 `OPENFLARE_TOKEN` 请求头。
+* `JWT_SECRET` 用于管理端 API 登录令牌的签名与验证，生产环境必须显式配置，避免重启后所有已登录令牌失效。
 * `REDIS_CONN_STRING` 未配置时，相关能力回退为进程内实现。
 
 ## 运行时 Option
@@ -295,7 +295,7 @@ OpenResty 性能参数与缓存参数继续统一保存在 `Option` 表。当前
 ### 生产 Server + PostgreSQL
 
 ```bash
-export SESSION_SECRET='replace-with-a-long-random-string'
+export JWT_SECRET='replace-with-a-long-random-string'
 export DSN='postgres://openflare:replace-with-strong-password@postgres:5432/openflare?sslmode=disable'
 export GIN_MODE='release'
 export LOG_LEVEL='info'
@@ -304,7 +304,7 @@ export LOG_LEVEL='info'
 ### 本地 Server + SQLite
 
 ```bash
-export SESSION_SECRET='dev-session-secret'
+export JWT_SECRET='dev-jwt-secret'
 export SQLITE_PATH='./openflare-dev.db'
 export LOG_LEVEL='debug'
 go run .