1. 前言
在 Web 应用开发中，我们经常会需要获取用户请求的 IP 地址。但是，在一些场景下，我们并不能够直接获取用户的真实 IP 地址，比如在使用反向代理的情况下，我们只能获取到代理服务器的 IP 地址。
在这种情况下，我们可以通过在 HTTP 头中添加一个额外的字段来获取用户的真实 IP 地址。在这个额外的字段中，我们可以添加一些额外的信息，例如用户请求的协议和端口信息。这个字段在 Hapi.js 框架中被称为 x-forwarded-from，而 x-forwarded-from-hapi 就是一个专门为 Hapi.js 框架开发的包，它可以帮助你轻松地使用 x-forwarded-from。
2. 安装和使用
你可以通过 npm 安装 x-forwarded-from-hapi 包：
npm install x-forwarded-from-hapi
安装之后，在你的 Node.js 项目中引入即可：
-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - ---------------------------------
----- ------ - -------------
----- -----
----- -----------
---
----- -------- ------- -
----- --------------------------------
--------------
------- ------
----- ----
-------- -------- --------- -- -
------ ------- --------
-
---
----- ---------------
-
--------在这个示例中，我们首先引入了 x-forwarded-from-hapi 库，然后将它注册到我们的 Hapi.js 服务器中。接下来，我们创建了一个简单的路由，用来响应根目录的 GET 请求。
可以看出，使用 x-forwarded-from-hapi 非常简单，只需要调用 server.register() 方法即可。
3. 深入了解
在上面的使用示例中，我们简单地介绍了 x-forwarded-from-hapi 的基本用法。接下来，我们将深入了解它的原理和更高级的使用方式。
3.1. 原理
在 Hapi.js 中，x-forwarded-from 是一个由插件 hapi-geo-locate 生成的 HTTP 头。这个头包含了用户访问网站时所使用的协议（HTTP 或 HTTPS）、用户的 IP 地址和端口信息。
当使用反向代理服务器时，反向代理服务器会接受用户的请求，并将请求发送给你的服务器。在这个过程中，反向代理服务器会将用户的真实 IP 地址添加到 x-forwarded-from 头中，然后将这个头发送给你的服务器。
在 Hapi.js 中使用 x-forwarded-from-hapi 插件时，这个插件会检查请求中是否包含了 x-forwarded-from 头，如果包含了，那么它会使用这个头来确定用户的真实 IP 地址。
3.2. 高级用法
除了基本的使用方式之外，x-forwarded-from-hapi 还提供了一些高级用法，例如：
- 可以使用
trustProxy选项来配置哪些代理服务器可以被信任； - 可以使用
headers选项来配置x-forwarded-from头的名称； - 可以使用
protocolHeader选项来配置协议信息所使用的头的名称； - 可以使用
hostHeader选项来配置主机信息所使用的头的名称； - 等等。
下面是一个示例代码，它演示了如何通过 x-forwarded-from-hapi 来使用这些高级选项：
-- -------------------- ---- -------
----- ---- - ----------------
----- -------------- - ---------------------------------
----- ------ - -------------
----- -----
----- -----------
---
----- -------- ------- -
----- -----------------
------- ---------------
-------- -
----------- -----------
-------- ------------------- ---------------------
--------------- -------------
----------- --------
-
---
--------------
------- ------
----- ----
-------- -------- --------- -- -
----- -------- - ---------------------------
----- ------------- - -----------------------
----- -------- - -----------------
----- ---- - ------------------
------ -
---------
--------------
---------
----
--
-
---
----- ---------------
-
--------在这个示例中，我们首先配置了 x-forwarded-from-hapi 插件的选项。这些选项包括了：
trustProxy: 'loopback'：只信任回环地址（127.0.0.1 和 ::1）的代理服务器；headers: ['x-forwarded-for', 'x-forwarded-proto']：使用x-forwarded-for和x-forwarded-proto头来获取用户的真实 IP 地址和协议信息；protocolHeader: 'x-protocol'：使用x-protocol头来获取用户请求所使用的协议；hostHeader: 'x-host'：使用x-host头来获取用户请求所访问的主机地址。
在 server.route() 方法中，我们定义了一个简单的路由，用来响应根目录的 GET 请求。在这个路由的处理函数中，我们使用了 request.info.remoteAddress 属性来获取用户的 IP 地址，使用 request.xForwardedFrom 属性来获取 x-forwarded-from 头的值，使用 request.protocol 属性来获取协议信息，使用 request.info.host 属性来获取访问的主机地址。
通过这个例子，可以看出 x-forwarded-from-hapi 插件非常灵活和强大，它可以让我们轻松地处理复杂的请求和响应。
4. 总结
在本文中，我们介绍了使用 x-forwarded-from-hapi 插件轻松获取用户的真实 IP 地址和其他相关信息的方法。
首先，我们通过一个简单的示例代码演示了如何使用 x-forwarded-from-hapi，然后我们深入了解了 x-forwarded-from-hapi 的原理和更高级的使用方式。
最后，我们总结了本文介绍的内容，并希望通过本文对您有所启发和帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600671198dd3466f61ffe7b2