FastapiAdmin v2.0.0
一套现代、开源、全栈融合的中后台快速开发平台，给个⭐️支持一下
📘 项目介绍（作者：@1014TaoTao）
FastapiAdmin 是一套 完全开源、高度模块化、技术先进的现代化快速开发平台，旨在帮助开发者高效搭建高质量的企业级中后台系统。该项目采用 前后端分离架构，融合 Python 后端框架 FastAPI 和前端主流框架 Vue3 实现多端统一开发，提供了一站式开箱即用的开发体验。
代码地址：
github：https://github.***/1014TaoTao/FastapiAdmin
giee：https://gitee.***/tao__tao/FastapiAdmin
gitcode: https://gitcode.***/qq_36002987/fastapi_vue3_admin
设计初心: 以模块化、松耦合为核心，追求丰富的功能模块、简洁易用的接口、详尽的开发文档和便捷的维护方式。通过统一框架和组件，降低技术选型成本，遵循开发规范和设计模式，构建强大的代码分层模型，搭配完善的本地中文化支持，专为团队和企业开发场景量身定制。
FastapiAdmin
├─ backend # 后端工程
├─ frontend # 前端工程
├─ devops # 部署工程
├─ docker-***pose.yaml # 部署文件
├─ start.sh # 一键部署脚本
├─ LICENSE # 许可协议
|─ README.en.md # 英文文档
└─ README.md # 中文文档
✨ 核心亮点
| 特性 | 描述 |
|---|---|
| 🔭 快速开发 | 一套完全开源的现代化快速开发平台，旨在帮助开发者高效搭建高质量的中后台系统。 |
| 🌐 全栈整合 | 前后端分离，融合 Python (FastAPI) + Vue3 多端开发 |
| 🧱 模块化设计 | 系统功能高度解耦，便于扩展和维护 |
| ⚡️ 高性能异步 | 使用 FastAPI 异步框架 + Redis 缓存优化接口响应速度 |
| 🔒 安全认证 | 支持 JWT OAuth2 认证机制，保障系统安全 |
| 📊 权限管理 | RBAC 模型实现菜单、按钮、数据级别的细粒度权限控制 |
| 🚀 快速部署 | 支持 Docker/Docker ***pose/Nginx 一键部署 |
| 📄 开发友好 | 提供完善的中文文档 + 中文化界面 + 可视化工具链，降低学习成本 |
| 🚀 快速接入 | 基于 Vue3、Vite5、Pinia、Ant Design Vue 等主流前端技术栈，开箱即用。 |
🛠️ 技术栈概览
| 类型 | 技术选型 | 描述 |
|---|---|---|
| 后端框架 | FastAPI / Uvicorn / Pydantic 2.0 / Alembic | 现代、高性能的异步框架，强制类型约束，数据迁移。 |
| ORM | SQLAlchemy 2.0 | 强大的 ORM 库。 |
| 定时任务 | APScheduler | 轻松实现定时任务。 |
| 权限认证 | PyJWT | 实现 JWT 认证。 |
| 前端框架 | Vue3 / Vite5 / Pinia / TypeScript | 快速开发 Vue3 应用。 |
| UI 库 | Ant Design Vue | 快速开发美观的 UI 组件。 |
| 数据库 | MySQL / MongoDB | 强大的数据库。 |
| 缓存 | Redis | 强大的缓存数据库。 |
| 文档 | Swagger / Redoc | 自动生成 API 文档。 |
| 部署 | Docker / Nginx / Docker ***pose | 快速部署项目。 |
📌 内置模块
| 模块名 | 子模块名 | 描述 |
|---|---|---|
| 仪表盘 | 工作台 、分析页 | 常用功能入口 |
| 系统管理 | 包含菜单、部门、岗位、角色、用户、日志、配置、公告、字典、任务等子模块 | 系统主功能 |
| 监控管理 | 在线用户、服务器监控、缓存监控 | 系统监控管理功能 |
| 公共管理 | 接口管理、文档管理 | 项目接口文档 |
🍪 演示环境
- 演示地址：http://service.fastapiadmin.***
- 管理员账号：
admin密码：123456 - 演示账号：
demo密码：123456
👷 安装和使用
版本说明
| 类型 | 技术栈 | 版本 |
|---|---|---|
| 后端 | Python | 3.10（大于3.10的版本, 会有兼容问题, 将来升级，暂时不考虑升级） |
| 后端 | FastAPI | 0.109 |
| 前端 | Node.js | >= 20.0（推荐使用最新版） |
| 前端 | npm | 16.14 |
| 前端 | Vue3 | 3.3 |
| 数据库 | MySQL | 8.0 （推荐使用最新版） |
| 中间件 | Redis | 7.0 （推荐使用最新版） |
获取代码
# 克隆代码到本地
git clone https://gitee.***/tao__tao/fastapi_vue3_admin.git
或
git clone https://github.***/1014TaoTao/fastapi_vue3_admin.git
本地后端启动
# 进入后端工程目录
cd backend
# 安装依赖
pip3 install -r requirements.txt
# 启动后端服务
python3 main.py run
或
python3 main.py run--env=dev
# 生成迁移文件
python3 main.py revision "初始化迁移" --env=dev(不加默认为dev)
# 应用迁移
python3 main.py upgrade --env=dev(不加默认为dev)
本地前端启动
# 进入前端工程目录
cd frontend
# 安装依赖
npm install
# 启动前端服务
npm run dev
# 构建前端, 生成 `frontend/dist` 目录
npm run build
本地访问地址
- 前端地址: http://127.0.0.1:5180
- 接口地址: http://127.0.0.1:8001/api/v1/docs
- 管理员账号：
admin密码：123456 - 演示账号：
demo密码：123456
docker 部署
# 复制脚本 `fastapi_vue3_amdin/start.sh` 脚本文件到服务器, 并赋予执行权限
chmod +x start.sh
# 执行脚本
./start.sh
# 查看镜像:
docsker images -a
# 查看容器:
docsker ***pose ps
# 查看日志
docker logs -f <容器名>
# 服务停止
docsker ***pose down
# 删除镜像
docker rmi <镜像名>
# 删除容器
docker rm <容器名>
# 后端配置文件目录
fastapi_vue3_amdin/backend/env/.env.prod.py
# 前端配置文件目录
fastapi_vue3_amdin/frontend/vite.config.ts
和
fastapi_vue3_amdin/frontend/.env.production
# 部署文件目录
fastapi_vue3_amdin/docker-***pose.yaml
和
fastapi_vue3_amdin/devops/devops/nginx/nginx.conf
🔧 模块展示
| 登陆 | 仪表盘 | 菜单管理 | 部门管理 |
| 岗位管理 | 角色管理 | 用户管理 | 日志管理 |
| 配置管理 | 在线用户管理 | 服务器监控 | 缓存监控 |
| 任务管理 | 字典管理 | 分析管理 | 接口管理 |
| 系统主题 | 在线文档 | 系统锁屏 |
🙏 特别鸣谢
感谢以下项目的贡献和支持，使本项目得以顺利完成：
- FastAPI 项目
- Vue3 项目
- APScheduler 项目
- Vite 项目
❤️ Star 支持我
如果你喜欢这个项目，请给我一个 ⭐️ Star 支持一下吧！非常感谢！
