PuraRoute 开发接入指南

安全购买、配置、连接和运营动态住宅代理与静态住宅代理。

本指南帮助您完成第一次 PuraRoute 代理请求，并把接入方案调整到可用于生产的状态。下文中的主机、端口、用户名和密码均为占位符；请从控制台复制当前连接信息，不要照抄示例值。

选择产品

产品	适用情况	购买单位	连接身份
动态住宅代理	请求需要地区灵活性、轮换或短期粘性会话	GB 流量	根据子账号与会话配置生成
静态住宅代理	业务流程或 IP 白名单需要稳定的专属 IP	IP 数量与使用周期	在资源期限内保持固定

产品可用性、地区、协议、库存和价格均为实时数据。购买前请以控制台当前结果为准。

快速开始

登录账户，并启用可用的账户安全选项。
如果所选产品使用钱包支付，先充值钱包。
在动态或静态产品页获取报价，核对金额、单位、数量、期限、地区和支付方式。
提交订单，等待支付和资源分配状态确认成功。
在对应资源页生成或读取连接凭证。
先运行一个小流量测试请求，再启用并发或生产流量。

营销页面价格不是结算金额。确认订单前，始终以最新报价为准。

动态住宅代理接入

1. 购买流量

打开动态住宅代理产品页，填写流量并获取报价。购买成功后，控制台会显示新的流量批次和可用余额。不同流量批次可能有各自的有效期规则。

2. 创建子账号

为应用或团队创建独立子账号，并只分配所需的流量上限。隔离子账号更便于统计用量、轮换凭证和控制安全事件影响范围。

3. 生成连接

在代理配置页选择：

一个已启用的子账号；
自动路由或当前可用国家；
轮换或粘性会话；
选择粘性会话时的持续时间；
HTTP(S) 或 SOCKS5；以及
需要生成的连接数量。

控制台会读取正确的网关和端口，并根据地区与会话策略生成代理用户名。除非支持团队明确要求，请勿手工修改生成的用户名。

4. 理解会话模式

**轮换会话：**适合相互独立、可以安全使用不同出口的请求。
**粘性会话：**尝试在所选时间窗口内保持同一出口，适合短期多步骤流程，但不是永久 IP 保留。

重试、重新连接、供应商条件或会话到期仍可能改变出口。应用应能从连接变化中安全恢复。

静态住宅代理接入

打开静态住宅代理产品页。
选择当前产品类型、国家或地区、协议、使用周期和 IP 数量。
检查实时库存并获取报价。
核对总金额和钱包余额后再确认订单。
资源分配成功后，打开资源读取节点、用户名和密码。
监控资源状态与到期时间；只有在计划保持钱包余额充足时才启用自动续费。

在平台确认支付和分配成功前，提交订单不代表库存已锁定。资源到期、停用或不可用后可能立即停止接受连接。

连接格式

大多数代理客户端支持以下格式：

http://<USERNAME>:<PASSWORD>@<HOST>:<PORT>
socks5://<USERNAME>:<PASSWORD>@<HOST>:<PORT>

如果把用户名和密码写入 URL，请进行百分号编码。优先使用能够分别传入凭证字段的客户端库，可减少编码错误和日志泄露风险。

使用 cURL 测试

curl --fail-with-body \
  --show-error \
  --silent \
  --location \
  --max-time 30 \
  --proxy "http://<USERNAME>:<PASSWORD>@<HOST>:<PORT>" \
  "https://httpbin.org/ip"

使用 SOCKS5 时，请填写控制台提供的 SOCKS5 主机和端口，并将代理协议改为 socks5://。测试目标应是您有权访问的地址。

Python 示例

安装客户端：

python -m pip install requests

使用环境变量保存凭证，不要写入源代码：

import os
from urllib.parse import quote

import requests

host = os.environ["PROXY_HOST"]
port = os.environ["PROXY_PORT"]
username = quote(os.environ["PROXY_USERNAME"], safe="")
password = quote(os.environ["PROXY_PASSWORD"], safe="")
proxy_url = f"http://{username}:{password}@{host}:{port}"

response = requests.get(
    "https://httpbin.org/ip",
    proxies={"http": proxy_url, "https": proxy_url},
    timeout=30,
)
response.raise_for_status()
print(response.text)

使用 SOCKS5 时，请安装 requests[socks]，并使用控制台显示的协议与节点。

Node.js 示例

安装 HTTP 代理 Agent：

npm install https-proxy-agent

const https = require('node:https');
const { HttpsProxyAgent } = require('https-proxy-agent');

const proxyUrl = new URL(
  `http://${process.env.PROXY_HOST}:${process.env.PROXY_PORT}`
);
proxyUrl.username = process.env.PROXY_USERNAME;
proxyUrl.password = process.env.PROXY_PASSWORD;

const request = https.get(
  'https://httpbin.org/ip',
  { agent: new HttpsProxyAgent(proxyUrl) },
  (response) => {
    let body = '';
    response.setEncoding('utf8');
    response.on('data', (chunk) => (body += chunk));
    response.on('end', () => {
      if (!response.statusCode || response.statusCode >= 300) {
        throw new Error(`Proxy test failed: HTTP ${response.statusCode}`);
      }
      console.log(body);
    });
  }
);

request.setTimeout(30_000, () =>
  request.destroy(new Error('Proxy request timed out'))
);
request.on('error', console.error);