ZeroTier 网关

ZeroTier 网关用于接入 ZeroTier 网络。它不是系统级 VPN，不会修改系统网络配置，也不会影响其他 App 的网络流量，仅为本 App 内的资源提供数据通道。

配置项

字段	说明
名称	网关显示名
Network ID	ZeroTier 网络 ID
Identity Public	节点身份公钥，可由 App 生成或保存
Identity Secret	节点身份私钥，需要妥善保存
本地代理地址	默认 127.0.0.1
本地代理端口	默认 9082
打开时自动连接	打开 App 时自动激活此网关，默认关闭

基本流程

1. 添加 ZeroTier 网关并填写 Network ID。
2. 保存并尝试连接。
3. 到 ZeroTier Central 或自建控制器批准新设备。
4. 重新打开资源。

授权设备

ZeroTier 网络通常需要在控制台授权新节点。没有授权时，OmniGate 可能能启动节点，但无法访问虚拟网络内资源。

常见问题

控制台看不到新设备

确认：

• Network ID 是否正确。
• 当前网络是否能访问 ZeroTier 根服务器或控制器。
• App 是否有可用网络。

已授权但资源打不开

检查：

• 目标资源 IP 是否在 ZeroTier 分配网段内。
• 目标设备防火墙是否允许来自 ZeroTier 地址访问。
• 资源端口是否正确。

当前实现说明

ZeroTier 使用 App 内节点，不是系统 VPN。它只服务于 OmniGate 内资源，不会让其他 App 走 ZeroTier 网络。

自动连接

ZeroTier 网关支持"打开时自动连接"开关。开启后：

• App 启动时会自动激活此网关。
• 网关列表中该网关会显示 auto 标签。
• 开启开关后会立即触发连接并保存配置。

关闭开关后网关列表显示 lazy 标签，只有打开该网关下的资源时才会连接。

开启自动连接可以省去等待网关连接的时间，但会增加 App 内存和耗电。建议只为常用的网关开启。