andrewnk/alpine-nginx-modsec

Alpine Nginx 镜像

镜像概述和主要用途

该镜像基于Alpine Linux构建Nginx，集成多种安全增强组件，旨在提供一个开箱即用的安全Web服务器环境。通过整合ModSecurity、OWASP规则集和GeoIP2等功能，可有效防护常见Web***并增强访问控制能力。

核心功能和特性

• ModSecurity v3：集成ModSecurity v3 Nginx连接器及OWASP Core Rule Set，提供Web应用防火墙(WAF)功能，防护SQL注入、XSS等常见***
• GeoIP2：包含ngx_http_geoip2_module模块及dbip数据库，支持基于IP地址的地理位置识别
• 额外安全特性：内置多项通用安全增强配置
• 可定制化：通过配置文件灵活调整Nginx、ModSecurity及OWASP规则集参数
• 预设页面：包含通用错误页面和维护页面，可直接使用或自定义

使用场景和适用范围

• 需要基础Web安全防护的Web应用部署
• 需实现基于地理位置访问控制的服务
• 希望使用轻量级Alpine环境同时保持安全功能的场景
• PHP应用服务器（默认配置包含PHP相关server block）

使用方法和配置说明

自定义配置

镜像配置文件位于conf目录下，可通过挂载该目录进行自定义：

• ModSecurity配置：conf/modsec目录包含OWASP规则链接及通用ModSecurity设置
• Nginx配置：conf/nginx目录包含Nginx主配置、HTTP及HTTPS配置文件。默认server block针对PHP应用设计，非PHP用户需移除PHP相关块和规则
• OWASP规则集配置：conf/owasp目录包含OWASP Core Rule Set的具体配置

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/your/conf:/etc/nginx/conf \
  --name alpine-nginx \
  alpine-nginx

Docker Compose配置

yaml
version: '3'
services:
  nginx:
    image: alpine-nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./conf:/etc/nginx/conf
    restart: always

错误和维护页面

镜像内置通用错误页面（如404、500等）和维护页面，位于默认站点根目录。可通过修改相关HTML文件自定义页面样式，以匹配网站设计风格。