Web 服务器与网关 / 系统课时

创建 upstream 服务组

创建 upstream 服务组

本课学习如何使用 Nginx upstream 将多个后端实例组织成服务组,并让反向代理按照指定策略分发请求。完成配置后,可以通过访问日志确认请求是否被正确转发到不同后端。

学习目标

  • 理解 upstream 在 Nginx 负载均衡中的职责
  • 掌握定义后端服务组并绑定代理请求的方法
  • 学会通过日志验证请求分发结果

理解 upstream 服务组

upstream 是 Nginx 中描述后端服务器集合的配置块。它将多个应用实例抽象为一个逻辑服务名,proxy_pass 只需要指向这个服务名,Nginx 就会根据负载均衡规则选择具体后端。

例如,一个订单服务运行在多个实例上,客户端只访问网关地址,Nginx 负责把请求分发到不同实例。

Nginx upstream 后端服务组与请求分发关系图

配置 upstream 后端组

upstream 通常放在 http 块中,然后在 server 或 location 中通过代理指向该服务组。下面示例创建三个后端实例,默认使用轮询方式分配请求。

nginx
http {
    upstream order_backend {
        server 10.0.0.11:8080;
        server 10.0.0.12:8080;
        server 10.0.0.13:8080;
    }

    server {
        listen <PORT>;

        location /orders/ {
            proxy_pass http://order_backend;
        }
    }
}

预期结果

text
Nginx 启动后,请求 /orders/ 会被转发到 order_backend 中任意可用实例。

配置中的 upstream 名称只是 Nginx 内部标识,不需要与真实域名一致。修改后需要先执行配置检查,再进行平滑加载。

bash
nginx -t && nginx -s reload

预期结果

text
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

验证请求落点

为了确认负载均衡是否生效,可以让每个后端返回不同标识,例如实例 IP 或主机名,并查看访问结果。

Nginx 访问日志也可以增加 $upstream_addr 字段,记录实际选择的后端地址。

nginx
log_format upstream_log '$remote_addr $request upstream=$upstream_addr status=$status';
access_log /var/log/nginx/access.log upstream_log;

预期结果

text
192.168.1.20 GET /orders/ upstream=10.0.0.12:8080 status=200
192.168.1.20 GET /orders/ upstream=10.0.0.13:8080 status=200

常见配置问题

如果请求始终进入同一个实例,首先检查后端数量是否真实生效,以及是否配置了其他固定策略,例如 ip_hash 或 hash。

如果修改 upstream 后没有变化,需要确认执行的是当前 Nginx 实例的配置文件,并检查 reload 是否成功。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 upstream 服务组

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通