uds比localhost更快，因其跳过tcp/ip协议栈，避免三次握手、内存拷贝等开销，实测qps提升15%–40%、p99延迟降30%+；配置需用upstream定义unix:/path.sock，proxy_pass指向该upstream，并严格校验权限与socket存在性。
直接用 Unix Domain Socket（UDS）代替 TCP 回环地址（如 127.0.0.1:8080），能让 Nginx 到后端应用的本地转发跳过网络协议栈，减少系统调用和内存拷贝，显著降低延迟、提升吞吐。这不是“可选优化”，而是本机部署时的推荐实践。
为什么 UDS 比 localhost 更快
Unix Domain Socket 是内核级进程间通信机制，不走 TCP/IP 协议栈：
- 没有三次握手、ACK、滑动窗口等开销
- 数据直接在内核内存中传递，避免用户态/内核态多次拷贝
- 无端口争抢、TIME_WAIT 状态、连接复用复杂度
- 实测 QPS 提升 15%–40%，P99 延迟下降 30%+（尤其高并发小包场景）
配置 proxy_pass 使用 UDS 的关键写法
必须配合 upstream 块使用，且路径需为绝对路径，权限要匹配：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
upstream backend { server unix:/run/myapp.sock; }—— 路径必须以unix:开头，后面是完整 socket 文件路径 -
location / { proxy_pass http://backend; }——proxy_pass后必须是http://+ upstream 名，不能写成proxy_pass http://unix:/run/myapp.sock - 确保 Nginx 工作进程（如
www-data或nginx用户）对/run/myapp.sock有读写权限 - socket 文件所在目录（如
/run）也需允许 Nginx 进程访问（常见问题：目录权限为 0755 但属主不是 Nginx 用户）
实际部署中必须检查的三件事
配置写完不等于能跑通，以下检查项缺一不可：
- 确认后端服务已启动并成功创建 socket 文件（
ls -l /run/myapp.sock），且文件存在、非空 - 运行
nginx -t验证语法，再systemctl reload nginx生效；若报错 “no such file or directory”，大概率是路径错或权限不足 - 用
curl -v http://localhost/测试，同时执行sudo ss -xl | grep myapp查看 socket 是否被 Nginx 正确连接
搭配健康检查与容错更可靠
UDS 不支持传统 TCP 心跳，但可通过参数增强健壮性：
- 在 upstream 中添加
max_fails=1 fail_timeout=10s，让 Nginx 在连接失败后快速标记并跳过该 socket - 加上
proxy_next_upstream error timeout http_502 http_503，遇到 socket 拒绝或超时自动重试（适用于多实例 fallback 场景） - 建议后端服务启动时用
chmod 660 /run/myapp.sock && chown nginx:nginx /run/myapp.sock显式授权
