opsx-licence

许可证（License）管理服务器 Web 版 —— 基于 Go (Gin) + Vue 3 的单体全栈应用。

项目简介

opsx-licence 是一个统一的授权验证与管理服务，提供许可证的生成、验证、激活、机器绑定、心跳等核心能力，并支持产品定价、订单购买、防重复购买与支付回调。

技术栈与工程结构参考 opsx-web-lite，业务领域参考 Licence 服务器 Web版。

技术栈

后端

• 语言/框架：Go 1.24 + Gin
• ORM：GORM（默认 SQLite，支持 MySQL / PostgreSQL）
• 认证：JWT（HS256）+ bcrypt
• 架构：4 层分层（controller → service → dto → model），按业务域分包

前端

• 框架：Vue 3.4 + Vite
• UI：Element Plus
• 状态/路由：Pinia + Vue Router 4
• 图表：ECharts

部署

• 单二进制：前端通过 //go:embed 打包进 Go 二进制，一个文件即可部署

快速开始

环境要求

• Go >= 1.24
• Node.js >= 20
• CGO（SQLite 驱动需要，macOS 自带 gcc）

一键启动（开发模式）

cp .env.example .env
./run.sh start

• 前端：http://localhost:5181
• 后端：http://localhost:9001
• 默认账号：admin / admin

Docker 部署（生产推荐）

cp .env.example .env
# 修改 JWT_SECRET、Waffo 等
./run.sh docker up      # 等价于 docker compose up -d --build
./run.sh docker logs
./run.sh docker down

• 访问：http://localhost:9001（管理后台 + /api）
• 数据卷：licence_data → 容器内 /data/db.sqlite3

构建单二进制

./run.sh build
./run.sh binary start

常用命令

命令	说明
make dev / ./run.sh start	启动前后端开发服务
make build / ./run.sh build	构建嵌入前端的单二进制
./run.sh stop	停止服务
./run.sh status	查看服务状态
make clean	清理构建产物

项目结构

opsx-licence/
├── backend/                 # Go 后端
│   ├── main.go              # 入口
│   ├── embed.go             # 前端嵌入
│   ├── config/              # 配置
│   ├── database/            # 数据库初始化 + 种子数据
│   ├── middleware/          # 中间件（auth / cors）
│   ├── router/              # 路由
│   ├── utils/               # 工具（jwt / password）
│   └── internal/            # 业务分层
│       ├── controller/      # HTTP 处理层
│       ├── service/         # 业务逻辑层
│       ├── dto/             # 请求/响应结构
│       └── model/           # 数据模型
├── frontend/                # Vue 前端
│   └── src/
│       ├── api/             # 接口封装
│       ├── stores/          # Pinia 状态
│       ├── router/          # 路由
│       ├── layouts/         # 布局
│       └── views/           # 页面
├── Makefile
├── run.sh                   # 启动脚本
└── .env.example

业务域（规划）

模块	说明	状态
认证 (Auth)	管理员登录、JWT	✅
核心授权	产品 / 客户 / License / 激活	🚧 规划中
定价订单	Plan / Order / 支付网关	🚧 规划中
防重复购买	客户权益 / 幂等回调	🚧 规划中
分析审计	Dashboard / Analytics / AuditLog	🚧 规划中

作者

Logan.Li