Files
OpenFlare/docs/guide/server.md
T
2026-05-09 17:37:06 +08:00

1.3 KiB

启动 Server

OpenFlare Server 是 Gin + GORM 单体控制面,负责管理端 UI、管理 API、Agent API、配置渲染、版本发布与状态存储。

前置条件

项目 要求
Go 1.24+
Node.js 18+
数据库 SQLite 文件目录可写,或可访问的 PostgreSQL 实例

生产环境建议显式配置 SESSION_SECRET,并优先使用 PostgreSQL。

构建管理端前端

cd openflare_server/web
corepack enable
pnpm install
pnpm build

pnpm build 会生成供 Go Server 托管的静态产物。

源码启动

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 端口。也可以通过命令行指定:

go run . --port 3000 --log-dir ./logs

首次登录

访问 http://localhost:3000。

用户名 密码
root 123456

Swagger

登录管理端后访问:

http://localhost:3000/swagger/index.html

如需在本地重新生成 Swagger 文档:

go install github.com/swaggo/swag/cmd/swag@v1.16.4
cd openflare_server
swag init -g main.go -o docs