2026家庭住宅代理IP接入教程：API对接、指定城市切换、Socks5/UDP协议配置一步到位——九零代理

“代理IP买回来了，结果对着控制台发了半天呆，不知道怎么接进自己的系统里。文档写了一堆英文术语，看都看不懂，更别说什么城市切换、API调用、UDP穿透了。”

一、为什么别人的代理接入只要五分钟，你却要折腾一整天？

在正式进入教程之前，我想先帮家人们卸下一个心理包袱：你接入慢、配置难，不是因为你的技术不行，而是因为你手里的代理产品没有为你考虑到这些。

我们来看看市面上常见的尴尬情况：

服务商A：只提供静态IP列表，每次要用都得手动复制粘贴，IP失效了全靠自己写脚本去探测更换。想用API动态获取IP？对不起，没有这个功能。
服务商B：号称有API，但返回的IP只是随机分配的，你想指定城市？它告诉你“无法保证，只能尽量”。做地域性业务的家人们直接傻眼。
服务商C：只支持HTTP协议，你问能不能用Socks5，客服说“暂时不支持”。至于UDP，对方表示“没听说过”。
服务商D：倒是支持Socks5了，但是一配进你的网络请求库就报Authentication failed，查半天发现它们的认证方式和标准Socks5有微小差异，需要你用特殊参数绕过。

这种体验，就像买了一辆宣称能跑赛车场的车，结果提车时发现连轮胎都没配齐。九零代理在做的事情，就是让你拿到的是整车、满油、带导航，坐上去就能开。

二、API对接：让你的代码动态掌控千万住宅IP

家人们，静态IP交付的时代已经过去了。真正现代化的数据采集系统，必须能够通过API动态获取IP、管理会话、监控状态。这不仅能大幅提升自动化程度，也是实现地域切换和智能调度的基础。

2.1 获取API接入凭证

登录九零代理的用户控制台，在左侧菜单找到“API管理”。你可以在这里生成一对专属于你的API Key和Secret。请务必妥善保管，就如同你服务器上的私钥一样。

2.2 调用API获取可用代理节点

九零代理提供RESTful风格的API，任何支持HTTP请求的语言都能轻松调用。下面以Python为例，演示如何根据需求拉取特定城市、特定运营商的住宅IP。

import requests
import json

API_ENDPOINT = "https://api.90proxy.com/v1/proxy/get"
API_KEY = "your_api_key_here"
API_SECRET = "your_api_secret_here"

def get_proxy(city="上海", isp="电信", protocol="socks5", count=1):
    """
    获取九零代理住宅IP
    :param city: 城市名称，如'北京'、'广州'
    :param isp: 运营商，可选'电信'/'联通'/'移动'
    :param protocol: 协议类型，可选'http'/'socks5'
    :param count: 获取数量
    """
    payload = {
        "api_key": API_KEY,
        "api_secret": API_SECRET,
        "city": city,
        "isp": isp,
        "protocol": protocol,
        "count": count,
        "format": "json"
    }
    resp = requests.post(API_ENDPOINT, json=payload, timeout=10)
    data = resp.json()
    if data["code"] == 200:
        proxies = data["data"]["proxies"]
        for p in proxies:
            print(f"获取到IP: {p['ip']}:{p['port']}  城市: {p['city']}  运营商: {p['isp']}")
        return proxies
    else:
        print(f"获取失败: {data['msg']}")
        return []

2.3 在你的采集代码里无缝接入

拿到代理IP后，你可以直接将它配置到requests、Scrapy、Playwright等任何主流工具中。以requests为例：

proxy_ip = "获取到的IP"
proxy_port = "获取到的端口"
proxy_user = "你的九零账号"
proxy_pass = "你的九零密码"

proxies = {
    "http": f"socks5://{proxy_user}:{proxy_pass}@{proxy_ip}:{proxy_port}",
    "https": f"socks5://{proxy_user}:{proxy_pass}@{proxy_ip}:{proxy_port}"
}

response = requests.get("https://www.target-website.cn", proxies=proxies)
print(response.status_code)

核心优势： 你不需要再手工维护任何IP列表，不需要写复杂的心跳检测脚本。IP的可用性、纯净度、城市准确性，全部由九零代理在服务端保障。你的代码只需要专注一件事——用这些IP拿到你需要的数据。

三、指定城市切换：让你的采集“指哪打哪”，精准捕捉地域化数据

很多业务场景对IP的地域性要求极高。比如采集某本地生活平台的店铺评价，你如果用北京的IP去请求上海的店铺数据，平台可能会返回一份针对北京用户的差异化内容，或者干脆触发异地登录警告。竞价广告监测、O2O业务验证这些场景更是如此，错位的城市就是错误的数据，错误的数据就是亏损的决策。

3.1 为什么服务商A做不到精确到城市？

服务商A的IP池来自全国各地的网上收集，IP地理定位信息往往只是粗略的省份级别，甚至完全缺失。你问他这个IP是哪个城市的，他只能说“大概是华东地区”，这种模糊度在商业应用中几近于零。

3.2 九零代理的“精确到区”城市路由

九零代理在全国所有省、自治区、直辖市的300+个城市、数千个区县都部署了真实的家庭住宅节点。当你通过API或隧道入口请求指定城市时，我们的智能调度中心会将你的流量精准路由到目标城市的光猫和路由器出口。

配置方式一：API参数指定（见上面的代码示例）

配置方式二：隧道入口通过自定义Header动态指定

如果你使用隧道代理模式（即一个固定入口地址，随时切换出口IP），可以在每次请求的HTTP Header中添加X-90Proxy-City字段，实现单次请求级别的城市切换。

headers = {
    "User-Agent": "...",
    "X-90Proxy-City": "成都"
}
resp = requests.get(url, headers=headers, proxies=tunnel_proxies)

配置方式三：控制台预设任务模板

对于固定的采集任务，你可以在九零代理控制台创建“任务模板”，预设好目标城市、运营商、协议类型等参数。每次启动任务时，系统自动分配符合条件的最佳IP池，你只需调用模板ID即可，一切批量操作都极为简洁。

这意味着什么呢？ 意味着你可以在一个采集周期内，用成都的住宅IP看成都用户看到的页面，下一秒又切换到深圳的IP看深圳用户看到的情形。所有切换都在毫秒级完成，对目标网站来说，这些访问完全来自不同的、真实的本地居民。你的数据地域精准度将达到前所未有的高度。

四、Socks5/UDP协议配置：不止于HTTP，让你的所有网络应用都穿上隐身衣

很多家人们做数据采集，以为HTTP协议能搞定一切。但实际上，越来越多的动态内容、实时数据，是通过WebSocket、UDP流等方式传输的。例如某些直播平台的数据监控、金融数据的实时推送、物联网设备的接口调试，这些场景必须依赖更底层的Socks5代理，甚至是UDP代理。

服务商C不提供Socks5，服务商D的Socks5有兼容问题，那么九零代理可以为你解决什么？

4.1 Socks5协议的一键开启

九零代理的家庭住宅节点同时支持HTTP和Socks5协议。在你的控制台中创建API密钥时，可以直接勾选“允许Socks5连接”。获取到的IP列表里，Socks5节点会明确标注端口和认证方式。

对于Python用户： 安装支持Socks5的requests版本（pip install requests[socks]或使用pysocks），然后按上面示例配置即可。

对于其他语言用户： Java、Go、Node.js等同样有对应Socks5支持的库，配置方式与标准HTTP代理无异，仅需将协议前缀改为socks5://。

4.2 UDP穿透：让你的实时数据采集如虎添翼

这是绝大多数代理服务商不愿意做、也做不到的功能。UDP是无连接协议，代理转发对资源占用大、技术复杂度高。但九零代理通过自研的高性能转发引擎，支持了全量的UDP代理。

适用场景举例：

DNS解析代理：通过UDP转发DNS请求，防止本地DNS泄露，同时实现域名解析的地域化。
实时音视频相关的数据流采集：某些应用的心跳包或状态同步包通过UDP发送，不代理UDP将导致数据不完整。
内部网络隧道：将本地服务的UDP流量通过九零代理的住宅IP转发出去，保护真实出口。

配置方法： 在获取代理时，指定协议为udp或在Socks5隧道中开启UDP转发。对于支持Socks5 UDP associate的工具，直接配置Socks5代理即可自动启用UDP。对于纯UDP应用，可以通过我们提供的udp-over-proxy转发小程序，将本地UDP包封装后通过九零代理的节点路由。

# 示例：使用九零代理转发本地12345端口的UDP流量
./90proxy-udp-forward --local-port 12345 --proxy-user your_user --proxy-pass your_pass --proxy-host tunnel.90proxy.com --proxy-port 8080

你原本复杂的UDP穿透难题，现在变成了一个简单的命令行参数。

五、排错与检验：接入后如何确认一切正常？

教程的最后，我们附上一份验证清单。完成配置后，依次检查以下项目，确保你的九零代理接入万无一失。

检查项	期望结果	异常处理
通过API成功获取到至少1个IP	API返回代理列表，`code`为200	检查API Key/Secret是否正确，IP白名单是否添加
使用获取到的代理访问`http://httpbin.org/ip`	返回的IP显示为住宅IP，非机房IP	若返回本地IP，检查代理配置是否生效
通过`X-90Proxy-City`指定城市后再次请求httpbin	返回IP的地理位置属于指定城市	检查Header字段名拼写，有些应用对自定义Header命名有要求
使用Socks5代理访问https网站	成功加载页面，无证书错误	检查Socks5认证密钥是否正确，代理端口是否支持Socks5
发送UDP包到指定测试服务器并收到回包	延迟正常，数据完整	检查防火墙是否放行相关端口，确认UDP转发程序正确运行

如果排查仍然困难，请直接联系九零代理技术支持。 我们的工程师团队将会与你进行一对一的远程协作，从网络抓包到应用日志逐层定位问题。绝不像某些服务商一样让你“自己去网上搜答案”。

2026家庭住宅代理IP接入教程:API对接、指定城市切换、Socks5/UDP协议配置一步到位 - 九零代理