六端 v6.8.2 · 安装耗时 35–70 秒 · 失败按现象查
本页把安装拆成可执行的动作:先确认前置条件,再按平台走步骤,最后用核对项收尾。失败的一节按现象组织,不按平台组织。
本页速览| 覆盖端数 | 6 端(桌面 2、移动 2、路由器与命令行各 1) |
|---|
| 安装耗时 | 35–70 秒(固态盘条件,桌面两端) |
|---|
| 授权项 | 2 项(虚拟网卡、系统 VPN 权限) |
|---|
| 失败分类 | 6 类现象(表 2 逐条对应) |
|---|
| 回退顺序 | 4 步:换包、换账户、关防护、换设备 |
|---|
| 旧版回退 | 90 天内可取(自发版日起算) |
|---|
6 端覆盖平台含命令行
35–70 秒安装耗时固态盘条件
2 项授权网卡与权限
4 步回退顺序由轻到重
安装前先确认的系统要求版本、空间、权限
三件事里任何一件不满足,安装都会卡住,而报错信息往往看不出原因。
版本看大版本号,补丁号不用管。空间看剩余容量,至少留包体两倍。权限看账户类型,桌面端需要管理员账户。
网络在安装阶段要通一次,用于拉取规则库与校验证书。装完可以断网使用,首次启动不行。
01Win10 1909 下限
Win10 1909、macOS 13、Android 9、iOS 16 是四条下限线。
02临时空间两倍包体
留包体两倍,装完清理临时文件,清理耗时 3–8 秒。
03管理员账户要求
桌面端需管理员账户,标准账户会在驱动阶段失败。
04首次启动联网
首次启动要拉规则库,耗时 3–6 秒,断网会卡在登录页。
05实时防护拦截驱动
部分实时防护会拦驱动安装,装前先看拦截记录。
06配置导出 JSON
升级前导出配置,得到一份 JSON,回退时可导入。
图 1:首次启动需要一次可用的网络。图片为场景示意。Windows 客户端怎么装驱动阶段会短暂断网
Windows 的安装器会自校验签名,签名不符时直接退出,不提供继续选项。整个过程 40–70 秒。
驱动安装阶段网络会断开 3–8 秒,这是虚拟网卡重载,不是故障。此时不要点取消。
- 运行安装器双击 exe,签名校验耗时 2–4 秒,通过后才出现安装界面。
- 选择目录默认装在 C 盘,路径含中文也能正常安装。
- 等待驱动驱动加载时断网 3–8 秒,进度条会停一下。
- 授权网卡首次启动弹窗请求虚拟网卡权限,选允许。
- 登录核对登录后看版本号与出口地区,两项都对即完成。
图 2:桌面端安装全程约 1 分钟。图片为场景示意。macOS 13 安装包怎么放行被拦一次是预期行为
macOS 会拦下首次打开,这是公证机制的正常表现。放行一次后不再提示,不需要关闭系统完整性保护。
网络扩展的授权在系统设置里完成,授权后需重启客户端,不重启不生效。
- 把 dmg 里的应用拖进应用程序文件夹,不要直接在镜像里运行。
- 首次打开被拦时,在隐私与安全性里点仍要打开。
- 网络扩展授权需要输入本机密码,输一次即可。
- 授权后重启客户端,否则连接按钮是灰的。
- 安装耗时 35–60 秒,条件为固态盘。
- 旧版覆盖安装时,先退出正在运行的客户端。
- 卸载时把应用拖进废纸篓,再清理网络扩展残留。
- 升级后若提示扩展不兼容,重启系统再试。
- 系统大版本升级后,扩展需重新授权一次。
- 公司管控的设备可能禁止安装扩展,这类设备装不上。
- 安装日志在控制台里按进程名过滤,可用于排查。
- 安装包本身可以删,删掉不影响已装好的客户端。
- 授权失败:多为密码输入超时,重新点授权并连续输入即可。
- 扩展未加载:系统更新后需重启一次,扩展才会被重新注册。
- 提示已损坏:多为下载截断,重新下载并核对摘要后再装。
- 旧版残留:先彻底卸载再装,残留的扩展会与新版本冲突。
图 3:macOS 的授权入口在系统设置里。图片为场景示意。安卓安装包与 iOS 描述文件安卓多一步来源允许
安卓的门槛在来源允许,iOS 的门槛在描述文件信任。两端的共同点是首次连接都要给 VPN 权限。
不给 VPN 权限也能装完,但点连接时会被系统拦回,表现为按钮无反应。
- 安卓安装前要在设置里允许未知来源,装完可关回去。
- 允许开关按应用授权,换一个安装器需重新授权。
- 安卓的包按架构拆分,arm64 设备不要取 32 位包。
- iOS 用签名工具安装时,需在描述文件页点信任。
- 描述文件被吊销时,信任项会变灰,需重新生成。
- 两端首次连接都会请求 VPN 权限,选始终允许。
- iOS 的本地网络权限影响节点探测,建议开启。
- 安卓的后台保活时长由系统策略决定,不做承诺。
- 安装耗时:安卓 20–35 秒,iOS 45–80 秒。
- iOS 安装后若图标为白底,说明描述文件未生效。
- 卸载安卓端时先断开连接,避免残留虚拟网卡。
- 两端的安装包都不能跨平台使用,扩展名不同。
- 权限被拒:首次弹窗点了拒绝,去系统设置里手动补授权。
- 装完无图标:桌面启动器未刷新,重启设备或重新加载桌面。
- 国行限制:部分国行系统移除 VPN 接口,装上也连不上。
- 双卡切换:切换数据卡后需重连一次,否则出口不变。
图 4:移动端安装多一步权限授予。图片为场景示意。路由器安装包的前置条件命令行为主,条件更多
这两端没有图形界面,安装靠命令。前置条件比桌面端多:固件版本、闪存余量、SSH 开关。
闪存余量低于 20MB 时会静默失败,命令返回 0 但进程起不来。先看余量,再看日志。
表 1:路由器与命令行的安装前置条件(v6.8.2)| 项目 | 要求 | 不满足的表现 |
|---|
| 固件版本 | OpenWrt 23.05 以上 | 包解压失败,提示格式不符 |
| 闪存余量 | 大于 20MB | 静默失败,进程不启动 |
| 处理器架构 | arm 或 mips | 内核模块加载失败 |
| SSH | 已开启 | 上传包失败,连接被拒 |
| 内核模块 | 支持 tun | 连接建立后无法转发 |
| 时间同步 | 误差 5 分钟内 | 证书校验失败 |
图 5:路由器端适合整网转发。图片为场景示意。安装包装不上:现象与动作按现象查,不按平台查
同一个现象在不同平台上原因相同。所以按现象组织,比按平台组织更快找到动作。
表里六类覆盖了绝大多数情况。六类之外的失败,先看日志再决定是否重装。
系统版本与时间同步
系统版本偏低、空间不足、时间不同步,表现为装完闪退或证书报错。
账户与 VPN 授权
账户非管理员、未给 VPN 权限,表现为按钮无反应。
安全软件拦截驱动
实时防护拦驱动、系统策略禁扩展,表现为静默失败。
包体截断与架构不符
下载截断、架构不符、版本错位,表现为解析失败或秒退。
虚拟网卡残留
旧版卸载不彻底、虚拟网卡残留,表现为装完连不上。
表 2:六类现象与对应动作(按出现频率排)| 现象 | 常见原因 | 处理动作 |
|---|
| 安装器秒退 | 包体被截断 | 重新下载并核对体积 |
| 提示无权限 | 账户非管理员 | 换管理员账户运行 |
| 驱动装不上 | 安全软件拦截 | 临时关闭实时防护再装 |
| 装完打不开 | 系统版本偏低 | 核对系统下限后升级 |
| 安卓解析失败 | 包与架构不符 | 取 arm64 包重装 |
| 装完连不上 | 虚拟网卡残留 | 清残留后重装 |
图 6:包体问题是六类里最容易排除的一类。图片为场景示意。装不上安装包怎么回退顺序反了会浪费一晚
回退不是重装。四步由轻到重:换包重下、换账户重装、关掉安全软件再装、换设备验证。
前三步都在同一台设备上完成。走到第四步才说明问题不在设备,多半在系统环境。
换镜像重下安装包
多数失败由包体引起,换镜像重下成本最低。
- 删掉半截文件再下,不要在原文件上续传。
- 换镜像后重新核对体积与摘要。
- 三次都失败再进第二步。
换管理员账户重装
权限问题换账户最快,不用改系统设置。
- 用管理员账户运行安装器,不要用标准账户。
- macOS 需要输入本机密码完成授权。
- 换账户前先退出旧账户的客户端。
关防护与换设备验证
前两步无效时,才动安全软件与设备。
- 临时关闭实时防护,装完立即恢复。
- 把安装目录加入白名单,避免再次被拦。
- 换一台设备装同一个包,能区分包问题与环境问题。
Windows 客户端日志在哪看错误码、组件名、时间戳
日志里只关心三样:错误码、失败的组件名、时间戳。其余内容对定位帮助不大。
找不到日志时,先确认客户端是否启动过。启动失败时日志可能只写了一半。
- Windows 安装日志在临时目录,文件名以 setup 开头。
- Windows 客户端日志在用户目录下的隐藏文件夹里。
- macOS 安装日志用控制台按进程名过滤。
- macOS 网络扩展日志在系统日志里,量较大。
- 安卓日志用系统日志工具看,按包名过滤。
- iOS 日志需连接电脑导出,手机上看不到全量。
- 路由器日志通过 SSH 查看,位置在系统日志目录。
- 错误码 0x8007 指权限,0x800B 指摘要不符。
- 错误码 1223 指操作被取消,多为安全软件拦截。
- 日志里的时间戳与安装时间对不上,说明看的是旧日志。
- 把日志与版本号一起发出,48 小时内回。
- 日志里含设备标识,对外发送前先删掉。
- 只看报错行:日志里搜 error 与 fail,能过滤掉九成无关行。
- 看上下文:报错行前后各三行,往往写着失败的组件名。
- 看重复:同一报错反复出现,说明重试逻辑没生效。
- 错误码先记错误码,再搜对应动作,比通读日志快。
- 组件名看失败的是驱动还是主程序,两者处理方式不同。
- 时间戳确认日志来自本次安装,旧日志会误导判断。
- 权限日志里出现拒绝访问,先换账户。
- 摘要日志里出现摘要不符,直接重下。
装完核对哪五项能连上不等于装对了
安装成功的判据不是能连上,而是五项都对。五项里有任何一项不对,问题会在使用中冒出来。
核对顺序:版本号、出口地区、解析位置、断线保护、额度占用。
表 3:装完五项核对与判断依据(v6.8.2)| 核对项 | 正常表现 | 异常时先做什么 |
|---|
| 版本号 | 显示 v6.8.2 | 确认装的是当前版本 |
| 出口地区 | 与所选线路一致 | 换线路再看 |
| 解析位置 | 在节点地区 | 检查加密 DNS 开关 |
| 断线保护 | 开关为开启 | 重新授权网络扩展 |
| 额度占用 | 占用 1 台 | 退出旧设备登录 |
| 规则库 | 版本为当月 | 手动触发一次拉取 |
图 7:核对在本地完成,不依赖下载环节。图片为场景示意。批量安装与换机迁移先一台,再铺开
多台设备部署时,先在一台完成安装与核对,再把这台的包与配置复制出去,能省掉重复排查。
迁移到新设备时,先在旧设备退出登录释放额度,再在新设备登录,避免额度被占满。
共享目录与配置模板
准备一份校验过的包与一份配置备份。
- 在一台设备上完成安装与五项核对。
- 把校验通过的包放到共享目录,只存当前版本。
- 导出一份配置 JSON,作为统一模板。
分批安装的并发上限
并发安装会抢带宽,分批更稳。
- 分批安装,每批不超过 5 台。
- 每台装完核对版本号与出口地区。
- 共享目录设为只读,避免被改写。
换机迁移的额度释放
额度按在线设备计,迁移要先退后登。
- 旧设备退出登录,额度在 30 秒内释放。
- 新设备登录后核对设备列表。
- 设备列表里出现陌生设备,立即踢掉并改密码。
图 8:批量部署适合有整网需求的场景。图片为场景示意。安装耗时与失败率数据点条件写在括号里
九个点覆盖耗时、授权与失败率,引用时请连同条件一起写。
- 安装耗时(实测):Windows 40–70 秒,macOS 35–60 秒,固态盘条件。
- 移动端耗时(实测):安卓 20–35 秒,iOS 45–80 秒。
- 驱动断网(实测):3–8 秒,虚拟网卡重载期间。
- 授权项(规则):2 项,虚拟网卡与系统 VPN 权限。
- 失败分类(规则):6 类现象,按出现频率排。
- 回退步骤(规则):4 步,由轻到重。
- 额度释放(实测):12–28 秒,退出登录后。
- 规则库拉取(实测):3–6 秒,首次启动时。
- 日志留存(规则):本地保留 7 天,超期自动清理。
- 首次启动:3–6 秒拉规则库,期间界面显示初始化。
- 卸载残留:虚拟网卡与扩展各留一项,需手动清理。
- 覆盖安装:不额外占用额度,也不重置已导出的配置。
耗时数据来自 2026 年 11 月的三次安装采样,设备为同型号固态盘机器,机械盘会慢 20–40 秒。
安装包装不上:六个问题权限、拦截与包体各两条
装完点连接没反应,先查什么?
先看 VPN 权限是否给了。安卓与 iOS 首次连接都要弹窗授权,拒绝后按钮会一直无反应,去系统设置里补授权即可。
Windows 安装时断网了,正常吗?
正常。驱动与虚拟网卡重载会断网 3–8 秒,之后自动恢复。此时不要点取消,取消会让驱动处于半装状态。
macOS 提示扩展被阻止怎么办?
在系统设置的隐私与安全性里放行一次,再重启客户端。若仍被阻止,检查是否有描述文件限制,公司管控设备常见。
为什么装完占用比包体大很多?
安装要解压并铺开规则库,占用约为包体的 2 到 3 倍。iOS 端最明显,96.5MB 的包装完约 210MB。
重装能解决连不上吗?
只有残留类问题靠重装解决。权限、拦截、包体三类问题重装无效,先按表 2 定位,再决定是否重装。
路由器端装完进程没起来,怎么查?
先看闪存余量,低于 20MB 会静默失败。再看内核是否支持 tun,最后看时间同步,误差超过 5 分钟会证书报错。
本页数据口径每条都带采样条件,可按同一方法复算
- 安装包体积(统计):六端 6.8MB 至 96.5MB,v6.8.2 文件本体读取。
- 校验耗时(测试):单文件 SHA-256 0.3–1.2 秒,取决于磁盘读取速度。
- 安装耗时(实测):Windows 40–70 秒、macOS 35–60 秒,各 20 次采样中位。
- 下载速度(实测):42.6MB 在 100Mbps 家宽约 4 秒,20Mbps 移动网络约 18 秒。
- 保留期(版本):旧包 90 天,从发版日起算,数据按版本记录统计。
按步骤装,失败有回退六端逐条步骤已列,回退四步由轻到重。