使用 proxy_pass 配合 Unix Socket 可提升单机反向代理性能，通过绕过 TCP/IP 栈降低开销；需正确配置绝对路径、权限、keepalive 上游及后端协同优化。

用 proxy_pass 配合 Unix Socket（UDS）能显著提升单机反向代理性能，核心在于绕过 TCP/IP 协议栈，减少系统调用和上下文切换开销。实测高并发短连接场景下，吞吐量可提升 20%–40%，延迟下降超 50%。

基础配置：正确指向 socket 文件

必须使用完整协议前缀，路径为绝对路径，且 Nginx 进程有读写权限：

• proxy_pass http://unix:/var/run/myapp.sock; —— 不能省略 http://，也不能写成 unix:/...
• socket 路径建议放在 /run/（tmpfs 内存文件系统），避免磁盘 I/O 和被系统清理
• Nginx worker 用户（如 www-data 或 nginx）需对 socket 文件及其父目录有 x（执行）权限（进入目录）和 rw（读写）权限（操作 socket）

启用 keepalive 连接复用

默认每次请求都新建并关闭 UDS 连接，开销大。必须通过 upstream 块启用长连接：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

• 定义 upstream：
  

  upstream backend {<br>  server unix:/var/run/myapp.sock;<br>  keepalive 32;<br>}

• 在 location 中引用：
  

  proxy_pass http://backend;<br>proxy_http_version 1.1;<br>proxy_set_header Connection '';

• keepalive 值建议设为 16–64；过高可能耗尽文件描述符

关键调试与避坑点

返回 502 Bad Gateway 是最常见问题，通常源于权限或时机问题：

• 检查 socket 是否存在：ls -l /var/run/myapp.sock
• 模拟 Nginx 用户访问：sudo -u www-data ls -l /var/run/myapp.sock
• 确保应用先于 Nginx 启动，或用 systemd 的 After=nginx.service 控制启动顺序
• 不要把 socket 放在 /tmp/ 下——部分系统会定期清理，且权限策略更严格

配合后端服务的协同优化

Unix Socket 性能优势需后端配合才能完全释放：

• Gunicorn、Uvicorn、FastAPI 等应配置为监听 UDS（而非 127.0.0.1:8000），并设置 backlog 足够大（如 2048）
• 后端进程用户与 Nginx worker 用户尽量一致，简化权限管理
• 若后端支持 HTTP/1.1 keepalive，确保其未强制关闭连接（如 Gunicorn 的 --keep-alive 参数）