故障排查

群晖 QuickConnect 无法连接

排查 Swads 通过群晖 QuickConnect 连接 NAS 时出现的 ID 不存在、服务暂停、初始化、连接超时、证书和网络错误。

Swads 会先验证 QuickConnect ID,再查询连接地址。地址解析成功后才会进入 DSM 登录流程。如果错误出现在用户名页面之前,请先排查 QuickConnect ID、NAS 状态和网络。

先做三项检查

  1. 打开群晖服务状态,确认 QuickConnect 当前正常运行。
  2. 登录 DSM,确认 NAS 可以访问互联网,并检查 QuickConnect 状态:
    • DSM 7:控制面板 > 外部访问 > QuickConnect
    • DSM 6.2:控制面板 > QuickConnect
  3. 如果设备与 NAS 在同一局域网,使用 IP 或主机地址直连,区分 DSM 问题与 QuickConnect 或外部网络问题。

根据 Swads 的错误提示处理

QuickConnect ID 不正确或不存在

输入 DSM 的 QuickConnect 页面中显示的 ID,不要输入 quickconnect.to 网址。

Swads 只接受符合以下格式的 ID:

  • 只能包含英文字母、数字和连字符;
  • 必须以英文字母开头;
  • 不能以连字符结尾。

输入框会移除空格,但完整网址和其他标点仍不是有效 ID。如果格式正确却仍提示不存在,请逐字对照 DSM 中的 ID。

暂停解析的 QuickConnect ID

该提示表示群晖 QuickConnect 服务返回了 ID 已暂停的状态。

请在 DSM 的 QuickConnect 页面和 Synology Account 中检查设备及 QuickConnect 状态。Swads 无法恢复、转移或替换被暂停的 ID。

QuickConnect 正在初始化

等待 DSM 完成 QuickConnect 信息注册后再试。在 DSM 的 QuickConnect 页面出现访问地址且没有状态错误后,再回到 Swads 重新连接。反复提交同一个 ID 不会缩短初始化时间。

请确保设备已开机并已连接互联网

依次确认:

  • NAS 已开机并连接互联网;
  • QuickConnect 已在 DSM 中启用;
  • DSM 的 QuickConnect 页面没有显示状态错误;
  • 在高级设置中,DSM 已获准使用 QuickConnect;
  • 如果外部网络无法直连 NAS,已启用 QuickConnect 中继服务。

Swads 可以发现和测试连接地址,但不能替你在 NAS 上启用 QuickConnect。

QuickConnect 连接超时

连接超时表示 Swads 未能及时完成 QuickConnect 连接,并不一定是 NAS 已离线。

请按顺序尝试:

  1. 检查群晖服务状态,然后重新连接一次。
  2. 在 Wi-Fi 和另一个网络之间切换。
  3. 暂时关闭可能改变 DNS 或 HTTPS 路径的 VPN、代理。
  4. 如果设备和 NAS 在同一局域网,测试 IP 或主机地址直连

显示网络或证书错误

查询数据中心或测试地址失败时,Swads 会显示系统返回的网络错误,包括 DNS 解析失败、拒绝连接、TLS 证书错误或请求超时。

判断是否只有 QuickConnect 连接不上

让 iPhone、iPad 或 Mac 与 NAS 连接同一个局域网,然后使用 NAS 的局域网 IP 地址或主机名添加实例。

  • 如果直连也失败,问题不只在 QuickConnect。检查 DSM 地址、HTTPS 端口、证书、防火墙,以及当前设备能否打开 DSM。
  • 如果直连能够进入 DSM 并完成登录,QuickConnect ID、QuickConnect 服务状态或外部网络路径更可能是故障来源。
  • 如果能够登录但 Download Station 无法加载,请单独检查 DSM 账号和套件权限。

IP 直连测试只用于区分 DSM 访问问题和 QuickConnect 地址发现问题。

再次连接前

  • 只重新输入 QuickConnect ID,不要粘贴完整网址。
  • 在 DSM 中确认 NAS 和 QuickConnect 服务均在线。
  • 更换一次网络,排除本地 DNS、VPN、代理或防火墙影响。
  • 同一局域网内急需访问时,先使用直连地址。

正常连接步骤请参阅使用 QuickConnect 连接。如果 DSM 中的 QuickConnect 本身仍不正常,请按照群晖的官方 QuickConnect 故障排查继续检查 NAS 的 DNS、网络接口、防火墙、IPv6、MTU 和系统时间。