docker 容器内部获取请求真实ip

我整理的一些关于【Docker】的项目学习资料（附讲解～～）和大家一起分享、学习一下：

 https://d.51cto.com/xltfov

如何在 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

• 1.

注释：

• --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();
});

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.

注释：

• 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/

• 1.
• 2.
• 3.
• 4.
• 5.

注释：

• curl -H "X-Forwarded-For: 123.123.123.123"：通过 curl 请求服务器，并在请求头中模拟真实 IP 为 123.123.123.123。

旅行图

我们可以使用 Mermaid 的 journey 语法展示整个过程：

关系图

同样，我们可以使用 Mermaid 的 erDiagram 语法展示相关的数据结构关系：

结尾

获取 Docker 容器中的真实客户端 IP 是一项常见而重要的任务，这在许多基于网络的应用中都非常有用。通过合理设置 Docker 网络选项，以及适当地在你的应用代码中处理 HTTP 头部信息，你可以轻松地实现这一目标。如果你按照以上步骤完成了设置，相信你已经能够在 Docker 容器内成功获取客户端的真实 IP 地址了。希望这篇文章能够帮助你更好地理解这一过程，并能够在实践中运用！

我整理的一些关于【Docker】的项目学习资料（附讲解～～）和大家一起分享、学习一下：

 https://d.51cto.com/xltfov

原创作者: u_16213347 转载于: https://blog.51cto.com/u_16213347/11738769