1. 注册山竹账号 进入山竹官网，点击右上角「注册」。
   填写：邮箱 / 手机号 → 密码 → 验证信息。
   完成注册后登录山竹控制台。
   官网注册入口

   填写注册信息
2. 实名认证 完善实名信息，可选择个人实名或企业实名。实名认证是提取代理 IP 的前置条件。
   个人实名

   企业实名
3. 选择产品 根据业务需求选择产品，例如动态短效 IP（详见「产品文档」）。
   选择产品
4. 选择计费方式 山竹代理共有两种计费方式：余额充值（按量扣费）与包时套餐（时段内使用）。
   选择计费方式
5. 获取代理 根据不同业务需求，按需配置筛选条件（地区、运营商、协议、数量、时效等），生成提取链接即可获取代理 IP；接入方法见「API文档」。
   按需配置筛选条件

核心概念

两种认证方式

动态短效 IP

动态短效 IP是山竹面向高频轮换业务推出的短时效代理产品：海量住宅 / 机房 IP 池，按分钟级时效自动更换，支持按省份、城市、运营商精准筛选，支持 HTTP / HTTPS / SOCKS5 三种协议。适合数据采集、舆情监测、SEO 分析、价格比对、账号运营等需要大量不同出口 IP 的场景。

1计费方式

2获取方式

在控制台「提取」页面配置筛选条件后生成提取链接，程序访问该链接即可批量获取 IP:Port；也可通过 /get_ips 接口在代码中动态生成链接（见「API文档」）。

验证代理 IP 可用性

拿到提取接口返回的 IP:Port 后，建议先用下面任一方法验证代理是否可用、出口 IP 是否为代理 IP，再接入业务代码。

1命令行快速验证（推荐）

通过 curl 走代理访问公网 IP 回显服务，返回的 IP 等于代理 IP 即说明代理可用：

# HTTP 代理
curl -x http://ip:port http://ifconfig.me/ip

# SOCKS5 代理
curl -x socks5://ip:port http://ifconfig.me/ip

观察连接耗时与状态码：

curl -x http://ip:port -o /dev/null -s -w "HTTP状态码:%{http_code} 耗时:%{time_total}s\n" http://ifconfig.me/ip

2Python 脚本验证

import requests

proxies = {
    "http":  "http://ip:port",
    "https": "http://ip:port",
}
r = requests.get("http://ifconfig.me/ip", proxies=proxies, timeout=10)
print("代理出口 IP:", r.text.strip())   # 应等于代理 IP 本身

3常见失败排查

通用说明

统一响应格式

大多数接口返回如下 JSON 结构（HTTP 200）：

{
  "ret": 0,          // 0=成功；1=业务失败
  "code": 1,         // 业务错误码，见「错误代码说明」
  "msg": "ok",       // 提示信息，失败时描述具体原因
  "ret_data": { },    // 业务数据
  "timestamp": 1786794848
}

接口总览

1接口详情

2调用步骤

1. 点击对应项的获取链接按钮；
2. 点击左侧菜单栏的API链接获取；
3. 使用页面上方 API 域名 + 获取到的链接，拼接后即可发起调用。

通用业务错误码

提取接口错误码（访问提取链接时返回）

访问 get_ips 生成的链接后，响应中的 code 字段为提取结果状态。开发者应据此实现重试与告警。

HTTP 状态码

白名单管理

• 部署环境公网 IP 固定时，建议锁定该白名单记录（white_lock），避免被自动清理。
• 公网 IP 会变化的场景（如家庭宽带），建议每次提取前自动添加当前出口 IP，或用定时任务刷新白名单。
• 批量操作注意单次上限：添加 100 个 / 删除 1000 个，超出请分批。

请求频率与限流

• 白名单 / 余额接口按来源 IP 限频约 2 秒一次，程序需控制调用间隔，否则会收到「请在 N 秒后再次请求」。
• 提取链接的访问同样有频率限制（错误码 111），建议按业务需要设置重试退避。

余额与用量监控

• 定时调用 look_balance，余额低于阈值时告警，避免余额不足导致提取中断（错误码 114）。
• 关注单日消费上限（错误码 123），在控制台合理设置每日消费额度。

安全与合规

• key 等同于账户凭证，务必保密：不要提交到代码仓库、不要在前端明文暴露；建议使用环境变量 / 密钥管理服务。
• 所有接口使用 HTTPS 调用，避免密钥在传输中被窃取。
• 代理 IP 仅用于合法业务场景，遵守目标网站的 robots 协议与当地法律法规。
• 对返回的 msg 做脱敏处理后再展示给终端用户，避免泄露内部信息。

健壮性建议

• 为提取、白名单等接口设置超时与重试（建议指数退避），对 111 / 115 等可重试错误自动重试。
• 短效 IP 有效期内可复用，优先做连接复用以提升性能。
• 记录提取日志（数量、地区、耗时、失败原因），便于统计与排障。