MotionPro 中文文档 下载 App

MotionPro 一直卡在"正在连接"状态的排查步骤

现象

点击连接网关后：

这说明流程卡在了 DNS 解析 → TCP 连接 → SSL 握手 → 认证 这四个阶段中的某一个。下面按顺序排查。

排查流程

第一步：确认 DNS 能解析网关（见"未知的主机"章节）

先在命令行/终端手动确认网关域名能解析：

# Windows
nslookup vpn.example.com
# 返回网关的 IP 地址 → DNS OK
# 返回 Non-existent domain → DNS 问题

# macOS / Linux
dig vpn.example.com +short
# 返回 IP → DNS OK
# 返回空 → DNS 问题

第二步：确认 TCP 端口可达

DNS 没问题后，测试能不能连上网关的 443 端口：

# Windows PowerShell
Test-NetConnection -ComputerName vpn.example.com -Port 443
# TcpTestSucceeded: True → TCP OK
# TcpTestSucceeded: False → TCP 不通

# macOS / Linux
nc -zv vpn.example.com 443
# Connection to port 443 [tcp/https] succeeded! → TCP OK
# timeout / refused → TCP 不通

TCP 不通可能的原因：

快速验证：用浏览器打开 HTTPS//vpn.example.com，看能不能看到登录页面。

第三步：确认 SSL 证书没问题

TCP 能连上后，测试 SSL 握手是否正常：

# macOS / Linux
openssl s_client -connect vpn.example.com:443
# 能正常握手并返回证书 → SSL OK

# Windows
# 用浏览器访问 HTTPS//vpn.example.com
# 浏览器是否报证书错误？如果有，MotionPro 也会有问题

如果浏览器报证书警告（自签名证书、证书过期、域名不匹配）：

第四步：手动指定协议版本

某些情况下 MotionPro 和 AG 网关之间的 SSL 协议版本协商会出问题。可以在网关配置的高级选项里手动指定：

第五步：MotionPro 客户端本身的问题

如果前四步都没问题（浏览器能打开网关登录页面）但 MotionPro 还是卡住：

  1. 完全退出重开：退出 MotionPro → 确认进程真的关了（Windows 任务管理器、macOS Activity Monitor）→ 重开 → 重试
  2. 删除配置重新添加：删掉当前网关配置 → 重新添加 → 重试
  3. 更新 MotionPro 到最新版本：旧版本可能有 TLS 协商的 Bug
  4. 清除应用数据（移动端）：卸载重装 MotionPro，清除所有缓存和配置

特殊情况：刚升级后出现

MotionPro 客户端自动升级到新版本后，可能出现卡在连接的情况。根据官方 Release Notes，MotionPro Windows 1.2.23 有个 Bug：

升级到最新版本后，状态栏一直显示 connecting。

这个问题在 1.2.24 版本中已修复。如果你遇到这种情况，确保升级到最新的 1.2.24+ 版本。

求助 IT

如果以上全部排查完还是卡住，把以下信息提供给 IT：