如何通过源IP控制Xdebug调试会话范围？

DevOps 小满

2026-6-14

指定Xdebug仅对特定IP/IP范围触发调试会话

Xdebug 3.x 配置方案（当前主流版本，推荐使用）

修改你的Xdebug配置文件（通常是php.ini或单独的xdebug.ini），添加或调整以下参数：

关闭客户端自动发现功能，避免任意IP触发调试：
```
xdebug.discover_client_host = 0
```

指定允许触发调试的单个IP、多个IP（逗号分隔）或CIDR格式的IP范围：

# 单个IP示例
xdebug.allowed_hosts = 192.168.1.100
# 多个IP示例
xdebug.allowed_hosts = 192.168.1.100,192.168.1.101
# CIDR网段示例（允许192.168.1.0-255整个网段）
xdebug.allowed_hosts = 192.168.1.0/24

确保调试客户端指向你的本地机器IP（可选，若allowed_hosts已包含该IP可省略）：
```
xdebug.client_host = 你的本地调试IP
```

Xdebug 2.x 配置方案

Xdebug 2.x无直接的IP范围限制参数，需结合以下方式处理：

基础配置关闭自动连接
修改配置文件，关闭远程连接自动发现：
```
xdebug.remote_connect_back = 0
xdebug.remote_host = 你的本地调试IP
```

PHP代码层面限制IP
在项目入口文件（如index.php）开头添加IP判断逻辑，非允许IP直接禁用Xdebug调试：

$allowed_ips = ['192.168.1.100', '192.168.1.0/24'];
$client_ip = $_SERVER['REMOTE_ADDR'];

// 检查IP是否在允许的CIDR网段内
function ip_in_cidr($ip, $cidr) {
    list($subnet, $mask) = explode('/', $cidr);
    $ip_bin = sprintf('%032b', ip2long($ip));
    $subnet_bin = sprintf('%032b', ip2long($subnet));
    return substr($ip_bin, 0, $mask) === substr($subnet_bin, 0, $mask);
}

$is_allowed = false;
foreach ($allowed_ips as $rule) {
    if (strpos($rule, '/') !== false) {
        if (ip_in_cidr($client_ip, $rule)) {
            $is_allowed = true;
            break;
        }
    } else {
        if ($client_ip === $rule) {
            $is_allowed = true;
            break;
        }
    }
}

if (!$is_allowed) {
    ini_set('xdebug.remote_enable', 0);
}