---
title: "Agent 反向 WebSocket 连接入口"
method: GET
path: "/v1/ws/agent"
tags: ["agent"]
---

# Agent 反向 WebSocket 连接入口

`GET /v1/ws/agent`

Rust Agent 通过此端点主动连回控制端，支持内网穿透模式

## Query parameters

- `secret` string, required

## Changes

- **2026-05-18** `24cddb042691` — 1 info
  - endpoint added
- **2025-10-22** `dcdf027169a3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api/changes/v1/ws/agent/get.md)

---

[API](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api.md) · [All operations](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oneclickvirt/oneclickvirt-api/revisions/5d38e17cc07e/schema)