GoodSync Connect 连接失败排查全流程
排查前的确认清单
开始排查前先确认几个最基础的前提条件：
- [ ] 两端设备都安装了 GoodSync 并在运行（移动端需要 Server 模式启动）
- [ ] 两端都登录了完全相同的 GoodSync Connect 账户（UserId + 密码）
- [ ] 两端都能访问互联网（浏览器打开 GoodSync 官网测试）
- [ ] 不是 GoodSync 版本太旧导致的兼容性问题（两端版本号尽量接近，最好都是 v12）
排查步骤一：账户层面
确认两端账户一致
这是最常见的原因：
- GoodSync 主界面 → Tools → GoodSync Connect Setup
- 确认显示的 UserId（邮箱地址）完全一致
- 注意大小写：Connect 账户区分大小写，
John@gmail.com≠john@gmail.com - 设备名也不能重复——如果提示设备名冲突，在其中一端修改设备名
账户验证状态
未验证的账户功能受限（最多 2 台设备）：
- 检查邮箱中是否有 GoodSync 发送的验证邮件
- 如果没收到，在 Connect 设置中点击「Resend Verification Email」
- 确认邮件没进垃圾箱
排查步骤二：网络层面
出站 HTTPS 可达性
GoodSync Connect 至少需要出站 HTTPS（端口 443）可达：
# Windows PowerShell
Test-NetConnection -ComputerName mediator.goodsync.com -Port 443
# Linux/Mac
curl -I https://mediator.goodsync.com如果无法连接：
- 检查是否有代理设置（GoodSync 可能未配置系统代理）
- 检查企业/学校网络是否拦截出站 HTTPS（某些网络只允许访问白名单域名）
- 临时换个网络环境测试（如手机热点）
客户端到 Mediator 的连接
GoodSync 会显示是否成功连接到 Mediator：
- GoodSync 主界面右下角状态栏
- 绿色 = 已连接 Mediator
- 红色 = 无法连接 Mediator
直连 vs Forwarder
GoodSync 的连接日志会显示连接策略：
# GoodSync 日志中搜索以下关键词：
# "Direct connection succeeded" → 直连成功
# "Using Forwarder" → 走了 Forwarder
# "All connection methods failed" → 完全失败如果直连失败但 Forwarder 成功：
- 正常现象，Forwarder 是备选用途
- 直连失败通常是因为 NAT 类型不支持 P2P hole punching（对称 NAT、防火墙等）
- 可以在 Connect 设置中强制要求 Forwarder 来提高成功率
排查步骤三：强制 Forwarder 测试
如果默认的连接策略（直连优先，Forwarder 兜底）都失败：
- GoodSync → Tools → GoodSync Connect Setup → Advanced
- 勾选「Forwarder Only」（强制只走 Forwarder，不尝试直连）
- 重新连接测试
如果强制 Forwarder 能成功：
- 问题在 NAT 穿透环节（两端 NAT 类型不兼容）
- 保持 Forwarder 模式即可（Forwarder 是正常设计，不是降级）
如果强制 Forwarder 也失败：
- 问题在出站 HTTPS 连通性
- 回到排查步骤二，重点检查防火墙
排查步骤四：防火墙与安全软件
Windows Defender 防火墙
- Windows 设置 → 更新和安全 → Windows 安全中心 → 防火墙
- 允许 GoodSync 应用通过防火墙
- 如果 GoodSync 不在列表中：手动添加 GoodSync.exe 和 gsync.exe
- 确保「专用网络」下允许入站和出站连接
企业安全软件
如果设备上装了企业级安全软件（Symantec、McAfee、CrowdStrike 等）：
- GoodSync 可能被安全软件的「应用控制」模块拦截
- 把 GoodSync.exe 加入白名单
- 或在安全软件中创建允许 GSTP 流量的规则
路由器级别
企业路由器或家庭路由器可能拦截 P2P 流量：
- 检查路由器的「应用程序控制」或「服务过滤」
- 确保 GoodSync / GSTP 未被列入 P2P 黑名单
- 如果可以，在路由器上配置 GoodSync 的出站白名单
排查步骤五：诊断工具
GoodSync 内建诊断
GoodSync 主界面 → Help → Run Diagnostics：
- 自动检测常见的 Connect 配置问题
- 生成诊断报告，可以发给 GoodSync 技术支持
GoodSync 日志
日志文件位置：
- Windows：
%APPDATA%\GoodSync\Logs\ - macOS：
~/Library/Application Support/GoodSync/Logs/ - Linux：
~/.goodsync/logs/
日志中搜索关键词：
"error" / "failed" / "exception" → 找具体错误信息
"mediator" → 看 Mediator 交互细节
"forwarder" → 看 Forwarder 交互
"connect" → 看连接尝试历史GoodSync Connect 在线检查
GoodSync 提供在线账户状态检查：
- 打开 GoodSync 官网的 Connect 页面
- 登录账户查看设备状态
- 确认两端设备都显示「在线」
典型错误与对策
| 错误信息 | 可能原因 | 解决方案 |
|---|---|---|
| Connection refused | 对端 GoodSync 没在运行 | 启动对端 GoodSync；移动端启动 Server 模式 |
| Device not found in Mediator | 设备未登记到 Mediator | 确保两端都已登录 Connect 账户；检查账户名拼写 |
| Forwarder connection failed | Forwarder 中转也不通 | 检查出站 443 连通性；检查防火墙 |
| Account not verified | 账户未验证 | 去邮箱点击验证链接 |
| Too many devices | 免费版设备数超限 | 移除不再使用的旧设备；或购买商业许可 |
最后的万能方案
如果所有排查都没找到问题，最后的万能方案：
- 两端 GoodSync 都完全退出（不仅是关闭窗口，还要从系统托盘/进程中退出）
- 两端 GoodSync 都重新打开并登录 Connect 账户
- 等待 30 秒让 Mediator 同步最新状态
- 再次尝试连接
这个「彻底重启」有时能清除 GoodSync 的内部状态混乱。