获取指定代理 - YumeBox

GET

/

proxies

/

{name}

获取指定代理

curl --request GET \
  --url http://{host}:{port}/proxies/{name} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://{host}:{port}/proxies/{name}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "http://{host}:{port}/proxies/{name}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://{host}:{port}/proxies/{name}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://{host}:{port}/proxies/{name}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "name": "示例节点 A",
  "type": "Shadowsocks",
  "now": "",
  "all": [],
  "history": [
    {
      "time": "2026-06-22T13:19:22Z",
      "delay": 108
    }
  ],
  "udp": true,
  "alive": true
}

授权

Authorization

string

header

必填

在请求头中携带 Authorization: Bearer ${secret}，其中 secret 对应配置中的 secret 字段.若未设置 secret 可省略，但强烈建议设置.

路径参数

name

string

必填

代理名称.

响应

200 - application/json

代理信息.

代理节点或策略组的信息.普通代理仅含公共字段；策略组另含 now/all 等字段.

name

string

示例:

"默认"

type

string

如 Shadowsocks、VMess、DIRECT、Selector、URLTest、Fallback、LoadBalance 等.

示例:

"Selector"

udp

boolean

是否支持 UDP.

示例:

true

uot

boolean

是否支持 UDP over TCP.

xudp

boolean

是否支持 XUDP.

tfo

boolean

是否启用 TCP Fast Open.

mptcp

boolean

是否启用 MPTCP.

smux

boolean

是否启用多路复用.

alive

boolean

当前是否存活.

示例:

true

history

object[]

延迟历史.

Show child attributes

extra

object

额外延迟历史（按测试 URL 分组）.

interface

string

绑定的网卡名称.

routing-mark

integer

路由标记.

provider-name

string

所属代理集合名称.

dialer-proxy

string

底层拨号代理名称.

now

string

当前选中的节点（策略组；LoadBalance 无此字段）.

示例:

"日本"

all

string[]

组内全部成员名称（策略组）.

示例:

["默认", "香港"]

testUrl

string

健康检查 URL（策略组）.

hidden

boolean

是否在面板中隐藏.

示例:

false

icon

string

图标 URL.

示例:

""

emptyFallback

string

成员全部不可用时的兜底节点名称.

expectedStatus

string

期望的 HTTP 响应状态码（Selector 无此字段）.

fixed

string

当前固定选中的节点名称（仅 URLTest、Fallback）.

获取指定代理

curl --request GET \
  --url http://{host}:{port}/proxies/{name} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://{host}:{port}/proxies/{name}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "http://{host}:{port}/proxies/{name}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://{host}:{port}/proxies/{name}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://{host}:{port}/proxies/{name}")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "name": "示例节点 A",
  "type": "Shadowsocks",
  "now": "",
  "all": [],
  "history": [
    {
      "time": "2026-06-22T13:19:22Z",
      "delay": 108
    }
  ],
  "udp": true,
  "alive": true
}