Repository navigation
x-admin v1.0.0 · 首个正式版本
x-admin v1.0.0
首个正式版本。x-admin 是一套可直接落地的中后台全栈脚手架:Go + Gin + GORM 提供 API,React 19 + antd 6 + Vite 8 提供 SPA,开箱即用 RBAC、安全认证、系统管理与 Workbench Liquid Glass 界面。
亮点
- RBAC 权限模型:用户 → 角色 → 菜单/按钮,
super_admin跳过校验,其余按模块:资源:动作权限码授权。 - 完整认证链路:图形验证码、登录失败锁定、JWT access token + refresh 轮换、TOTP 二次验证、一次性恢复码、Passkey(WebAuthn)、接口限流。
- 系统管理模块:看板、用户、角色、菜单、部门、字典、参数、文件、定时任务、操作日志、登录日志、个人中心、站内通知。
- 工程化交付:版本化 SQL 迁移嵌入二进制、启动自动迁移与种子数据、Swagger/OpenAPI、Excel 导入导出、Go 单元/集成测试、Vitest 前端测试。
- 部署友好:单二进制后端、Docker Compose 完整栈、非 root 镜像、健康检查、Nginx SPA 与反代配置齐全。
- 界面体验:两级导航、多标签页保活、右键页签操作、暗色模式、登录趋势图表、可复用文件选择器,基于 MIT 协议开源。
下载说明
| 文件 | 平台 | 内容 |
|---|---|---|
x-admin_1.0.0_linux_amd64.tar.gz |
Linux x86_64 | 后端二进制 + 配置样例 + README/LICENSE |
x-admin_1.0.0_linux_arm64.tar.gz |
Linux arm64 | 同上 |
x-admin_1.0.0_darwin_amd64.tar.gz |
macOS Intel | 同上 |
x-admin_1.0.0_darwin_arm64.tar.gz |
macOS Apple Silicon | 同上 |
x-admin_1.0.0_windows_amd64.zip |
Windows x86_64 | x-admin.exe + 配置样例 + README/LICENSE |
x-admin-web_1.0.0.zip |
通用 | 前端静态资源(dist 内容) |
checksums.txt |
— | 全部产物的 SHA-256 校验和 |
快速开始
Docker Compose(推荐)
git clone https://github.com/xgd16/x-admin.git
cd x-admin
cp .env.example .env
# 编辑 .env,至少填写 JWT_SECRET(建议 32+ 位随机字符)
docker compose -f deploy/docker-compose.yml up -d --build启动后访问:
默认账号:admin / Admin@123456(首次登录后请立即修改)。
使用发布产物
tar -xzf x-admin_1.0.0_linux_amd64.tar.gz
cd x-admin_1.0.0_linux_amd64
# 按需修改 configs/config.yaml,或使用 X_ADMIN_* 环境变量覆盖
./x-admin -config configs/config.yaml要求 MySQL 8.0+;生产环境必须使用 Redis 7.x。启动时自动执行数据库迁移与种子数据。前端将 x-admin-web_1.0.0.zip 解压到 Nginx 站点目录,并参考仓库内 deploy/nginx.conf 配置 /admin/v1、/uploads、/swagger 与 SPA fallback。
校验产物
sha256sum -c checksums.txt # macOS: shasum -a 256 -c checksums.txt升级与注意事项
- 这是首个版本,无升级兼容负担。
- 部署到生产前请替换
JWT_SECRET、数据库密码,收紧CORS_ORIGINS与TRUSTED_PROXIES,并启用 HTTPS。 - Passkey 仅在
localhost或 HTTPS 安全上下文中可用,不支持 IP 地址。 - 多副本部署时请使用 Redis,定时任务依赖缓存锁避免重复执行。
相关文档
- 使用与部署文档:README.md
- 接口与实现契约:SPEC.md
- OpenAPI:internal/docs/openapi.yaml