白名单与本机IP说明

在使用 API 提取代理时，需要正确配置 IP 白名单。

👉 白名单用于验证请求来源，仅允许指定公网 IP 访问 API。

很多用户配置失败，通常是因为不了解「本机 IP」与「公网 IP」的区别。

---

🌍 什么是本机公网 IP？

公网 IP 是当前网络对外访问时显示的 IP 地址。

API 白名单校验的就是：

👉 当前请求 API 的公网 IP。

---

⚠️ 注意：不是电脑本地 IP

以下属于本地 / 内网 IP：

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

👉 这些不能用于白名单配置。

---

✅ 正确的白名单 IP

正确示例：

123.123.123.123

👉 必须填写公网 IP。

---

🌐 如何查看当前公网 IP？

推荐访问：

https://ipinfo.io

或：

https://api.ipify.org

---

返回示例

123.123.123.123

👉 显示的即为当前公网 IP。

---

⚙️ 为什么 API 需要白名单？

API 提取方式无需用户名和密码认证。

因此：

👉 系统会通过白名单限制可访问 API 的设备。

只有已加入白名单的公网 IP 才允许访问 API。

---

🛠 白名单配置步骤

进入：

用户中心 → IP 白名单

---

配置流程

查看公网 IP
↓
复制公网 IP
↓
添加至白名单
↓
保存配置

---

⚠️ 为什么添加后仍不生效？

常见原因包括：

• 添加了错误 IP

• 当前网络公网 IP 已变化

• 请求来自其他服务器

• 白名单尚未同步

---

🌍 使用服务器时需要注意什么？

如果程序运行在：

• 海外 VPS

• Linux 服务器

• 云服务器

👉 白名单应填写服务器公网 IP，而不是本地电脑 IP。

---

💡 家庭网络用户注意事项

部分家庭宽带：

• 使用动态公网 IP

• 重启网络后 IP 会变化

可能导致：

👉 白名单偶尔失效。

---

建议：

公网 IP 变化后重新更新白名单。

---

⚙️ Docker / 云函数环境说明

部分环境：

• Docker

• 容器服务

• 云函数

实际出口 IP 可能与服务器 IP 不一致。

---

建议：

在实际运行环境中访问：

https://ipinfo.io

确认真实出口 IP。

---

❗ 常见问题

为什么本地测试正常，服务器无法访问 API？

通常是：

👉 服务器公网 IP 未加入白名单。

---

为什么更换网络后 API 失效？

可能原因：

👉 当前公网 IP 已变化。

---

白名单支持填写多个 IP 吗？

支持。

👉 可根据实际业务添加多个公网 IP。

---

🆘 遇到问题怎么办？

如果 API 无法访问：

建议优先检查：

• 当前公网 IP

• 白名单配置

• 请求来源服务器

---

总结

API 白名单校验逻辑：

请求 API
↓
检查公网 IP
↓
匹配白名单
↓
允许访问

👉 白名单中必须填写真实公网 IP

---