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

# 获取指定代理



## OpenAPI

````yaml /api/openapi.json get /proxies/{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:
  /proxies/{name}:
    get:
      tags:
        - 代理
      summary: 获取指定代理
      operationId: getProxyByName
      parameters:
        - name: name
          in: path
          required: true
          description: 代理名称.
          schema:
            type: string
      responses:
        '200':
          description: 代理信息.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Proxy'
              example:
                name: 示例节点 A
                type: Shadowsocks
                now: ''
                all: []
                history:
                  - time: '2026-06-22T13:19:22Z'
                    delay: 108
                udp: true
                alive: true
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 可省略，但强烈建议设置.

````