# 认证方式

EProxies 支持两种认证方式,可按网络环境自由选择,二者可同时使用。

## 方式一:账密认证(推荐)

在代理请求中携带用户名和密码,适用于任何网络环境,并且支持通过 [username 参数](https://www.eproxies.io/docs/usage/username-syntax)控制地理定位和会话。

```bash
curl -x proxy.eproxies.net:23333 -U "USERNAME-pool-flow:PASSWORD" https://ipinfo.io
```

* 用户名、密码在控制台「代理设置」页查看。
* username 主体后必须携带 `-pool-flow` 池标识,再按需追加定位/会话参数。
* 密码永远原样使用,所有参数都拼在 username 上。

## 方式二:白名单 IP 认证

将你服务器的出口 IP 添加到白名单后,通过 [API 提取](https://www.eproxies.io/docs/usage/api-extraction)获取 `IP:端口` 列表直连,无需用户名密码。适合出口 IP 固定的服务器环境,以及不便配置代理认证的软件。

**配置步骤**

1. 登录控制台,进入「白名单」页。
2. 点击「添加当前 IP」(页面会自动检测你的出口 IP),或手动录入其他服务器 IP。
3. 白名单生效后,用「API 提取」页生成的链接获取代理列表。

> 白名单条目可随时启用/停用或删除。服务器出口 IP 变化后需要更新白名单,否则提取的代理无法连接。

## 两种方式对比

| | 账密认证 | 白名单认证 |
| --- | --- | --- |
| 适用环境 | 任何环境(含动态出口 IP) | 出口 IP 固定的服务器 |
| 定位/会话控制 | username 参数,粒度最细 | 提取链接参数 |
| 集成难度 | 需支持代理认证 | 免认证,兼容性最好 |
| 典型场景 | 代码调用、指纹浏览器 | 老旧软件、无认证支持的工具 |
