产品用途

OpenZiti是开源零信任网络项目，提供终端接入和网络组件，适合搭建受控的应用访问。 安装入口覆盖 Windows、macOS、Linux、Android、iOS，可从发布方下载页或项目发行页获取适合设备的客户端或组件。

安装前检查与配置保护

确认设备系统、处理器架构与安装来源一致。下载后检查发布方提供的签名或校验信息，不使用来历不明的修改版。保存账号、访问密钥或配置时使用设备的安全存储，不将凭据复制到公开评论、截图或共享文档中；组织网络需要先取得管理员授权。

连接与配置

使用 OpenZiti 时先建立自己的网络或加入管理员提供的网络，再配置设备身份和访问权限。连接后通过设备地址访问已授权资源；局域网游戏还需检查端口、防火墙和游戏联网模式。

按连接阶段排查问题

首先断开当前连接并检查基础网络，排除设备本身离线。然后区分错误发生在安装、登录、建立连接还是访问目标应用阶段，保留时间和错误信息。检查系统时间、应用权限、有效配置和目标服务状态，逐项修改并复测，避免同时启动多个改变系统路由的应用，也不要长期关闭防火墙。

保留排查记录与恢复配置

记录操作系统、应用版本、发生问题的时间、目标资源和具体错误提示。分别在连接前后测试同一项任务，区分目标服务不可用与本地配置异常；需要提交工单或项目 issue 时只提供必要日志并隐藏账号、访问密钥和内部地址。测试结束后撤销临时代理与路由规则，在下一次启动前确认正常网络仍可使用。