vite-press init

docs/guide/server.md

@@ -0,0 +1,66 @@
+# 启动 Server
+
+OpenFlare Server 是 Gin + GORM 单体控制面，负责管理端 UI、管理 API、Agent API、配置渲染、版本发布与状态存储。
+
+## 前置条件
+
+| 项目 | 要求 |
+| --- | --- |
+| Go | `1.24+` |
+| Node.js | `18+` |
+| 数据库 | SQLite 文件目录可写，或可访问的 PostgreSQL 实例 |
+
+生产环境建议显式配置 `SESSION_SECRET`，并优先使用 PostgreSQL。
+
+## 构建管理端前端
+
+```bash
+cd openflare_server/web
+corepack enable
+pnpm install
+pnpm build
+```
+
+`pnpm build` 会生成供 Go Server 托管的静态产物。
+
+## 源码启动
+
+```bash
+cd openflare_server
+export SESSION_SECRET='replace-with-random-string'
+export SQLITE_PATH='./openflare.db'
+export LOG_LEVEL='info'
+# 可选：设置后优先使用 PostgreSQL。
+# export DSN='postgres://openflare:secret@127.0.0.1:5432/openflare?sslmode=disable'
+go run .
+```
+
+默认监听 `3000` 端口。也可以通过命令行指定：
+
+```bash
+go run . --port 3000 --log-dir ./logs
+```
+
+## 首次登录
+
+访问 `http://localhost:3000`。
+
+| 用户名 | 密码 |
+| --- | --- |
+| `root` | `123456` |
+
+## Swagger
+
+登录管理端后访问：
+
+```text
+http://localhost:3000/swagger/index.html
+```
+
+如需在本地重新生成 Swagger 文档：
+
+```bash
+go install github.com/swaggo/swag/cmd/swag@v1.16.4
+cd openflare_server
+swag init -g main.go -o docs
+```