MSLX 实例更新 API 参数互斥与逻辑校验规范

在调用 UpdateServerRequest 接口时，系统通过后端自定义验证（IValidatableObject.Validate）执行了以下四条硬性互斥与逻辑校验规则。任何违反规则的请求都将被系统拦截。

1. 核心更新源互斥规则

冲突表现： 不能同时提供 本地上传核心 和 远程下载核心。也就是说，参数 CoreFileKey 与 CoreUrl 存在独占互斥关系，只允许填写其中一个。

拦截错误信息：

冲突：不能同时提供 '核心文件上传 (CoreFileKey)' 和 '远程下载地址 (CoreUrl)'，请只选择一种更新方式。

2. 内存数值区间逻辑冲突

冲突表现： 当同时配置了最小内存 (MinM) 和最大内存 (MaxM) 时，最大内存的配置值绝对不能小于最小内存。

拦截错误信息：

逻辑错误：最大内存 ({MaxM}) 不能小于最小内存 ({MinM})。

3. Docker 网络别名与内置网络互斥

冲突表现： 当 Java 处于 Docker 运行模式时，网络别名参数 DockerNetworkAlias 仅能在用户自定义网络中配置。如果当前网络模式 DockerNetworkMode 为 Docker 的内置网络（bridge、host 或 none），则禁止配置网络别名，否则会导致容器因底层规则冲突无法拉起。

拦截错误信息：

规范错误：网络别名 (DockerNetworkAlias) 仅支持在用户自定义网络中配置。当前网络模式为 '{normMode}'，属于 Docker 内置网络，强行配置会导致容器无法拉起。

4. Docker 交换内存与最大物理内存逻辑冲突

冲突表现： 当同时限制了物理内存 (DockerMaxMemoryMb) 和交换内存 (DockerMaxSwapMb) 时，如果 Swap 限制值不为 -1（不限制）且不为 0（禁用），则交换内存（总内存上限）不能小于最大物理内存。

拦截错误信息：

逻辑错误：Docker 容器的交换内存限制 ({DockerMaxSwapMb}MB) 作为总内存上限，不能小于最大物理内存限制 ({DockerMaxMemoryMb}MB)。如果您想彻底禁用 Swap，请将交换内存的值设置为与物理内存完全一致（即填入 {DockerMaxMemoryMb} 或者 0）。

补充：实例内部目录安全隔离校验

为了防止路径穿越以及外部敏感文件损坏，以下路径参数必须为实例目录内的相对路径，且段落中禁止包含绝对路径根（如 D:/）、.、.. 或系统非法字符：

ServerPropertiesPath (服务器配置文件路径)

PluginsPath (插件目录路径)

ModsPath (模组目录路径)

WorldPath (地图目录路径)

RegionPath (区块目录路径，且必须是地图目录内的相对路径)

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Path 参数

Body 参数application/json必填

示例

{
    "id": 2,
    "name": "1.21.8 Fabric",
    "base": "D:\\MSL\\MSL\\Server1218fabric",
    "java": "docker-java",
    "core": "fabric-1.21.8.jar",
    "minM": 1024,
    "maxM": 8192,
    "args": "",
    "yggdrasilApiAddr": "",
    "backupMaxCount": 3,
    "backupDelay": 20,
    "backupPath": "MSLX://Backup/Instance",
    "monitorPlayers": true,
    "autoRestart": false,
    "forceAutoRestart": true,
    "ignoreEula": false,
    "runOnStartup": false,
    "inputEncoding": "utf-8",
    "outputEncoding": "utf-8",
    "fileEncoding": "utf-8",
    "serverPropertiesPath": "server.properties",
    "pluginsPath": "plugins",
    "modsPath": "mods",
    "worldPath": "world",
    "regionPath": "region",
    "coreUrl": "",
    "coreSha256": "",
    "coreFileKey": "",
    "dockerImage": "MSLX://DockerImage/Java/21",
    "dockerWorkingDir": "/mslx-data",
    "dockerVolumes": null,
    "dockerEnvVars": null,
    "dockerNetworkMode": "bridge",
    "dockerNetworkAlias": "",
    "dockerPorts": "25565:25565",
    "dockerCpuPercentage": null,
    "dockerCpuCores": null,
    "dockerMaxMemoryMb": null,
    "dockerMaxSwapMb": null,
    "dockerMaxStorage": null,
    "dockerUploadRate": null,
    "dockerDownloadRate": null,
    "dockerExtraArgs": null,
    "dockerExtraHosts": null,
    "forceExitDelay": 10,
    "stopCommand": "stop",
    "allowOriginASCIIColors": true,
    "forceJvmUTF8": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

更新服务端实例设置

MSLX 实例更新 API 参数互斥与逻辑校验规范

1. 核心更新源互斥规则

2. 内存数值区间逻辑冲突

3. Docker 网络别名与内置网络互斥

4. Docker 交换内存与最大物理内存逻辑冲突

补充：实例内部目录安全隔离校验

请求参数

请求示例代码

返回响应

更新服务端实例设置

MSLX 实例更新 API 参数互斥与逻辑校验规范#

1. 核心更新源互斥规则#

2. 内存数值区间逻辑冲突#

3. Docker 网络别名与内置网络互斥#

4. Docker 交换内存与最大物理内存逻辑冲突#

补充：实例内部目录安全隔离校验#

请求参数

请求示例代码

返回响应

MSLX 实例更新 API 参数互斥与逻辑校验规范

1. 核心更新源互斥规则

2. 内存数值区间逻辑冲突

3. Docker 网络别名与内置网络互斥

4. Docker 交换内存与最大物理内存逻辑冲突

补充：实例内部目录安全隔离校验