---
title: "按数据库记录重建端口转发"
method: POST
path: "/admin/port-mappings/repair"
tags: ["Admin-Port-Mapping"]
---

# 按数据库记录重建端口转发

`POST /admin/port-mappings/repair`

预览或创建后台任务，将控制端数据库中的端口映射重新应用到节点。执行时必须提供确认词 REBUILD。

## Request body

- AdminRepairPortMappingsRequest
  - `confirmation` string
  - `dryRun` boolean
  - `portIds` integer[]
  - `providerIds` integer[]

## Response `200`

OK

- CommonResponse
  - `code` integer
  - `data` unknown
  - `message` string
  - `msg` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `409` — Conflict
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

- **2026-07-12** `f1aa3505732d` — 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/admin/port-mappings/repair/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/2d2db1776645/schema)