不限量动态住宅接入手册

套餐按端口配置不限流量住宅资源,程序统一连接固定网关 unlimit.residential.123proxy.cn:10253。地区和 3–30 分钟轮转周期仍按套餐统一设置。

资源连续代理端口 每端口不限流量与并发 轮转3–30 分钟 地区套餐级统一设置
打开提取代理 查看端口套餐
01
MINIMUM REQUEST

固定网关,只替换代理账密

示例中的主机固定为 unlimit.residential.123proxy.cn,端口固定为 10253。只需填写控制台生成的代理用户名和密码。

export PROXY_USER="YOUR_PROXY_USER"
export PROXY_PASS="YOUR_PROXY_PASSWORD"

curl --fail-with-body --silent --show-error \
  --proxy "http://unlimit.residential.123proxy.cn:10253" \
  --proxy-user "${PROXY_USER}:${PROXY_PASS}" \
  --connect-timeout 15 \
  --max-time 30 \
  "https://api.ipify.org?format=json"
网关端口不是需要猜测的套餐参数

10253 是不限量动态住宅的固定接入端口。套餐资源、地区和轮转配置由控制台及代理网关识别。

02
GATEWAY & PACKAGE

固定网关与套餐端口资源分开理解

套餐仍按端口数量配置资源,但客户端不应自行拼接或遍历网关端口。代码始终连接固定域名和固定端口,套餐映射由控制台生成的代理凭证识别。

固定网关域名unlimit.residential.123proxy.cn代码中直接使用
固定网关端口10253不是套餐起始端口
需要替换USER / PASSWORD控制台代理账密
套餐端口资源

用于定义当前套餐容量,具体资源关系由控制台和网关管理。

不限流量

套餐不按累计 GB 扣减,但仍应监控业务侧带宽与目标响应。

不限并发

每端口不限制并发线程;目标站点承载能力仍需由程序控制。

03
PACKAGE ROUTING

地区和轮转周期对全部端口生效

设置作用范围生效逻辑
国家或地区当前套餐全部端口不能为单个端口分别设置
轮转周期当前套餐全部端口3–30 分钟内固定,周期结束自动更换
配置同步当前套餐全部端口修改后通常需要约 3–15 分钟
不需要在用户名中设置 SESSION

端口本身承担粘性路由。持续使用同一端口即可在所选周期内尽量保持同一住宅出口。

04
AUTHENTICATION

账密或套餐 IP 白名单

账密认证

所有端口使用所选代理用户与密码。适合开发机、弹性节点和多 worker。

HOST:PORT:USER:PASSWORD
套餐 IP 白名单

白名单绑定当前不限量套餐,并对套餐全部端口生效。程序仅发送 HOST:PORT。

HOST:PORT
05
MULTI WORKER

多个 worker 共用固定代理网关

下面示例启动多个 worker,但所有请求都连接 unlimit.residential.123proxy.cn:10253。代码无需生成端口范围,只需保护并复用控制台代理账密。

import os
from concurrent.futures import ThreadPoolExecutor
import requests

host = "unlimit.residential.123proxy.cn"
port = 10253
worker_count = 8
username = os.environ["PROXY_USER"]
password = os.environ["PROXY_PASS"]
target = "https://api.ipify.org?format=json"

def run_worker(worker_id):
    proxy = f"http://{username}:{password}@{host}:{port}"
    response = requests.get(
        target,
        proxies={"http": proxy, "https": proxy},
        timeout=(15, 30),
    )
    response.raise_for_status()
    return worker_id, port, response.json()

with ThreadPoolExecutor(max_workers=worker_count) as pool:
    for worker_id, port, result in pool.map(run_worker, range(worker_count)):
        print(worker_id, port, result)
06
OUTPUT FORMAT

固定接入地址的文本格式

无论选择哪种文本顺序,HOST 和 PORT 都是固定网关;需要变化的部分是代理用户名与密码。

txt_type=1HOST:PORT:USER:PASSWORD
txt_type=2HOST:PORT@USER:PASSWORD
txt_type=3USER:PASSWORD:HOST:PORT
txt_type=4USER:PASSWORD@HOST:PORT

不要把套餐端口数量写成网关端口,也不要自行猜测其他接入域名。

07
PRODUCTION

生产使用建议

固定网关常量在代码中保留官方域名与 10253 端口,不使用主机占位符。
集中管理代理账密通过环境变量或密钥服务向多个 worker 提供凭证。
变更后重新建连地区或周期同步完成后,关闭旧连接池再验证出口。
限制单站点速率端口不限并发不代表目标站点允许无限并发。
08
TROUBLESHOOTING

常见问题

不限量动态住宅的程序接入地址是什么?

固定使用 unlimit.residential.123proxy.cn:10253。代码只替换控制台代理用户名与密码,不自行生成其他网关端口。

能否为每个端口设置不同国家?

不能。国家或地区与 3–30 分钟轮转周期均按套餐统一设置,对套餐全部端口生效。

如何让一个出口保持更久?

在控制台将套餐轮转周期设置为 3–30 分钟中的合适值,并持续使用同一网关与代理凭证。该产品不使用 SESSION 用户名。

修改地区后为什么旧连接仍是原出口?

配置同步通常需要约 3–15 分钟。等待后关闭旧连接池并重新建立代理连接。