upstream配置详解

### Nginx Upstream配置详解

#### 一、Upstream模块概述
Nginx的`upstream`模块是实现负载均衡和故障转移的重要组成部分。该模块允许定义一组服务器，这些服务器可以接收来自客户端的请求并处理它们。通过合理的配置，不仅提高了应用程序的服务质量，还增强了系统的可扩展性和可靠性[^1]。

#### 二、基本语法结构
在Nginx配置文件中设置`upstream`非常直观：

upstream 后端服务名称 {
    server IP地址或域名:端口号 权重;
}

这里，“后端服务名称”是一个自定义的名字，在后续的location块里会被引用；而server指令用来指定实际提供服务的具体机器及其权重参数（如果不特别指明，默认值为1），这有助于控制流量分配比例[^2]。

#### 三、常用属性与选项解释
除了简单的定义外，还可以给每个server添加更多特性以优化性能表现：

- `weight`: 设置权值大小，默认情况下所有节点都是平等对待即权值相同；
- `max_fails`: 定义尝试连接失败次数上限之后标记此台主机不可达；
- `fail_timeout`: 当达到最大失败数后暂停的时间长度；
- `backup`: 将某一台或多台设定成备用状态，只有当其他非备份成员全部失效时才会启用它/们；
- `down`: 手动下线某个实例而不必修改整个集群配置[^3]。

#### 四、集成到Server区块内
完成上述准备工作后，就可以把之前创建好的`upstream`对象引入至HTTP上下文中了：

server {
    listen       80;
    server_name  example.com;

    location / {
        proxy_pass http://后端服务名称;
        
        # 下面几行用于传递原始请求头信息给目标服务器
        proxy_set_header Host            $host;
        proxy_set_header X-Real-IP       $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

这段代码片段展示了如何在一个虚拟主机(`server`)内部署代理转发逻辑，并确保必要的头部字段被正确地发送出去以便于下游应用层解析真实访客详情。