实战 proxy_pass 配合 Unix Domain Socket 与 Keepalive 提升单机转发性能

Nginx通过proxy_pass unix:/path/to.sock配合upstream keepalive可显著提升本地高并发性能，实测吞吐增15%+、P99延迟降30%，但需严格配置协议前缀、权限、连接复用及缓冲参数。 直接用 指向 Unix Domain Socket（UDS）并启用 upstream keepalive，是本地高并发场景下最有效的性能组合——实测吞吐提升 15% 以上，P99 延迟下降约 30%，但配置稍有不慎就会触发 或连接复用失效。 proxy _pass unix :/path/to.sock 必须带 unix: 前缀且路径准确 UDS 路径不是普通文件路径，Nginx 要求显式声明协议类型。漏掉 或多写空格都会导致解析失败，错误日志里通常只报 ，不提具体哪行错。 ✅ 正确，注意末尾分号和无空格 ❌ 缺少 ，Nginx 当作普通域名处理 ❌ 冒号后有空格，解析中断 路径必须绝对，不能用 或环境变量； 等变量在 中不可用 upstream 块里加 keepalive 才能真正复用 UDS 连接 很多人只在 里设 和 ，却忘了 upstream 层必须显式启用连接池——否则每次请求仍会新建/销毁 socket 文件描述符，UDS 的优势全白费。 upstream 必须定义名称，不能直接在 里写 ： 表示每个 worker 最多缓存 32 个空闲 UDS 连接；值太小（如 4）会导致复用率低，太大（如 256）可能耗尽 socket 描述符限制 对应 location 中必须用该 upstream 名： ，不能写成 务必配 和 ，否则后端可能主动断连 权限问题比 TCP 复杂得多，属主/组+文件权限缺一不可 UDS 是文件系统对象，Nginx worker 进程必须同时满足：对 socket 文件有读写权限、与后端服务同属一个 group（常见坑）、且 socket 文件不能被 umask 截断权限。 UNIX技术手册 Unix in a Nutshell, 4th Edition 英文PDF文字版 Unix in a Nutshell同时涵盖了许多重要的、业界标准的开放源码工具 本书还完整地讨论了常用的shell(bash、ksh及tcsh)和重要元素如正则表达式，乃至旧式工具如sed、awk与vi。 Unix不是一个庞大的物体：它是一个综合体，而《Unix技术手册》则是将这一切合并在一起的一本书。 到底unix是什么?原始的unix源码是由sco拥有，unix注册商标是由open group拥有，而领先的仿unix系统则是gnu／linux、mac os x及solaris。这些版本所附的命令与选 下载 检查 socket 属主： 应类似 ，其中 是 Nginx worker 默认用户组 Nginx 配置中确认运行用户： （或对应组），不能是 或 后端启动时需显式设置 socket 权限，例如 Gunicorn 加 ，uWSGI 加 systemd 管理时，在 段加 和 ，避免启动顺序导致权限错乱 proxy_buffering off + tcp_nodelay on 适合低延迟 API 场景 UDS 本身延迟极低，但默认开启的 proxy buffering 和 Nagle 算法反而会引入毫秒级抖动，尤其对小包 JSON 接口明显。 强制流式转发，避免 Nginx 缓存整个响应再发，但要求后端支持 chunked 或明确 禁用 Nagle，让小包立即发出；和 搭配效果更稳 不要设 过大（如 64k），UDS 不需要 TCP 那种大缓冲，4k～8k 足够 禁用 ：它对 UDS 无效，且可能干扰流式响应 真正难的不是写对那几行配置，而是让 Nginx worker、UDS 文件、后端进程三者在权限、生命周期、连接复用策略上严丝合缝——任意一环松动，性能就掉回 TCP loopback 水平。