# 八爪鱼 Octoparse 如何接入代理，有哪些限制？

区分 Octoparse 本地运行与云端任务，说明账密限制及动态 API 提取的条件。

Octoparse 是可视化采集工具。配置前先确认运行方式与代理认证能力：当前官方说明自备代理仅用于本地运行、支持 HTTP 的 IP:端口，不支持用户名密码认证；云端任务只支持其内置代理。因此不能把只只HTTP静态实例或动态账密直接粘贴为可用配置。

## 步骤一：选择可用接入方式

| 方式 | 当前适用范围 |
| --- | --- |
| 静态住宅独立账密 | Octoparse 自备代理入口不支持直接接入，不能省略凭据或用动态白名单代替 |
| 动态住宅账密 | 同样不能直接填写到无认证字段的入口 |
| 动态 API 提取 | 仅当本地运行来源 IPv4 满足只只HTTP白名单与权益要求时，使用实际提取响应中的 HTTP IP:端口 |
| Octoparse 云端任务 | 当前仅支持其内置代理，不把本篇本地步骤用于云端运行 |

动态 API 提取准备见[动态住宅 API 提取](/help/network/api-extraction)和[动态白名单](/help/network/ip-whitelist)。静态用户需要账密工具时，可使用[Postman](/help/network/postman)或[自动化工具](/help/network/automation-tools)，不必为兼容性问题改自己的实例凭据。

## 步骤二：配置本地任务自备代理

1. 打开任务，进入“Task Settings → Anti-blocking”。
2. 勾选“Access website via proxies”，选择“Use my own proxies → Configure”。
3. 填写本次动态 API 提取实际返回的 `IP:PORT`，按客户端要求分行输入。不能填 API 提取网址，也不能把 `us.zzhttp.com:7878` 当作提取结果。
4. 确认配置并保存任务。本流程使用 HTTP，不依据其他教程推断 SOCKS5 支持。

登录页的手动代理只作用于登录；任务编辑或采集需要在各自入口配置。若编辑时也需走代理，使用编辑器右上角“Proxy”，并核对“Use the same proxies for task runs”。

## 步骤三：运行并验证

先新建小型检测任务，在本地请求 `https://ipinfo.io/json`，检查实际运行结果的出口和地区，再运行目标采集任务。代理提取与任务应来自获准的来源环境；提取结果失效后重新取得，不承诺列表永久有效。

## 常见问题

- **账密填在哪里**：当前自备代理入口没有可用账密方式，不能把用户名密码拼到 IP:端口里解决。
- **云端执行失败**：官方自备代理流程仅支持本地运行；不能通过加入自己电脑的白名单让云端任务使用同一代理。
- **本地超时**：核对提取结果、来源 IPv4、有效期、网络及实际本地运行模式。
- **登录成功但采集失败**：登录代理不覆盖任务，检查任务配置与编辑器设置。
- **目标拒绝或字段缺失**：检查目标响应、页面结构和等待设置，不将所有采集错误视为代理失效。

适用范围与入口参考[Octoparse 官方代理设置](https://helpcenter.octoparse.com/en/articles/6470932-set-up-ip-proxies)（2026-10-07 核对）。
