Repolode
fastapi

fastapi/full-stack-fastapi-template

融合 FastAPI 后端、React 前端、PostgreSQL 与 Docker Compose 的全栈 Web 应用模板。

Star
46,051
Fork
9,153
未关闭 Issue
12
最近提交
6天前

这是什么?

这是一个全栈 Web 应用的起步模板。后端基于 FastAPI,使用 SQLModel 操作 PostgreSQL 数据库,并通过 Pydantic 做数据校验和配置管理。前端采用 TypeScript、React 和 Vite 构建,使用 Tailwind CSS 与 shadcn/ui 组件,并由 FastAPI 与 API 部署在同一域名下提供服务。

模板开箱即带有 JWT 认证、安全的密码哈希、基于邮件的密码找回(邮件模板使用 React Email),以及用于本地测试邮件的 Mailpit。Docker Compose 负责启动本地服务,自托管部署时可用 Traefik 作为反向代理并自动配置 HTTPS。后端使用 Pytest 测试,端到端测试使用 Playwright,CI/CD 基于 GitHub Actions。

使用时点击 “Use this template” 即可创建新仓库。项目提供了 FastAPI Cloud 与 Docker Compose 自托管两种部署方式的文档。

核心功能

  • 01基于 FastAPI 与 SQLModel 的后端,数据存储于 PostgreSQL
  • 02使用 Vite、Tailwind CSS 与 shadcn/ui 构建的 React + TypeScript 前端
  • 03内置 JWT 认证与安全的密码哈希
  • 04基于邮件的密码找回,邮件模板由 React Email 生成
  • 05Docker Compose 配置,配合 Traefik 自动启用 HTTPS
  • 06Pytest 后端测试、Playwright 端到端测试与 GitHub Actions 持续集成部署

适用场景

  • 启动需要 Python 接口与 React 管理后台的新 Web 应用
  • 搭建带用户登录与增删改查页面的管理后台
  • 使用 Docker Compose 与 HTTPS 自托管 Web 应用
  • 将 FastAPI 项目部署到 FastAPI Cloud

快速上手

  1. 1

    点击 Use this template 按钮创建新仓库

  2. 2

    阅读开发文档了解本地工作流和 Docker Compose 配置

使用前须知

  • 标准的本地环境需要 Docker 和 Docker Compose,详见开发文档。

标签

常见问题

full-stack-fastapi-template 是什么?
融合 FastAPI 后端、React 前端、PostgreSQL 与 Docker Compose 的全栈 Web 应用模板。 这是一个全栈 Web 应用的起步模板。后端基于 FastAPI,使用 SQLModel 操作 PostgreSQL 数据库,并通过 Pydantic 做数据校验和配置管理。前端采用 TypeScript、React 和 Vite 构建,使用 Tailwind CSS 与 shadcn/ui 组件,并由 FastAPI 与 API 部署在同一域名下提供服务。
full-stack-fastapi-template 可以免费使用吗?用的什么许可证?
full-stack-fastapi-template 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
full-stack-fastapi-template 还在维护吗?
活跃维护中。full-stack-fastapi-template 最近一次提交是在 2026年10月15日。
full-stack-fastapi-template 适合用来做什么?
启动需要 Python 接口与 React 管理后台的新 Web 应用 搭建带用户登录与增删改查页面的管理后台 使用 Docker Compose 与 HTTPS 自托管 Web 应用 将 FastAPI 项目部署到 FastAPI Cloud
full-stack-fastapi-template 怎么安装和运行?
点击 Use this template 按钮创建新仓库 阅读开发文档了解本地工作流和 Docker Compose 配置
在哪里获取 full-stack-fastapi-template?
源代码和安装说明在 GitHub 上:https://github.com/fastapi/full-stack-fastapi-template

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目