Firebase Functions如何获取客户端IP以实现IP白名单访问控制

你获取IP返回undefined的核心原因是你在本地Firebase模拟器环境中测试相关逻辑：Firebase本地模拟器不会主动填充x-forwarded-for请求头，也不会对req.ip字段做赋值，只有部署到正式的云函数线上环境后，这两个字段才会被谷歌云的代理层正确填充。

• 部署到线上环境测试：本地模拟器不支持IP字段填充，所有IP获取逻辑必须部署到线上后再验证
• 优先取x-forwarded-for头解析：线上环境下该字段为逗号分隔的IP链路，最左侧的IP就是真实客户端IP，示例代码如下：

exports.getIP = functions.https.onRequest(async (req, res) => {
  // 解析x-forwarded-for头取第一个IP
  const clientIP = req.headers['x-forwarded-for']?.split(',')[0].trim();
  // 也可以直接用req.ip，底层Express会自动解析上面的头赋值
  // const clientIP = req.ip;

  // 白名单校验逻辑
  const whiteList = ['1.1.1.1', '2.2.2.2']; // 替换成你的白名单IP
  if (!whiteList.includes(clientIP)) {
    return res.status(403).send('IP not allowed');
  }

  res.send(`Your IP is: ${clientIP}`);
});

• 本地测试临时方案：如果需要在本地调试白名单逻辑，可以在发请求时手动给请求头加x-forwarded-for字段，值填你要模拟的客户端IP即可。

内容的提问来源于stack exchange，提问作者Khalifa Alkhatri