在 server 块中配置 client_header_buffer_size 和 large_client_header_buffers 可实现单站请求头缓冲精细化控制，二者须成对使用、不可置于 location 块内；推荐值为 4k 和 4 8k，适配 jwt 等长请求头场景。

在 Nginx 的 server 块中设置单站的客户端请求头缓冲区，本质是覆盖全局默认值、实现站点级精细化控制。它不依赖 http 块，而是直接在目标 server 内配置，对本域名或 IP 下所有请求生效（除非被更内层 location 覆盖）。

关键指令只有两个，必须成对使用、协同生效：

• client_header_buffer_size
• large_client_header_buffers

---

✅ 正确写法（放在 server 块内）

server {
    listen 443 ssl;
    server_name api.example.com;

    # 单站专属请求头缓冲配置
    client_header_buffer_size 4k;
    large_client_header_buffers 4 8k;

    # 其他配置...
    location / {
        proxy_pass http://backend;
    }
}

⚠️ 注意：这两个指令不能写在 location 块里，Nginx 会报错 directive is not allowed here。

---

? 各参数含义与推荐值

client_header_buffer_size 4k;

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• 每个请求最先分配的缓冲区大小
• 覆盖典型 JWT（~1.5–3KB）、多段 Cookie、基础埋点 Header
• 普通网站用 2k，API 网关或含长 Token 场景建议 4k

large_client_header_buffers 4 8k;

• 当请求头超出 client_header_buffer_size 时，最多启用 4 个缓冲区，每个最大 8k
• 单个请求头必须能放进一个 buffer 中（不能拼接），所以实际支持最大头长度 = 8k
• 不要设 8 16k 这类组合——总容量虽大，但单 buffer 过大会增加 OOM 风险

---

? 常见错误排查点

• 日志出现 400 Bad Request 并带 client sent too large request 或 excess request headers → 缓冲不足
• 设了 client_header_buffer_size 8k 却没配 large_client_header_buffers → 超长头仍失败（扩容逻辑未触发）
• 把参数误写在 location 或 if 块里 → Nginx 启动失败

---

? 补充建议（单站增强）

可搭配以下指令提升健壮性：

client_header_timeout 8s;           # 防慢速头攻击，超时断连
underscores_in_headers off;        # 禁用下划线，防绕过鉴权

这些也支持放在 server 块中，属于单站生效的安全加固项。

不复杂但容易忽略