> ## Documentation Index
> Fetch the complete documentation index at: https://yumebox.gal.tf/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取代理集合内指定代理

> 获取代理集合内指定代理的信息。路径形如 /providers/proxies/{providerName}/{name}。



## OpenAPI

````yaml /api/openapi.json get /providers/proxies/{providerName}/{name}
openapi: 3.1.0
info:
  title: Mihomo 外部控制器 API
  version: 1.1.0
  description: >-
    Mihomo（clash.meta）内核通过外部控制器（external-controller）暴露的 RESTful
    API，可用于查询状态、切换节点、测试延迟、管理连接与 provider 等。TCP / TLS 外部控制器在配置了 secret 时需要携带
    Authorization: Bearer ${secret}；Unix socket / Windows named pipe 访问不会校验
    secret。鉴权与路径以 MetaCubeX mihomo hub/route 实现为准；可在右侧 Try it 面板中修改 host/port（示例
    external-controller: 0.0.0.0:9093）。
servers:
  - url: http://{host}:{port}
    variables:
      host:
        default: 127.0.0.1
        description: 外部控制器监听地址 / mihomo 后端的局域网 IP。
      port:
        default: '9093'
        description: '外部控制器监听端口；默认值对齐 mihomo 示例配置 external-controller: 0.0.0.0:9093。'
security:
  - bearerAuth: []
tags:
  - name: 日志
    description: 实时日志流。
  - name: 流量信息
    description: 实时上下行流量统计。
  - name: 内存信息
    description: 实时内存占用统计。
  - name: 版本信息
    description: 内核版本信息。
  - name: 缓存
    description: FakeIP / DNS 缓存清理。
  - name: 运行配置
    description: 运行配置的读取、重载与修改。
  - name: 更新
    description: 内核、面板与 GEO 数据库的更新。
  - name: 策略组
    description: 策略组的查询与延迟测试。
  - name: 代理
    description: 代理节点的查询、选择与延迟测试。
  - name: 代理集合
    description: 代理集合（proxy provider）的查询、更新与健康检查。
  - name: 规则
    description: 规则的查询与临时禁用。
  - name: 规则集合
    description: 规则集合（rule provider）的查询与更新。
  - name: 连接
    description: 连接信息的查询与关闭。
  - name: 域名查询
    description: 通过内核 DNS 进行域名解析。
  - name: 存储
    description: 内核键值存储的读写。
  - name: DEBUG
    description: 调试相关端点（需内核日志级别为 debug）。
paths:
  /providers/proxies/{providerName}/{name}:
    get:
      tags:
        - 代理集合
      summary: 获取代理集合内指定代理
      description: 获取代理集合内指定代理的信息。路径形如 /providers/proxies/{providerName}/{name}。
      operationId: getProxyProviderProxyByName
      parameters:
        - name: providerName
          in: path
          required: true
          description: 代理集合名称。
          schema:
            type: string
        - name: name
          in: path
          required: true
          description: 代理名称。
          schema:
            type: string
      responses:
        '200':
          description: 代理信息。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Proxy'
components:
  schemas:
    Proxy:
      type: object
      description: 代理节点或策略组的信息。普通代理仅含公共字段；策略组另含 now/all 等字段。
      properties:
        name:
          type: string
          example: 默认
        type:
          type: string
          description: 如 Shadowsocks、VMess、DIRECT、Selector、URLTest、Fallback、LoadBalance 等。
          example: Selector
        udp:
          type: boolean
          description: 是否支持 UDP。
          example: true
        uot:
          type: boolean
          description: 是否支持 UDP over TCP。
        xudp:
          type: boolean
          description: 是否支持 XUDP。
        tfo:
          type: boolean
          description: 是否启用 TCP Fast Open。
        mptcp:
          type: boolean
          description: 是否启用 MPTCP。
        smux:
          type: boolean
          description: 是否启用多路复用。
        alive:
          type: boolean
          description: 当前是否存活。
          example: true
        history:
          type: array
          description: 延迟历史。
          items:
            $ref: '#/components/schemas/DelayHistory'
        extra:
          type: object
          description: 额外延迟历史（按测试 URL 分组）。
          additionalProperties: true
        interface:
          type: string
          description: 绑定的网卡名称。
        routing-mark:
          type: integer
          description: 路由标记。
        provider-name:
          type: string
          description: 所属代理集合名称。
        dialer-proxy:
          type: string
          description: 底层拨号代理名称。
        now:
          type: string
          description: 当前选中的节点（策略组；LoadBalance 无此字段）。
          example: 日本
        all:
          type: array
          items:
            type: string
          description: 组内全部成员名称（策略组）。
          example:
            - 默认
            - 香港
        testUrl:
          type: string
          description: 健康检查 URL（策略组）。
        hidden:
          type: boolean
          description: 是否在面板中隐藏。
          example: false
        icon:
          type: string
          description: 图标 URL。
          example: ''
        emptyFallback:
          type: string
          description: 成员全部不可用时的兜底节点名称。
        expectedStatus:
          type: string
          description: 期望的 HTTP 响应状态码（Selector 无此字段）。
        fixed:
          type: string
          description: 当前固定选中的节点名称（仅 URLTest、Fallback）。
    DelayHistory:
      type: object
      properties:
        time:
          type: string
          example: '2026-06-22T10:00:00.000Z'
        delay:
          type: integer
          example: 109
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        在请求头中携带 Authorization: Bearer ${secret}，其中 secret 对应配置中的 secret 字段。若未设置
        secret 可省略，但强烈建议设置。

````