请求头配置 (Request Headers)

• 1. 基本格式
• 2. 代理配置 (Proxy)
• 3. URL 附加 JS 参数
• 4. 图片链接自定义 Headers
• 5. 重定向拦截 (Redirect Interception)

源的请求头字段用于控制 HTTP 请求行为，包括代理设置、自定义 Headers 和动态参数注入。

1. 基本格式

请求头以 JSON 对象形式填写，key 区分大小写。

正确	错误
User-Agent	user-agent
Referer	referer

2. 代理配置 (Proxy)

支持 HTTP、SOCKS4、SOCKS5 三种代理协议。

协议	格式	示例
SOCKS5	socks5://host:port	{"proxy": "socks5://127.0.0.1:1080"}
SOCKS4	socks4://host:port	{"proxy": "socks4://127.0.0.1:1080"}
HTTP	http://host:port	{"proxy": "http://127.0.0.1:1080"}
HTTP（带认证）	http://host:port@user@pass	{"proxy": "http://127.0.0.1:1080@admin@secret"}

3. URL 附加 JS 参数

在 URL 后附加 JSON 对象，可在解析 URL 时执行 JavaScript 动态处理请求。

语法：

URL,{"js":"JavaScript 代码"}

示例：

https://www.example.com,{"js":"java.headerMap.put('xxx', 'yyy')"}
https://www.example.com,{"js":"java.url=java.url+'yyyy'"}

4. 图片链接自定义 Headers

在正文图片链接中附加自定义请求头，适用于需要 Referer 或 Cookie 才能加载图片的场景。

let options = {
  "headers": {
    "User-Agent": "xxxx",
    "Referrer": baseUrl,
    "Cookie": "aaa=vbbb;"
  }
};
'<img src="' + src + "," + JSON.stringify(options) + '">'

5. 重定向拦截 (Redirect Interception)

通过 java.get / java.post 方法拦截重定向，获取最终跳转后的 URL。适用于搜索结果会重定向的网站。

// 方法签名
java.get(urlStr: String, headers: Map<String, String>)
java.post(urlStr: String, body: String, headers: Map<String, String>)

示例：搜索重定向场景下获取真实 URL：

(() => {
  if (page == 1) {
    let url = 'https://www.example.com/search,' + JSON.stringify({
      "method": "POST",
      "body": "show=title&tempid=1&keyboard=" + key
    });
    return source.put('surl', String(java.connect(url).raw().request().url()));
  } else {
    return source.get('surl') + '&page=' + (page - 1)
  }
})()