shinejh0528/nginx

镜像概述

本镜像基于nginx构建，提供便捷的Web服务器部署方案。支持自定义配置文件路径、日志持久化存储，可快速搭建HTTP/HTTPS服务，并支持反向代理配置，适用于开发环境和生产环境的Web服务部署。

核心功能与特性

• 自定义配置：通过环境变量指定nginx主配置文件(nginx_config)和站点配置目录(nginx_sa)路径
• 日志持久化：支持将日志文件存储到宿主机目录，避免容器销毁后日志丢失
• 端口映射：默认开放80(HTTP)和443(HTTPS)端口，支持端口映射到宿主机
• 反向代理支持：内置反向代理配置示例，可对接本地或容器内其他服务
• 便捷管理：支持通过docker exec连接容器进行配置修改和服务管理

使用场景

• 快速部署Web服务器，提供静态文件服务
• 作为反向代理服务器，转发请求到后端应用服务
• 开发环境中快速搭建nginx服务，测试HTTP/HTTPS配置
• 需要自定义nginx配置和日志持久化的场景

使用方法

运行容器命令

bash
docker run -itd -v [data_dir]:[data_dir] -p 80:80 -p 443:443 -e nginx_config=[path_to]/nginx.conf -e nginx_sa=[sa_path] --name [name] shinejh0528/nginx:1.1.0

参数说明：

• -v [data_dir]:[data_dir]：数据卷挂载，用于持久化存储配置文件和日志（替换[data_dir]为宿主机实际目录）
• -p 80:80：HTTP端口映射（宿主机端口:容器端口）
• -p 443:443：HTTPS端口映射（宿主机端口:容器端口）
• -e nginx_config=[path_to]/nginx.conf：指定nginx主配置文件路径（不设置则使用默认路径）
• -e nginx_sa=[sa_path]：指定站点配置目录（site-available）路径（不设置则使用默认路径）
• --name [name]：容器名称（替换[name]为自定义名称）

常用操作

连接容器

通过exec命令进入容器内部：

bash
docker exec -it [name] /bin/bash

（替换[name]为实际容器名称）

配置文件路径

站点配置文件（默认路径）

/etc/nginx/sites-available/default

主配置文件（默认路径）

/etc/nginx/nginx.conf

配置示例：反向代理

以下示例配置两个域名的反向代理，分别转发到不同端口：

nginx
server {
    listen 80;
    server_name xxx1.com;  # 替换为实际域名

    location / {
        proxy_pass http://172.17.0.1:8080;  # Docker容器内访问宿主机使用http://172.17.0.1
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 80;
    server_name xxx2.com;  # 替换为实际域名

    location / {
        proxy_pass http://172.17.0.1:8088;  # Docker容器内访问宿主机使用http://172.17.0.1
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

server {
    listen 443 ssl;
    server_name xxx2.com;  # 替换为实际域名

    # SSL证书配置（替换为实际证书路径）
    ssl_certificate [path].pem;
    ssl_certificate_key [path].key;

    # SSL协议配置
    ssl_protocols TLSv1.2 TLSv1.3;

    # 加密套件配置
    ssl_prefer_server_ciphers on;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass https://172.17.0.1:8088;  # HTTPS反向代理
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

注意：

• 容器内访问宿主机服务时，推荐使用http://172.17.0.1（Docker默认桥接网络网关）
• 本地直接运行时，可使用http://localhost或http://127.0.0.1

日志文件配置

修改nginx配置文件（如nginx.conf），设置日志路径实现持久化：

nginx
access_log /data/nginx/log/access.log;  # 访问日志路径（需确保宿主机挂载了对应目录）
error_log /data/nginx/log/error.log;    # 错误日志路径

重启nginx服务

配置修改后，需重启nginx使配置生效：

bash
service nginx restart