worker_cpu_affinity仅绑定cpu,不控制内存分配,须配合numactl的--cpunodebind与--membind双参数锁定numa节点;验证需用numastat而非taskset,systemd启动时必须设daemon off和master_process on以确保策略继承。

worker_cpu_affinity 本身不解决跨节点内存访问
很多人误以为配了 worker_cpu_affinity 就能避免 NUMA 延迟,其实它只管 CPU 绑定,完全不管内存从哪块 RAM 分配。Linux 默认的内存分配策略是“本地优先(localalloc)”,但若 Worker 进程被调度到 Node 0 的 CPU,却因内核调度或碎片化从 Node 1 分配页帧,就会触发跨节点访问——实测延迟增加 60–100ns,QPS 下降明显。
验证方式不是看 taskset -cp,而是查 numastat -p PID 的 Node 0 Total 和 Node 1 Total 占比;理想应 >95% 集中在绑定节点。
-
worker_cpu_affinity必须与numactl配合,否则只是“半绑” - Nginx 主进程启动后 fork 出的 Worker 继承父进程的内存策略,所以必须对主进程做
numactl封装 - 若用
worker_cpu_affinity auto,需确认 Nginx 版本 ≥1.19.10,否则 auto 模式不支持多 NUMA 节点自动分段
numactl 启动时必须指定 --cpunodebind 和 --membind
只写 --cpunodebind=0 不够,它只限制 CPU,不锁内存;只写 --membind=0 也不行,可能把进程调度到远端 CPU 上运行。二者必须同时出现,且值一致:
numactl --cpunodebind=0 --membind=0 /usr/sbin/nginx -g 'daemon off;'
双路服务器上若想让一半 Worker 走 Node 0、另一半走 Node 1,不能靠单个 numactl 实现——Nginx 不支持多实例内存亲和混部。可行路径只有两个:
- 拆成两个独立 systemd service,分别用
--cpunodebind=0 --membind=0和--cpunodebind=1 --membind=1启动,监听不同端口或用 upstream 分流 - 写 shell 启动脚本,用
numactl分别拉起两组 Worker(通过nginx -c指定不同配置),再统一用nginx -s reload协同管理
worker_cpu_affinity 掩码写法容易错位,尤其跨 NUMA 节点
比如双路 32 核服务器(Node 0: CPU 0–15,Node 1: CPU 16–31),设 worker_processes 32,有人直接写:
worker_cpu_affinity 1000000000000000 0100000000000000 ...
这是错的——掩码长度必须覆盖全部 32 位,且第 0 位对应 CPU 0,第 16 位对应 CPU 16。正确写法是:
worker_cpu_affinity 0000000000000001 0000000000000010 ... 00000000000000010000000000000000;
更稳妥的是分组写,明确区分节点:
- 前 16 个 Worker 绑 Node 0:用 16 个 32 位掩码,每位只置 Node 0 的 CPU(0–15)
- 后 16 个 Worker 绑 Node 1:每个掩码只置 Node 1 的 CPU(16–31),例如
00000000000000010000000000000000表示 CPU 16 - 若用
auto模式,必须配合worker_processes显式设为每节点核心数(如 16),否则 auto 可能跨节点均匀排布
systemd 里改 ExecStart 容易漏掉 daemon on / master_process 配置
很多人在 /etc/systemd/system/nginx.service.d/override.conf 里只改了 ExecStart,却忘了 Nginx 默认是 daemon on,而 numactl 启动后若主进程后台化,子进程会丢失 numactl 的内存策略继承。
必须显式关闭 daemon,并确保 master 进程常驻:
[Service] ExecStart= ExecStart=/usr/bin/numactl --cpunodebind=0 --membind=0 /usr/sbin/nginx -g 'daemon off; master_process on;'
注意三点:
- 第一行
ExecStart=是清空默认命令的必要写法,缺了就无效 -
daemon off是关键,否则 Worker fork 后脱离控制,numactl策略不继承 -
master_process on保证热重载(nginx -s reload)仍可用,否则只能 kill + restart
NUMA 优化最易被忽略的,是内存策略无法靠 Nginx 自身配置透传到子进程——它本质是个外部约束,必须从启动源头卡死,且每一步(掩码位序、numactl 参数、systemd 语义)都容错率极低。











