接口列表

所有代理服务支持的接口端点及参数说明。

ALL /

默认代理路径:根据配置的 Host 和当前路径转发请求。

参数来源

目标 URL 由以下优先级生成:

  1. 请求头 proxy_host
  2. Cookie proxy_host(通过 /__proxy__/ 接口 设置)
  3. 符合 ${1}.w.yice.eu.org 格式的 Host 自动解析(详见 Host 解析规则

响应示例(未设置 Host 时)

{ "msg": "Please set host first!", "method": "GET", "host": "proxy.example.com", "path": "/", "ip": "192.168.1.1", "user-agent": "Mozilla/5.0 ..." }

ALL /__proxy__/

用于设置/获取目标 Host,或直接通过 ?url= 参数转发请求。

参数说明

<
参数 <位置 <说明
host 查询参数(?host=xxx) 设置目标 Host(如 https://example.com),会存入 Cookie
url 查询参数(?url=xxx) 直接转发请求到该 URL(优先级高于 Host 配置)

示例 1:设置 Host

GET /__proxy__/?host=https://httpbin.org { "host": "https://httpbin.org", "status": true }

示例 2:直接转发 URL

GET /__proxy__/?url=https://httpbin.org/get?a=1

GET /__proxy__/fetch

通过 Base64 编码的 JSON 参数转发请求(适合复杂请求场景)。

参数说明

<
参数 <位置 <说明
arg 查询参数(?arg=xxx) Base64 编码的 JSON 字符串,包含 url/method/headers 等信息

使用步骤

  1. 构建 JSON 对象:{ "url": "目标URL", "method": "GET", "headers": {} }
  2. JSON 字符串转 Base64(支持 URL 安全编码)
  3. 对 Base64 结果执行 encodeURIComponent()
  4. 作为 ?arg=xxx 传入接口

详细示例见 单接口详情