白名单不生效

如果已经添加 IP 白名单，但 API 仍无法访问、请求失败或提示无权限，通常表示当前请求 IP 与白名单中的 IP 不一致，或白名单尚未正确生效。

👉 API 提取方式必须正确配置白名单后才能正常使用。

---

🔍 常见表现

出现以下情况时，通常属于白名单未生效：

• API 请求失败

• 返回无权限

• 无法获取代理 IP

• 返回为空

• 明明已添加白名单但仍无法使用

---

⚡ 快速检查（推荐）

请先确认：

• 当前服务器公网 IP

• 白名单中的 IP

• API 请求来源 IP

三者是否一致。

---

🌍 如何查看当前公网 IP？

请访问：

https://ipinfo.io

查看当前公网 IP。

👉 建议复制完整 IP 后再进行白名单配置。

---

🛠 常见原因与解决方法

---

1️⃣ 添加了错误的 IP

这是最常见原因。

很多情况下：

• 本地 IP

• 内网 IP

• 云服务器内网地址

并不是实际请求 API 的公网 IP。

---

正确示例

123.123.123.123

---

错误示例

192.168.x.x
10.x.x.x
172.x.x.x

👉 白名单必须填写公网 IP。

---

2️⃣ 当前网络 IP 已变化

如果使用：

• 家庭宽带

• 动态公网 IP

• 云服务器自动切换 IP

可能导致：

👉 当前请求 IP 与白名单 IP 不一致。

---

建议：

重新检查公网 IP 后更新白名单。

---

3️⃣ 白名单尚未生效

部分情况下：

• 刚添加白名单

• 系统尚未同步

可能需要等待短暂时间。

---

建议：

• 等待几分钟后重试

• 重新请求 API

---

4️⃣ 使用了多个服务器或代理环境

如果：

• API 请求来自不同服务器

• 程序部署在多台机器

• 使用了代理/VPN

可能导致请求 IP 不一致。

---

建议：

确认实际请求 API 的出口 IP。

---

5️⃣ API 请求未从预期服务器发出

部分程序：

• 本地调试

• Docker 环境

• 云函数环境

可能与想象中的出口 IP 不同。

---

建议：

在实际运行环境中访问：

https://ipinfo.io

确认真实出口 IP。

---

⚙️ 白名单配置建议

推荐：

• 使用固定公网 IP

• 使用稳定服务器环境

• 不频繁切换网络

👉 可减少白名单失效问题。

---

💡 使用建议

• 添加白名单后建议立即测试 API

• 推荐直接复制公网 IP

• 不建议填写内网地址

---

❗ 常见问题速查

问题	可能原因
白名单无效	添加了错误 IP
API 无权限	当前 IP 不一致
已添加仍失败	网络 IP 已变化
API 偶尔可用	动态公网 IP
多服务器失败	部分服务器未加白名单

---

🆘 仍未解决？

如果问题仍未解决，请联系官方客服。（官网右侧在线客服）

👉 建议提供：

• 当前公网 IP

• 白名单截图

• API 请求结果

• 使用环境（本地 / 云服务器）

---

总结

白名单不生效通常由以下原因导致：

公网 IP 错误
↓
网络 IP 变化
↓
请求来源不一致
↓
白名单未同步

👉 建议优先确认实际出口公网 IP

---