openeuler/uwsgi

uWSGI | openEuler Docker镜像文档

镜像概述和主要用途

uWSGI是一个开源软件应用，旨在构建完整的托管服务栈，名称源于其最初支持的Web Server Gateway Interface (WSGI)标准。本镜像基于openEuler构建，是官方维护的uWSGI Docker镜像，由https://gitee.com/openeuler/cloudnative%E8%B4%9F%E8%B4%A3%E7%BB%B4%E6%8A%A4%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E5%8F%AF%E5%85%8D%E8%B4%B9%E4%BD%BF%E7%94%A8%E4%B8%94%E6%97%A0%E7%94%A8%E6%88%B7%E9%80%9F%E7%8E%87%E9%99%90%E5%88%B6%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%83%A8%E7%BD%B2%E5%90%84%E7%B1%BBPython 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

参数说明

问题与反馈

如遇使用问题或需特殊功能支持，请在https://gitee.com/openeuler/openeuler-docker-images%E4%BB%93%E5%BA%93%E6%8F%90%E4%BA%A4issue%E6%88%96Pull Request。获取帮助也可联系https://gitee.com/openeuler/cloudnative%E6%88%96https://gitee.com/openeuler/community%E3%80%82