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