在 nginx 中配置代理到 unix 套接字，需要在 proxy_pass 指令中使用以 unix: 开头的特殊 uri 格式。具体做法是将目标路径包裹在双引号中，例如 proxy_pass http://unix/absolute/path/to/socket.sock;。nginx 会忽略主机名部分，直接通过该绝对路径创建 unix domain socket 连接。如果后端服务监听的是相对路径，需确保 nginx 工作目录正确或使用绝对路径以避免歧义。
如何指定具体的 socket 文件路径
要指定具体的 socket 文件路径，只需将 unix: 后的占位符替换为实际的绝对路径即可。关键在于路径必须是绝对的，因为 Nginx 主进程和工作进程可能在不同的上下文中运行。例如，若 Gunicorn 生成的 socket 位于 /tmp/gunicorn.sock，则配置应写为 proxy_pass http://unix:/tmp/gunicorn.sock;。这种写法告诉 Nginx 放弃 DNS 解析和 TCP 端口连接，转而使用本地文件系统上的套接字文件进行通信。
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://unix:/tmp/gunicorn.sock;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
上述配置是标准的 Nginx 片段。当请求到达时，Nginx 会尝试打开 /tmp/gunicorn.sock。如果文件不存在或权限不足，Nginx 将返回 502 Bad Gateway 错误。务必检查操作系统对 /tmp 目录的权限设置，以及运行 Nginx worker 进程的用户（通常是 www-data 或 nginx）是否有读取和写入该 socket 文件的权限。
如何处理多后端负载均衡场景
在负载均衡场景中，可以使用 upstream 块定义多个 UNIX 套接字后端。Nginx 支持在 upstream 中混合使用 TCP 地址和 UNIX 套接字，但通常建议保持类型一致以便管理。定义方式是在 server 指令中使用 unix: 前缀。例如，可以定义一个名为 backend 的上游组，包含两个不同路径的 socket。这种方式允许你将流量分发到同一台机器上不同实例，或者不同机器上通过共享存储挂载的 socket（较少见，通常用于单机多实例）。
upstream backend {
server unix:/var/run/app1.sock;
server unix:/var/run/app2.sock;
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
}
}
此配置展示了如何将请求负载均衡到两个不同的 UNIX 套接字。Nginx 默认使用轮询算法分配请求。需要注意的是，这些 socket 文件必须存在于 Nginx 能够访问的文件系统中。如果后端应用重启导致 socket 文件暂时消失，Nginx 会在下一次请求时重试，期间可能会短暂报错。可以通过 max_fails 和 fail_timeout 参数调整故障转移行为，例如 server unix:/var/run/app1.sock max_fails=3 fail_timeout=30s;，这样可以在连续失败 3 次后，在 30 秒内不再将该节点加入负载均衡池。
proxy_pass 路径重写对 socket 连接有影响吗
配置 proxy_pass 时的 URI 部分不会影响 UNIX 套接字的底层连接建立，但会影响发送给后端应用的 HTTP 请求路径。当使用 proxy_pass http://unix:/path/to/socket; 且没有 trailing slash 时，Nginx 会将客户端请求的完整 URI 传递给后端。如果写成 proxy_pass http://unix:/path/to/socket/;（注意末尾斜杠），Nginx 会尝试去除匹配的位置前缀后再传递。对于 UNIX 套接字，这一行为与 TCP 代理完全一致。例如，若位置是 location /api/，且 proxy_pass 带有尾随斜杠，请求 /api/users 将被转换为 /users 发送给后端。若不带尾随斜杠，则发送 /api/users。后端应用（如 Flask 或 Django）需要根据实际接收到的路径来路由请求。因此，配置的关键不在于 socket 本身，而在于 URL 映射逻辑是否符合后端框架的预期。
