Apify 代理 IP 配置指南：住宅代理 IP、认证、价格与失败排查

在 Apify 中接入代理时，先确认 Actor 或爬虫是否真正读取了代理 IP，再用最小请求验证出口 IP、地区和目标服务响应。代理 IP 只改变网络出口，不能替代账号权限、接口配额或平台规则。

如何在 Apify Actor 或爬虫中接入代理 IP

先确认 Actor 从哪里读取代理配置

先确认 Actor 或爬虫从哪个配置对象读取代理，以及代理设置作用于单次请求、浏览器上下文还是整个任务。使用 Apify Proxy 时，还要区分平台自带代理与外部住宅代理 IP，不能只看任务界面里保存了配置。首次规划采集链路时，可先参考数据采集代理 IP 总指南。

填写代理主机、端口和认证信息

按框架要求填写代理主机、端口、账号和密码，并用最小请求确认认证信息已被读取。若使用 Apify Actor 的代理配置对象，应以当前官方文档中的字段名为准，先在小任务中验证出口 IP，再扩大分页和并发。

根据任务设置并发、重试和会话

再设置并发、重试和会话策略。动态住宅代理 IP 适合多地区公开数据采样，长期会话则要评估静态住宅代理 IP 的适配性；自动重试和故障切换可参考代理请求重试与故障转移。

Apify 代理 IP 轮换、会话和价格该怎么选

请求切换和粘性会话分别适合什么任务

轮换方式要与任务的会话要求匹配。公开数据采样可测试请求切换，需要连续状态的任务则要验证粘性会话的实际保持情况。

先确认流量、时长还是 IP 数计费

先确认服务按流量、时长还是 IP 数计费，并记录并发上限和失败重试产生的额外消耗。

不只看单价，还要比较成功请求成本

用小规模任务测地区命中、响应时间、验证码和失败率，再比较成功请求成本，不要只看标价。

Apify 采集失败时按什么顺序排查

返回 407 时检查代理认证

先确认代理配置已被框架读取，再核对账号、密码、端口和认证字段。仍然返回 407 时，可按407 认证错误排查逐项复核。

返回 403 或 429 时检查频率和平台规则

检查目标 URL、请求频率、并发、重试和平台规则，不要持续扩大请求规模。

请求超时时检查地区、连接池和超时设置

检查代理地区、连接池和客户端超时。连续失败时停止重试并保存 Actor 或爬虫日志。

如何确认 Apify 已经使用代理 IP

先确认配置对象，再验证代理认证、出口 IP 和地区，最后运行真实 Actor。只有小规模任务稳定后，才扩大并发和分页范围。

计费与最小验证

计费应按实际单位、并发、重试流量和成功请求成本一起评估。成功请求成本可按“总费用 ÷ 成功请求数”估算，并把失败重试产生的消耗单独记录。发布前先运行小规模 Actor，记录代理认证、出口地区、状态码和失败重试次数，再决定是否扩大任务规模。具体价格以 Apify、代理服务商官网或后台当前显示为准，不在本文虚构固定价位。官方资料见 Apify Proxy configuration 和 Actor input/output。

FAQ

1. Apify 代理 IP 适合哪些采集任务？

适合公开数据采样、多地区访问和需要控制会话的 Actor 或爬虫任务。

2. Apify 代理 IP 应该优先看哪些参数？

优先确认代理协议、认证方式、地区覆盖、并发上限和计费单位。

3. 什么时候使用粘性会话？

需要在一段请求中保持同一出口时再考虑粘性会话；短时多地区采样通常更适合请求切换。

4. 采集任务什么时候应该停止？

连续出现 403、429、验证码或大量超时时，应先停止扩大规模并保存 Actor 日志。