这个翻译StrongLoop / IBM提供.

相对于英文版的文档,本文档可能已过时。要了解最近的更新,请参阅英文版文档

代理背后的 Express

在代理背后运行 Express 应用程序时,可使用 app.set() 将应用程序变量 trust proxy 设置为下表中所列的某个值。

尽管不设置应用程序变量 trust proxy 该应用程序也不会运行失败,但是它会误将代理的 IP 地址注册为客户机 IP 地址(除非配置了 trust proxy)。

类型
布尔

如果为 true,那么客户机的 IP 地址将用作 X-Forwarded-* 头中最左侧的条目。 如果为 false,那么该应用程序将被视为直接面对因特网,而客户机的 IP 地址则派生自 req.connection.remoteAddress。这是缺省设置。

IP 地址

要信任的 IP 地址、子网或者一组 IP 地址与子网。以下列表显示预先配置的子网名称:

  • loopback - 127.0.0.1/8::1/128
  • linklocal - 169.254.0.0/16fe80::/10
  • uniquelocal - 10.0.0.0/8172.16.0.0/12192.168.0.0/16fc00::/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 地址。

数字

信任来自正面代理服务器的第 n 个中继段,以此作为客户机。

函数

定制信任实现。仅当您知道自己要做什么时,方可使用该选项。

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

设置非 false trust proxy 值会导致三个重大变化:

trust proxy 设置由使用 proxy-addr 包实现。有关更多信息,请参阅其文档。