代理提取与使用

本章汇总了关于动态代理与静态独享代理的提取流程、参数配置、接入规范与高阶使用技巧。

---

动态代理提取与使用

购买了动态流量后，该如何提取代理并开始使用？

动态代理的使用非常简便，只需以下三步：

1. 配置代理认证凭据：登录控制台，进入对应网络类型（如「住宅代理」）页面，切换到顶部的「账密与白名单」标签页，创建一个专用的用户名与密码（例如用户名前缀 user1，设置好密码）。
2. 提取代理 IP：切换到控制台的「提取」标签页（或进入 提取 页面）：
   • 在 Web 提取 中选择订单、协议（HTTP 或 SOCKS5）、目标国家/城市以及会话模式（轮换或黏性保持）；
   • 点击 立即生成 即可在结果列表中获取代理地址。
3. 填入客户端配置：将生成的连接信息配置到你的软件中：
   • 代理主机：固定为 gate.joyproxy.com
   • 代理端口：固定为 9001
   • 用户名：完整复制生成出来的整长串文本（切勿手动修改或删减）
   • 密码：填写你在第一步中自己设置的代理密码

为什么所有动态代理连接的都是同一个 gate.joyproxy.com:9001？

这是云端动态网关的标准化架构。gate.joyproxy.com:9001 是 JoyProxy 全球动态分发集群的统一入口。 当你的客户端带着特定用户名连接该网关时，网关服务会毫秒级解析用户名中携带的参数（例如包含的目标国家、城市以及会话 ID），并在庞大的云端池中实时调度最匹配的真实宽带节点作为出口转发你的请求。这种架构不仅保证了高吞吐与高可用，还省去了爬虫频繁维护海量代理列表的麻烦。

动态提取出来的用户名为什么那么长？能否自己改短？

绝对不能自行删减或更改。动态代理的用户名并不是普通的纯字母账号，而是高度编码的指令字符串，格式通常类似： user1-zone-resi-region-us-city-los_angeles-session-ab12cd-sessTime-30 其中每一段都代表明确的路由规则：

• user1：你的代理账号
• region-us / city-...：目标出境地理位置
• session-...：黏性会话标识
• sessTime-30：会话保持时间（分钟）

如果手动截断或修改该字符串，网关将无法识别你的路由需求，会导致鉴权失败（407 错误）或将流量错误路由至随机国家。

轮换模式与黏性会话该如何选择？

• 轮换会话（每次换 IP）：每次发起新的 HTTP/HTTPS 请求，出口 IP 都会自动更换。适合大规模网页采集、公开数据抓取，能最大程度分散单个 IP 的请求频次并防止目标站封禁。
• 黏性会话（保持 IP 不变）：
  • 界面可调时长：控制台提取界面滑块支持 1 到 1440 分钟（整整 24 小时 / 1 天），在此窗口内发起的所有网络请求都将尽可能固定使用同一个出口 IP。
  • 自定义长粘性设置（无时间上限）：若需保持更长会话（如 3 天、7 天），您无需受限于界面滑块，可直接在生成的代理用户名中修改 sesstime-<minutes> 属性。例如设置 sesstime-10080（对应 7 天），该数值在系统后端没有任何硬编码上限。
  • 高纯净度业务推荐：针对社交媒体养号、多步骤结算、AI 大模型对话等对 IP 纯净度要求极高的场景，动态住宅代理或移动代理配合长粘性会话，既能享受 100% 纯净的真实家庭/移动基站网络身份，又能获得长效稳定的会话连接。

在设定的粘性时间内，如果出口 IP 故障会怎么样？

动态住宅与移动代理来自于全球海量真实家庭宽带路由器与移动 4G/5G 手机基站。在设定的粘性窗口内，远端真实物理设备可能会因为家庭断电关机、系统休眠、宽带断网、手机进入信号盲区或基站切换等正常网络行为而偶发离线。

• 网关智能容灾调度：JoyProxy 全球网关具备毫秒级健康探测机制。一旦监测到当前出口 IP 失活或故障，系统会瞬间在同地区资源池中平滑分配一个可用的新出口 IP 接替转发，确保业务请求不中断；
• 严格继承属地与 ASN 属性：重新分配的新出口 IP 会严格继承原选定的国家、省市和运营商 ASN 属性，不会发生跨地区漂移；
• 客户端零感知、免封控：客户端连接不会断开，原有的连接域名、端口、用户名和密码完全不变。这种局域网重拨或基站切换行为与真实网民完全一致，不仅不会触发目标站风控，反而是最拟真的网络防护。

黏性会话时间到期后，连接会自动断开吗？

不会中断连接。

• 当设定的 sesstime 到期后（例如设定的 1440 分钟已满），底层的代理连接绝对不会被强制切断，原有的整串长用户名和密码仍然持续有效，完全无需重新提取；
• 在到期后的下一次发起网络请求时，网关会自动平滑分配一个同国家、同地区、同 ASN 属性的全新出口 IP 开始新的周期；
• 自动化爬虫、指纹浏览器或脚本无需停止或修改任何代理配置，即可平滑过渡并长期稳定运行。

---

静态独享代理提取与使用

提取静态代理时，Entry Point（接入地址）与 Exit IP（出口 IP）有什么区别？

这是新手最容易混淆的概念：

• Entry Point（接入地址）：格式形如 isp.joyproxy.com:端口 或 dc.joyproxy.com:端口（历史分配的 *.std.joyproxy.com / *.pro.joyproxy.com 亦兼容可用）。这是你在客户端、爬虫或浏览器扩展中唯一需要且必须填入的代理主机与端口。
• Dedicated Exit IP（专属出口 IP）：形如 198.51.100.24。这是该线路实际对公网展示的真实 IP 地址，仅供你核对出口属地与外部网络环境，绝对不能把 Exit IP 当作代理主机填入客户端，否则会导致连接被拒。

控制台提示：在控制台已购列表中，你可以通过表头的「隐藏出口 IP / 显示出口 IP」开关来避免混淆。

静态独享代理可以更换 IP 或地区吗？

• 更换出口 IP：可以。在控制台「已购」列表中找到对应的静态线路，在操作列点击 更换 IP，系统会在同地区为你免费分配一个新的专属出口 IP。更换后，你的连接域名和端口保持不变，极大地简化了客户端维护。
• 更换地区：不可以。静态独享在下单付款时就已经锁定国家与城市，不支持跨国或跨城市变更。如需其他地区，请另行购买该地区的静态独享线路，或改用动态代理并在提取时指定地区。

为什么 ISP 静态代理会被部分网站检测为代理、商业或数据中心？社媒、AI、抢购类网站该选什么？

虽然 ISP 代理常被称为「静态住宅代理」，但它的技术实现本质是机房直接向商业宽带/住宅运营商采买的大带宽专线。 由此导致以下现状：

1. 机房宣告与历史行为标记：由于机房 BGP 广播宣告属性、以及同 C 段历史上其他使用者的行为，国际各大第三方 IP 数据库（如 IPinfo、IP2Location、MaxMind、Scamalytics 等）可能会将部分 ISP 段识别或标记为商业（Commercial/Hosting）或代理（Proxy）类型。
2. 目标平台严格风控：主流社交媒体（如 Instagram、TikTok、Facebook、LinkedIn）、主流 AI 平台（如 ChatGPT、Claude）、国际支付网关（如 Payoneer）以及球鞋潮牌抢购网站，部署了极其严苛的 IP 风险评分与 ASN 拦截策略，使用被标记过的 IP 容易引发验证码、访问被拒甚至账号风控。

权威选型建议：

• 强烈推荐选购「住宅代理（Residential）」或「移动代理（Mobile）」：
  • 住宅代理和移动代理来自于全球海量真实家庭宽带和 4G/5G 手机基站网络，网络身份天然具备 100% 真实纯净的民用属性，不携带任何商业机房或代理标记，绝不会引发上述严格平台的机房风控拦截。
  • 虽然动态代理偶发会随设备状态变化 IP，但这完全符合真实人类网民的上网行为。配合控制台的粘性会话（设置 1440 分钟或自定义 sesstime），可在保证极高 IP 纯净度的同时获得长期稳定的会话体验，即使切换也自动继承原地区与 ASN。因此，凡是对 IP 纯净度要求严苛的业务，动态住宅与移动代理是公认的最优解。

我的静态代理 Exit IP 为什么变了？是不是被平台偷偷换掉了？

平台绝对不会无故更换用户的独享出口。静态代理承诺提供专享固定出口，但在极少数情况下可能发生变化：

• 触发了线路健康容灾：平台具备全天候线路健康监测系统。如果底层宽带节点发生断电、运营商机房割接或物理故障导致出口长时间失活，为了保证你的业务不中断，系统会自动将出口平滑切换为同地区的可用健康 IP；
• 用户主动操作：团队成员在控制台点击了「更换 IP」。 切换后的出口依然为你专属独占，不会与他人共用。

购买静态代理前能否咨询号段或 ASN？

可以。如果您对目标国家、特定运营商或 ASN 有明确要求，请在控制台左侧导航栏点击「工单」提交咨询，说明您需要的地区与运营商，人工客服会为您确认并回复可用情况。

对分配的 ISP 或数据中心代理质量不满意，或需要更高带宽、更低延迟怎么办？

如果当前分配的静态线路无法满足业务需求，可先在控制台「已购代理」中尝试「更换 IP」重新分配出口。如需超低延迟、大带宽的静态代理，请通过工单申请直连专属代理，我们将根据您的地区与带宽需求定制专属方案。

静态独享代理有流量、限速或连接设备限制吗？

没有任何流量、带宽、并发连接或使用设备数量的限制。 静态独享代理按「IP 数量 × 租用时间」计费。在服务有效期内，您可以不受限制地传输流量和连接多个设备，适合大吞吐量与长连接业务场景。

静态独享代理到期后会发生什么？

如果服务到期前未完成续费，系统会在到期时刻立即停止代理转发，并在保留缓冲期后彻底释放该固定端口与底层出口资源。已释放的端口或特定出口 IP 将无法重新找回。如果需要长期保留，建议在控制台开启「自动续费」。

---

提取方式与工具配置

在控制台有哪些提取代理 IP 的方式？

JoyProxy 提取页面提供三种提取渠道：

1. Web 提取：在页面上可视化筛选国家、城市、协议和会话类型，实时生成直连链接，支持一键复制或导出为 CSV/JSON/TXT；
2. API 提取：适合写进自动化程序中批量拉取代理列表，支持 CRLF 换行文本与 JSON 格式输出；
3. AI 提取：在 Cursor、VS Code、Claude Desktop 或 OpenClaw 中使用自然语言调取代理端点。

代理 API 提取接口支持一次提取多少条？调用频率有什么限制？

通过 API 提取代理 IP 时，count 参数的有效取值范围为 1 到 200（单次最多返回 200 条代理）。 由于动态代理的网关地址与凭据长期有效（只要账户内仍有流量额度即可持续使用），你不需要高频死循环轮询提取接口。如果调用过于频繁触发了速率保护，接口将返回 429 Too Many Requests，适当调大调用间隔即可恢复。详细参数请参阅控制台 OpenAPI 中心 或 程序化提取指南。

静态独享更换 IP 能否通过 API 自动化执行？

目前不可以。静态独享更换出口 IP 需要在控制台「已购」页面人工点击确认完成。API 提取接口仅负责读取当前已经配置就绪的接入域名与端口，不会自动触发底层换 IP 流程。

如何在指纹浏览器（如 AdsPower、Hubstudio、Octobrowser 等）中配置？

以静态独享线路为例：

1. 打开指纹浏览器，新建或编辑浏览器环境；
2. 代理类型选择 HTTP 或 SOCKS5；
3. 将 JoyProxy 控制台「已购」中显示的 Entry Point 拆分填入：域名填在代理主机栏，冒号后的数字填在端口栏；
4. 填写该网络下「账密与白名单」中设置的代理账号与密码（若使用的是静态独享线路且已绑定本机公网 IP 到白名单，账密可免密留空；动态代理网关必须填写账密）；
5. 点击「测试连接」，检测通过且出口 IP 符合预期后即可保存启动。

可以把 JoyProxy 代理添加到 Clash、v2rayN 或 Shadowrocket 客户端吗？

可以。JoyProxy 提供标准的 HTTP、HTTPS 与 SOCKS5 代理协议。只要第三方客户端支持标准 HTTP 或 SOCKS5 代理协议类型（带有用户名密码认证或白名单鉴权），均可按照提取到的 host:port 与账密填入作为常规代理节点使用。

---

凭证管理与浏览器插件

JoyProxy 一共有几种 Token？它们有什么区别？

平台共有四种专用的产品 Token，遵循最小权限与职责分离原则，互不通用：

1. Master User Token（主用户 Token）：用于管理用户资产、查看余额、程序化下单与续费等账号级操作，在控制台「我的账户」中查看或轮换。切勿将主用户 Token 写进爬虫代码中，不能用于提取代理 IP 或调用抓取。
2. API Token（Extract Token / 提取 Token）：专用于代理 IP 的公网提取接口（如 /v2/extract\、/v2/extract-long\、/v2/whitelist\ 等）。购买代理后在控制台提取页面使用。
3. AI Access Token：仅用于 OpenClaw Skill、Cursor、VS Code 或 AI MCP 等 AI 助手集成。
4. Scraping API Token：专用于网页抓取 API（如 /v1/scraping/fetch\），在控制台 Scraping API 中心获取。

注：网站登录的 JWT 仅用于网页控制台会话认证，不能作为公网 API Token 使用。

如果 Token 不小心泄露了该怎么办？

请立即在对应的控制台模块点击 Rotate（轮换），旧 Token 将会即时失效，您只需将自动化脚本中的凭据更新为新 Token 即可：

• Master Token：在「我的账户」中轮换；
• API Token：在提取页面点击「Rotate token」；
• AI Token：在 AI 集成面板轮换；
• Scraping API Token：在 Scraping API 中心轮换。 提示：代理连接的用户名与密码、以及 IP 白名单，是在各网络控制台顶部的「账密与白名单」中管理，与 Token 轮换是相互独立的。

如何使用官方 JoyProxy Chrome 浏览器扩展？

JoyProxy 提供了官方 Chrome 浏览器扩展，支持免改系统全局代理，仅为单个浏览器窗口快速配置代理网络：

1. 获取线路与凭据：登录控制台，记下生成的接入端点 \host:port\ 以及代理账号密码；
2. 安装扩展：在 Chrome Web Store 中搜索「JoyProxy」并添加到浏览器；
3. 测试并应用代理：点击浏览器工具栏的 JoyProxy 扩展图标，选择对应网络类型（静态选 Static，动态选 Rotating），填入接入地址与账密（或直接登录账号一键同步已购线路），点击「Test and apply」；
4. 清除代理恢复直连：使用完毕后，点击扩展右上角的「Direct」按钮，即可瞬间清除本浏览器代理并恢复本地直连。

白名单添加后多久生效？为什么添加后依然报 407 代理鉴权失败？

1. 生效延迟：JoyProxy 全球边缘网关同步白名单规则通常需要 5 到 10 秒，添加后请稍等片刻再发起测试连接；
2. 本机出口公网 IP 变动排查：很多用户的本地网络使用的是家庭宽带动态公网 IP（每次断网或光猫重拨都会更换出口 IP）。如果本机公网 IP 变动，原先添加的白名单便会失效，请前往控制台更新为最新的本机公网 IP；
3. 网络类型适配确认：动态代理（住宅/移动/商业）因需要通过长用户名传递路由参数，必须使用用户名密码鉴权，不走 IP 白名单；IP 白名单免密连接专用于静态独享代理（ISP / 数据中心代理）。

购买静态独享代理后，如果首次分配的出口 IP 觉得质量不符合预期，更换规则是怎样的？

• 随时免费更换：在控制台「已购代理」列表中，找到对应的静态线路，在操作列点击 更换 IP，系统会在同地区为您重新分配一个全新的专属出口 IP，无需额外付费；
• 配置零变动：更换出口 IP 后，该线路的 Entry Point（接入地址域名 + 端口）以及账密完全不变，您无需修改任何客户端或指纹浏览器配置；
• 防滥用建议：由于静态代理为独占资源，建议每次更换后稍作连通性验证，避免短时间内无节制高频点击更换。