elice/python-nginx

Python 3.9.4 + Nginx 1.19.10 镜像文档

镜像概述

本镜像基于 python:3.9.4-buster 构建，整合了 Python 3.9.4 和 Nginx 1.19.10，解决了官方 Python 镜像与 Nginx 镜像之间的 uid/gid 冲突问题，以及 Python 镜像的 locale 编码问题，提供了一个可直接用于部署 Python 应用与 Nginx 服务的一体化环境。

核心功能与特性

版本信息

• Python: 3.9.4
• Nginx: 1.19.10
• NJS (Nginx JavaScript): 0.5.3
• 基础镜像: Debian Buster

关键改进

• 解决 uid/gid 冲突：创建专用 nginx 用户（uid 102，gid 102），避免与 Python 镜像默认用户的 ID 冲突
• 修复 locale 问题：安装 locales 并配置 en_US.UTF-8 编码，解决 Python 环境中的字符编码异常
• 完整 Nginx 模块：包含 xslt、geoip、image-filter、njs 等官方模块
• 日志优化：Nginx 访问日志和错误日志分别重定向到 stdout 和 stderr，适配 Docker 日志收集机制

使用场景与适用范围

• 需同时运行 Python 后端应用（如 Flask、Django）和 Nginx 前端服务的 Web 开发/部署
• Python 应用需要 Nginx 作为反向代理、静态资源服务器的场景
• 需解决容器内用户 ID 冲突或字符编码问题的环境

使用方法与配置说明

基本运行

简单启动

bash
docker run -d -p 80:80 --name python-nginx docker.xuanyuan.run/your-image-name

挂载自定义配置与应用

bash
docker run -d \
  -p 80:80 \
  -v /path/to/nginx/conf:/etc/nginx/conf.d \  # 挂载 Nginx 配置
  -v /path/to/python/app:/app \               # 挂载 Python 应用代码
  --name python-nginx your-image-name

Nginx 配置

Nginx 主配置文件路径：/etc/nginx/nginx.conf
自定义站点配置建议放在：/etc/nginx/conf.d/ 目录（需通过 -v 挂载自定义配置文件）

示例 Nginx 配置（保存为 myapp.conf 并挂载到 /etc/nginx/conf.d/）：

nginx
server {
    listen 80;
    server_name localhost;

    location /static {
        alias /app/static;  # 静态文件目录
    }

    location / {
        proxy_pass http://127.0.0.1:5000;  # 代理到 Python 应用
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Python 应用部署

1. 将 Python 应用代码挂载到容器内（如 /app 目录）
2. 通过 docker exec 进入容器安装依赖：

   bash
   docker exec -it python-nginx pip install -r /app/requirements.txt
   

3. 使用进程管理工具（如 Supervisor）或后台命令启动 Python 应用：

   bash
   docker exec -d python-nginx python /app/app.py
   

环境变量

Docker Compose 示例

yaml
version: '3'
services:
  python-nginx:
    image: docker.xuanyuan.run/your-image-name
    ports:
      - "80:80"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d
      - ./python/app:/app
    command: >
      sh -c "pip install -r /app/requirements.txt &&
             python /app/app.py &
             nginx -g 'daemon off;'"

注意事项

• Nginx 以非 root 用户（uid 102）运行，确保挂载的配置文件和静态资源目录具有适当权限
• Python 应用默认需监听 127.0.0.1 地址，以便 Nginx 反向代理
• 如需修改 Nginx 用户 ID，需重新构建镜像调整 adduser 命令中的 uid/gid 参数