isac322/uvicorn

预安装uvicorn的Python Docker镜像

!https://img.shields.io/docker/pulls/isac322/uvicorn?logo=docker&style=flat-square !https://img.shields.io/docker/image-size/isac322/uvicorn/latest?logo=docker&style=flat-square !https://img.shields.io/pypi/v/uvicorn?label=uvicorn&logo=python&style=flat-square !https://img.shields.io/pypi/pyversions/uvicorn?logo=python&style=flat-square !https://img.shields.io/github/last-commit/isac322/docker_image_uvicorn/master?logo=github&style=flat-square !https://img.shields.io/github/workflow/status/isac322/docker_image_uvicorn/ci/master?logo=github&style=flat-square !https://flat.badgen.net/github/dependabot/isac322/docker_image_uvicorn?icon=github

支持平台：linux/amd64, linux/arm64/v8, linux/386, linux/arm/v7

镜像概述

本镜像为预安装Python ASGI服务器uvicorn的Docker镜像，旨在提供便捷的ASGI应用部署环境。镜像基于官方Python镜像构建，支持多种Python版本和轻量级基础镜像，可根据需求选择不同的uvicorn安装配置，适用于开发和生产环境中快速运行FastAPI、Starlette等ASGI框架应用。

核心功能与特性

• 多Python版本支持：提供Python 3.6、3.7、3.8、3.9版本
• 轻量级基础镜像：支持alpine（极小体积）和slim（精简Debian）两种基础镜像类型
• 灵活的uvicorn配置：提供三种安装选项：
  • essential：基础安装（pip install uvicorn）
  • performance：性能优化版（包含uvloop和httptools）
  • standard：标准完整版（pip install uvicorn[standard]）
• 多平台支持：适配amd64、arm64、386、armv7等架构
• 简化部署：直接以uvicorn为入口点，无需额外配置

使用场景

• 快速部署基于FastAPI、Starlette等ASGI框架的Python Web应用
• 开发环境中快速测试ASGI应用
• 生产环境中运行轻量级ASGI服务
• 需要跨平台部署的Python Web应用

标签格式

镜像标签遵循以下格式：
<Python版本>-<基础镜像类型>-<uvicorn版本>-<uvicorn安装选项>

各部分说明

• Python版本：可选值为py3.9、py3.8、py3.7、py3.6
• 基础镜像类型：可选值为alpine（基于Alpine Linux）或slim（基于精简Debian）
• uvicorn版本：指定uvicorn的版本号
• uvicorn安装选项：
  • essential：基础安装，仅包含uvicorn核心功能
  • performance：性能优化版，包含uvloop==0.15.2（Python 3.7+）和httptools
  • standard：标准完整版，包含所有推荐依赖

别名标签

别名规则

• 可省略Python或uvicorn的最新版本号
• 可省略essential和alpine（默认值）

常用别名示例

• latest == alpine == essential == <最新uvicorn版本> == <最新Python版本>-alpine-<最新uvicorn版本>-essential
• standard == <最新Python版本>-alpine == <最新Python版本>-alpine-<最新uvicorn版本>-standard
• py3.8 == py3.8-alpine == py3.8-essential == py3.8-alpine-essential == py3.8-alpine-<最新uvicorn版本>-essential

使用方法

基本使用

镜像的入口点（Entrypoint）已设置为uvicorn，直接运行容器并指定uvicorn参数即可：

bash
docker run -ti docker.xuanyuan.run/isac322/uvicorn main:app

上述命令等价于在容器内执行uvicorn main:app

工作目录

容器默认工作目录为/app，建议将应用代码挂载到该目录：

bash
docker run -ti -v $(pwd):/app docker.xuanyuan.run/isac322/uvicorn main:app --host 0.0.0.0 --port 8000

指定镜像版本

如需使用特定Python版本和配置：

bash
# 使用Python 3.9、slim基础镜像、standard配置
docker run -ti docker.xuanyuan.run/isac322/uvicorn:py3.9-slim-standard main:app

# 使用Python 3.8、alpine基础镜像、performance配置
docker run -ti docker.xuanyuan.run/isac322/uvicorn:py3.8-alpine-0.23.2-performance main:app

Docker Compose示例

yaml
version: '3'
services:
  web:
    image: isac322/uvicorn:py3.9-slim-standard
    volumes:
      - ./app:/app
    ports:
      - "8000:8000"
    command: main:app --host 0.0.0.0 --port 8000