极安代理 - 提取工具-搜索

搜索

全部文档·(7)

代理IP怎么接入程序？开发者完整操作流程摘要：代理IP的接入流程可以归纳为四步：获取代理地址、完成身份验证、测试连通性、集成到业务代码。不同服务商的界面和术语有差异，但底层逻辑一致。本文以极安代理为操作环境，把每一步的原理和操作都写清楚。短效代理和隧道代理有什么区别？在接入代理IP之前，需要先搞清楚自己该用哪种类型的代理IP，因为两种代理IP的接入方式和使用逻辑完全不同。市面上的代理产品基本可以分成两类，叫法不完全统一，但机制是相同的。短效代理（也叫提取式代理、API代理）的工作方式是：调用一个 API 接口，服务端返回一批代理 IP，每个 IP 有存活时间，到期失效需要重新提取。开发者需要自己管理 IP 池——提取、使用、淘汰过期 IP，循环往复。隧道代理（也叫转发代理）的工作方式是：服务商给你一个固定的代理网关地址，你所有请求都发到这个地址，服务端在背后自动切换出口 IP。使用隧道代理时，开发者不需要感知 IP 层面的细节。对比项短效代理隧道代理获取方式调 API，返回 IP 列表固定网关地址 IP 更换手动管理，到期重新提取每次请求自动轮换代码复杂度较高，需要 IP 池逻辑低，配置一次即可典型场景大量不同 IP 的批量采集稳定通道，不想管 IP 选型没有绝对优劣，取决于你的业务是要”大量不同的IP”还是”一个省心的代理通道”。极安代理同时提供这两种产品，可以根据业务场景选择。代理IP接口地址怎么获取？确定代理IP类型之后，第一步都是拿到代理的接入地址。短效代理要拿到的是一条 API 提取链接，调用后返回可用 IP。大多数服务商都提供可视化的链接生成工具，选好地区、协议、数量等参数就能直接生成链接，不需要自己看文档拼接。例如极安代理的提取工具页面，勾选完参数后一键复制链接即可。隧道代理要拿到的是一个代理网关地址，格式通常是 host:port。购买完成后在服务商后台的产品列表中可以直接看到：这一步比较直观，拿到代理IP地址就可以进入下一步的授权验证。代理IP的授权验证怎么配置？代理服务商需要区分”谁的请求可以使用我的代理”。行业通用的验证方式有两种： IP 白名单验证——你把发起请求的服务器公网 IP 告诉服务商，服务商在后端放行这个 IP 的所有请求。好处是代码里完全不需要带认证信息，干净利落。限制是你的出口 IP 必须固定，否则每次 IP 变了都要重新加白名单。用户名密码验证（账密验证）——服务商给你一组凭据，请求代理时按 username:password@proxy-addres 的格式传入。不依赖固定 IP，适合本地开发或 IP 会变的环境。对比项 IP 白名单账密验证代码侵入性无，不需要改代码需要在请求中带上凭据对 IP 的要求出口 IP 必须固定无要求安全性 IP 级别控制凭据级别控制适合场景云服务器部署本地开发、多人协作在极安代理的后台，白名单在业务管理页的「白名单设置」中添加：账密凭据对应的是 Authkey 和 Authpwd 两个字段，在业务详情页可以找到：其他服务商的命名可能不同，但本质都是用户名和密码。两种方式选一种配好即可。怎么测试代理IP是否连通？代理IP授权配置完成后，在写业务代码之前，先用 curl 单独验证代理本身能不能用。这一步的目的是隔离问题——如果 curl 都不通，就是代理配置的问题，不用去翻代码。 # 账密验证 curl -x http://用户名:密码@代理地址 https://httpbin.org/ip # 白名单验证（不需要带账密） curl -x http://代理地址 https://httpbin.org/ip httpbin.org/ip 会返回请求的出口 IP。如果返回的 IP 和你本机不同，代理就是通的。代理IP测试不通的话，按以下顺序排查：白名单没加对。确认添加的是公网出口 IP 而不是内网 IP。用 curl https://httpbin.org/ip 查看本机实际出口 IP。刚添加的白名单一般有一两分钟的生效延迟。账密格式错误。用户名或密码中的特殊字符（@、:、# 等）需要 URL 编码，否则会被当作分隔符导致解析错误。套餐额度用完。部分服务商在额度耗尽后不会返回明确提示，直接超时。协议不匹配。目标网站是 HTTPS 但代理套餐只支持 HTTP 转发，会直接断连。如果返回了带数字的错误信息，可以去服务商的错误码文档查对应含义。极安代理的错误码表在帮助中心可以找到。代理IP在 Python 代码里怎么集成？curl 测试通了之后，代码集成就是把相同的代理地址和验证信息传给你的 HTTP 客户端。几乎所有编程语言的 HTTP 库都支持通过 proxies 或类似参数指定代理。以 Python 的 requests 库为例：隧道代理： import requests proxy = "http://用户名:密码@代理地址" proxies = {"http": proxy, "https": proxy} resp = requests.get("https://httpbin.org/ip", proxies=proxies, timeout=10) print(resp.json()) # 服务端自动换 IP，代码不需要额外处理短效代理： import requests # 第一步：调 API 提取一批可用代理 IP api_url = "你的提取链接" ip_list = requests.get(api_url).text.strip().split("\n") # 第二步：逐个使用 for ip in ip_list: proxies = {"http": f"http://{ip}", "https": f"http://{ip}"} try: resp = requests.get("https://httpbin.org/ip", proxies=proxies, timeout=5) print(f"{ip} -> {resp.json()}") except Exception as e: print(f"{ip} 失败: {e}") 其他语言的写法不同但逻辑一样：Node.js 用 http-proxy-agent，Go 在 http.Transport 里设置 Proxy 字段，Java 用 Proxy 类或在 HttpClient 中配置。核心都是把代理地址告诉 HTTP 客户端。生产环境中，短效代理通常还需要加上定时提取和本地 IP 池的管理逻辑，保证随时有可用 IP。总结代理IP的接入并不复杂，核心就是四步：拿到代理IP地址、配好授权验证、curl 测试连通、写入业务代码。本文基于极安代理的短效代理和隧道代理完成了全流程演示，其中代理IP的授权机制、测试方法和代码集成方式对其他代理IP服务商同样适用。遇到问题时优先用 curl 隔离定位，再对照错误码排查，大部分代理IP接入问题都能快速解决。代理IP接入常见问题Q：curl 能通但代码里请求失败是什么原因？最常见的原因是代理地址格式不对。http:// 前缀不能省略；如果用了账密验证，用户名或密码里的特殊字符必须做 URL 编码。另外检查代码里是否同时设置了 http 和 https 两个协议的代理——只设一个的话，另一个协议的请求不会走代理。 Q：为什么 HTTP 网站能访问但 HTTPS 不行？代理套餐不一定支持 HTTPS。部分产品只做 HTTP 层转发，遇到 HTTPS 请求会直接断连而不是返回错误信息。在服务商后台确认套餐的协议支持范围，必要时升级到支持 HTTPS 的套餐。 Q：并发量一上去就大面积报错怎么办？代理套餐通常有并发连接数上限，超出后请求会被拒绝。先确认套餐允许的并发数，然后在代码里用信号量、连接池或限流器控制并发。如果业务本身需要高并发，需要选择对应规格的套餐。 Q：短效代理提取出来有一部分 IP 用不了？正常现象。短效 IP 有存活窗口，从你提取到实际发出请求之间有时间差，部分 IP 可能已过期。代码中加异常捕获和自动切换下一个 IP 的逻辑就行，不需要追求 100% 可用率。来自：行业资讯 API概览 1 接口简介极安代理提供了功能丰富的API接口，满足开发者在各种场景下的调用需求。所有接口支持 HTTP 或者 HTTPS 请求，部分接口采用 GET 方法，部分接口采用 POST 方法；接口返回数据的格式支持文本、json、xml。具体请参见接口文档。 2 API 列表接口类型接口名称短效代理接口 - 提取IP - 查询余额白名单相关接口 - 查询白名单IP- 添加白名单IP - 删除白名单IP 3 测试代理可用性3.1 生成API链接对于代理提取API，您可以到提取工具在线生成API链接，内置到您的程序中：也可以查看API文档，获取接口url和参数说明，自己生成API链接。 3.2 测试API链接浏览器测试您可以把生成的API链接直接在浏览器里打开，查看返回结果。例如，您直接点击如下api链接 https://api.ja.cn/getip?key=ABCD1234 命令行测试如果您在linux系统下，可以通过curl命令请求API链接查看结果： curl “https://api.ja.cn/getip?key=ABCD1234“ 4 错误码查看公共接口返回错误码错误码描述 -1 未知错误 -10 参数不合法 -11 请求过于频繁 -12 Authkey被封禁 -13 当前客户端IP不在授权名单中 -14 Pwd不合法 -15 Authkey对应的业务无此权限 -100 计划不存在或已过期 -103 资源不足 -104 申请资源失败 -105 释放的IP数超过允许释放的IP数 5 代理使用监控业务开始使用后，您可在控制台-业务详情中了解AP代理使用的具体监控数据。来自：API接口短效代理-接口介绍 1 说明通过编码使用短效代理主要有以下4步骤： 1.通过接口文档或提取工具获取api接口； 2.使用白名单或账密进行授权验证； 3.进行代理测试；查看测试步骤＞＞ 4.编写采集程序，使用代理IP。 2 API接口短效代理API接口一览接口类型 API 描述资源相关 - getip - balance - 提取IP资源 - 查询余额白名单相关 - whitelist/query- whitelist/add - whitelist/del - 查询IP的白名单 - 添加IP的白名单 - 删除IP的白名单来自：短效代理接口短效代理-使用指南-手动版步骤总览完成购买后等待片刻，即可在控制台看到相关业务信息。下面介绍手动设置使用代理的具体步骤。 1 授权验证为保障代理权益，使用前需进行授权验证。极安支持白名单和账密两种验证方式，可自主选择使用。白名单模式即把要实现代理的服务器IP添加进该代理业务的白名单中，后续就能顺利在该IP环境中连接代理；账密模式即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。详细操作可查看代理验证＞ 2 提取IP1.点击对应业务右侧的【详情】，在详情页面中点击【提取IP】进入提取工具页面； 2.在提取工具页面，选择对应业务的Authkey，以及提取数量、地区、格式等其他选项，便可在页面下方看到链接，点击【打开链接】；便可在打开的网页中看到此时提取到的IP地址。 3 设置代理提取到IP后，就可以设置代理了。极安代理当前支持用户使用各种浏览器、代理客户端、电脑系统等等进行代理设置。以谷歌浏览器chrome为例，设置代理需要1.在右上角菜单中点击【设置】，设置页面中选择【系统】-【打开代理设置】； 2.在新打开的弹窗页面中，把【使用代理服务器】按钮打开，并填写地址与端口信息，点击保存，就算启动代理连接了； 3.若使用的是账密验证，此时在浏览器打开一个新网页，会弹出以下会话，填写业务所对应的AuthKey以及AuthPwd信息，点击确认便能完成代理连接；若使用的是白名单验证，则跳过该步骤。 4.此时进行正常的网页浏览，若能正常使用，就算代理连接成功了。 4 重新获取IP极安代理产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。 IP到期失效之后，需要回到第一步重新提取IP，再将新ip信息填入代理服务器中进行使用。隧道代理产品不需要提取IP，将隧道地址写进代码，IP即可在云端切换了解更多产品信息，可点击以下链接↓短效代理＞隧道代理＞来自：短效代理短效代理-使用指南-开发版我们提供提供多种API接口，以协助开发者更便利地使用代理。本篇仅以【提取IP】这一操作为例步骤总览 1 获取API接口在极安，获取API接口链接有两种方式 ① 使用提取工具使用提取工具，进行简单的选择便可以获取接口链接。传送门＞＞提取工具 ② 查看api接口文档除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。点击了解API接口文档＞短效代理接口 2 授权验证为保障代理权益，使用前需进行授权验证。极安支持白名单和账密两种验证方式，可自主选择使用。白名单模式即把要实现代理的服务器IP添加进该代理业务的白名单中，后续就能顺利在该IP环境中连接代理；账密模式即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。详细操作可查看代理验证＞ 3 代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} 若响应不成功，可对应错误码表，排查问题。 4 编写采集程序测试代理可用后，便可开始编写代理采集程序了。注：极安代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。来自：短效代理代理IP使用指南-手动版步骤总览本指南适用于短效代理产品，隧道代理由于产品特性无法手动设置使用，请查看开发者指南完成购买后等待片刻，即可在控制台看到相关业务信息。下面介绍手动设置使用代理的具体步骤。 1 授权验证为保障代理权益，使用前需进行授权验证。极安支持白名单和账密两种验证方式，可自主选择使用。白名单模式即把要实现代理的服务器IP添加进该代理业务的白名单中，后续就能顺利在该IP环境中连接代理；账密模式即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。详细操作可查看代理验证＞ 2 提取IP1.点击对应业务右侧的【详情】，在详情页面中点击【提取IP】进入提取工具页面； 2.在提取工具页面，选择对应业务的Authkey，以及提取数量、地区、格式等其他选项，便可在页面下方看到链接，点击【打开链接】；便可在打开的网页中看到此时提取到的IP地址。 3 设置代理提取到IP后，就可以设置代理了。极安代理当前支持用户使用各种浏览器、代理客户端、电脑系统等等进行代理设置。以谷歌浏览器chrome为例，设置代理需要1.在右上角菜单中点击【设置】，设置页面中选择【系统】-【打开代理设置】； 2.在新打开的弹窗页面中，把【使用代理服务器】按钮打开，并填写地址与端口信息，点击保存，就算启动代理连接了； 3.若使用的是账密验证，此时在浏览器打开一个新网页，会弹出以下会话，填写业务所对应的AuthKey以及AuthPwd信息，点击确认便能完成代理连接；若使用的是白名单验证，则跳过该步骤。 4.此时进行正常的网页浏览，若能正常使用，就算代理连接成功了。 4 重新获取IP极安代理产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。 IP到期失效之后，需要回到第一步重新提取IP，再将新ip信息填入代理服务器中进行使用。隧道代理产品不需要提取IP，使用隧道地址进行连接，IP即可在云端切换了解更多产品信息，可点击以下链接↓短效代理＞隧道代理＞来自：开发者指南代理IP使用指南-开发版步骤总览 1 获取API接口/隧道地址短效代理与隧道代理需要获取不同的信息来接入代理： ①短效代理—API接口链接可以使用提取工具，进行简单的选择便可以获取接口链接。传送门＞＞提取工具也可以查看api接口文档自主编写所需的接口链接。点击了解API接口文档＞短效代理接口 ②隧道代理—隧道地址完成产品购买后，页面自动跳转进入控制后台，看到如以下的页面，产品页列中就有隧道地址； 2 授权验证获取代理信息之后，还需要有授权验证才能使用代理。极安支持白名单和帐密两种验证方式，可自主选择使用。白名单模式即把要实现代理的服务器IP添加进该代理业务的白名单中，后续就能顺利在该IP环境中连接代理；账密模式即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。详细操作可查看代理验证＞ 3 代理测试在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl} 若响应不成功，可对应错误码表，排查问题。 4 编写采集程序测试代理可用后，便可开始编写代理采集程序了。来自：开发者指南

前往

页