| 你需要的 | FastapiAdmin | Django Admin | 纯前端模板 |
|---|---|---|---|
| 🎯 开箱即用的后台系统 | ✅ | ❌ 只有 UI | |
| ⚡ FastAPI 异步高性能后端 | ✅ | ❌ 同步为主 | ❌ 无后端 |
| 🔐 RBAC 菜单/按钮/数据三级权限 | ✅ | ❌ 基础 | ❌ |
| 🤖 代码生成器（选表 → 出前后端代码） | ✅ | ❌ | ❌ |
| 📱 移动端（H5 + 小程序）一体 | ✅ | ❌ | ❌ |
| 🐳 Docker 一键部署（含 Nginx + SSL） | ✅ | ❌ | ❌ |
👉 详细技术选型对比：为什么选择 FastapiAdmin？
| 端 | 地址 | 账号 |
|---|---|---|
| 💻 Web 端 | service.fastapiadmin.com/web | admin / 123456 |
| 📱 移动端 | service.fastapiadmin.com/app | admin / 123456 |
| 📖 官方文档 | service.fastapiadmin.com | 无需登录 |
# 1. 克隆
git clone https://gitee.com/fastapiadmin/FastapiAdmin.git
# 2. 配置环境
cp backend/env/.env.dev.example backend/env/.env.dev
cp frontend/web/.env.development.example frontend/web/.env.development
# 3. 启动后端（首次自动建表 + 初始化数据）
cd backend && uv sync && uv run main.py run --env=dev
# 4. 启动前端
cd ../frontend/web && pnpm install && pnpm run dev
# ✅ 浏览器打开 http://127.0.0.1:5173，用 admin/123456 登录| 环境要求 | |
|---|---|
| Python ≥ 3.12 | Node.js ≥ 20.0 + pnpm |
| MySQL 8.0+ / PostgreSQL 14+ | Redis 6.x / 7.x |
FastapiAdmin/ # Monorepo 全栈工程
├─ backend/ # FastAPI 后端（Pydantic 2.0 + SQLAlchemy + Alembic）
├─ frontend/
│ ├── web/ # Vue3 Web 前端（Element Plus + TypeScript）
│ ├── app/ # UniApp 移动端（H5 + 小程序 + App）
│ └── docs/ # VitePress 文档网站
├─ docker/ # Docker Compose 一键部署（Nginx + SSL）
├─ deploy.sh # 一键部署脚本
└─ LICENSE # MIT 开源协议
| 模块 | 包含能力 |
|---|---|
| 📊 仪表盘 | 工作台、数据分析 |
| ⚙️ 系统管理 | 用户 / 角色 / 菜单 / 部门 / 岗位 / 字典 / 参数 / 公告 / 工单 / 版本 |
| 👀 监控管理 | 在线用户 / 服务器监控 / 缓存监控 |
| 📝 日志管理 | 操作日志审计 |
| 🧰 开发工具 | 接口文档 |
| 模块 | 包含能力 | 裁剪开关 |
|---|---|---|
| 🧩 任务管理 | 定时任务调度 + 可视化工作流编排（内置业务节点） | task |
| 🔧 代码生成器 | 选表 → 生成前后端全量代码 | generator |
| 📁 数据存储 | 统一文件 / 对象存储（SFTP / S3 / OSS / COS / OBS） | storage |
| 🤖 AI 对话 | 基于 Agno 的智能体对话 | ai |
| 💬 内部聊天 | 系统内用户纯文字私聊 / 群聊（WebSocket 实时推送 + 未读角标） | chat |
扩展模块可通过 backend/app/config/setting.py 中的 ENABLED_MODULES 按需启用 / 停用——移除列表项即可，无需删除任何代码或菜单，对应的 REST 接口、WebSocket 端点与初始化逻辑将自动不加载：
# 例如：停用内部聊天与 AI 对话，保留其余扩展模块
ENABLED_MODULES = ["generator", "task", "storage"]- 聊天边界：内部聊天定位为轻量内部沟通，仅支持纯文字消息，不含文件传输、撤回、已读回执、多端同步等 IM 能力；如有强 IM 需求，请对接企业微信 / 钉钉 / 飞书等成熟产品。随时可在
ENABLED_MODULES中移除chat停用。 - 单实例部署：实时功能（内部聊天 WebSocket、定时任务调度器）基于单实例内存连接与本地调度实现，请以单实例方式部署。如需水平扩展，请自行引入 Redis Pub/Sub 或消息队列。
- 密钥安全：所有第三方密钥（AI、云存储等）请配置在
backend/env/.env.*环境变量中，切勿提交到仓库或写入数据库。 - 数据库迁移：正式环境请使用 Alembic 迁移（
uv run alembic upgrade head）管理表结构变更，create_all仅用于首次初始化的兜底。
| 登录 | 仪表盘 | 代码生成 | AI 助手 |
|---|---|---|---|
 |
 |
 |
 |
欢迎提交 Issue / PR！详见 贡献指南。
感谢以下所有给 FastapiAdmin 贡献过代码的 开发者。
如果你觉得项目有用，请给一个 ⭐️ Star 支持！
- 后端：FastAPI · Pydantic · SQLAlchemy · APScheduler
- 前端：Vue3 · TypeScript · Vite · Element Plus
- 移动端：UniApp · Wot Design Uni
- AI：Agno