84 lines
2.4 KiB
Markdown
84 lines
2.4 KiB
Markdown
# 请求头配置 (Request Headers)
|
||
|
||
[[toc]]
|
||
|
||
源的请求头字段用于控制 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 才能加载图片的场景。
|
||
|
||
```js
|
||
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。适用于搜索结果会重定向的网站。
|
||
|
||
```js
|
||
// 方法签名
|
||
java.get(urlStr: String, headers: Map<String, String>)
|
||
java.post(urlStr: String, body: String, headers: Map<String, String>)
|
||
```
|
||
|
||
**示例**：搜索重定向场景下获取真实 URL：
|
||
|
||
```js
|
||
(() => {
|
||
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)
|
||
}
|
||
})()
|
||
```
|