MotionPro 中文文档 下载 App

MotionPro "主机格式无效"的根因与修复方法

现象

在 MotionPro 客户端里创建或编辑网关配置,点击"保存"按钮时弹出错误:

主机格式无效

或者:

主机名格式不正确,请检查主机字段

根因

99% 的情况是主机字段错误地包含了 HTTPS// 或 HTTP// 前缀。

MotionPro 的主机字段(Host)只接受纯主机名或 IP 地址。协议类型是 SSL(HTTPS)由客户端内置行为决定,不需要用户输入。

错误示例 vs 正确示例

输入内容主机字段填写端口字段填写结果
HTTPS//vpn.example.com:443HTTPS//vpn.example.com:443不填❌ "主机格式无效"
HTTPS//vpn.example.comHTTPS//vpn.example.com不填❌ "主机格式无效"
vpn.example.com:443vpn.example.com443✅ 正确
vpn.example.comvpn.example.com443✅ 正确
10.0.0.110.0.0.1443✅ 正确

修复步骤

  1. 找到报错的网关配置条目
  2. 进入编辑模式(移动端:点击配置 → 编辑;桌面端:右键 → 编辑)
  3. 在主机字段里,把开头的 HTTPS// 或 HTTP// 删掉
  4. 如果地址里包含 :443 这样的端口号,把主机名和端口分开填写——主机字段只填 vpn.example.com,端口字段填 443
  5. 点击保存

为什么客户端不自动处理

MotionPro 的主机字段校验是严格的格式校验——它要求主机字段只能包含域名字符(字母、数字、点、连字符)或纯 IP 地址。包含 :// 的值会直接被校验器拒绝。

这种设计虽然对用户不友好,但有合理的工程原因:如果自动剥离前缀,可能掩盖用户其他输入错误(比如带了 file:// 或 ftp:// 这样的协议)。严格校验可以尽早发现问题。

其他可能原因

虽然极少见,但主机格式无效还可能由以下原因触发:

但这些都远不如 HTTPS// 前缀常见。遇到主机格式无效时,先检查前缀,99% 直接解决。