获取指定策略组 - YumeBox

GET

/

group

/

{name}

获取指定策略组

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

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

fetch('http://{host}:{port}/group/{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}/group/{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}/group/{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}/group/{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": "默认",
  "type": "Selector",
  "now": "日本",
  "all": [
    "默认",
    "香港",
    "台湾",
    "日本",
    "美国",
    "新加坡"
  ],
  "hidden": false,
  "icon": "",
  "history": []
}

授权

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）。

最后修改于 2026年7月31日

获取所有策略组

测试策略组内节点延迟

获取指定策略组

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

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

fetch('http://{host}:{port}/group/{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}/group/{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}/group/{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}/group/{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": "默认",
  "type": "Selector",
  "now": "日本",
  "all": [
    "默认",
    "香港",
    "台湾",
    "日本",
    "美国",
    "新加坡"
  ],
  "hidden": false,
  "icon": "",
  "history": []
}