关于 FastAPI
FastAPI 是用于构建类型化 HTTP API 的 Python 框架。类型注解可驱动验证、序列化、依赖注入和 OpenAPI 文档，其 ASGI 基础也支持异步端点与 WebSocket。
本地 FastAPI 服务通常通过 Uvicorn 等 ASGI 服务器运行。其余环境应跟随实际服务：持久化数据所需的 ORM 数据库、迁移工具，以及异步工作负载需要时才添加的 Worker 或 Broker。
核心能力
- 类型驱动验证
- OpenAPI 文档
- 依赖注入
- 异步 ASGI 端点
- WebSocket
- Pydantic 模型
常见使用场景
- 类型化 REST API
- 移动应用后端服务
- 数据与机器学习服务端点
- 异步集成 API
- 内部 API 平台
FastAPI 环境跟随服务契约
框架本身刻意保持轻量，本地依赖应反映 API 实现，而不是套用固定技术栈。
- Python 与 ASGI 服务器
- 使用锁定的 Python 依赖及 Uvicorn 等 ASGI 服务器运行应用。
- 数据库与迁移
- PostgreSQL 或项目选择的数据库应与 ORM 和迁移工具配套。
- API 客户端与安全来源
- 浏览器客户端、OAuth 重定向或 Webhook 回调测试时可能需要本地域名与 HTTPS。
- Broker 与 Worker（按设计）
- 仅当 API 明确将后台工作卸载时，才使用 Redis、RabbitMQ 或 Worker 进程。
FlyEnv 如何提供帮助
匹配项目运行时
为 FastAPI 选择项目所需的运行时版本。
管理本地服务
仅在项目需要时启动数据库、缓存和其他服务。
保持项目隔离
让不同项目使用各自的版本和服务配置。
配置本地域名
需要时可通过本地域名和 HTTPS 访问项目。
配置本地环境
项目安装请遵循上游官方文档；FlyEnv 负责管理其所需的运行时、数据库、Web 服务器和辅助服务。
- 1按照 FastAPI 官方文档安装项目和依赖。
- 2在 FlyEnv 中选择项目需要的运行时版本。
- 3启动项目配置中指定的数据库服务。
- 4仅在项目需要时启动缓存、搜索或其他辅助服务。
- 5按需配置本地 Web 服务器、域名和 HTTPS。
- 6将相关服务加入启动组，方便重复启动。
准备好本地运行 FastAPI 吗？
使用 FlyEnv 管理本地 FastAPI 环境所需的运行时、数据库、Web 服务器和服务。