mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-09-29 22:06:38 +08:00
ryan
67 lines
1.4 KiB
Markdown
67 lines
1.4 KiB
Markdown
# 启动 Server
|
|
|
|
OpenFlare Server 是 Gin + GORM 单体控制面，负责管理端 UI、管理 API、Agent API、配置渲染、版本发布与状态存储。
|
|
|
|
## 前置条件
|
|
|
|
| 项目 | 要求 |
|
|
| --- |-----------------------------------|
|
|
| Go | `1.25+` |
|
|
| 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
|
|
```
|