跳到正文
本中心目录
代理接入

静态住宅协议接入

使用实例端点和独立凭据接入HTTP、HTTPS CONNECT与SOCKS5,并说明安全和重试边界。

只只HTTP技术团队维护更新于 2026年9月29日

静态住宅实例直接交付代理 IP、端口、用户名和密码。连接时只使用 IP 管理页面当前展示的实例信息,不复用动态住宅网关主机、子账号或客户白名单。

准备环境变量

从实例页面读取当前 IP 和端口,分别注入 STATIC_PROXY_IP、STATIC_PROXY_PORT;把实例用户名和密码从密钥管理系统注入 STATIC_PROXY_USER、STATIC_PROXY_PASS。凭据的脱敏展示示例为 ab******9Z 和 p8******K2,代码需要真实环境变量才能连接。不要把这些值写进源码、命令历史和日志。

下方检测地址 https://ipinfo.io/json 返回出口 ip、country 和 region,可用于初步核对实例地区;第三方定位可能存在偏差。

HTTP 与 HTTPS CONNECT

使用 HTTP 代理访问 HTTPS 目标时,客户端会通过代理建立 CONNECT 隧道:

Bash
curl \
  --proxy "http://${STATIC_PROXY_IP}:${STATIC_PROXY_PORT}" \
  --proxy-user "${STATIC_PROXY_USER}:${STATIC_PROXY_PASS}" \
  --connect-timeout 10 \
  --max-time 30 \
  'https://ipinfo.io/json'

代理密码包含特殊字符时,优先使用客户端提供的独立认证参数或安全 URI 编码能力,避免手工拼接后被错误解析。

SOCKS5 TCP

需要由代理端解析目标域名时使用 socks5h:

Bash
curl \
  --proxy "socks5h://${STATIC_PROXY_IP}:${STATIC_PROXY_PORT}" \
  --proxy-user "${STATIC_PROXY_USER}:${STATIC_PROXY_PASS}" \
  --connect-timeout 10 \
  --max-time 30 \
  'https://ipinfo.io/json'

当前静态住宅只说明 SOCKS5 TCP 接入,不包含 SOCKS5 UDP。

Python 示例

Python
import os
import requests
from urllib.parse import quote

proxy_url = (
    f"http://{quote(os.environ['STATIC_PROXY_USER'], safe='')}:"
    f"{quote(os.environ['STATIC_PROXY_PASS'], safe='')}@"
    f"{os.environ['STATIC_PROXY_IP']}:"
    f"{os.environ['STATIC_PROXY_PORT']}"
)

response = requests.get(
    "https://ipinfo.io/json",
    proxies={"http": proxy_url, "https": proxy_url},
    timeout=(10, 30),
)
response.raise_for_status()
print(response.json()["ip"])

连接与重试建议

  • 建立连接和读取响应分别设置超时,不允许无限等待。
  • 认证失败时先重新读取当前凭据,不要自动反复换 IP。
  • 换 IP 或修改凭据后关闭旧连接池,再使用实例页面的新信息创建连接。
  • 实例过期、异常或售后操作处理中时停止业务请求,避免制造无意义重试。
  • 不记录完整代理 URL;日志只保留实例编号、协议、耗时和脱敏错误。

接口边界

静态住宅目录、报价、采购、订单、实例与售后操作也可通过静态 API完成;具体是否开放以账户控制台的 API 状态为准。自动化程序应使用公开 API 和安全配置的代理端点,不依赖内部控制台接口或浏览器会话抓取凭据。

产品概念与购买流程见静态住宅首次购买与连接。

这篇内容解决了你的问题吗?

反馈只用于改进公开文档,不会提交账号或请求信息。