跳转到内容

启动 Server

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

前置条件

项目要求
Go1.24+
Node.js18+
数据库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

用户名密码
root123456

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

基于 Apache License 2.0 发布