0

0

宝塔面板如何配置获取真实IP_宝塔环境PHP获取IP设置【教程】

雪夜

雪夜

发布时间:2026-02-23 11:18:22

|

901人浏览过

|

来源于php中文网

原创

真实ip能否被php正确获取取决于web服务器配置、php信任设置及应用层读取方式;需在nginx中配置set_real_ip_from和real_ip_header,并在php中优先解析x-forwarded-for等头字段。

宝塔面板如何配置获取真实ip_宝塔环境php获取ip设置【教程】

宝塔面板本身不直接处理IP透传,真实IP能否被PHP正确获取,取决于你用的Web服务器(Nginx/Apache)是否配置了反向代理头、PHP是否信任这些头,以及应用层是否用对了获取方式。默认情况下,PHP的 $_SERVER['REMOTE_ADDR'] 拿到的是宝塔前端(比如Nginx)的连接IP,不是用户真实IP——尤其当你用了CDN、负载均衡或反向代理时。

确认你是否处于反向代理链路中

这是前提。如果你的站点直接面向用户(没开CDN、没套SLB、没自己配Nginx反代),那 $_SERVER['REMOTE_ADDR'] 就是真实IP,无需额外配置。但只要经过任何一层代理(包括宝塔自带的Nginx作为静态服务+PHP-FPM分离部署),就极大概率需要透传 X-Forwarded-ForX-Real-IP

  • 常见场景:开了腾讯云/阿里云CDN、用了Cloudflare、自建Nginx反代、宝塔开启“网站重定向”或“反向代理”功能
  • 验证方法:在PHP里打印 print_r($_SERVER),看是否存在 HTTP_X_FORWARDED_FORHTTP_X_REAL_IPHTTP_X_FORWARDED_FOR 等字段,且值看起来像公网IP
  • 注意:CDN厂商可能用不同头名,比如Cloudflare用 HTTP_CF_CONNECTING_IP,腾讯云CDN常用 HTTP_X_REAL_IP

Nginx配置需透传真实IP头

宝塔的Nginx站点配置默认不写透传逻辑,必须手动加。进入「网站」→「设置」→「配置文件」,在 location ~ \.php$ 块**外部**(通常在 server 块内)添加:

set_real_ip_from 127.0.0.1;
set_real_ip_from ::1;
real_ip_header X-Forwarded-For;
real_ip_recursive on;

这段的作用是让Nginx把 X-Forwarded-For 最左的有效IP写入 $remote_addr,后续PHP的 $_SERVER['REMOTE_ADDR'] 才会变成真实IP。关键点:

立即学习PHP免费学习笔记(深入)”;

Rezi.ai
Rezi.ai

一个使用 AI 自动化创建简历平台

下载
  • set_real_ip_from 必须列出所有可信代理IP(如CDN回源IP段、你自己的反代服务器IP),不能只写 0.0.0.0/0,否则会被伪造
  • 如果你用的是腾讯云CDN,要查其官方回源IP段,逐条加进 set_real_ip_from
  • 改完记得「重载配置」,不要只点保存

PHP代码里别硬写 $_SERVER['REMOTE_ADDR']

即使Nginx配置了 real_ip,很多PHP程序(尤其老框架或自写逻辑)仍习惯直接读 $_SERVER['REMOTE_ADDR']。这在没透传时错,在透传后也可能因Nginx未生效而错。更稳妥的方式是按优先级取值:

$ip = $_SERVER['REMOTE_ADDR'] ?? '';
if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
    $ip = $_SERVER['HTTP_X_FORWARDED_FOR'];
} elseif (!empty($_SERVER['HTTP_X_REAL_IP'])) {
    $ip = $_SERVER['HTTP_X_REAL_IP'];
} elseif (!empty($_SERVER['HTTP_CF_CONNECTING_IP'])) {
    $ip = $_SERVER['HTTP_CF_CONNECTING_IP'];
}
// 过滤掉可能的多IP(如 X-Forwarded-For: 1.1.1.1, 2.2.2.2)
$ip = explode(',', $ip)[0];
$ip = trim($ip);

这个逻辑比单纯依赖Nginx更健壮,但前提是你的Nginx确实把头传进来了——如果Nginx没配置 proxy_set_headerHTTP_X_* 就根本不会出现在 $_SERVER 里。

Apache环境要额外加 RewriteRule 和 SetEnvIf

用Apache的用户容易忽略这点:宝塔默认Apache不解析 X-Forwarded-For。你需要在站点根目录的 .htaccess 或虚拟主机配置里加:

SetEnvIf X-Forwarded-For "^.*\..*\..*\..*" proxy-ip
RequestHeader set X-Real-IP %{REMOTE_ADDR}s env=proxy-ip
# 或启用 mod_remoteip 模块(更推荐,但需宝塔编译支持)

不过绝大多数宝塔用户用的是Nginx,Apache下真实IP问题更隐蔽,因为 mod_remoteip 默认不启用,且宝塔界面不提供图形化开关。

最常被忽略的其实是信任边界:Nginx的 set_real_ip_from 如果漏写某个CDN回源段,或者PHP代码无条件取 X-Forwarded-For 而不校验来源,攻击者就能伪造IP绕过限流或风控。真实IP不是“配一下就能有”,而是整个链路(CDN → Nginx → PHP)每一环都得对齐信任策略。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

240

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

518

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

567

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

243

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

563

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3606

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

51

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

67

2026.01.13

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

1030

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.3万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号