MotionPro "主机格式无效"的根因与修复方法
现象
在 MotionPro 客户端里创建或编辑网关配置,点击"保存"按钮时弹出错误:
主机格式无效
或者:
主机名格式不正确,请检查主机字段
根因
99% 的情况是主机字段错误地包含了 HTTPS// 或 HTTP// 前缀。
MotionPro 的主机字段(Host)只接受纯主机名或 IP 地址。协议类型是 SSL(HTTPS)由客户端内置行为决定,不需要用户输入。
错误示例 vs 正确示例
| 输入内容 | 主机字段填写 | 端口字段填写 | 结果 |
|---|---|---|---|
HTTPS//vpn.example.com:443 | HTTPS//vpn.example.com:443 | 不填 | ❌ "主机格式无效" |
HTTPS//vpn.example.com | HTTPS//vpn.example.com | 不填 | ❌ "主机格式无效" |
vpn.example.com:443 | vpn.example.com | 443 | ✅ 正确 |
vpn.example.com | vpn.example.com | 443 | ✅ 正确 |
10.0.0.1 | 10.0.0.1 | 443 | ✅ 正确 |
修复步骤
- 找到报错的网关配置条目
- 进入编辑模式(移动端:点击配置 → 编辑;桌面端:右键 → 编辑)
- 在主机字段里,把开头的
HTTPS//或HTTP//删掉 - 如果地址里包含
:443这样的端口号,把主机名和端口分开填写——主机字段只填vpn.example.com,端口字段填443 - 点击保存
为什么客户端不自动处理
MotionPro 的主机字段校验是严格的格式校验——它要求主机字段只能包含域名字符(字母、数字、点、连字符)或纯 IP 地址。包含 :// 的值会直接被校验器拒绝。
这种设计虽然对用户不友好,但有合理的工程原因:如果自动剥离前缀,可能掩盖用户其他输入错误(比如带了 file:// 或 ftp:// 这样的协议)。严格校验可以尽早发现问题。
其他可能原因
虽然极少见,但主机格式无效还可能由以下原因触发:
- 主机名里包含了空格(复制粘贴时不小心带的)
- 主机名里有中文或全角字符(MotionPro 只接受 ASCII 主机名)
- IP 地址格式写错了(如
10.0.0— 少了一段)
但这些都远不如 HTTPS// 前缀常见。遇到主机格式无效时,先检查前缀,99% 直接解决。