MotionPro 连接时报"未知的主机"的排查清单

现象

在 MotionPro 里点击网关条目尝试连接时，几秒钟后弹出错误：

未知的主机。请检查主机名。

或者：

Unknown host. Please check hostname.

排查顺序（按可能性从高到低）

1. 确认主机字段格式正确

先去网关配置里检查主机字段有没有 HTTPS// 前缀或其他协议标识。如果有，删掉。详见「主机格式无效」章节。

2. 确认主机名确实存在

在命令行/终端里手动解析主机名：

# Windows
nslookup vpn.example.com

# macOS / Linux
dig vpn.example.com
# 或
nslookup vpn.example.com

如果返回 "Non-existent domain" 或 "NXDOMAIN"，说明 DNS 服务器上没有这个主机名的记录。

3. 检查 DNS 服务器

你的设备当前用的是哪个 DNS 服务器？是否正确？

# Windows
ipconfig /all | findstr "DNS Servers"

# macOS / Linux
networksetup -getdnsservers Wi-Fi

如果你用的是公共 DNS（如 8.8.8.8、1.1.1.1），有可能解析不了组织内网专用的域名。有些 VPN 网关域名只在组织的内部 DNS 服务器上注册，公网 DNS 不知道。

测试方法：试试直接用 IP 地址在浏览器里打开网关。如果 IP 能访问但域名不行，就是 DNS 解析问题。

4. 确认网络环境

你是在公司/校园内网里尝试连接 VPN 吗？

有些组织的 VPN 网关域名：

• 只在公网 DNS 上注册（vpn.example.com 解析到公网 IP，从外面访问）
• 内网 DNS 里没有（因为内网直接访问 vpn 就够了）

所以在内网尝试连接 VPN 反而会报"未知的主机"。解决方法：离开内网环境（用家庭宽带、手机热点）再连。

5. 检查网关是否存活

如果以上都没问题，用浏览器尝试打开网关地址（如 HTTPS//vpn.example.com）：

• 浏览器能打开登录页面 → 网关存活，是 MotionPro 客户端的问题
• 浏览器也打不开 → 网关可能挂了，或你的网络有问题

6. 切换网络测试

用手机释放一个 WiFi 热点，让电脑/平板连热点再尝试连接：

• 这样可以排除本地网络（路由器、公司内网限制）的问题
• 如果热点下能连上，说明本地网络有问题（DNS 劫持、端口被封等）
• 如果热点下也连不上，问题在网关或账号

7. MotionPro 客户端问题

如果浏览器能打开网关但 MotionPro 连不上：

• 确认用的是最新版本的 MotionPro
• 尝试删除这个网关配置，重新添加
• 或者清除 MotionPro 的应用缓存（会清空所有配置）

可能的根因分类