Proxy IP

国内动态代理 IP：巨量代理与 51代理两条线路，均按次提取、返回结构化 ip:port 列表。

/api/ProxyIp/

Service Description

代理 IP 服务提供两条国内动态代理线路：巨量代理（独享代理产品，key / sign 双模式凭据）与 51代理（参数名与官方提取链接一致，账密可整组自带）。调用方按需选择线路即可，不必分别对接各平台的协议与参数。

动态代理的有效期普遍很短（数十秒到数分钟），提取后可立即用于采集；用尽或过期后重新调用即可。所有线路均需项目签名。

Response Format

Every endpoint returns the same JSON envelope; the payload is always inside data:

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}

code: business status code. 10000 means success; anything else is an error — see the Error Codes page for the full list.
msg: a human-readable message you can show to end users, but never use it for program logic.
data: the payload; usually null on error. Each endpoint's Response section lists its data fields.

Judge success by code, not by the HTTP status code. View all error codes

Juliang Proxy IP

juliangip.com (dedicated proxy product, domestic dynamic IP) Signature Required

Extracts domestic dynamic proxy IPs on demand. Because the official signature is strictly bound to the parameter set (changing any parameter fails verification), two credential modes are offered (choose one): key mode = pass your business key and the server computes the signature per the official rules, so num / area / isp and any other parameter can be passed freely; custom_sign mode = pass your own precomputed signature and parameters are forwarded as-is with no server-side defaults. The business ID / key / proxy credentials are held by the platform .env by default, and the caller may also pass their own (using their own purchased order). Note: in the official docs the signature parameter is called sign, while this API exposes it as custom_sign — the platform auth parameter already uses sign, and the server passes custom_sign through to the official sign field.

GET /api/ProxyIp/juliang/proxies Total calls: 0

Get Dynamic Proxy

Extract Juliang dynamic proxy IPs and return a parsed ip:port list (JSON format by default).

Count num

Optional: number of proxies to extract per call, 1-100, default 1.

Business ID trade_no

Optional: Juliang business ID; if omitted, the platform .env value (PROXY_JULIANG_TRADE_NO) is used.

Business Key key

Optional: the server computes the signature for you, so any other parameter can be passed freely; choose either this or custom_sign; if omitted, the platform .env value (PROXY_JULIANG_KEY) is used.

Self-computed Signature custom_sign

Optional: the 32-character lowercase MD5 computed per the official rules (the server sends it as the official sign); choose either this or key. When custom_sign is provided, parameters are passed through as-is with no server-side defaults.

Proxy Username username

Optional: proxy auth username, paired with password; if omitted, the platform .env value (PROXY_JULIANG_USERNAME) is used.

Proxy Password password

Optional: paired with username; if omitted, the platform .env value (PROXY_JULIANG_PASSWORD) is used.

Proxy Protocol pt

Optional

Region Filter area

Optional: filter by region; separate multiple values with commas.

ISP Filter isp

Optional: filter by ISP (China Telecom / China Unicom / China Mobile).

Response Format result_type

Optional: xml is not supported (ip:port cannot be parsed).

Text Separator split

Optional: takes effect only when result_type=text.

Auto-add to Whitelist auto_white

Optional: automatically add the caller IP to the whitelist when extracting.

Filter IPs Extracted Today filter

Optional: filter out IPs already extracted today.

Return City Name city_name

Optional: return the city name in an extra column.

Return City Code city_code

Optional: return the city code in an extra column.

Return Remaining Time ip_remain

Optional: return the remaining lifetime of each IP in an extra column.

Return Auth Info auth_info

Optional: return the username/password auth info in an extra column.

Only one of key or custom_sign may be provided; providing both returns 20003.
When neither is provided, the platform .env key is used in key mode; if the platform is not configured, 20011/40001 is returned.
In custom_sign mode (self-computed signature) the signature is strictly bound to the parameter set; changing any parameter requires recomputing the signature, otherwise the upstream API returns 401.
username and password must be provided together (providing only one returns 20001); when provided together, each proxy entry includes a ready-to-use proxy field.
When extra-column options (city_name / ip_remain / auth_info, etc.) are enabled, the extra information of each IP is placed in the extra field and does not affect ip / port parsing.

Response Common envelope

Field	Type	Description
proxies	array	Proxy list
proxies[].ip	string	Proxy IP
proxies[].port	string	Proxy port
proxies[].protocol	string	Protocol: HTTP / SOCKS5
proxies[].region	string	Region note (fixed as "Domestic dynamic")
proxies[].extra	string	Extra columns; only present when extra-column params are enabled
proxies[].username	string	Proxy auth username; only when credentials are provided as a pair
proxies[].password	string	Proxy auth password; only when credentials are provided as a pair
proxies[].proxy	string	Ready-to-use proxy URL; only when credentials are provided as a pair
total	int	Total returned
fetched	int	Returned this time

Example response

{
  "proxies": [
    {"ip": "27.28.167.190", "port": "36629", "protocol": "HTTP", "region": "国内动态",
     "username": "user", "password": "pass",
     "proxy": "http://user:pass@27.28.167.190:36629"}
  ],
  "total": 1,
  "fetched": 1
}

51代理 IP

51daili.com（bapi.51daili.com 不限量套餐接口，国内动态 IP） Signature Required

按次提取国内动态代理 IP，走 51代理的不限量套餐提取接口。参数名与官方控制台生成的提取链接完全一致，可直接照抄。账号三件套（uid / accessName / accessPassword）与套餐标识（packid / pid）默认由平台 .env 持有，调用方也可整套传自己的（使用自己购买的套餐）——只传其中一部分会被拒绝，因为混用两个账号的凭据没有意义（pid 是不限量套餐 ID，缺了上游会直接回「不限量套餐id不能为空」）。其余参数（qty / time / port / format / field / linePoolIndex）不传则用平台默认值。

GET /api/ProxyIp/51daili/proxies Total calls: 0

Get Dynamic Proxy

提取 51代理动态 IP，返回解析好的 ip:port 列表（默认 JSON 格式），每条另带一个 `proxy` 字段 —— 那是**经国内中转**、在任何网络下都能直接用的形态。

Count qty

选填：单次提取数量，>=1，默认 1，最大 100

Proxy Protocol port

Optional

稳定使用时长 time

选填：本线路默认 2（照抄平台控制台生成的提取链接）；实际可用时长以账号套餐为准

Response Format format

选填：不支持 html（无法解析出 ip:port）

返回字段 field

选填：英文逗号分隔；不含 ipport 时上游会把 ip / port 拆成两个字段

线路池索引 linePoolIndex

选填：-1=不限

账号 ID uid

选填：不传则用平台 .env（PROXY_51DAILI_UID）

账号名 accessName

选填：不传则用平台 .env（PROXY_51DAILI_ACCESS_NAME）

账号密码 accessPassword

选填：不传则用平台 .env（PROXY_51DAILI_ACCESS_PASSWORD）

套餐 ID packid

选填：不传则用平台 .env（PROXY_51DAILI_PACKID）

不限量套餐 ID pid

选填：本接口必填项（缺了上游回「不限量套餐id不能为空」）；不传则用平台 .env（PROXY_51DAILI_PID）

提取标识 rid

选填：控制台提取链接上的 rid；不传则用平台 .env（PROXY_51DAILI_RID）

uid / accessName / accessPassword / packid / pid 必须整组传入：只传一部分返回 20001，一个都不传则整组回退平台 .env。
平台 .env 未配置凭据时返回 40001（并说明缺哪些变量）。
⚠️ 51代理的节点只从中国内地网络可达：海外服务器拿正确账密直连也是一律 TCP 超时（实测 0/5）。因此平台尽量再给每条补一个 proxy 字段 —— 那是经国内中转的形态（http://<会话键>:<密钥>@<中转机>:17890），可直接塞进 requests 的 proxies（{"http": proxy, "https": proxy}），由国内中转机去连 51代理节点并把数据回传，因此任何网络环境都能用。平台未配置中转（.env 的 PROXY_RELAY_URL / PROXY_RELAY_SECRET 为空）时，该字段不出现，返回与旧版一致。
proxy 与同条的 ip/port 不保证是同一条节点：中转形态的出口由中转机从同一个 51代理账号实时取，ip/port/region 描述的是「直连形态会拿到什么」。
同一个 proxy 反复使用会粘住同一个出口 IP（中转机按会话键复用，TTL 10 分钟）；换一条 proxy 就换一个出口。
中转形态只对中转机白名单内的来源 IP 可用（见中转机 hj_relay.env 的 HJ_RELAY_ALLOW_IPS，目前是本机与备用出口两个 IP）；新机器接入需把它的出口 IP 加进去。
format=txt 时上游改回文本行（ip:port|地区|到期时间|运营商），服务端同样会解析成结构化字段；该模式下拿不到上游错误码，解析不出 ip:port 时会把上游原文作为失败原因返回。
账号密码错误时上游返回 10102，服务端会剥掉消息里的账号名前缀再返回。

Response Common envelope

Field	Type	Description
proxies	array	Proxy list
proxies[].ip	string	Proxy IP
proxies[].port	string	Proxy port
proxies[].protocol	string	Protocol: HTTP / SOCKS5
proxies[].region	string	Region name (may be empty)
proxies[].region_code	string	Region code (may be empty)
proxies[].isp	string	ISP (may be empty)
proxies[].end_time	string	Expiry time (may be empty)
proxies[].proxy	string	Proxy URL via domestic relay; absent when no relay is configured
total	int	Total returned
fetched	int	Returned this time

Example response

{
  "proxies": [
    {"ip": "1.2.3.4", "port": "8080", "protocol": "HTTP", "region": "曲靖市",
     "region_code": "530300", "isp": "电信", "end_time": "2026-10-01 13:26:28",
     "proxy": "http://sess:secret@relay.example.com:17890"}
  ],
  "total": 1,
  "fetched": 1
}

Endpoint catalog 2

Juliang Proxy IP

GET Get Dynamic Proxy /api/ProxyIp/juliang/proxies

51代理 IP

GET Get Dynamic Proxy /api/ProxyIp/51daili/proxies

Auth Settings

Stored locally only