静态住宅协议接入
使用实例端点和独立凭据接入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 隧道:
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:
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 示例
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 和安全配置的代理端点,不依赖内部控制台接口或浏览器会话抓取凭据。
产品概念与购买流程见静态住宅首次购买与连接。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。