blackice1414/python395-fastapi

python395-fastapi 镜像文档

镜像概述

python395-fastapi是一个基于Python 3.9.5的FastAPI应用开发与运行环境镜像。该镜像预安装了FastAPI框架及多种常用依赖库，涵盖Web服务、数据库连接、身份认证、数据处理等功能，可快速搭建高性能RESTful API服务。

核心功能与特性

Web框架与服务

• FastAPI 0.65.1：高性能异步Web框架，支持自动生成API文档
• Uvicorn 0.13.4：ASGI服务器，用于运行FastAPI应用
• Pydantic 1.8.2：数据验证与序列化库，提供强类型支持

数据库支持

• SQLAlchemy 1.4.15：ORM框架，支持多种关系型数据库
• PyMySQL 1.0.2：MySQL数据库驱动
• psycopg2 2.8.4：PostgreSQL数据库驱动
• pymongo 3.12.1：MongoDB同步客户端
• motor 2.5.1：MongoDB异步客户端
• SQLAlchemy-Utils 0.38.3：SQLAlchemy扩展工具集

认证与安全

• python-jose 3.0.0：JWT（JSON Web Token）实现
• pyjwt 2.9.0：JWT编码/解码工具
• passlib：密码哈希库，支持多种哈希算法
• bcrypt：密码加密算法库
• oauth2client 4.1.3：OAuth2认证客户端

工具与辅助功能

• requests 2.22.0：HTTP请求库
• pillow 8.2.0：图像处理库
• autopylogger 1.0：日志工具
• py*dome 3.10.1**：加密算法库
• python-multipart 0.0.5：表单数据处理
• shapely 1.8.0：地理空间数据处理
• matrix-client 0.4.0：Matrix协议客户端
• redis 5.0.1：Redis数据库客户端

使用场景与适用范围

• 快速开发RESTful API服务
• 构建微服务架构后端应用
• 开发需要多种数据库支持的应用
• 实现带有身份认证的API接口
• 开发需要处理文件上传、图像处理的Web服务

使用方法与配置说明

基本使用（Docker Run）

bash
# 运行FastAPI应用（假设当前目录包含main.py）
docker run -d -p 8000:8000 -v $(pwd):/app python395-fastapi uvicorn main:app --host 0.0.0.0

Docker Compose配置示例

yaml
version: '3'
services:
  fastapi-app:
    image: python395-fastapi
    ports:
      - "8000:8000"
    volumes:
      - ./app:/app
    environment:
      - DB_URL=mysql+pymysql://user:password@mysql:3306/dbname
      - REDIS_URL=redis://redis:6379/0
      - JWT_SECRET_KEY=your-secret-key
    command: uvicorn main:app --host 0.0.0.0

配置参数说明

应用开发示例

创建main.py文件：

python
from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Item(BaseModel):
    name: str
    price: float

@app.post("/items/")
async def create_item(item: Item):
    return {"item_name": item.name, "item_price": item.price}

@app.get("/")
async def root():
    return {"message": "Hello World from python395-fastapi"}

运行容器后，访问 http://localhost:8000/docs 可查看自动生成的API文档。