> 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/kai-fa-zhe-wen-dang/api-shi-yong-zhi-nan/ren-zheng-fang-shi-shuo-ming.md).

# 认证方式说明

IPWO 支持 [**用户名密码认证**](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi/yong-hu-ming-mi-ma-ren-zheng.md) 和 **IP 白名单认证** 两种方式。您可以根据业务场景选择适合的认证方式。

***

### 一、用户名密码认证（推荐）

用户名密码认证是最常用的连接方式，适用于：

* API 调用
* 数据采集
* 浏览器配置
* 云服务器部署
* 动态 IP 环境

代理信息示例：

```
Host:
us.ipwo.net

Port:
7878

Username:
username_custom_zone_us

Password:
password
```

***

#### cURL 示例

```bash
curl -x http://us.ipwo.net:7878 \
-U username_custom_zone_us:password \
http://ipinfo.io
```

***

#### 优势

* 配置简单
* 支持动态网络环境
* 支持多台服务器同时使用
* 兼容大部分开发语言和工具

***

### 二、[IP 白名单](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi/api-dong-tai-huo-qu-jin-dong-tai-dai-li.md#di-yi-bu-pei-zhi-ip-bai-ming-dan)认证

IP 白名单认证通过授权服务器公网 IP 的方式完成身份验证，无需在代码中填写用户名和密码。

适用于：

* 固定 IP 服务器
* 企业内部系统
* 长期运行项目

***

#### 配置流程

```
获取服务器公网 IP
↓
添加到白名单
↓
等待生效
↓
开始使用代理
```

***

#### 白名单示例

```
203.0.113.10
```

将服务器公网 IP 添加到控制台白名单后即可使用。

***

#### 优势

* 无需在代码中存储密码
* 便于服务器统一管理
* 适合长期部署项目

***

### 三、如何选择？

| 场景          | 推荐认证方式 |
| ----------- | ------ |
| 本地开发测试      | 用户名密码  |
| 云服务器部署      | 用户名密码  |
| 动态公网 IP     | 用户名密码  |
| 固定公网 IP 服务器 | IP 白名单 |
| 企业内部系统      | IP 白名单 |

对于大多数开发者，推荐优先使用 **用户名密码认证**。

***

### 四、常见问题

#### [407 Proxy Authentication Required](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/407-proxy-authentication-required.md)

通常是：

* 用户名错误
* 密码错误
* Zone 参数错误
* 白名单未生效

***

#### [白名单不生效](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/bai-ming-dan-bu-sheng-xiao.md)

请检查：

* 添加的是公网 IP 而非内网 IP
* 当前服务器 IP 是否发生变化
* 是否等待白名单同步完成

***

#### 用户名密码正确但无法连接

建议：

* 使用 curl 测试
* 检查网络环境
* 确认代理套餐状态正常

***

### 相关文章

* [获取代理信息](/kai-fa-zhe-wen-dang/kuai-su-kai-shi/huo-qu-dai-li-xin-xi.md)
* [白名单不生效](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/bai-ming-dan-bu-sheng-xiao.md)
* [407 Proxy Authentication Required](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/407-proxy-authentication-required.md)
* [如何检测代理是否生效](/dai-li-jian-ce-yu-yin-si-an-quan/ru-he-jian-ce-dai-li-shi-fou-sheng-xiao.md)
* [如何快速定位问题](/kai-fa-zhe-wen-dang/chang-jian-cuo-wu/ru-he-kuai-su-ding-wei-wen-ti.md)

> 推荐先使用用户名密码认证完成测试，确认代理正常后再根据业务需求切换到 IP 白名单认证。