tozd/nginx

tozd/nginx

https://gitlab.com/tozd/docker/nginx

可用镜像地址：

• https://hub.docker.com/r/tozd/nginx
• https://gitlab.com/tozd/docker/nginx/container_registry

镜像继承关系

https://gitlab.com/tozd/docker/base ← https://gitlab.com/tozd/docker/dinit ← tozd/nginx

标签

• ubuntu-trusty: nginx 1.4.6
• ubuntu-xenial: nginx 1.10.3
• ubuntu-bionic: nginx 1.14.0
• ubuntu-focal: nginx 1.18.0
• ubuntu-jammy: nginx 1.18.0
• ubuntu-noble: nginx 1.24.0

卷

• /var/log/nginx: 当LOG_TO_STDOUT未设置为1时，存放日志文件。
• /etc/nginx/sites-volume: 容器提供的站点的Nginx配置文件存放路径。

环境变量

• SET_REAL_IP_FROM: 配置https://nginx.org/en/docs/http/ngx_http_realip_module.html#set_real_ip_from%EF%BC%8C%E5%AE%9A%E4%B9%89%E5%B7%B2%E7%9F%A5%E4%BC%9A%E5%8F%91%E9%80%81%E6%AD%A3%E7%A1%AE%E6%9B%BF%E6%8D%A2%E5%9C%B0%E5%9D%80%E7%9A%84%E5%8F%AF%E4%BF%A1IP%E5%9C%B0%E5%9D%80%E3%80%82%E8%8B%A5%E5%AE%B9%E5%99%A8%E8%BF%90%E8%A1%8C%E5%9C%A8%E5%8F%8D%E5%90%91HTTP%E4%BB%A3%E7%90%86%E4%B9%8B%E5%90%8E%EF%BC%8C%E5%8F%AF%E8%AE%BE%E7%BD%AE%E6%AD%A4%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E9%85%8D%E7%BD%AE%E4%BB%A3%E7%90%86IP%E5%9C%B0%E5%9D%80%EF%BC%8C%E4%BD%BFNginx%E8%83%BD%E6%AD%A3%E7%A1%AE%E8%A7%A3%E6%9E%90%E5%B9%B6%E8%AE%B0%E5%BD%95%E5%AE%A2%E6%88%B7%E7%AB%AFIP%E5%9C%B0%E5%9D%80%E3%80%82
• LOG_TO_STDOUT: 若设置为1，日志将输出到标准输出（可通过docker logs命令查看），而非日志卷。

端口

• 80/tcp: Nginx监听的HTTP端口。

镜像概述

tozd/nginx是提供Nginx HTTP服务器的Docker镜像，基于tozd/dinit构建，支持多种Ubuntu版本，适用于部署和扩展HTTP服务。镜像包含灵活的日志配置、站点配置及反向代理IP解析功能，便于集成到各类Web服务架构中。

核心功能与特性

• 多版本支持：提供多种Ubuntu版本标签，对应不同Nginx版本，满足不同环境需求。
• 日志灵活配置：通过LOG_TO_STDOUT变量控制日志输出位置，支持日志卷存储或标准输出（便于docker logs查看）。
• 站点配置管理：通过/etc/nginx/sites-volume卷挂载自定义站点配置，简化服务配置。
• 反向代理IP解析：通过SET_REAL_IP_FROM变量配置可信代理IP，确保Nginx正确记录客户端真实IP。

使用场景

• 部署静态网站或Web应用的HTTP服务。
• 作为反向代理服务器，转发请求至后端服务。
• 开发或测试环境中快速搭建Nginx服务。
• 需要自定义Nginx配置的Web服务场景。

使用方法与配置示例

基本运行

启动一个基础Nginx服务，使用默认配置：

bash
docker run -d -p 80:80 --name nginx-server docker.xuanyuan.run/tozd/nginx:ubuntu-noble

挂载站点配置

通过卷挂载自定义站点配置文件（将本地./sites目录挂载到/etc/nginx/sites-volume）：

bash
docker run -d -p 80:80 -v $(pwd)/sites:/etc/nginx/sites-volume --name nginx-custom docker.xuanyuan.run/tozd/nginx:ubuntu-noble

配置反向代理IP解析

若Nginx运行在反向代理之后（如Docker Compose中的前端代理），配置可信代理IP（假设代理IP为192.168.1.100）：

bash
docker run -d -p 80:80 -e SET_REAL_IP_FROM=192.168.1.100 --name nginx-proxy docker.xuanyuan.run/tozd/nginx:ubuntu-noble

日志输出到标准输出

设置日志输出到标准输出，便于通过docker logs查看：

bash
docker run -d -p 80:80 -e LOG_TO_STDOUT=1 --name nginx-stdout docker.xuanyuan.run/tozd/nginx:ubuntu-noble

Docker Compose示例

创建docker-compose.yml文件，配置包含自定义站点和日志输出的Nginx服务：

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/tozd/nginx:ubuntu-noble
    ports:
      - "80:80"
    volumes:
      - ./sites:/etc/nginx/sites-volume  # 挂载自定义站点配置
      # - ./logs:/var/log/nginx  # 若不使用LOG_TO_STDOUT，挂载日志卷
    environment:
      - LOG_TO_STDOUT=1  # 日志输出到stdout
      - SET_REAL_IP_FROM=172.17.0.1  # 配置Docker网关为可信代理IP
    restart: unless-stopped

启动服务：

bash
docker-compose up -d