Nginx通过proxy_pass结合upstream keepalive代理Unix Domain Socket可提升吞吐15%–40%、降低P99延迟30%–50%，关键需严格使用http://unix:/path.sock格式、逐层打通目录与socket文件权限、显式配置keepalive连接池并配齐HTTP/1.1头部。
直接用 proxy_pass 指向 Unix Domain Socket（UDS），再配合 upstream keepalive，是单机高并发反向代理场景下最有效的性能组合——实测吞吐提升 15%–40%，P99 延迟下降约 30%–50%，关键在于协议写法、权限对齐、连接复用三者必须同时到位。
必须写对 protocol 前缀和路径格式
UDS 路径不是普通文件路径，Nginx 要求显式声明协议类型，且格式极其严格：
-
正确写法：
proxy_pass http://unix:/run/myapp.sock;—— 必须带http://unix:前缀，路径为绝对路径，末尾有分号，中间无空格 -
常见错误：
proxy_pass unix:/run/myapp.sock;（缺http://）、proxy_pass /run/myapp.sock;（当成普通路径）、proxy_pass http://unix: /run/myapp.sock;（冒号后多空格） - 路径不能含中文、空格或波浪号（
~），也不支持变量（如$document_root）
权限必须逐层打通：目录 + socket 文件 + 用户组
UDS 是文件系统对象，Nginx worker 进程需同时满足三项权限条件：
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
- socket 所在**所有父目录**（如
/run、/run/myapp）对 Nginx 用户（如www-data或nginx）有执行（x）权限，否则无法进入目录 - socket 文件本身（如
/run/myapp.sock）需具备读写（rw）权限，且属组建议与 Nginx 用户一致（例如都属www-data） - 检查命令示例：
sudo -u www-data ls -l /run/myapp.sock；若失败，可设权限为srw-rw----，属组为www-data
启用 keepalive 连接池才能真正复用 UDS
只配 proxy_pass 不启用连接复用，每次请求仍新建/销毁 socket，UDS 的优势完全浪费。必须通过 upstream 显式开启：
- 定义 upstream 块，包含
keepalive N（推荐 16–64）：upstream backend {<br> server unix:/run/myapp.sock;<br> keepalive 32;<br>} - location 中必须引用该 upstream 名：
proxy_pass http://backend;，不可直接写proxy_pass unix:/... - 配套必须加：
proxy_http_version 1.1;和proxy_set_header Connection '';，否则后端可能主动断连
规避启动时的 socket 文件残留与竞争问题
后端服务异常退出后，UDS 文件常未被清理，导致 Nginx reload 失败或返回 502：
- 后端启动脚本中加入清理逻辑：
rm -f /run/myapp.sock && exec gunicorn --bind unix:/run/myapp.sock ... - 用 systemd 的
RuntimeDirectory=或tmpfiles.d提前声明目录，确保每次启动环境干净 - 避免将 socket 放在
/tmp下（易被系统清理），优先使用/run（tmpfs，内存挂载，更安全高效）
