---
title: "创建端口映射"
method: POST
path: "/admin/port-mappings"
tags: ["端口映射管理"]
---

# 创建端口映射

`POST /admin/port-mappings`

管理员创建新的端口映射（异步执行）

## Request body

- AdminCreatePortMappingRequest
  - `description` string — 端口用途描述
  - `guestPort` integer, required — 起始端口
  - `hostPort` integer — 可选，不指定则自动分配，指定时作为起始端口
  - `instanceId` integer, required
  - `internalHost` string — 控制端转发目标地址（容器IP）
  - `mappingType` 'node' | 'controller' — "node"（默认）或 "controller"（控制端转发）
  - `portCount` integer — 端口数量，默认1（单端口），最多1500个
  - `protocol` 'tcp' | 'udp' | 'both', required — 协议类型

## Response `200`

创建成功，返回任务ID

- object
  - `code` integer
  - `data` object
  - `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)