修复 WordPress 使用腾讯云 EdgeOne 导致评论获取不到正确 IP 的问题

问题背景

最近在将 WordPress 网站接入腾讯云 EdgeOne 加速服务后，发现了一个令人困扰的问题：所有评论者的 IP 地址都显示为 EdgeOne CDN 节点的 IP，而不是用户的真实 IP。这不仅影响了评论归属地的正确显示，也给网站管理带来了不便。

效果预览

问题根源分析

当用户访问经过 EdgeOne 加速的 WordPress 站点时，网络请求的流向是这样的：

用户真实 IP → 腾讯云 EdgeOne CDN → WordPress 服务器

在这个过程中，WordPress 默认只能获取到最后一个连接点的 IP 地址，也就是 EdgeOne CDN 节点的 IP，而不是原始用户的真实 IP。

解决方案

EdgeOne 和其他主流 CDN 服务一样，会通过特定的 HTTP 头部来传递用户的真实 IP 信息。我们需要修改 WordPress 代码来正确读取这些头部信息。

核心修复代码

将以下代码添加到您的主题 functions.php 文件中：

<?php

/**
 * 获取真实访客 IP 地址
 * 修复 EdgeOne CDN 导致的 IP 获取问题
 */
function get_real_user_ip() {
    $ip_keys = array(
        'HTTP_X_FORWARDED_FOR',    // 标准代理头部
        'HTTP_X_REAL_IP',          // Nginx 真实 IP
        'HTTP_CF_CONNECTING_IP',   // Cloudflare
        'HTTP_TRUE_CLIENT_IP',     // Akamai & EdgeOne
        'HTTP_X_CLIENT_IP',        // 其他代理
        'HTTP_CLIENT_IP',          // 客户端 IP
    );
    
    foreach ($ip_keys as $key) {
        if (!empty($_SERVER&#91;$key&#93;)) {
            // 处理多个 IP 的情况（如 X-Forwarded-For: client, proxy1, proxy2）
            $ip_list = explode(',', $_SERVER&#91;$key&#93;);
            $ip = trim($ip_list&#91;0&#93;); // 取第一个 IP（最原始的用户 IP）
            
            // 验证 IP 格式，排除私有 IP 和保留 IP
            if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
                return $ip;
            }
        }
    }
    
    // 回退到服务器直接记录的 IP
    return isset($_SERVER&#91;'REMOTE_ADDR'&#93;) ? $_SERVER&#91;'REMOTE_ADDR'&#93; : '127.0.0.1';
}

/**
 * 修改评论提交时的 IP 地址为真实 IP
 */
function update_comment_author_ip($commentdata) {
    $real_ip = get_real_user_ip();
    
    // 如果获取到有效的真实公网 IP，替换评论数据中的 IP
    if ($real_ip && $real_ip !== '127.0.0.1' && filter_var($real_ip, FILTER_VALIDATE_IP)) {
        $commentdata&#91;'comment_author_IP'&#93; = $real_ip;
    }
    
    return $commentdata;
}
// 在 WordPress 处理评论数据之前拦截并修改 IP
add_filter('preprocess_comment', 'update_comment_author_ip');

?>

核心代码详解：

🔧 1. get_real_user_ip() 函数

这个函数负责从多个可能的 HTTP 头部中提取用户的真实 IP：

• HTTP_X_FORWARDED_FOR：最常用的代理 IP 头部
• HTTP_TRUE_CLIENT_IP：EdgeOne 和 Akamai 使用的专用头部
• HTTP_X_REAL_IP：Nginx 等服务器的真实 IP 头部
• 其他备用头部确保兼容性

函数会逐个检查这些头部，找到第一个有效的公网 IP 地址。

function get_real_user_ip() {
    $ip_keys = array(
        'HTTP_X_FORWARDED_FOR',    // 最常用的代理IP头
        'HTTP_X_REAL_IP',          // Nginx等服务器的真实IP头
        'HTTP_CF_CONNECTING_IP',   // Cloudflare CDN
        'HTTP_TRUE_CLIENT_IP',     // Akamai和EdgeOne CDN
        'HTTP_X_CLIENT_IP',        // 其他代理服务器
        'HTTP_CLIENT_IP',          // 客户端IP头
        'HTTP_X_CLUSTER_CLIENT_IP', // 集群客户端IP
    );
    
    foreach ($ip_keys as $key) {
        if (!empty($_SERVER[$key])) {
            $ip_list = explode(',', $_SERVER[$key]);
            $ip = trim($ip_list[0]); // 取第一个IP（最原始的用户IP）
            
            // 验证IP格式，排除私有IP和保留IP
            if (filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE)) {
                return $ip;
            }
        }
    }
    
    // 回退到服务器直接记录的IP
    return isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : '127.0.0.1';
}

🔧 2. update_comment_author_ip() 函数

这个函数通过 WordPress 的 preprocess_comment 过滤器，在评论数据保存到数据库之前，将 CDN IP 替换为真实用户 IP。

function update_comment_author_ip($commentdata) {
    $real_ip = get_real_user_ip();
    
    // 如果获取到有效的真实公网IP，替换评论数据中的IP
    if ($real_ip && $real_ip !== '127.0.0.1' && filter_var($real_ip, FILTER_VALIDATE_IP)) {
        $commentdata['comment_author_IP'] = $real_ip;
    }
    
    return $commentdata;
}
// 在WordPress处理评论数据之前拦截并修改IP
add_filter('preprocess_comment', 'update_comment_author_ip');

技术原理：

🌐 支持的CDN/代理头部

• X-Forwarded-For - 标准代理头部
• X-Real-IP - Nginx等服务器的真实IP
• CF-Connecting-IP - Cloudflare专用
• True-Client-IP - Akamai和EdgeOne专用
• X-Client-IP - 其他代理服务
• Client-IP - 备用头部
• X-Cluster-Client-IP - 集群环境

🔒 安全验证

• IP格式验证：使用 filter_var() 验证IP格式
• 排除私有IP：FILTER_FLAG_NO_PRIV_RANGE 排除 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16
• 排除保留IP：FILTER_FLAG_NO_RES_RANGE 排除其他保留IP段
• 本地IP回退：如果是 127.0.0.1 则使用原始IP

💾 修改后数据流向

用户真实IP → CDN/代理 → HTTP头部 → get_real_user_ip() → update_comment_author_ip() → WordPress数据库

验证修复效果

修复后，您可以通过以下方式验证效果：

• 前台评论显示：查看新评论的 IP 归属地是否正确
• 后台评论列表：在 WordPress 后台查看评论的 IP 地址
• 数据库检查：直接查看 wp_comments 表中的 comment_author_IP 字段

注意事项

• 安全性：代码已经包含了 IP 地址的验证，防止伪造 IP 攻击
• 兼容性：支持多种 CDN 服务，不仅限于 EdgeOne
• 性能：IP 验证逻辑轻量，不会影响网站性能
• 更新维护：建议定期检查代码兼容性，特别是在 WordPress 核心更新后

总结

通过这个简单的代码修复，我们成功解决了 WordPress 在腾讯云 EdgeOne CDN 环境下无法获取用户真实 IP 的问题。这个方案具有很好的通用性，同样适用于其他 CDN 服务如 Cloudflare、阿里云 CDN 等。

关键点在于理解 CDN 的工作原理，并通过正确的 HTTP 头部来获取原始用户信息。希望这篇文章能帮助到遇到同样问题的 WordPress 用户。

建议：在生产环境部署前，请在测试环境充分验证代码的稳定性和兼容性。