> 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/huan-jing-zhun-bei/bai-ming-dan-yu-ben-ji-ip-shuo-ming.md).

# 白名单与本机IP说明

在使用 [API 提取](/huo-qu-yu-pei-zhi-dai-li/ru-he-huo-qu-dai-li/api-ti-qu.md)代理时，需要正确配置 [IP 白名单](/huo-qu-yu-pei-zhi-dai-li/ip-bai-ming-dan.md)。

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

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

***

### 🌍 什么是[本机公网 IP](/huan-jing-zhun-bei/ru-he-jian-ce-ben-ji-gong-wang-ip.md)？

公网 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

***