静态住宅协议接入
使用实例端点和独立凭据接入HTTP、HTTPS CONNECT与SOCKS5，并说明安全和重试边界。
只只HTTP技术团队维护更新于 2026年9月4日
静态住宅实例直接交付代理 IP、端口、用户名和密码。连接时只使用 IP 管理页面当前展示的实例信息，不复用动态住宅网关主机、子账号或客户白名单。
准备环境变量
把敏感值放入本地密钥管理或进程环境，不要写进源码、命令历史和日志。
export STATIC_PROXY_IP='<proxy-ip>'
export STATIC_PROXY_PORT='<proxy-port>'
export STATIC_PROXY_USER='<proxy-user>'
export STATIC_PROXY_PASS='<proxy-pass>'
示例中的检测地址使用保留的 .invalid 域名，运行前请替换为您有权访问的公开检测目标。
HTTP 与 HTTPS CONNECT
使用 HTTP 代理访问 HTTPS 目标时，客户端会通过代理建立 CONNECT 隧道：
curl \
--proxy "http://${STATIC_PROXY_USER}:${STATIC_PROXY_PASS}@${STATIC_PROXY_IP}:${STATIC_PROXY_PORT}" \
--connect-timeout 10 \
--max-time 30 \
'https://ip.example.invalid/location'
代理密码包含特殊字符时，优先使用客户端提供的独立认证参数或安全 URI 编码能力，避免手工拼接后被错误解析。
SOCKS5 TCP
需要由代理端解析目标域名时使用 socks5h：
curl \
--proxy "socks5h://${STATIC_PROXY_USER}:${STATIC_PROXY_PASS}@${STATIC_PROXY_IP}:${STATIC_PROXY_PORT}" \
--connect-timeout 10 \
--max-time 30 \
'https://ip.example.invalid/location'
当前静态住宅只说明 SOCKS5 TCP 接入，不包含 SOCKS5 UDP。
Python 示例
import os
import requests
proxy_url = (
f"http://{os.environ['STATIC_PROXY_USER']}:"
f"{os.environ['STATIC_PROXY_PASS']}@"
f"{os.environ['STATIC_PROXY_IP']}:"
f"{os.environ['STATIC_PROXY_PORT']}"
)
response = requests.get(
"https://ip.example.invalid/location",
proxies={"http": proxy_url, "https": proxy_url},
timeout=(10, 30),
)
response.raise_for_status()
print(response.text)
连接与重试建议
- 建立连接和读取响应分别设置超时，不允许无限等待。
- 认证失败时先重新读取当前凭据，不要自动反复换 IP。
- 换 IP 或修改凭据后关闭旧连接池，再使用实例页面的新信息创建连接。
- 实例过期、异常或售后操作处理中时停止业务请求，避免制造无意义重试。
- 不记录完整代理 URL；日志只保留实例编号、协议、耗时和脱敏错误。
接口边界
当前静态住宅目录、购买、凭据和售后操作只在登录态控制台中提供，不开放客户 API 令牌形式的静态住宅接口。自动化程序可以消费已经安全配置到运行环境中的代理端点，但不能依赖内部控制台接口或浏览器会话抓取凭据。
产品概念与购买流程见静态住宅首次购买与连接。
这篇内容解决了你的问题吗？
反馈只用于改进公开文档，不会提交账号或请求信息。