davyinsa/nginx

docker-nginx 镜像文档

镜像概述

docker-nginx是一个基于官方Nginx镜像构建的自定义Nginx镜像，在保留官方Nginx所有功能特性的基础上，仅添加了server_tokens off;配置项。该配置用于禁用Nginx在HTTP响应头中返回服务器版本信息，从而减少服务器信息泄露风险，增强Web服务安全性。

核心功能

• 继承官方特性：完全保留并继承官方Nginx镜像的所有功能，包括HTTP/HTTPS服务、反向代理、负载均衡、URL重写、静态文件服务等核心能力。
• 安全加固配置：默认添加server_tokens off;配置指令，关闭服务器版本信息显示（官方默认配置为on，会在响应头中显示完整版本如nginx/1.25.3），仅保留Server: nginx基础标识。

使用场景

• 生产环境Web服务：需要隐藏服务器版本信息以符合安全合规要求的生产环境Web服务部署。
• 安全敏感场景：对服务器信息泄露敏感的应用场景，如电商平台、企业官网、API服务、***系统等。
• 快速安全部署：希望在不手动修改配置的情况下，快速部署具备基础安全加固（隐藏版本信息）的Nginx服务。

使用方法

基本运行命令

通过以下命令可直接启动容器，映射80端口提供Web服务：

bash
docker run -d --name nginx-server -p 80:80 docker.xuanyuan.run/your-registry/docker-nginx:latest

Docker Compose 配置示例

创建docker-compose.yml文件，可结合自定义静态文件目录或配置文件进行部署：

yaml
version: '3.8'
services:
  nginx:
    image: docker.xuanyuan.run/your-registry/docker-nginx:latest
    container_name: nginx-server
    ports:
      - "80:80"       # HTTP端口映射
      - "443:443"     # 如需HTTPS可添加443端口映射
    volumes:
      - ./html:/usr/share/nginx/html  # 挂载自定义静态文件目录（可选）
      - ./conf.d:/etc/nginx/conf.d    # 挂载自定义站点配置（可选，如需扩展配置）
      - ./ssl:/etc/nginx/ssl          # 挂载SSL证书（如需HTTPS，可选）
    restart: always  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

配置说明

server_tokens off 作用详解

server_tokens是Nginx的核心配置指令之一，控制是否在以下位置显示服务器版本信息：

• HTTP响应头的Server字段（如Server: nginx/1.25.3 vs Server: nginx）
• 错误页面（如404页面底部的版本信息）

本镜像通过在Nginx主配置文件（/etc/nginx/nginx.conf）的http块中添加server_tokens off;指令实现版本隐藏，配置片段示例：

nginx
http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    server_tokens off;  # 本镜像添加的配置项
    # ... 其他默认配置 ...
}

自定义配置覆盖

如需修改或扩展配置，可通过挂载本地配置文件到容器的/etc/nginx/conf.d/目录（推荐）或直接修改/etc/nginx/nginx.conf文件。若自定义配置中包含server_tokens指令，将覆盖本镜像的默认配置（如需维持隐藏版本功能，建议保留server_tokens off;）。

注意事项

• 版本更新：本镜像基于官方Nginx镜像构建，建议定期更新镜像以同步官方安全补丁和版本更新。
• 配置冲突：若通过挂载自定义配置文件（如conf.d目录下的站点配置），需注意避免与主配置中的server_tokens指令冲突。
• HTTPS配置：如需启用HTTPS，需自行准备SSL证书并挂载到容器，同时在配置文件中添加HTTPS相关配置（参考官方Nginx HTTPS配置文档）。