Nginx配置真实IP地址转发的实现示例

更新时间：2024年11月27日 10:55:34 作者：宋发元

在许多web应用程序中,获取客户端的真实 IP 地址非常重要,本文就来介绍一下Nginx配置真实IP地址转发的实现示例,感兴趣的可以了解一下

在许多 web 应用程序中，获取客户端的真实 IP 地址非常重要，尤其是在使用反向代理服务器（如 Nginx）时。本文将指导你如何在 Nginx 中配置 X-Real-IP 和 X-Forwarded-For 头部，以确保你的后端应用能够获取到真实的客户端 IP 地址。

1. 安装 Nginx

如果尚未安装 Nginx，可以使用以下命令进行安装：

# 对于 Ubuntu/Debian 系统
sudo apt update
sudo apt install nginx

# 对于 CentOS/RHEL 系统
sudo yum install epel-release
sudo yum install nginx

2. 配置 Nginx

打开 Nginx 的配置文件，通常路径为 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available/default。使用以下命令打开文件：

sudo nano /etc/nginx/nginx.conf

在 server 块中添加或修改以下内容：

server {
    listen 80;  # 或者 443，取决于你的需求
    server_name your_domain.com;  # 替换为你的域名或 IP 地址

    location / {
        proxy_pass http://your_backend;  # 替换为你的后端服务地址
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;  # 设置 X-Real-IP
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  # 设置 X-Forwarded-For
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

3. 测试配置

在保存配置文件后，确保配置没有错误。使用以下命令进行测试：

sudo nginx -t

如果输出显示没有错误，可以继续进行下一步。

4. 重新加载 Nginx

测试无误后，重新加载 Nginx 配置以使更改生效：

sudo systemctl reload nginx

5. 验证配置

在你的后端应用中，使用以下代码来获取客户端的真实 IP 地址（假设你使用 Go 语言）：

func GetIP(r *http.Request) (string, error) {
    ip := r.Header.Get("X-Real-IP")
    if net.ParseIP(ip) != nil {
        return ip, nil
    }

    ip = r.Header.Get("X-Forwarded-For")
    for _, i := range strings.Split(ip, ",") {
        if net.ParseIP(i) != nil {
            return i, nil
        }
    }

    ip, _, err := net.SplitHostPort(r.RemoteAddr)
    if err != nil {
        return "", err
    }

    if net.ParseIP(ip) != nil {
        return ip, nil
    }

    return "", errors.New("no valid ip found")
}

总结

通过上述步骤，你已经成功配置了 Nginx，以便将客户端的真实 IP 地址转发到后端应用。这样一来，后端应用就可以正确识别访问者的真实 IP 地址了。如果在配置过程中遇到任何问题，可以查看 Nginx 的错误日志以获取更多信息：

sudo tail -f /var/log/nginx/error.log

到此这篇关于Nginx配置真实IP地址转发的实现示例的文章就介绍到这了,更多相关Nginx 真实IP地址转发内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

nginx对http请求处理的各个阶段详析
这篇文章主要给大家介绍了关于nginx对http请求处理的各个阶段分析的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-11-11
Windows 系统下 Nginx 的配置步骤详解
Nginx 是一款功能强大的软件,在互联网领域有广泛应用,简单来说,它就像一个聪明的交通指挥员,能让网站运行得更高效、更稳定,这篇文章主要介绍了Windows系统下Nginx的配置步骤详解,需要的朋友可以参考下
2025-06-06
nginx上传文件大小报错500的解决办法
这篇文章主要介绍了nginx上传文件大小报错解决办法的相关资料,小文件可以提交，大文件会报500内部错误，这里提供解决办法，需要的朋友可以参考下
2017-08-08
详解Nginx配置文件
Nginx是lgor Sysoev为俄罗斯访问量第二的rambler.ru站点设计开发的，Nginx功能丰富，可作为HTTP服务器，也可作为反向代理服务器，邮件服务器。这篇文章主要介绍了Nginx配置文件，需要的朋友参考下
2017-01-01
Nginx中try_files指令的实现示例
try_files是Nginx配置中的一个指令,用于检查文件是否存在,并根据存在情况处理请求,本文就来介绍一下Nginx中try_files指令的实现示例,感兴趣的可以了解一下
2024-10-10
nginx常用基础模块详解
文章详细介绍了Nginx的强大功能及其高度模块化设计,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
2026-03-03
nginx修改上传文件大小限制的方法
本篇文章主要介绍了nginx修改上传文件大小限制的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧。
2016-12-12
Nginx优化和模块解读
本文介绍了Nginx的优化配置与模块应用,涵盖安装、虚拟主机设置、location匹配、隐藏版本号、进程调整、文件限制等操作,并通过实验验证了gzip压缩、缓存优化、防盗链及HTTPS重定向等安全与性能改进措施
2025-07-07
centos环境下nginx高可用集群的搭建指南
为了防止Nginx单点故障造成服务器瘫痪,本文介绍了Nginx实现高可用集群构建,下面这篇文章主要给大家介绍了关于centos环境下nginx高可用集群的搭建指南,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
2022-07-07
Nginx 根据URL带的参数转发的实现
这篇文章主要介绍了Nginx 根据URL带的参数转发的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-09-09