白名单添加后还需要账号密码吗？动态住宅 API 返回 IP:端口怎么用
白名单和账号密码是两套认证逻辑。白名单校验发起请求的出口 IP，适合固定服务器和动态住宅 API 接入；账号密码校验 username/password，更适合多人、多设备或出口经常变化的环境。动态住宅 API 返回的 IP:端口应填进程序作为代理入口，不是白名单对象。排查时先确认认证方式，再核对出口 IP、协议、端口和程序字段。
白名单添加后是否还需要账号密码，要看当前后台启用的是哪种认证方式。白名单模式通常只校验发起请求的出口 IP，程序里填写代理主机和端口即可；账号密码模式仍要填写 username/password。动态住宅 API 返回的 IP:端口是代理入口，不是白名单对象。
白名单认证和账号密码认证有什么区别
固定服务器或办公出口先用白名单认证，更省事；它校验的是发起请求的公网 IP，不是目标网站 IP，也不是代理IP返回的 IP:端口。出口一变、多人共用或换机器测试，就容易误判成代理IP不稳。
| 认证方式 | 校验对象 | 用户需要填写什么 | 适合场景 | 常见误区 |
|---|---|---|---|---|
| 白名单认证 | 发起请求的公网出口 IP | 通常只填代理主机和端口 | 固定服务器、固定办公出口 | 把目标网站 IP 或代理出口 IP 加进白名单 |
| 账号密码认证 | username 和 password | 主机、端口、用户名、密码 | 多设备、多人协作、出口经常变化 | 把官网登录账号当代理认证账号 |
| 动态住宅 API 返回值 | 本次可用的代理入口 | 程序里填写返回的 IP:端口 | 采集、监控、短时访问任务 | 把返回的代理 IP 当白名单对象 |
| 混合排查 | 先确认后台启用哪种认证 | 按对应模式检查字段 | 认证失败或连接超时时 | 白名单和密码一起乱试 |
出口 IP 经常变化时为什么更适合账号密码认证
团队协作、跨设备接入、服务器经常切换时，账号密码认证更合适；它校验的是 username 和 password，客户端只要主机、端口和凭证填对，通常不用反复加白名单。短板是凭证填错、协议或入口不匹配时，会直接报认证失败。
代理连不上时应该先查白名单还是账号密码
先问客服你当前走白名单还是账号密码。前者先查出口 IP 是否已授权，后者先查用户名、密码、协议和端口；混着排查，容易把认证问题误判成代理IP质量问题。
动态住宅 API 返回的 IP:端口怎么理解
固定服务器先跑通请求时，应先把本机或服务器出口加入白名单，再调用动态住宅 API 获取页返回 IP 端口。原因很直接：API 先校验你的出口是否有权限，没授权就拿不到可用代理；具体字段边界可对照参数说明，如果还没确定产品入口，可先看动态住宅产品。
什么时候需要先加白名单再获取动态住宅 API IP:端口
拿到的 IP:端口 是这次或一段时间内可用的代理入口，通常填进采集程序、浏览器或代理池，再由它们去请求目标网站。它不是白名单 IP，也不是账号密码本身；把它当认证信息看，最常见的结果就是连通性正常但请求仍失败。
为什么 API 返回的 IP:端口不是账号密码或白名单 IP
如果你当前用的是白名单认证，程序请求这些代理IP时，通常不需要再填账号密码；如果后台配置的是账号密码模式，再补对应凭证。采购前真正要确认的是：你买的是哪种认证方式、返回结果给谁用、会不会频繁换出口。
哪些场景加白名单后不需要账号密码
固定服务器使用白名单时还要不要填账号密码
固定服务器调用动态住宅 API，且服务器出口稳定、白名单已生效时，通常可以不再填写账号密码；程序只取用返回的 IP:端口，常见于采集、价格监控、公开页面访问。
内部系统或脚本长期只从一个出口发起请求，也更适合白名单认证，原因是维护简单，不必把凭证分散到多人、多设备。
但本机网络经常切换、多人共用出口、临时换机器测试时，仍建议用账号密码；否则一旦出口变了，就容易被误判成代理IP失效。
白名单和账号密码认证的常见错误
多数连不上并不是代理IP失效，而是白名单对象、认证方式或字段填错；
需要按网络、协议、认证逐项排查时，可以继续看代理 IP 连不上先查什么。
| 错误表现 | 更可能的原因 | 先检查什么 |
|---|---|---|
| 返回 407 或提示 Proxy Authentication Required | 认证失败，或当前出口 IP 不在白名单里 | 先确认后台是白名单还是账号密码模式，再核对 username/password 或当前公网出口 IP |
| 连接超时、无响应 | 前置网络拦截、端口不通，或 HTTP/HTTPS/SOCKS5 协议选错 | 换固定网络复测，确认端口放行，并把协议、host、port 分开填写 |
| API 能返回 IP:端口，但程序里不可用 | 调用 API 的环境出口已授权，但实际发起请求的环境未授权，或填错返回的 IP:端口 | 确认 API 调用机器和业务程序是否同一出口，再核对程序里填写的代理入口 |
为什么把 API 返回的代理 IP 加进白名单后仍不生效
白名单要加的是发起请求的本机或服务器出口 IP，不是 API 返回的代理IP。遇到“我已经全加了还是不通”，先纠正白名单对象，再测连通性。
白名单添加成功后换网络又失效怎么办
重新查询当前出口 IP，并在后台更新白名单；如果接入环境经常变化，改用账号密码认证会更省维护。
为什么白名单模式和账号密码模式不能混着排查
有人明明走白名单，却一直核对密码；也有人是账号密码模式，只盯着白名单。先确认后台启用哪种认证，再按主机、端口、认证、本机网络逐项排查。
代理主机、端口和协议填错时先检查哪些字段
把 IP:端口 整串塞进 host，或把 HTTP、HTTPS、SOCKS5 混填，最常见的结果就是认证失败或连通性异常。采购前要确认你的工具支持哪种协议，以及字段是否分开填写。
常见问题
白名单添加后，还需要填写账号密码吗？
不一定。白名单模式通常不需要再填账号密码；账号密码模式仍要填写 username/password，先以后台启用的认证方式为准。
动态住宅 API 返回的 IP:端口是什么意思？
它是程序后续请求目标网站时使用的代理入口，不是白名单 IP。白名单应添加发起 API 请求的本机或服务器出口 IP。
白名单里到底应该添加哪个 IP？
添加你这边实际发起请求的出口 IP，例如服务器公网 IP 或本机当前出口 IP。不要添加目标网站 IP，也不要添加 API 返回的代理 IP。
为什么已经加了白名单，代理 IP 还是连不上？
按“后台认证方式、代理协议、端口、host 字段”顺序核对；如果 API 和业务程序不在同一台机器上，还要确认两边出口是否一致。
可带走的速查顺序：先看后台认证模式；白名单模式查当前出口 IP；账号密码模式查凭证、协议和端口。