ironclad/nginx-headers-more

ironclad/nginx-headers-more镜像说明

镜像概述

本镜像是基于轻量Alpine Linux的Nginx镜像派生版本，集成了ngx_headers_more模块（来自OpenResty项目），提供比原生Nginx更灵活的HTTP头管理能力，适用于需要自定义请求/响应头的Web服务场景。

核心功能

• 支持添加、修改或删除HTTP请求头（如more_set_input_headers）
• 支持添加、修改或删除HTTP响应头（如more_set_headers）
• 保持Alpine镜像的轻量特性，体积小、启动快
• 兼容Nginx原生配置语法，易于迁移现有服务

使用场景

1. Web服务中添加CORS（跨域资源共享）头信息
2. API网关中调整请求头以满足后端服务要求
3. 静态资源服务中设置缓存控制头（如Cache-Control）
4. 安全加固场景中添加安全相关头（如X-Frame-Options）

配置说明

通过挂载自定义nginx.conf文件来使用ngx_headers_more模块的指令，示例配置片段：

nginx
server {
    listen 80;
    server_name example.com;
    
    # 设置响应头
    more_set_headers "X-Content-Type-Options: nosniff";
    more_set_headers "X-Frame-Options: SAMEORIGIN";
    
    # 清除特定响应头
    more_clear_headers "Server";
    
    location / {
        root /usr/share/nginx/html;
        index index.html;
    }
}

部署示例

Docker Run命令

bash
docker run -d -p 80:80 \
  -v ./nginx.conf:/etc/nginx/nginx.conf \
  -v ./html:/usr/share/nginx/html \
  ironclad/nginx-headers-more

Docker Compose配置

yaml
version: "3"
services:
  nginx:
    image: ironclad/nginx-headers-more
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./html:/usr/share/nginx/html
    restart: always