> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/gu-zhang-pai-chu/bai-ming-dan-bu-sheng-xiao.md).

# 白名单不生效

如果已经添加[ IP 白名单](/huo-qu-yu-pei-zhi-dai-li/ip-bai-ming-dan.md)，但 API 仍无法访问、请求失败或提示无权限，通常表示当前请求 IP 与白名单中的 IP 不一致，或白名单尚未正确生效。

👉 [API 提取方式](/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li/api-ti-qu.md)必须正确配置白名单后才能正常使用。

***

### 🔍 常见表现

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

* 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](/huo-qu-yu-pei-zhi-dai-li/ip-bai-ming-dan.md) 不一致。

***

#### 建议：

重新检查公网 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    |
| 多服务器失败   | 部分服务器未加白名单 |

***

### 🆘 仍未解决？

如果问题仍未解决，请联系官方客服。（[官网](https://www.ipwo.net/)右侧在线客服）

👉 建议提供：

* 当前公网 IP
* 白名单截图
* API 请求结果
* 使用环境（本地 / 云服务器）

***

### 总结

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

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

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

***