内容总览

Nginx 安全加固与防护 思维导图

一、起源

1.1 入口层的位置决定了加固价值

Nginx 同时具备两个条件:接触到客户端的原始请求,且能看到后端的真实响应。这带来两方面结果:

  • 针对协议层与传输层的攻击在到达后端之前即可被拦截,代价最低。
  • 配置错误会把内部信息、其他站点的内容或个性化数据暴露给不该看到的请求方。

因此入口层的加固目标是"减少暴露面"与"限制资源占用",而不是替代应用层的身份与权限体系。

1.2 三类风险

风险类别 具体表现 主要成因
信息泄露 版本号、目录结构、备份文件、调试信息、其他站点内容被访问 默认配置未关闭、文件放置在 Web 根目录、默认站点未拦截
资源滥用 连接数耗尽、带宽被占满、后端被大量请求压垮 缺少连接与速率上限、超时设置过长
身份与传输 明文传输、降级到弱协议、身份信息被伪造或泄露 TLS 配置不当、信任了客户端可伪造的请求头

1.3 取舍

加固项之间存在相互制约,需要按业务特性选择:

  • 限流阈值过严会误伤正常用户,过松则无法拦截滥用,阈值应基于实测流量分布确定。
  • 超时过短会中断慢速但正常的客户端,过长则给慢速攻击留出资源占用窗口。
  • HSTS 生效后浏览器在有效期内拒绝降级,回退成本高,应在证书与域名稳定后启用并逐步延长有效期。
  • 安全响应头中的 CSP 需要与应用实际加载的资源一致,配置过严会直接导致页面不可用。

二、原理

2.1 传输安全

TLS 加固围绕三个问题:允许哪些协议版本、允许哪些套件、如何减少握手成本。

  • 协议版本:只保留 TLSv1.2 与 TLSv1.3,禁用 SSLv3、TLSv1.0、TLSv1.1,旧版本存在已知弱点且不再被合规要求接受。
  • 加密套件:TLSv1.3 的套件由协议规定,无法通过配置调整;TLSv1.2 需要显式排除空加密、导出级与仅完整性校验的套件。
  • 证书链:应配置包含中间证书的完整链,缺失中间证书时部分客户端会校验失败,表现为特定环境无法访问而其他环境正常。
  • 会话复用:ssl_session_cache 与 ssl_session_timeout 减少完整握手次数;ssl_session_tickets 使用票据复用,票据密钥由进程维护,多实例部署时需要考虑密钥同步,否则复用率下降。
  • OCSP 装订:ssl_stapling 让 Nginx 直接从 CA 获取吊销状态并随握手返回,避免客户端额外请求;需要配置 ssl_trusted_certificate 提供链信息。
  • HSTS:通过响应头声明后续访问必须使用 HTTPS,防止首次跳转被劫持后的降级。

2.2 信息泄露面

泄露项 默认表现 关闭方式
版本号 响应头 Server: nginx/x.y.z 与错误页脚注 server_tokens off;
目录结构 请求目录路径时列出文件 autoindex off; 并确认未在 location 中开启
隐藏文件 .git、.env、编辑器交换文件可被访问 正则 location 拒绝以点开头的路径
备份与配置文件 .bak、.sql、.conf、.zip 可被下载 排除对应后缀,或把源文件移出 Web 根目录
默认站点内容 未匹配域名时返回默认站点,泄露站内信息 配置默认 server 返回 444 直接断开
错误详情 后端错误页包含堆栈与路径 自定义 5xx 页面,屏蔽后端细节

server_tokens off 只能隐藏版本号,Server: nginx 字段本身仍然存在;彻底移除需要第三方模块,通常不必做到这一步。

2.3 请求解析层的边界

Nginx 在解析请求时执行一组上限检查,这些上限同时是慢速攻击的防线:

维度 相关指令 作用
请求行与单个请求头 large_client_header_buffers 限制单个头的大小与缓冲区数量,超限返回 400 或 414
请求头总大小 client_header_buffer_size 常规头缓冲区大小,超出后使用大缓冲区
请求体大小 client_max_body_size 超限返回 413,避免大体积请求占用磁盘与内存
读取请求的时间 client_header_timeout、client_body_timeout 限制读取阶段的间隔时间,压缩慢速发送的占用窗口
响应发送 send_timeout 限制两次写操作之间的间隔
允许的方法 limit_except 限定某个 location 可用的方法

关于请求走私:当 Content-Length 与 Transfer-Encoding 同时存在且前后端解释不一致时,攻击者可以让一个请求被拆成两个。防护要点是保持入口唯一、避免多层代理对同一请求做不同的规范化处理,并及时更新 Nginx 版本以获得对异常组合的处理修正。

2.4 访问控制与认证

手段 适用场景 限制
allow / deny 按来源地址限制管理入口、内部接口 依赖来源地址可信,经 NAT 或代理时需先还原真实地址
auth_basic 简单的用户名口令保护,如内部工具页面 明文口令经 TLS 传输,无细粒度权限
auth_request 把认证委托给外部服务,可与应用的会话体系一致 需要额外的认证服务与一次子请求开销,且需要编译时启用 --with-http_auth_request_module
internal 限制 location 只能被内部重定向或子请求访问 不校验身份,只阻止外部直接访问
secure_link 带签名与有效期的临时下载链接 需要应用生成签名,密钥需严格管理,且需要编译时启用 --with-http_secure_link_module

要点:allow / deny 的判定依据是 $remote_addr,若请求经过可信前置代理,需要先用 real_ip 模块在可信来源范围内还原客户端地址,否则限制会作用在代理地址上,导致限制失效或误封代理。

2.5 限流与限速

三类手段作用的对象不同:

手段 限制对象 典型指令 超限结果
请求速率 单位时间的请求数 limit_req 默认 503,可配置为 429
并发连接 同时保持的连接数 limit_conn 默认 503,可配置为 429
传输速率 单连接带宽 limit_rate、limit_rate_after 超过部分降速传输,不拒绝

limit_req 的工作方式与参数:

  • rate 决定平均速率,内部的漏桶按固定速率补充请求配额。
  • burst 是允许排队的请求数,超出的请求直接被拒绝。
  • 不带 nodelay 时,突发请求会被延迟到符合平均速率后再处理;带 nodelay 时立即处理但占用配额,适合允许瞬时突发的接口。
  • delay=n 是介于两者之间的形式,前 n 个突发请求立即处理,其余延迟。
  • limit_req_status 应配置为 429,便于与后端错误区分;日志中也需要记录,否则限流表现为无告警的 5xx。

limit_conn 对慢速攻击有效:慢速攻击的特点是连接数多而每连接请求量低,速率限制无法拦截,而并发连接数上限可以直接压缩其占用。

2.6 CC 与爬虫

两类流量的特征不同,处置组合也不同:

类型 特征 处置组合
连接洪泛 大量连接建立后不发送完整请求 limit_conn + 缩短 client_header_timeout
请求洪泛(CC) 单地址或少量地址高频请求特定接口 limit_req + burst + 阈值告警 + 自动封禁
分布式 CC 来源地址分散,单地址速率不高 按 $server_name 或 URL 维度限流,配合日志分析与上游清洗
采集爬虫 遍历大量 URL,速率平稳 校验 User-Agent 与 Referer,或对特定路径限流

判定依据应来自日志统计而非主观判断:状态码分布、来源地址 TOP、单地址访问同一路径的频次见 nginx 访问日志分析与在线监控 第六章。自动封禁由外部工具读取日志执行,避免在 Nginx 内维护动态黑名单。

2.7 安全响应头

响应头 作用 常用取值
Strict-Transport-Security 强制后续使用 HTTPS max-age=31536000; includeSubDomains
X-Content-Type-Options 禁止浏览器猜测内容类型 nosniff
X-Frame-Options 禁止被其他站点嵌入为框架 DENY 或 SAMEORIGIN
Referrer-Policy 控制跳转时携带的来源信息 strict-origin-when-cross-origin
Content-Security-Policy 限制可加载的脚本与资源来源 按实际资源来源逐项声明
Permissions-Policy 限制浏览器特性的可用范围 按需声明,如 geolocation=()

add_header 的重要特性:当同一层级存在其他 add_header 指令或内层的 add_header 时,父层级的响应头不再继承。因此安全响应头应放在所有涉及 add_header 的层级,且通常配合 always 参数保证错误响应也携带。

2.8 跨域

跨域配置需要明确的三个点:

  • Access-Control-Allow-Origin 为 * 时不允许同时携带凭证,需要按来源白名单返回具体值。
  • 预检请求(OPTIONS)需要在 Nginx 直接返回,避免转发到后端产生额外开销。
  • 需要暴露给前端读取的响应头要通过 Access-Control-Expose-Headers 声明,否则前端无法读取自定义头。

2.9 日志与封禁联动

  • 限流与拒绝同样需要记录日志,否则无法从流量侧观察攻击行为;limit_req 触发后的状态码应统一为 429。
  • 自动封禁工具读取访问日志中的高频来源地址并写入防火墙规则,工具用法见 fail2ban。
  • 封禁规则要考虑误封:代理出口地址被大量用户共享,按地址封禁会波及正常用户,需要设置较长的观察窗口与白名单。

三、实现

3.1 安全基线配置

http {
    # 隐藏版本号
    server_tokens off;

    # 请求解析与超时边界,压缩慢速攻击的占用窗口
    client_header_buffer_size    8k;
    large_client_header_buffers  4 16k;
    client_max_body_size         10m;
    client_header_timeout        15s;
    client_body_timeout          30s;
    send_timeout                 30s;
    keepalive_timeout            30s;

    # 限流与并发限制的共享内存区
    limit_req_zone  $binary_remote_addr zone=req_per_ip:10m rate=10r/s;
    limit_conn_zone $binary_remote_addr zone=conn_per_ip:10m;

    # 默认站点:未匹配到 server_name 时直接断开,避免暴露站内信息
    server {
        listen 80 default_server;
        listen 443 ssl default_server;
        server_name _;
        ssl_certificate     /etc/nginx/ssl/default.crt;
        ssl_certificate_key /etc/nginx/ssl/default.key;
        return 444;
    }

    server {
        listen 80;
        server_name www.example.com;

        # 统一的安全响应头
        add_header X-Content-Type-Options nosniff always;
        add_header X-Frame-Options DENY always;
        add_header Referrer-Policy strict-origin-when-cross-origin always;
        add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

        # 隐藏文件与备份文件
        location ~ /\. { deny all; }
        location ~* \.(bak|old|swp|sql|conf|log|zip|tar\.gz)$ { deny all; }

        # 目录浏览显式关闭
        autoindex off;

        # 管理入口限流并限制来源
        location /admin/ {
            allow 10.0.0.0/8;
            deny  all;
            limit_req zone=req_per_ip burst=10 nodelay;
            limit_req_status 429;
            proxy_pass http://backend;
        }

        location /api/ {
            limit_req       zone=req_per_ip burst=20 nodelay;
            limit_conn      conn_per_ip 20;
            limit_req_status 429;
            limit_conn_status 429;

            proxy_set_header Host            $host;
            proxy_set_header X-Real-IP       $remote_addr;
            proxy_set_header X-Forwarded-For $remote_addr;
            proxy_pass http://backend;
        }

        # 下载路径单连接限速
        location /download/ {
            limit_rate_after 10m;
            limit_rate       1m;
            root /data/files;
        }
    }
}

3.2 TLS 配置与验证

server {
    listen 443 ssl;
    listen 80;
    server_name www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.pem;   # 含中间证书的完整链
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;

    ssl_protocols             TLSv1.2 TLSv1.3;
    ssl_ciphers               ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers on;
    ssl_ecdh_curve            X25519:secp256r1;

    ssl_session_cache    shared:SSL:10m;
    ssl_session_timeout  10m;
    ssl_session_tickets  off;                          # 多实例未同步票据密钥时关闭

    ssl_stapling         on;
    ssl_stapling_verify  on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;

    add_header Strict-Transport-Security "max-age=31536000" always;
}

# HTTP 跳转,仅在确认全站可用 HTTPS 后启用
server {
    listen 80;
    server_name www.example.com;
    return 301 https://$host$request_uri;
}
# 语法检查
nginx -t

# 核对协商结果:协议版本、套件、证书链
openssl s_client -connect www.example.com:443 -servername www.example.com </dev/null 2>/dev/null | grep -E 'Protocol|Cipher|Verify Return Code'

# 验证旧协议是否已被拒绝(应失败)
openssl s_client -connect www.example.com:443 -tls1_1 </dev/null 2>&1 | head -3

# 查看证书有效期与主体
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null | openssl x509 -noout -subject -dates

# 验证 HSTS 与安全响应头
curl -sI https://www.example.com/ | grep -iE 'strict-transport-security|x-content-type-options|x-frame-options|referrer-policy'

# 验证默认站点已断开
curl -s -o /dev/null -w "%{http_code}\n" -H 'Host: unknown.example.com' http://127.0.0.1/

3.3 访问控制与认证

# Basic 认证:生成口令文件后引用
location /internal/ {
    auth_basic           "Restricted";
    auth_basic_user_file /etc/nginx/.htpasswd;
    proxy_pass http://backend;
}

# 委托认证:由外部服务返回 2xx 表示通过
location /app/ {
    auth_request /authz;
    error_page 401 = @login_redirect;

    proxy_pass http://backend;
}

location = /authz {
    internal;                               # 只允许内部子请求访问
    proxy_pass              http://authz_service/check;
    proxy_pass_request_body off;
    proxy_set_header        Content-Length "";
    proxy_set_header        X-Original-URI $request_uri;
}

location @login_redirect {
    return 302 /login?next=$request_uri;
}

# 可信代理来源内还原真实客户端地址
set_real_ip_from 10.0.0.0/8;
real_ip_header    X-Forwarded-For;
real_ip_recursive on;
# 生成 Basic 认证口令文件(-c 表示新建,后续追加不要带 -c)
htpasswd -c /etc/nginx/.htpasswd opsuser

# 验证访问控制生效
curl -s -o /dev/null -w "%{http_code}\n" http://www.example.com/admin/
curl -s -o /dev/null -w "%{http_code}\n" -u opsuser:password http://www.example.com/internal/

# 验证内部 location 不可被外部直接访问(应返回 404)
curl -s -o /dev/null -w "%{http_code}\n" http://www.example.com/authz

# 验证隐藏文件与备份文件被拒绝
curl -s -o /dev/null -w "%{http_code}\n" http://www.example.com/.git/config
curl -s -o /dev/null -w "%{http_code}\n" http://www.example.com/config.bak

3.4 限流限速配置与验证

# 验证请求速率限制:连续请求应出现 429
for i in $(seq 1 40); do curl -s -o /dev/null -w "%{http_code}\n" http://www.example.com/api/ping; done | sort | uniq -c

# 验证并发连接限制:并发发起慢请求,观察 429 与连接数
for i in $(seq 1 50); do curl -s -o /dev/null --limit-rate 1k http://www.example.com/download/big.iso & done; wait

# 验证单连接限速生效(观察下载速率被压低)
curl -s -o /dev/null -w "%{speed_download}\n" http://www.example.com/download/big.iso

# 观察限流触发的请求分布
awk '$9==429 {print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head

3.5 响应头与跨域

# 安全响应头(含错误响应)
add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; object-src 'none'; frame-ancestors 'none'" always;
add_header X-Content-Type-Options nosniff always;
add_header X-Frame-Options DENY always;
add_header Referrer-Policy strict-origin-when-cross-origin always;
add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;

# 跨域:按来源白名单返回,不使用通配符配合凭证
location /api/ {
    if ($http_origin ~* '^https://(www\.)?example\.com$') {
        add_header Access-Control-Allow-Origin  $http_origin always;
        add_header Access-Control-Allow-Credentials true always;
        add_header Vary Origin always;
    }

    # 预检请求在 Nginx 直接返回
    if ($request_method = OPTIONS) {
        add_header Access-Control-Allow-Methods "GET, POST, PUT, DELETE, OPTIONS" always;
        add_header Access-Control-Allow-Headers "Content-Type, Authorization" always;
        add_header Access-Control-Max-Age 86400 always;
        return 204;
    }

    proxy_pass http://backend;
}

要点:if 在 location 中属于 rewrite 阶段,上述用法只做响应头设置与提前返回,不涉及 content 阶段指令,因此不违反阶段约束;Vary: Origin 是必需的,否则缓存可能把某个来源的跨域响应返回给其他来源。

3.6 加固核对清单

核对项 期望结果 核对命令
版本号已隐藏 响应头无具体版本 curl -sI http://host/ \| grep -i server
默认站点已断开 未知域名无响应或 444 curl -I -H 'Host: unknown' http://127.0.0.1/
隐藏文件被拒绝 404 或 403 curl -o /dev/null -w '%{http_code}' http://host/.git/config
目录浏览已关闭 目录请求不列文件 curl http://host/uploads/
旧 TLS 协议被拒绝 握手失败 openssl s_client -tls1_1
证书链完整 校验返回 0 openssl s_client ... \| grep 'Verify Return Code'
HSTS 与安全头存在 响应头齐全 curl -sI https://host/
限流已生效 高频请求出现 429 连续请求脚本
请求体上限已设置 超限返回 413 curl -F file=@big.iso http://host/upload
错误页不含后端细节 自定义 5xx 页面 停后端后请求

3.7 常见问题归因

现象 常见原因 核对手段
安全响应头在错误页缺失 add_header 未加 always 用 404 请求验证响应头
安全响应头全部消失 某层级存在其他 add_header,父层不再继承 逐层核对 add_header 所在上下文
限流误伤正常用户 阈值低于真实业务峰值,或按地址限流但用户共享出口 依据日志统计重新核定阈值
限流未生效 共享内存区过小或键取错(如使用了 $remote_addr 但地址被代理覆盖) 核对 *_zone 大小与键变量
访问控制未生效 $remote_addr 实为代理地址 检查 real_ip 配置与可信来源范围
部分客户端无法建立 TLS 连接 证书链缺少中间证书,或协议版本过低被禁用 openssl s_client 核对链与协议
页面在启用 CSP 后白屏 CSP 未覆盖实际资源来源 浏览器控制台查看被拒资源
跨域请求在缓存下返回错误来源的头 未声明 Vary: Origin 核对响应头与缓存配置
HSTS 生效后无法回退到 HTTP 有效期未过,浏览器拒绝降级 等待有效期结束或更换域名

四、总结

  1. 入口层加固的目标是减少暴露面与限制资源占用,身份与权限仍应由应用层承担。
  2. 信息泄露多数来自默认行为:版本号、目录浏览、默认站点、备份文件都需要显式关闭或拦截。
  3. 请求行、请求头与请求体三处大小上限与各类读取超时,是抵御慢速攻击与异常请求的基础配置。
  4. allow / deny 与限流都依赖 $remote_addr,经过可信前置代理时必须先用 real_ip 还原地址,否则限制会失效或误伤。
  5. 限流有三种对象:limit_req 限制请求速率、limit_conn 限制并发连接、limit_rate 限制单连接带宽;limit_conn 是拦截慢速连接洪泛的主要手段。
  6. add_header 的继承规则会导致安全响应头在错误响应或内层 location 中丢失,必须配合 always 使用并逐层核对。
  7. HSTS 与 CSP 的生效代价高,应在证书、域名与资源来源稳定后启用,并保留回退方案。
  8. 攻击行为的发现依赖日志统计,封禁应由外部工具执行,避免在 Nginx 内维护动态黑名单。