FastSoyAdmin 是一套开箱即用的全栈后台管理模板。前端基于 Vue3、Vite7、TypeScript、Pinia 和 UnoCSS 构建，后端采用 FastAPI、Pydantic v2 和 Tortoise ORM，并通过 Redis 加速接口响应。项目内置丰富的主题配置、完整的 RBAC 权限控制、自动化文件路由以及多语言支持，适合作为中后台项目的起步脚手架，也适合用来学习全栈开发的最佳实践。

• 全栈技术栈：后端 FastAPI + Pydantic v2 + Tortoise ORM，前端 Vue3 + Vite7 + TypeScript + Pinia + UnoCSS，前后端均采用主流技术方案。
• 完整的权限体系：基于 RBAC 模型，前后端角色权限严格分离，后端对 API 和按钮级别进行二次鉴权，确保安全可控。
• 日志与审计：内置请求日志和操作日志管理，便于排查问题和审计追踪。
• Redis 缓存加速：集成 fastapi-cache2 + Redis，有效提升接口响应速度。
• 清晰的项目结构：采用 pnpm monorepo 管理，后端分层架构（Router → Controller → CRUD/Model），代码组织清晰易维护。
• 严格的代码规范：前端遵循 SoybeanJS 规范，集成 ESLint + oxlint + simple-git-hooks；后端使用 Ruff + Pyright，保持一致的代码风格。
• TypeScript 全覆盖：支持严格类型检查，提升代码可维护性和开发体验。
• 丰富的主题配置：内置多套主题方案，与 UnoCSS 深度集成，轻松定制界面风格。
• 国际化支持：内置 vue-i18n 多语言方案（中文 / English），一键切换语言。
• 丰富的页面与组件：内置 403、404、500 等异常页面，集成 ECharts、AntV、VChart 等可视化库，以及富文本编辑器、Markdown 编辑器等。
• 移动端适配：响应式布局，完美支持移动端访问。
• Docker 一键部署：提供完整的 Docker Compose 配置（Nginx + FastAPI + Redis），一条命令即可启动全栈服务。

• 在线预览
• 项目文档
• Apifox 接口文档
• GitHub 仓库
• SoybeanAdmin
• FastAPI
• Tortoise ORM

# 克隆项目
git clone https://github.com/sleep1223/fast-soy-admin
cd fast-soy-admin

# 启动全部服务
docker compose up -d

# 查看日志
docker compose logs -f        # 所有服务
docker compose logs -f app    # 仅 FastAPI
docker compose logs -f nginx  # 仅 Nginx
docker compose logs -f web    # 仅前端构建

更新代码后重新部署：

docker compose down && docker compose up -d

环境要求

安装与启动

# 克隆项目
git clone https://github.com/sleep1223/fast-soy-admin
cd fast-soy-admin

# 后端依赖
uv sync  # 或 pdm install / pip install -r requirements.txt

# 前端依赖（请使用 pnpm，项目采用 pnpm monorepo 管理）
cd web && pnpm install

# 启动后端（端口 9999）
python run.py

# 启动前端（端口 9527，新开终端）
cd web && pnpm dev

构建前端

cd web && pnpm build

• 使用 Redis 优化响应速度
• 使用 Docker 部署
• 集成 FastCRUD

欢迎提交 Pull Request 或创建 Issue 来参与项目建设，任何形式的贡献都非常欢迎。

感谢所有为本项目做出贡献的开发者。

本项目基于 MIT © 2024 协议开源，可自由使用与修改，商业使用请保留作者版权信息。作者不对软件的使用承担任何担保或责任。