代理 IP

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

/api/ProxyIp/

服務說明

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

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

響應格式

所有接口返回同一個 JSON 信封，業務數據都在 data 裡：

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

code：業務狀態碼，10000 表示成功；其餘為各類錯誤，完整清單見「錯誤碼」頁。
msg：給人看的提示文案，可直接展示給終端用戶，但不要用它做邏輯判斷。
data：業務數據；出錯時通常為 null。各接口 data 的具體字段見該接口的「響應說明」。

判斷成功與否請看 code，不要依賴 HTTP 狀態碼。查看完整錯誤碼

巨量代理 IP

juliangip.com（獨享代理產品，國內動態 IP）需簽名

按次提取國內動態代理 IP。官方簽名與參數集嚴格綁定（改任何參數都會驗簽失敗），故提供兩種憑據模式（二選一）：key 模式 = 傳業務密鑰，由服務端按官方規則代算簽名，可自由傳 num / area / isp 等任意參數；custom_sign 模式 = 傳自己算好的簽名，參數原樣透傳、服務端不補任何默認值。業務編號 / 密鑰 / 代理賬密默認由平臺 .env 持有，調用方也可傳自己的（使用自己購買的訂單）。註：官方文檔裡的簽名參數叫 sign，本接口對外叫 custom_sign——平臺自身的鑑權參數已佔用 sign，服務端會把 custom_sign 原樣傳給官方接口的 sign 字段。

GET /api/ProxyIp/juliang/proxies 累計調用 0 次

獲取動態代理

提取巨量代理動態 IP，返回解析好的 ip:port 列表（默認 JSON 格式）。

數量 num

選填：單次提取數量，1-100，默認 1

業務編號 trade_no

選填：巨量代理業務編號；不傳則用平臺 .env（PROXY_JULIANG_TRADE_NO）

業務密鑰 key

選填：由服務端代算簽名，可自由傳其它參數；與 custom_sign 二選一；不傳則用平臺 .env（PROXY_JULIANG_KEY）

自算簽名 custom_sign

選填：按官方規則算好的 32 位小寫 MD5（服務端會作為官方的 sign 發送）；與 key 二選一；傳 custom_sign 時參數原樣透傳，服務端不做任何補全

代理賬號 username

選填：代理認證賬號，與 password 成對；不傳則用平臺 .env（PROXY_JULIANG_USERNAME）

代理密碼 password

選填：與 username 成對；不傳則用平臺 .env（PROXY_JULIANG_PASSWORD）

代理協議 pt

選填

地區篩選 area

選填：按地區篩選，多個用英文逗號分隔

運營商篩選 isp

選填：按運營商篩選（電信 / 聯通 / 移動）

返回格式 result_type

選填：不支持 xml（無法解析出 ip:port）

文本分隔符 split

選填：僅 result_type=text 時生效

自動加白名單 auto_white

選填：提取時自動把調用方 IP 加入白名單

過濾今日已提取 filter

選填：過濾掉今天已提取過的 IP

返回城市名 city_name

選填：在附加列返回城市名

返回城市編碼 city_code

選填：在附加列返回城市編碼

返回剩餘時長 ip_remain

選填：在附加列返回該 IP 剩餘可用時長

返回認證信息 auth_info

選填：在附加列返回賬密認證信息

key 與 custom_sign 只能二選一，同傳返回 20003。
兩者都不傳時：用平臺 .env 的密鑰走 key 模式；平臺未配置則返回 20011/40001。
custom_sign 模式（自算簽名）的簽名與參數集嚴格綁定，改動任何參數都必須重算簽名，否則上遊接口返回 401。
username 與 password 必須成對出現（傳一個會返回 20001）；成對提供時每條代理附帶可直接使用的 proxy 字段。
附加列參數（city_name / ip_remain / auth_info 等）開啟後，該 IP 的附加內容統一放在 extra 字段，不影響 ip / port 解析。

響應說明外層統一格式

字段	類型	說明
proxies	array	代理列表
proxies[].ip	string	代理 IP
proxies[].port	string	代理端口
proxies[].protocol	string	協議：HTTP / SOCKS5
proxies[].region	string	歸屬說明（固定為「國內動態」）
proxies[].extra	string	附加列內容；僅開啟附加列參數時出現
proxies[].username	string	代理認證賬號；隨賬密成對出現時才有
proxies[].password	string	代理認證密碼；隨賬密成對出現時才有
proxies[].proxy	string	可直接使用的代理地址；隨賬密成對出現時才有
total	int	返回總數
fetched	int	本次返回數

返回示例

{
  "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）需簽名

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

GET /api/ProxyIp/51daili/proxies 累計調用 0 次

獲取動態代理

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

數量 qty

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

代理協議 port

選填

稳定使用时长 time

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

返回格式 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，服务端会剥掉消息里的账号名前缀再返回。

響應說明外層統一格式

字段	類型	說明
proxies	array	代理列表
proxies[].ip	string	代理 IP
proxies[].port	string	代理端口
proxies[].protocol	string	協議：HTTP / SOCKS5
proxies[].region	string	地區名（可能為空）
proxies[].region_code	string	地區編碼（可能為空）
proxies[].isp	string	運營商（可能為空）
proxies[].end_time	string	到期時間（可能為空）
proxies[].proxy	string	經國內中轉的代理地址；未配置中轉時無此字段
total	int	返回總數
fetched	int	本次返回數

返回示例

{
  "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
}

接口目錄 2

巨量代理 IP

GET 獲取動態代理 /api/ProxyIp/juliang/proxies

51代理 IP

GET 獲取動態代理 /api/ProxyIp/51daili/proxies

鑑權設置

僅本機保存