运行在反向代理后的 Express 应用

若设为 true，客户端IP地址将被认定为X-Forwarded-For请求头中最左侧的条目。

若设为 false，表示应用直接面向客户端，客户端IP地址取自 req.socket.remoteAddress。 该值为默认配置。

可配置为一个IP地址、一个子网，或由多个IP地址和子网组成的数组，用于指定可信任的反向代理。 以下列表展示了预配置的子网名称：

• loopback - 127.0.0.1/8, ::1/128
• linklocal - 169.254.0.0/16, fe80::/10
• uniquelocal - 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, fc00::/7

你可通过以下任意方式设置IP地址：

app.set('trust proxy', 'loopback'); // specify a single subnet
app.set('trust proxy', 'loopback, 123.123.123.123'); // specify a subnet and an address
app.set('trust proxy', 'loopback, linklocal, uniquelocal'); // specify multiple subnets as CSV
app.set('trust proxy', ['loopback', 'linklocal', 'uniquelocal']); // specify multiple subnets as an array

指定后，这些IP地址或子网将被排除在地址判定流程之外，最靠近应用服务器的非受信IP将被认定为客户端IP地址。 其工作原理是检查 req.socket.remoteAddress 是否为可信任地址。 若为可信地址，则从右向左检查X-Forwarded-For中的每个地址，直至找到第一个非可信地址。

使用距离 Express 应用不超过 n 个网络跳数的地址。 req.socket.remoteAddress 为第一跳，其余地址从X-Forwarded-For请求头中从右向左查找。 取值为 0 表示：第一个非可信地址就是 req.socket.remoteAddress，即不存在反向代理。

自定义信任实现。

app.set('trust proxy', (ip) => {
  if (ip === '127.0.0.1' || ip === '123.123.123.123')
    return true; // trusted IPs
  else return false;
});

app.set('trust proxy', (ip: string) => {
  if (ip === '127.0.0.1' || ip === '123.123.123.123')
    return true; // trusted IPs
  else return false;
});