如何在Cloudflare环境下模拟客户端IP地址以测试地理定位逻辑？

方案1：利用Cloudflare Workers自定义请求头（测试专用） #

测试阶段可部署Cloudflare Worker，在请求抵达源站前添加或修改Cloudflare原生地理定位相关请求头，以此模拟指定IP的地理信息。注意需给逻辑加上测试环境判断，避免影响生产流量。

示例Worker代码片段：

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  // 通过自定义头标识测试请求
  const isTestRequest = request.headers.get('X-Test-Simulate-IP') === 'enable'
  if (!isTestRequest) return fetch(request)

  // 模拟目标IP及对应地理信息
  const modifiedHeaders = new Headers(request.headers)
  modifiedHeaders.set('CF-Connecting-IP', '8.8.8.8')
  modifiedHeaders.set('CF-IPCountry', 'US')
  modifiedHeaders.set('CF-IPCity', 'Mountain View')

  return fetch(request, { headers: modifiedHeaders })
}

方案2：本地开发用Wrangler模拟请求头 #

使用Cloudflare的wrangler工具启动本地服务，通过wrangler.toml配置模拟请求头，直接在本地验证业务逻辑。

示例配置片段：

[env.test]
dev = { 
  headers = { 
    "CF-Connecting-IP" = "202.102.10.10", 
    "CF-IPCountry" = "CN",
    "CF-IPCity" = "Hefei"
  } 
}

方案3：通过Cloudflare转换规则临时替换IP（仅限测试） #

在Cloudflare控制台的「规则」→「转换规则」中创建测试专用规则：当请求包含特定测试参数（如?test_simulate_ip=xxx）时，修改CF-Connecting-IP及对应地理头。需设置规则优先级，测试完成后及时禁用，避免影响正常流量。

注意事项 #

• 所有模拟操作必须严格限定在测试环境，禁止在生产环境修改Cloudflare原生请求头，否则会破坏正常地理定位逻辑与安全防护。
• 模拟时要保证IP与地理信息的一致性，避免出现逻辑冲突。

内容的提问来源于stack exchange，提问作者Jack Spektor