openeuler/uwsgi

uWSGI | openEuler Docker镜像文档

镜像概述和主要用途

uWSGI是一个开源软件应用，旨在构建完整的托管服务栈，名称源于其最初支持的Web Server Gateway Interface (WSGI)标准。本镜像基于openEuler构建，是官方维护的uWSGI Docker镜像，由openEuler CloudNative SIG负责维护。该镜像可免费使用且无用户速率限制，适用于部署各类Python WSGI应用。

核心功能和特性

• 多架构支持：提供amd64和arm64架构镜像，适配不同硬件环境
• 稳定基础：基于openEuler操作系统构建，确保系统级稳定性和安全性
• 开源免费：完全开源，无使用限制和用户速率限制
• 易于集成：可直接集成到Docker部署流程，支持标准容器编排工具

支持的标签及Dockerfile链接

每个uWSGI镜像标签由uWSGI版本和基础镜像版本组成，具体如下：

使用场景和适用范围

• 部署Python WSGI应用（如Flask、Django等框架开发的Web应用）
• 构建高性能、可扩展的Web服务
• 开发环境与生产环境的一致性部署
• 需要多架构支持的云原生应用场景

使用方法和配置说明

拉取镜像

根据需求选择对应的{Tag}标签拉取镜像：

bash
docker pull openeuler/uwsgi:{Tag}

交互式shell运行

启动容器并进入交互式shell以使用uWSGI：

bash
docker run -it --rm openeuler/uwsgi:{Tag} bash

准备应用

创建工作目录

bash
mkdir /app

创建WSGI入口文件（myapp.py）

python
# /app/myapp.py
def application(environ, start_response):
    status = '200 OK'
    headers = [('Content-type', 'text/plain; charset=utf-8')]
    start_response(status, headers)
    return [b"Hello World from uWSGI!"]

设置非Root用户及权限

为增强安全性，建议使用非root用户运行uWSGI：

创建专用用户和组

bash
groupadd -r uwsgi_group
useradd -r -g uwsgi_group -d /app -s /bin/false uwsgi_user

设置权限

bash
chown -R uwsgi_user:uwsgi_group /app
chmod -R 755 /app

启动uWSGI服务（推荐参数）

基础启动命令

bash
./uwsgi \
  --http-socket :8000 \
  --processes 4 \
  --threads 2 \
  --chdir /app \
  --wsgi-file myapp.py \
  --master \
  --enable-threads \
  --buffer-size 32768 \
  --uid uwsgi_user \
  --gid uwsgi_group

参数说明

问题与反馈

如遇使用问题或需特殊功能支持，请在openeuler-docker-images仓库提交issue或Pull Request。获取帮助也可联系openEuler CloudNative SIG或openEuler社区。