Appearance
MengStack v2.0
MengStack 是面向多租户 SaaS 应用的 Go 通用底座。
概述
MengStack 把账号、权限、租户、组织、审计、配置、消息、插件等所有 Web 应用共享的能力一次性做好,让你只专注于业务逻辑。
核心特性
🏢 多租户内建
支持三种隔离策略,通过配置切换:
- 共享表 + tenant_id(默认,适合大多数场景)
- Schema 隔离(高安全需求)
- 独立数据库(企业级隔离)
go
// 请求头传入租户 ID
// X-Tenant-ID: tenant-abc-123
// 框架自动解析并注入上下文
tenantID := tenant.FromContext(c.Request.Context())🔌 插件架构
通过扩展点和 .mengplugin 包格式扩展功能,不改动内核代码:
go
func (p *MyPlugin) Permissions() plugin.Permissions {
return plugin.Permissions{
Database: []string{"my_table"},
Events: []string{"order.created"},
Routes: []string{"/api/v1/orders/*"},
}
}📦 四层分层
domain → application → infrastructure → interfaces| 层 | 职责 | 禁止 |
|---|---|---|
| Domain | 实体、领域接口 | import gorm/http/redis |
| Application | 用例编排、事务 | 直接操作数据库 |
| Infrastructure | 数据库/缓存实现 | 含业务逻辑 |
| Interfaces | 参数校验、调 service | 写业务逻辑 |
🔐 安全默认
- JWT 双 Token(Access + Refresh)
- RBAC 权限管理
- bcrypt 密码哈希
- 参数化查询(防 SQL 注入)
- XSS 过滤
- 三级限流
🌍 国际化
i18n 框架内置,支持多语言切换。
快速开始
1. 环境准备
- Go 1.26+
- PostgreSQL 16+
- Redis 7+
2. 获取发行版
bash
# 克隆纯内核基座(9 大核心模块 + 示例插件,不含业务插件,可独立编译启动)
git clone https://mengstackgit.softunis.com/softunis/mengstack-kernel-dist.git
cd mengstack-kernel-dist发行版为公开仓库,无需认证即可克隆
3. 配置环境
bash
cp .env.example .env
# 编辑 .env,填入数据库密码和 JWT 密钥4. 启动服务
bash
# 安装依赖
go mod download
# 运行迁移 + 启动
make run5. 访问服务
| 端点 | 地址 |
|---|---|
| API | http://localhost:2222 |
| 健康检查 | http://localhost:2222/health |
| Swagger 文档 | http://localhost:2222/swagger/index.html |
项目结构
.
├── cmd/
│ ├── server/ # 主服务入口
│ ├── migrate/ # 数据库迁移工具
│ └── smrm/ # CLI 脚手架工具
├── internal/
│ ├── app/ # 应用基础设施
│ ├── config/ # 配置加载
│ ├── kernel/ # ★ 内核(开源部分)
│ └── modules/ # 业务模块
│ ├── auth/ # 认证
│ ├── rbac/ # 角色权限
│ ├── org/ # 组织架构
│ ├── audit/ # 审计日志
│ └── ...
├── migrations/ # 数据库迁移脚本
└── configs/ # 配置模板核心模块
认证模块 (auth)
POST /api/v1/auth/register → 注册
POST /api/v1/auth/login → 登录
POST /api/v1/auth/refresh → 刷新令牌
POST /api/v1/auth/logout → 登出
GET /api/v1/auth/me → 获取当前用户RBAC 模块
基于角色的权限控制,支持:
- 角色管理
- 权限分配
- 用户-角色绑定
审计模块
记录所有操作日志,支持:
- 操作审计
- 日志查询
- 日志导出
常用命令
bash
make build # 编译
make run # 启动开发服务
make test # 运行测试
make test-cover # 测试覆盖率
make lint # 代码检查
make swagger # 重新生成 Swagger 文档
make migrate # 运行数据库迁移技术栈
| 组件 | 选型 | 说明 |
|---|---|---|
| 语言 | Go 1.26+ | 编译为单文件 |
| Web 框架 | Gin | 高性能 HTTP 路由 |
| ORM | GORM v2 | PostgreSQL 数据访问 |
| 数据库 | PostgreSQL 16 | 多租户原生支持 |
| 缓存 | Redis 7 | 会话/缓存/队列 |
| 依赖注入 | Uber fx | 编译期装配 |
| 配置 | Viper | 分层配置 |
| 日志 | Zap | 结构化日志 |
| 认证 | JWT | 双 Token |
| 迁移 | golang-migrate | 版本化变更 |
| API 文档 | Swag | 自动生成 Swagger |

