IPDATAHUB / DOCUMENTATION
接入与使用文档
从选择产品到建立第一条连接，再到用量、续费和日常管理。按下面的步骤操作，也可以从目录直接查找你要完成的任务。
四步开始使用
先确定产品，再进入对应页面
需要持续使用同一条固定资源时，先看固定 IP 产品；按流量、带宽时长或代理条数使用时，选择对应生成类产品。各产品的计费与额度分别管理。
Unlimited 代理
按带宽与小时或天计费
适合按可用带宽和运行时间规划成本的持续任务。
按带宽和使用时长购买；选择有效 KEY 生成连接，并在“我的 KEY”中查看有效期或续费。
看懂套餐与支付状态
目前可浏览套餐、查看历史订单和管理已有资源，购买、充值与续费付款暂不可用。
- 配置实际套餐。在价格页选择产品 Tab，再依次选择周期、洲、国家和线路。有 30 天规格时默认选择 30 天；其他选项以当前可售套餐为准。动态和移动选择 GB 套餐，Unlimited 选择带宽与时长，短效住宅选择代理条数。
- 核对单价与总价。固定产品的单价对应“每 IP / 所选周期”，不是每日价格。按日套餐总价包含套餐内的 IP 数；GB、Unlimited 和短效产品分别按其计费单位计算。
- 继续购买并确认订单。未登录时先完成登录，所选套餐配置会保留。检查支付渠道、适用优惠及最终应付金额，再确认。余额不足时可前往充值；在线渠道以页面实际可用项为准。
- 以订单结果确认到账。创建支付订单、钱包广播和平台确认到账是不同阶段。“检查到账”只查询订单，不会直接标记成功。付款状态不明确时先查询，避免重复提交付款。
固定资源：复制连接与维护
付款确认后，打开对应产品列表，按关键字或状态查找资源。使用同一条记录中的主机、端口、用户名与密码；不要把不同资源的字段混在一起。
复制连接后先测试，确认协议与有效期，再保存到客户端。需要备份时使用导出；二维码仅适用于对应客户端及协议。
静态住宅 / 直播线路
支持备注、复制、导出、二维码、单条或批量续费，以及已连接和封禁设备管理。续费前先选资源，核对续费报价与最终订单。
静态按日
查看原始与中转地址，支持搜索、备注、复制及导出。此产品列表没有续费或设备管理入口，不能沿用普通静态的操作步骤。
数据中心
查看连接与到期时间，使用备注、复制、导出和二维码；支持单条或批量续费。此列表不提供设备管理。
按产品生成代理连接
生成连接信息后，仍需在客户端发起请求才能验证连通性。请选择与所购额度或 KEY 匹配的生成器。
动态住宅代理
- 确认动态住宅有剩余流量，再选择网关与线路池。
- 选择国家；按当前线路池支持情况选择州、城市或 ASN。选择 ASN 后，州和城市会清空。
- 设置会话、协议、数量和排列格式，点击生成，复制或下载结果。
更换线路池或国家后，请重新核对下级地区；生成 API 与连接列表是不同的输出。
打开生成器移动代理
- 确认移动流量余额与移动 KEY 可用，打开移动代理生成器。
- 选择国家、网关和会话。移动产品使用固定移动池，页面不提供州、城市或 ASN 筛选。
- 选择协议、数量和排列格式后生成；需要批量接入时导出生成 API。
移动产品的额度与凭据独立；普通住宅剩余流量不会增加移动产品的可用额度。
打开生成器Unlimited 代理
- 在“我的 KEY”检查所购 KEY 的带宽、状态与有效期。
- 在代理设置中选择有效 KEY，再设置国家、会话、协议和格式。
- 输入 1–1000 的生成数量，生成列表或 API；续费从 KEY 列表进入。
没有有效 KEY 或专属网关尚未配置时无法生成连接；带宽与时长以所购套餐为准。
打开生成器短效住宅代理
- 查看剩余可生成条数；单次选择 1–100 条，且不能超过剩余额度。
- 选择国家，按需要选择州或省，然后点击生成。
- 复制成功结果，并在“我的短效 IP”查看历史；出现部分失败时先核对成功条数。
此产品按代理条数使用额度，不提供与动态住宅相同的生成 API 或固定 IP 续费流程。
打开生成器区分地区、网关与会话
- 目标国家与地区
- 用来选择出口所在的国家或地区。可用国家、州、城市和 ASN 取决于产品与线路池；选择随机时不指定固定地区。
- 接入网关
- 客户端连接的主机与端口。网关区域和出口国家是两项配置，不能仅凭网关名称判断出口国家。请使用生成结果返回的完整地址。
- 每次更换
- 选择此模式时，不固定粘性会话；适合按请求轮换的任务。
- 粘性会话
- 动态、移动与 Unlimited 可选择 5、10、15 或 30 分钟会话。保留完整会话用户名用于同一会话；会话时长不是固定 IP 的永久保留承诺。
- 手动切换
- 动态和移动产品支持手动模式；先生成连接，再使用页面提供的切换操作。Unlimited 没有同样的手动模式。
把连接填入客户端
先确认服务实际支持的协议，再按客户端字段填写。协议下拉和输出格式是不同设置：改变字符串排列方式不会转换协议。
- 主机
PROXY_HOST - 资源或生成结果中的代理域名 / IP。
- 端口
PROXY_PORT - 与当前连接对应的端口，不是网站的 API 端口。
- 用户名
USERNAME - 完整复制，包含地区、会话等后缀。
- 密码
PASSWORD - 使用同一条连接的代理密码。
三种常用排列格式
PROXY_HOST:PROXY_PORT:USERNAME:PASSWORDUSERNAME:PASSWORD@PROXY_HOST:PROXY_PORTUSERNAME:PASSWORD:PROXY_HOST:PROXY_PORT客户端有独立字段时分别填写；要求整条字符串时，选择它支持的排列格式。不要删除用户名中的地区或会话片段。
HTTP 代理：测试 HTTPS 目标
curl --proxy "http://PROXY_HOST:PROXY_PORT" --proxy-user "USERNAME:PASSWORD" --connect-timeout 15 "https://example.com/"SOCKS5：由代理解析目标域名
curl --proxy "socks5h://PROXY_HOST:PROXY_PORT" --proxy-user "USERNAME:PASSWORD" --connect-timeout 15 "https://example.com/"Windows PowerShell 中可把开头的 curl 改为 curl.exe。这些示例使用单行命令；凭据包含引号等特殊字符时，应按终端规则转义，或在客户端的独立字段中填写。 cURL 官方参数说明
先检测这条连接导出生成 API
动态住宅、移动和 Unlimited 生成器可以按当前配置生成 API 地址，供自己的程序获取代理连接。它与客户端连接的代理主机不是同一个地址。
- 进入对应产品生成器，确认额度或有效 KEY，设置地区、会话、数量、协议和排列格式。
- 选择页面中的生成 API / API 模式，复制页面实际生成的完整 URL；不要自行替换产品 KEY 或拼接另一产品的参数。
- 程序请求该 URL 后读取返回的连接内容，再把取得的代理信息交给请求客户端使用。生成 URL 本身不能填入客户端的代理主机字段。
生成 URL 可能包含产品凭据，应按连接密码保存。重置 KEY 后应重新生成连接和 API，并更新正在使用的程序。
https://ipdatahub.com/api此地址是服务接口基址，不是代理网关。实际生成 URL 请从生成器复制。
用量、订单与账户维护
按现象定位问题
建议先用一条代理、一个目标地址测试，再扩大数量。下面的检查不需要反复购买或重复生成整批连接。
无法登录或登录验证超时
检查网络后使用页面重试入口；会话失效时重新登录。忘记密码可在登录页进入找回流程，不需要重新注册账户。
检查工作空间登录代理认证失败 / HTTP 407
确认用户名和密码来自同一条连接，完整保留地区与会话后缀，检查空格、排列顺序和当前 KEY。重置过 KEY 时重新生成后再试。
核对连接字段超时、主机无法解析或端口无法连接
核对代理域名、端口和所选协议，确认资源有效、额度充足，并检查本机网络是否允许该端口。用检测工具对比同一条连接的结果。
打开代理检测出口地区与预期不同 / 会话发生变化
检查生成器选择的目标国家，区别网关区域与出口地区。需要同一会话时保留完整用户名，确认没有选每次更换模式，并核对会话时长。
查看地区与会话说明无法生成、没有有效 KEY 或网关不可用
确认正在使用所购产品的生成器及对应额度。Unlimited 需要有效 KEY；缺少服务网关时联系支持确认配置，不能填入服务 API 基址代替。
核对产品生成步骤短效住宅只生成了部分结果
先复制成功结果，核对失败条数、历史记录和剩余额度，再决定是否补充生成。不要把部分失败当成整批失败反复提交。
查看短效生成记录已付款但订单待确认 / 暂未看到资源
先查当前订单状态；订单创建或钱包广播不等于平台已确认到账。确认已支付后，检查产品分类并刷新对应资源或额度。仍异常时向支持提供订单编号与时间。
查询订单状态仍然需要帮助？
准备产品类型、订单或资源编号、发生时间及已脱敏的报错信息，便于定位问题。