故障排查

排查连接问题时，先判断失败发生在网域层还是资源层。

网域连接失败

### WireGuard

检查：

• 对端地址和端口是否正确。
• 本地私钥、对端公钥、预共享密钥是否匹配。
• 本地 IP 是否带 CIDR。
• 服务端是否允许该 peer。
• 服务端是否允许转发到目标内网。

FRP

检查：

• serverAddr 和 serverPort 是否正确。
• token 是否匹配。
• transport.protocol 是否与服务端支持一致。
• user 和 clientID 是否与其他在线客户端冲突。

如果 frps 提示 client_id is already online，说明相同 user/clientID 已经在线。

### Tailscale

检查：

• 是否已登录。
• 设备是否被 Tailscale 或 Headscale 管理端授权。
• 控制服务器 URL 是否正确。
• Auth Key 是否有效。
• 当前网络是否能访问控制服务器。

如果提示没有登录链接，优先检查 Headscale 是否支持交互式登录，或改用 Auth Key。

ZeroTier

检查：

• Network ID 是否正确。
• ZeroTier 控制台是否出现新设备。
• 新设备是否已授权。
• 当前网络是否允许 ZeroTier 连接。

资源连接失败

Web 页面打不开

检查：

• URL 是否包含 http:// 或 https://。
• 当前资源是否属于正确网域。
• 目标 host 和端口是否可从该网域访问。
• HTTP 页面是否被 App Transport Security 或混合内容策略拦截。

HTML 打开但页面功能异常

可能是 Ajax、WebSocket 或重定向地址没有走通。检查页面中实际请求的地址是否仍在当前网域可达范围内。

SSH 卡在连接中

检查：

• host、port、username 是否正确。
• 当前网域是否已 ready。
• 目标 sshd 是否允许来自网域地址的连接。
• 认证方式是否正确。
• 私钥是否需要密码。

文件管理空白或打不开目录

检查：

• FTP / SMB / SFTP / WebDAV 账号密码是否正确。
• path 是否是服务端存在的目录。
• SMB path 是否包含共享名。
• 本地目录是否已通过系统文件选择器授权。

VNC 连接失败

检查：

• 端口是否正确，常见为 5900 或 5901。
• 服务端是否启用 VNC password auth。
• 密码是否正确。
• 服务端是否启用了 OmniGate 暂不支持的高级安全类型或编码。

切换 App 或息屏后资源失效

移动系统可能会暂停后台连接。OmniGate 进入后台后会在设定的超时时间（默认 5 分钟）后自动断开所有网域连接以节省电量。回到前台后，设置了自动连接的网域会自动重新上线。

如果资源无法恢复：

1. 先使用资源页菜单重新连接。
2. 如果仍失败，返回资源列表重新打开。
3. 如果网域状态异常，切换网域或重启 App。

如果希望后台保持连接不断开，可以在 设置 > 通用 > 后台保持连接 中选择"永不断开"，但会增加耗电。

切换网络后资源失效

切换 WiFi、切换到蜂窝数据或重新联网后，OmniGate 会自动检测网络变化并重连当前正在使用和设置了自动连接的网域。

如果自动重连没有生效：

1. 检查网域列表中对应网域的状态是否已恢复为已连接。
2. 使用资源页菜单重新连接。
3. 如果仍失败，返回资源列表重新打开资源。

## 日志怎么看

调试时优先看 Xcode 控制台中以下关键词：

• [ProxyRuntime]
• [Browser]
• [SSH]
• [WireGuardProxy]
• [TailscaleProxy]
• [ZeroTierProxy]
• [FRP]
• [SOCKS5]

判断原则：

• 只有网域日志，没有资源日志：资源可能还没开始连接。
• 网域 ready 后资源失败：优先查目标地址、端口、认证。
• 出现 direct mode：确认资源是否属于 None 网域，或当前代理是否未激活。