基于 GoFrame 的企业级中后台:一套 REST API + 两套 Vue 3 前台。
JWT 鉴权、多租户、RBAC、定时任务、监控运维、附件与视频队列。后端无 CGO,可交叉编译为单一静态二进制。
欢迎加入 QQ 交流群:
| 前台 | 地址 | 说明 |
|---|---|---|
| Soybean Admin | https://gf.phpframe.org | Soybean/,清新布局、elegant-router |
| Art Design Pro | https://goframe.phpframe.org/ | web/,多布局、Tailwind + UnoCSS |
两套前台对接同一套 Go 后端(默认 :8787)。演示账号以站点提示为准,本地默认多为 admin / 123456。
OpenAPI:/api.json Swagger:/docs
- 双前台可选:Art Design Pro 与 Soybean Admin 共用 API,按团队 UI 偏好选一套或并行维护
- 权限与组织:JWT + 刷新令牌、验证码、RBAC、部门 / 岗位 / 多租户数据隔离
- 开箱业务:用户角色菜单、字典配置、附件上传、操作日志、通知、文章 CMS、插件配置
- 运维能力:主机 / Redis / 在线用户监控、进程内定时调度、数据库备份还原、代码生成
- 安全默认:CSRF、XSS 过滤、限流、IP 黑白名单;密码哈希兼容 PHP
$2y$bcrypt - 可部署:Windows / Linux 交叉编译脚本、systemd + Nginx 一键部署;后端
CGO_ENABLED=0
浏览器
├─ Soybean Admin :9527 (开发) ──┐
└─ Art Design Pro :5730 (开发) ──┤ /api /core /ws
▼
GoFrame API :8787
(生产反代后 :8181)
│
┌──────────────┼──────────────┐
▼ ▼ ▼
MySQL Redis 可选
fssoa-net db 4 yt-dlp / ffmpeg
生产推荐:Nginx(80/443)托管前端 dist,反代 /api、/core、/ws 到本机后端。
| 层 | 选型 |
|---|---|
| 后端 | Go 1.27.1、GoFrame v2 2.10.x、MySQL 5.7/8.0、Redis 5+ |
| 认证 / 安全 | JWT(HS256)、bcrypt、CSRF、bluemonday XSS、限流、IP 名单 |
| 实时 / 媒体 | Gorilla WebSocket(/ws/ai)、go-ytdlp + 系统 yt-dlp / ffmpeg |
前台 web/ |
Vue 3.5、Vite、TypeScript、Element Plus、vxe-table、Pinia、vue-i18n、TailwindCSS v4、UnoCSS |
前台 Soybean/ |
Vue 3.5、Vite、TypeScript、Element Plus、UnoCSS、Pinia、elegant-router、pnpm workspace(@sa/*) |
.
├── go-project/ # GoFrame 后端
│ ├── main.go
│ ├── manifest/config/ # 运行时配置(生产密钥勿入库)
│ ├── internal/modules/ # 业务模块:router → controller → service → dao → models
│ ├── scripts/ # 编译 / 启停
│ └── deploy/ # systemd、Nginx、一键部署
├── web/ # Art Design Pro 前台(开发端口 5730)
└── Soybean/ # Soybean Admin 前台(开发端口 9527)
后端模块一览见 go-project/README.md。公共能力在 internal/authkit、internal/middleware、internal/shared。
| 模块 | 说明 |
|---|---|
auth |
登录、验证码、令牌刷新、按用户名查租户 |
menu / user / role / dept / post / tenant |
权限与组织 |
dict / config |
字典与系统配置 |
attachment / file |
附件与上传 |
logmod / notice |
操作日志、通知 |
plugin |
插件注册与配置 |
article |
文章 CMS |
video |
视频解析与下载队列 |
monitor |
主机、Redis、在线用户 |
cronjob / crontab |
任务节点、进程内调度、执行日志 |
gencode |
代码生成 |
dbmaint |
数据库维护(仅 app.debug=true) |
health |
/health、/health/ready |
wsai |
WebSocket AI 通道(未绑定外部 LLM) |
demo / flow |
演示接口;工作流为占位(空列表) |
- Go 1.27.1+
- MySQL 5.7 / 8.0(库名默认
fssoa-net) - Redis 5.0+(默认 db 4)
- Node.js ≥ 20.19、pnpm ≥ 8.8(跑前台时)
- 可选:
yt-dlp、ffmpeg(视频)、mysqldump(备份)
准备 MySQL / Redis,导入结构与初始数据(如 go-project/static/restore/init.sql),再改 go-project/manifest/config/config.yaml(生产密钥不要提交)。
cd go-project
# 国内可改 GOPROXY=https://goproxy.cn,direct
export GOPROXY=https://proxy.golang.org,direct
go mod tidy
go run .Windows:scripts\start.bat / scripts\stop.bat
Linux:bash scripts/start.sh / bash scripts/stop.sh
热重载:gf run main.go(需 GoFrame CLI)
常用覆盖:GF_GCFG_FILE、FSSADMIN_DB_LINK、FSSADMIN_YTDLP_BIN。
go test ./...
curl -s http://127.0.0.1:8787/health两端开发代理都指向 http://127.0.0.1:8787,请先启动后端。
Art Design Pro(web/)
cd web
pnpm install
pnpm dev浏览器:http://127.0.0.1:5730
生产构建:pnpm build
Soybean Admin(Soybean/)
cd Soybean
pnpm install
pnpm dev浏览器:http://127.0.0.1:9527
生产构建:pnpm build 路由生成:pnpm gen-route
后端无 CGO,统一 CGO_ENABLED=0。脚本默认 GOPROXY=https://goproxy.cn,direct。
| 场景 | 命令 | 产物 |
|---|---|---|
| Windows 本机 | scripts\build-windows.bat |
bin/fssadmin.exe |
| Windows → Linux | scripts\build-linux.bat |
bin/fssadmin-linux-amd64 |
| Linux 本机 | bash scripts/build.sh |
bin/fssadmin |
| Linux → Windows | bash scripts/build.sh windows |
bin/fssadmin.exe |
# 手动交叉编译 Linux amd64
cd go-project
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags "-s -w" -o bin/fssadmin .Linux 生产请用 go-project/deploy/(systemd + Nginx),不要用 scripts/start.sh 长期托管:
chmod +x deploy/deploy.sh
sudo DOMAIN=admin.example.com ./deploy/deploy.sh all分步命令、环境变量与发布包清单见 deploy/Install.md。deploy.sh 默认后端端口 8181(仅本机),本地开发仍是 8787。
未内置 Dockerfile:交叉编译出目标二进制,挂载 manifest/、static/、logs/ 即可。外部配置优先于 gf build 打进二进制的默认配置。
主配置:go-project/manifest/config/config.yaml。生产建议:
server.address只监听本机,由 Nginx 对外app.debug: false(关闭调试类接口)app.secretKey、数据库与 Redis 密码用强随机值,通过环境变量或部署脚本注入app.schedulerEnable: true时启用内置备份 cron(默认每天 02:00,输出static/bakup)
- Fork 本仓库,创建分支
feature/xxx - 后端改动请先
cd go-project && go test ./... - 提交并发起 Pull Request
问题与讨论请走 GitHub Issues。提交前不要把生产密钥、.env 实密、数据库 dump 打进仓库。
- GoFrame
- Art Design Pro(
web/) - Soybean Admin(
Soybean/)
本仓库采用 MIT License。前台目录保留各自上游的版权声明。
