---
title: "检查端口可用性"
method: POST
path: "/admin/ports/check"
tags: ["端口映射管理"]
---

# 检查端口可用性

`POST /admin/ports/check`

检查指定Provider上的端口或端口段是否可用

## Request body

- AdminCheckPortAvailabilityRequest
  - `hostPort` integer, required — 要检查的主机端口（起始端口）
  - `mappingType` 'node' | 'controller' — 映射位置，默认节点侧
  - `portCount` integer — 端口数量（默认1，检查端口段时使用）
  - `protocol` 'tcp' | 'udp' | 'both', required — 协议类型
  - `providerId` integer, required — Provider ID

## Response `200`

检查成功

- object
  - `code` integer
  - `data` AdminCheckPortAvailabilityResponse
    - `available` boolean — 是否所有端口都可用
    - `availablePorts` integer[] — 可用的端口列表
    - `message` string — 检查结果描述
    - `portRange` string — 端口范围描述（如 "10000-10009"）
    - `suggestion` string — 建议（如果有冲突，提供替代方案）
    - `unavailablePorts` integer[] — 不可用的端口列表
  - `message` string
  - `msg` string

## Other responses

- `400` — 参数错误
- `500` — 检查失败

---

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