祺洛后台管理介绍 Rust 快速开发平台

will_csdn_go

已于 2025-07-16 15:52:06 修改

阅读量633

点赞数 27

CC 4.0 BY-SA版权

文章标签： rust 开发语言后端

于 2025-07-16 15:48:21 首次发布

本文链接：https://blog.youkuaiyun.com/will_csdn_go/article/details/149376931

祺洛 (QiLuo) - Rust 快速开发平台

📖 项目概述

祺洛是一个基于 Rust 技术栈开发的企业级快速开发平台，采用现代化的架构设计，提供完整的后台管理系统解决方案。平台集成了用户管理、权限控制、系统监控、微信公众号管理等核心功能，适用于中小型企业的信息化建设。

✨ 核心特性

🦀 Rust 生态 — 基于 Rust + Axum + Sea-ORM + JWT 构建，性能卓越，内存安全
🔐 权限管理 — 完整的 RBAC 权限体系，支持用户、角色、菜单、API 多维度权限控制
📱 微信集成 — 内置微信公众号管理，支持菜单配置、消息管理、用户管理、自动回复
⚡ 高性能 — 异步架构，支持高并发，响应速度快
🌐 分布式 — 支持集群部署，多数据源，分布式架构
📊 系统监控 — 实时服务器状态监控，在线用户管理，操作日志追踪
⏰ 定时任务 — 在线配置定时任务，支持 Cron 表达式
🎨 现代化界面 — 基于 Vue 的管理后台，界面美观，操作便捷

🛠️ 技术栈

后端技术

技术	说明	版本
Rust	系统开发语言	>= 1.70.0
Axum	Web 框架	最新版
Sea-ORM	ORM 框架	最新版
Tokio	异步运行时	最新版
MySQL/SQLite	数据库	MySQL >= 8.0 或 SQLite >= 3.35
Redis	缓存服务	>= 6.0
JWT	认证机制	最新版
tracing	日志系统	最新版

前端技术

技术	说明	版本
Vue	前端框架	3.4.x
Vite	构建工具	5.2.x
TypeScript	类型系统	5.4.x
Pinia	状态管理	2.1.x
Vue Router	路由管理	4.3.x
Element Plus	UI 组件库	2.7.x
Axios	HTTP 请求	最新版
ECharts	图表库	最新版

🚀 快速开始

系统要求

在运行项目之前，请确保您的系统已安装以下软件：

Rust >= 1.70.0 (安装指南)
MySQL >= 8.0 或 SQLite >= 3.35
Redis >= 6.0 (可选，用于缓存)
Node.js >= 16.0.0 (前端开发)

1. 获取源码

后端地址：https://github.com/chelunfu/qiluo_admin.git

克隆后端项目

git clone https://github.com/chelunfu/qiluo_admin.git
cd qiluo_admin

前端地址：https://github.com/chelunfu/qiluo_vue.git

克隆前端项目

git clone https://github.com/chelunfu/qiluo_vue.git
cd qiluo_vue

2. 配置数据库

编辑 config/ 目录下的配置文件，设置数据库连接信息：

[database]
url = "mysql://username:password@localhost:3306/qiluo"
# 或使用 SQLite
# url = "sqlite:data/qiluo.db"

创建数据库，并导入 qiluo.sql 文件。

3. 启动项目

启动后端服务

# 开发模式运行
cargo run


#### 启动前端项目

```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm run dev

4. 访问系统

服务启动后，访问以下地址：

管理后台：http://localhost:4000

🔧 生产环境部署

后端部署

# 构建 Release 版本
cargo build --release

# 运行 Release 版本
./target/release/qiluo

前端部署

# 生产环境构建
pnpm build:pro

# 构建产物位于 dist 目录，可部署到任意静态服务器

📁 项目结构

后端目录结构

qiluo/
├── 📁 config/               # 配置文件
├── 📁 data/                 # 数据存储目录
│   ├── 📁 img/              # 图片资源
│   ├── 📁 log/              # 日志文件
│   ├── 📁 static/           # 静态资源
│   ├── 📁 upload/           # 上传文件
│   └── 📁 web/              # 前端文件
├── 📁 migration/            # 数据库迁移
├── 📁 src/                  # 源代码
│   ├── 📁 api/              # API 控制器
│   │   ├── 📁 sys_controll/ # 系统管理接口
│   │   └── 📁 wechat/       # 微信接口
│   ├── 📁 cache/            # 缓存管理
│   ├── 📁 common/           # 公共模块
│   ├── 📁 config/           # 配置模块
│   ├── 📁 midle_ware/       # 中间件
│   ├── 📁 model/            # 数据模型
│   ├── 📁 service/          # 业务服务
│   └── 📁 worker/           # 后台任务
└── 📄 Cargo.toml            # 项目配置

前端目录结构

qiluo_vue/
├── 📁 public/               # 静态资源目录
├── 📁 src/                  # 源代码目录
│   ├── 📁 api/              # API 接口定义
│   ├── 📁 assets/           # 项目资源文件
│   ├── 📁 axios/            # Axios 请求配置
│   ├── 📁 components/       # 公共组件
│   ├── 📁 constants/        # 常量定义
│   ├── 📁 directives/       # 自定义指令
│   ├── 📁 hooks/            # 自定义 Hook
│   ├── 📁 layout/           # 布局组件
│   ├── 📁 locales/          # 国际化资源
│   ├── 📁 plugins/          # 插件配置
│   ├── 📁 router/           # 路由配置
│   ├── 📁 store/            # 状态管理
│   ├── 📁 styles/           # 样式文件
│   ├── 📁 utils/            # 工具函数
│   ├── 📁 views/            # 页面视图
│   ├── 📄 App.vue           # 根组件
│   ├── 📄 main.ts           # 应用入口文件
│   └── 📄 permission.ts     # 权限控制
├── 📁 types/                # TypeScript 类型定义
├── 📄 index.html            # HTML 模板
├── 📄 package.json          # 项目依赖
└── 📄 vite.config.ts        # Vite 配置