如何在 Docker 容器内部获取请求的真实 IP
当你在使用 Docker 部署应用时，想要获取客户端请求的真实 IP 地址可能会遇到一些挑战。由于 Docker 的网络层，直接在容器内获取 IP 地址可能会被代理和负载均衡器影响。本文将带你逐步实现这一目标。
整个流程
获取请求真实 IP 的流程可以简化为以下几个步骤：
| 步骤 | 描述 |
|---|---|
| 第一步 | 在 Docker 容器中设置正确的网络选项 |
| 第二步 | 使用合适的中间件获取真实 IP |
| 第三步 | 进行代码实现并进行测试 |
接下来，我们将对这几个步骤进行详细的解释和代码示例。
第一步：在 Docker 容器中设置正确的网络选项
Docker 默认使用的是 NAT 网络设置，当你使用 HTTP 代理或负载均衡时，容器内可能无法直接获取到真实的客户端 IP。因此，你需要确保你的容器连接到正确的网络模式。
在 docker run 命令中，你可以使用 --network host 来让容器使用宿主机的网络：
docker run --network host -d your-image-name
注释：
--network host：这个参数使容器共享宿主机的网络栈，从而可以直接访问到宿主机的真实 IP 地址。
第二步：使用合适的中间件获取真实 IP
很多 Web 框架都提供了获取真实 IP 的方法。然而，在使用反向代理或负载均衡器时，你需要特别关注 X-Forwarded-For HTTP 头部。这个头部通常会包含客户端的真实 IP 地址。
以 Node.js 和 Express 为例，你可以使用下面的中间件来获取真实的客户端 IP：
const express = require('express');
const app = express();
app.use((req, res, next) => {
// 获取 'X-Forwarded-For' 头部
const ip = req.headers['x-forwarded-for'] || req.connection.remoteAddress;
console.log(`Client IP: ${ip}`); // 输出客户端的真实 IP
next();
});
注释：
req.headers['x-forwarded-for']：获取 HTTP 头部中的X-Forwarded-For，该标头通常由代理服务器添加。req.connection.remoteAddress：如果没有找到X-Forwarded-For，则直接获取连接的远程 IP 地址。
第三步：进行代码实现并进行测试
上述代码已经实现了获取客户端真实 IP 的逻辑。接下来，你可以启动 Docker 容器并使用 Postman 或任何 HTTP 客户端来测试。
# 启动容器
docker run --network host -p 3000:3000 -d your-image-name
# 测试
curl -H "X-Forwarded-For: 123.123.123.123" http://localhost:3000/
注释：
curl -H "X-Forwarded-For: 123.123.123.123"：通过 curl 请求服务器，并在请求头中模拟真实 IP 为123.123.123.123。
旅行图
我们可以使用 Mermaid 的 journey 语法展示整个过程：
journey
title Docker 获取客户端真实 IP 的旅程
section 步骤
设置 Docker 网络 : 5: 打开
配置中间件 : 4: 中
测试功能 : 5: 完成
关系图
同样，我们可以使用 Mermaid 的 erDiagram 语法展示相关的数据结构关系：
erDiagram
Request {
string id
string headers
}
Client {
string ip
}
Request ||--|{ Client : "发起请求"
结尾
获取 Docker 容器中的真实客户端 IP 是一项常见而重要的任务，这在许多基于网络的应用中都非常有用。通过合理设置 Docker 网络选项，以及适当地在你的应用代码中处理 HTTP 头部信息，你可以轻松地实现这一目标。如果你按照以上步骤完成了设置，相信你已经能够在 Docker 容器内成功获取客户端的真实 IP 地址了。希望这篇文章能够帮助你更好地理解这一过程，并能够在实践中运用！
