---
title: "测试SSH连接延迟"
method: POST
path: "/admin/providers/test-ssh-connection"
tags: ["提供商管理"]
---

# 测试SSH连接延迟

`POST /admin/providers/test-ssh-connection`

测试SSH连接延迟，执行多次测试并返回最小、最大、平均延迟及推荐超时时间

## Request body

- AdminTestSSHConnectionRequest
  - `host` string, required — SSH服务器地址
  - `password` string, required — SSH密码
  - `port` integer, required — SSH端口
  - `testCount` integer — 测试次数，默认3次
  - `username` string, required — SSH用户名

## Response `200`

测试成功

- object
  - `code` integer
  - `data` AdminTestSSHConnectionResponse
    - `avgLatency` integer — 平均延迟（毫秒）
    - `errorMessage` string — 错误信息（如果失败）
    - `maxLatency` integer — 最大延迟（毫秒）
    - `minLatency` integer — 最小延迟（毫秒）
    - `recommendedTimeout` integer — 推荐的超时时间（秒），最大延迟*2
    - `success` boolean — 测试是否成功
    - `testCount` integer — 测试次数
  - `msg` string

## Other responses

- `400` — 请求参数错误
- `500` — 测试失败

## Changes

- **2025-10-22** `dcdf027169a3` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/oneclickvirt/apis/oneclickvirt-api/changes/admin/providers/test-ssh-connection/post.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/dcdf027169a3/schema)