mirror of https://github.com/fastapiadmin/FastapiAdmin.git synced 2026-09-21 04:46:26 +00:00

Files

T

zhangtao d6c3104f2d chore: upgrade python version to 3.12 and refactor password encryption

This commit upgrades the project's Python base version from 3.10 to 3.12, updates all related dependency versions, replaces bcrypt password hashing with pbkdf2-sha256, refactors the UA parsing library, removes unused dependencies, and fixes related exception handling code.

2026-06-21 06:57:44 +08:00

6.5 KiB

Raw Blame History

FastApiAdmin ^v3.0.0

🚀 追求极致代码质量，五分钟搭建企业级中后台，开箱即用

基于 FastAPI + Vue3 + TypeScript 的全栈快速开发平台，Web / H5 / 小程序一站式交付

简体中文 | English

💡 为什么选择 FastapiAdmin？

你需要的	FastapiAdmin	Django Admin	纯前端模板
🎯 开箱即用的后台系统	✅	⚠️ 功能有限	❌ 只有 UI
⚡ FastAPI 异步高性能后端	✅	❌ 同步为主	❌ 无后端
🔐 RBAC 菜单/按钮/数据三级权限	✅	❌ 基础	❌
🏢 多租户 SaaS 数据隔离 + 配额 + 个性化	✅	❌	❌
🤖 代码生成器（选表 → 出前后端代码）	✅	❌	❌
📱 移动端（H5 + 小程序）一体	✅	❌	❌
🐳 Docker 一键部署（含 Nginx + SSL）	✅	❌	❌

👉 详细技术选型对比：为什么选择 FastapiAdmin？

🍪 在线体验

端	地址	账号
💻 Web 端	service.fastapiadmin.com/web	`admin` / `123456`
📱 移动端	service.fastapiadmin.com/app	`admin` / `123456`
📖 官方文档	service.fastapiadmin.com	无需登录

🚀 5 分钟本地跑起来

# 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 开源协议

📌 内置功能（开箱即用）

模块	包含能力
📊 仪表盘	工作台、数据分析
⚙️ 系统管理	用户 / 角色 / 菜单 / 部门 / 岗位 / 字典 / 配置 / 公告
🏢 多租户	租户管理 / 数据隔离 / 配额控制 / 个性化配置 / 菜单权限
👀 监控管理	在线用户 / 服务器监控 / 缓存监控
📋 任务管理	定时任务调度
📝 日志管理	操作日志审计
🧰 开发工具	代码生成、表单构建、接口文档
📁 文件管理	统一文件管理
🤖 智能体	基于 Agno 的智能体框架