Skip to content

x-admin v1.0.0 · 首个正式版本

Choose a tag to compare

@xgd16 xgd16 released this 04 Nov 13:20
· 36 commits to main since this release

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,定时任务依赖缓存锁避免重复执行。

相关文档

完整变更记录:https://github.com/xgd16/x-admin/commits/v1.0.0