June 22, 2025 ZH

rustzen-admin：Rust + React 管理后台模板

2025-06-22 的 rustzen-admin 模板历史快照，记录当时的 Rust 后端与 React 前端基础能力。

migrated and adapted from idaibin/blog Read English version

历史说明：本文记录 2025-06-22 时 rustzen-admin 模板的阶段状态。后续认证和权限文章记录了之后的实现演进，当前状态应以项目源码和后续文章为准。

开发管理后台时，经常需要重复实现相同的功能模式：用户认证、权限管理、CRUD 操作等基础功能。rustzen-admin 是一个开源模板，使用 Rust 作为后端、React 作为前端，提供这些基础功能的基础实现。

当前实现功能

这是一个正在开发中的模板项目，以下是当时记录的功能：

✅ 后端 (Rust + Axum + PostgreSQL)

用户认证：当时记录为基于 JWT 的登录系统；密码哈希后续已从 bcrypt 演进到 Argon2
权限控制：用户、角色、权限的完整管理体系
菜单系统：支持层级结构的菜单管理和权限控制
操作日志：基础的操作记录和安全审计功能
选项接口：统一的下拉框和选择器数据接口

✅ 前端 (React 19 + TypeScript + Ant Design)

认证流程：完整的登录/登出和令牌管理
用户管理：用户的增删改查和角色分配
角色管理：权限分配和菜单访问控制
菜单管理：树形结构编辑和组织管理
响应式界面：基于 Ant Design 的响应式设计

🔄 开发中功能

部门/组织架构管理
系统配置管理
文件上传功能

技术架构

后端结构

backend/src/features/
├── auth/           # 认证和授权
├── system/
│   ├── user/      # 用户管理
│   ├── role/      # 角色管理
│   ├── menu/      # 菜单管理
│   └── log/       # 操作日志

每个功能模块都遵循一致的分层模式：

Model：数据结构和验证
Repository：数据库操作（使用 SQLx）
Service：业务逻辑处理
Routes：HTTP 请求处理

前端结构

frontend/src/
├── pages/          # 页面组件
├── services/       # API 通信
├── types/          # TypeScript 类型定义
└── layouts/        # 布局组件

技术选型理由

为什么选择 Rust 作为后端？

内存安全：编译期检查避免常见运行时错误
性能表现：相比 Node.js 等方案资源占用更少
类型安全：强类型系统帮助早期发现问题
生态支持：SQLx 数据库操作、Axum Web 框架

为什么选择 React + TypeScript？

开发体验：前端开发者熟悉的开发模式
类型安全：与后端模型的端到端类型检查
组件生态：Ant Design 提供企业级组件
现代工具：Vite 提供快速的开发构建

快速开始

环境要求

# 必需工具
rust --version     # >= 1.70
node --version     # >= 20
docker --version   # >= 20.10

安装步骤

git clone https://github.com/rustzen/rustzen-admin.git
cd rustzen-admin

# 配置环境变量
cp backend/.env.example backend/.env

# 安装 just 命令工具
cargo install just

# 启动开发环境
just dev

启动后包含：

PostgreSQL 数据库（Docker）
Rust 后端服务 http://localhost:8000
React 前端应用 http://localhost:5173

默认登录账号：admin / admin123

开发体验

统一命令管理

just dev       # 启动开发环境
just build     # 构建生产版本
just test      # 运行测试
just clean     # 清理构建缓存

API 测试

项目包含 REST Client 文件，可直接在 VSCode 中测试 API：

### 登录
POST http://localhost:8000/api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "admin123"
}

性能表现

基础负载测试显示在典型管理后台使用场景下有合理的性能表现：

指标	结果
冷启动时间	~1 秒
内存占用	~30-50MB
并发处理	可良好处理数百并发

注：这是开发环境下的指标，生产环境性能取决于部署配置。

适用场景

适合的项目类型：

企业内部管理工具
SaaS 产品后台管理
内容管理系统
中小规模应用系统

建议考虑其他方案的情况：

需要快速原型开发（有学习成本）
团队没有 Rust 经验且无学习时间
项目需要大量实时功能
需要成熟生态和大量插件支持

参与贡献

欢迎参与项目贡献！特别需要帮助的领域：

文档完善：改进安装指南和教程
测试扩展：增加测试覆盖率
界面优化：提升用户界面体验
功能增强：添加常用的管理后台功能

贡献流程

Fork 仓库
创建功能分支
进行开发修改
如适用，添加测试
提交 Pull Request

当前局限性

坦诚说明这个模板目前还没有包含的功能：

无实时通知功能
文件上传处理较简单
前端错误处理较基础
无国际化支持
移动端优化有限

发展规划

短期目标

完成部门管理功能
改进错误处理机制
增加全面的测试
完善项目文档

长期规划

WebSocket 实时功能支持
插件架构设计
移动端 PWA 增强
高级数据可视化组件

学习资源

如果你对 Rust 或这个技术栈还不熟悉，推荐以下学习资源：

Rust Web 开发：

React TypeScript：