发布通道 · v3.7.2 / 2026-11-04
客户端下载:五个平台、38.6 MB 与一份校验值
Windows 安装包 38.6 MB,macOS 通用包 41.2 MB,两者都公布 SHA-256 前 16 位;安装过程约 40 秒,不捆绑任何第三方组件,静默安装参数支持批量部署。
发布参数 / build spec
- 当前版本
- v3.7.2
- 发布日期
- 2026-11-04
- Windows 包
- 38.6 MB
- macOS 包
- 41.2 MB
- 安装耗时
- 约 40 秒
- 校验
- SHA-256
- 更新检查
- 每周
§01
下载入口:五个平台的安装包与校验值
同一份订阅覆盖五个平台,安装包的体积与校验值列在下表。校验值取 SHA-256 前 16 位,完整值在发布公告里给出,逐版本更新。
| 平台 | 体积 | 校验值(前 16 位) | 说明 |
|---|---|---|---|
| Windows 10/11 x64 | 38.6 MB | a91f4c7d2e83b60f | 含静默安装参数与开机自启 |
| macOS 12+(通用) | 41.2 MB | c47b0e19f3a8d256 | Intel 与 Apple 芯片合一包 |
| Android 9+ | 26.4 MB | 5d02ab7c91e6f348 | 支持分应用代理 |
| iOS 15+ | 32.8 MB | e3b6281d7f95c0a4 | 需在系统设置中允许按需连接 |
| Linux(deb / rpm) | 18.9 MB | 7a4c1f902db83e65 | 提供 systemd 服务单元 |


§02
校验方法:三步确认文件未被改动
下载完成后先校验再安装。校验值不一致说明文件在传输中被改动或下载不完整,此时应删除并从同一入口重新下载,而不是跳过校验。
- 打开终端(Windows 用 PowerShell,macOS 用终端),进入安装包所在目录。
- 执行对应命令,把输出的哈希与下载页表格的前 16 位比对。
- 一致则继续安装;不一致先删除文件,再重新下载并重复前两步。
- 若两次下载的哈希都与页面不符,停止安装并记录下载时间与网络环境。
为什么只公布前 16 位
前 16 位是 64 位信息量,碰撞概率低于传输错误概率,足以判断文件是否被改动;完整 64 位值在发布公告里给出,供批处理脚本比对。两者不一致时以公告为准。
| 版本 | Windows 校验值 | macOS 校验值 | 发布日期 |
|---|---|---|---|
| v3.7.2 | a91f4c7d2e83b60f | c47b0e19f3a8d256 | 2026-11-04 |
| v3.7.1 | 3e8b0a51c74d92f6 | 91d4c70b3e85a2f1 | 2026-09-18 |
| v3.7.0 | b5f2d819e04a7c36 | 2a7e5c91b40d83f7 | 2026-08-06 |
校验失败的两个常见原因
一是下载被代理节点缓存了旧版本,删除浏览器缓存后重新下载即可;二是磁盘写入错误,多见于可用空间不足。两种情况都与安装包本身无关。
§03
Windows 安装:六个步骤与三个注意点
Windows 安装包是单文件,双击后无需联网即可完成安装,首次启动才需要登录。安装过程约 40 秒,主要耗时在规则库解压与协议栈注册。
- 双击安装包,若出现用户账户控制提示,选择「是」以允许写入系统目录。
- 选择安装路径,默认路径为系统盘的 Program Files 目录,可改到其他盘。
- 勾选是否开机自启与是否加入体验计划,两项都可取消。
- 点击安装,等待进度条走完,期间不要关闭窗口。
- 安装完成后启动客户端,用邮箱接收六位验证码登录。
- 首次连接前建议先执行一次六方向抽样,确认本机到各方向的延迟。
| 项目 | 最低要求 | 建议配置 |
|---|---|---|
| 操作系统 | Windows 10 1809 | Windows 11 22H2 及以上 |
| 处理器 | 双核 1.6 GHz | 四核 2.0 GHz 及以上 |
| 内存 | 2 GB 可用 | 4 GB 可用 |
| 磁盘 | 120 MB | 300 MB(含规则库与日志) |
| 网络 | 任意 IPv4 出口 | 支持 UDP 443 出站 |
| 阶段 | 耗时 | 是否可跳过 |
|---|---|---|
| 解压安装包 | 6 秒 | 否 |
| 写入程序文件 | 11 秒 | 否 |
| 注册虚拟网卡驱动 | 9 秒 | 否 |
| 写入规则库 | 7 秒 | 可用空库跳过 |
| 创建快捷方式 | 2 秒 | 可用静默参数跳过 |
| 首次启动自检 | 5 秒 | 否 |
安装包为什么这么大
38.6 MB 中约 11 MB 是协议栈与加密库,约 9 MB 是规则库初版,其余为界面资源与多语言包。规则库可以首次启动后联网更新,但为了弱网环境下也能用,安装包仍内置一份完整初版。
为什么需要管理员权限
安装过程要注册虚拟网卡驱动并写入系统路由表,这两项都需要管理员权限。客户端运行本身不需要管理员,安装完成后可用标准用户启动。
杀毒软件误报怎么处理
少数杀毒软件会把虚拟网卡驱动识别为可疑行为。处理方式是把安装目录加入信任列表,而不是关闭杀毒软件。安装包的数字签名在属性页可见,可用于辅助判断。

§04
macOS 安装:授权与按需连接
macOS 的安装包是通用格式,Intel 与 Apple 芯片共用一份。首次启动需要在系统设置里允许网络扩展,否则客户端能启动但无法建立隧道。
- 打开安装包,按提示把应用拖入应用程序目录。
- 首次启动时系统会提示「允许来自开发者的应用」,进入系统设置确认。
- 在隐私与安全性中允许网络扩展,客户端会请求一次系统授权。
- 登录后选择节点,首次连接会请求添加网络配置,输入本机密码确认。
- 若使用按需连接,需要在客户端里为蜂窝与 Wi-Fi 分别设置触发条件。
Mac 上的三个授权项
一是允许应用运行,二是允许网络扩展,三是允许添加网络配置。三项缺一不可:只允许运行会导致隧道无法建立,只允许扩展会导致路由无法写入。客户端在设置页把这三点拆成独立的状态灯,缺哪项一目了然。
为什么 macOS 的步骤比 Windows 多
macOS 对网络扩展有独立的授权流程,且每次系统大版本升级都会重置部分权限。这不是安装包的问题,而是系统安全模型的差异,客户端只能在界面上把缺失的授权项列出来,无法绕过。
Apple 芯片下的性能表现
在 M 系列芯片上,协议栈以原生架构运行,单核占用低于 3%,待机功耗增加小于 0.4 瓦。Intel 机型走同一份二进制,性能差异主要体现在加解密吞吐上。
§05
移动端:分应用代理与按需连接
移动端最需要的不是更多节点,而是「只让该走加速的应用走加速」。Android 支持分应用代理,iOS 依靠按需连接规则实现近似效果。
| 能力 | Android | iOS |
|---|---|---|
| 分应用代理 | 支持,按应用勾选 | 不支持,按域名规则近似 |
| 按需连接 | 支持,按网络类型触发 | 支持,需系统级配置 |
| 快捷开关 | 支持通知栏磁贴 | 支持控制中心快捷指令 |
| 后台保活 | 支持前台服务 | 受系统限制,需保持应用活跃 |
| 设备类型 | 安装耗时 | 首次连接耗时 | 备注 |
|---|---|---|---|
| Android 中端机 | 38 秒 | 1.4 秒 | 含一次系统授权确认 |
| Android 旗舰机 | 26 秒 | 0.9 秒 | 磁贴开关可直接连接 |
| iPhone 13 | 31 秒 | 1.1 秒 | 需在设置中允许按需连接 |
| iPad Air | 33 秒 | 1.2 秒 | 与 iPhone 共用同一订阅 |
移动端安装包的体积差异
Android 包 26.4 MB、iOS 包 32.8 MB,差异主要来自系统框架与签名方式。两个包都内置完整规则库,首次启动不需要联网下载规则,这一点在弱网环境下尤其重要。
Android 的分应用代理怎么用
在客户端里选择「分应用代理」,把需要走加速的应用勾选上,其余应用保持直连。银行类应用与内网办公工具建议不勾选,避免触发风控或超时。
iOS 为什么做不到分应用
iOS 的网络扩展以整机为单位接管流量,应用层无法按进程区分。客户端的做法是用域名规则近似实现:把需要加速的域名归组走代理,其余直连。
§06
静默安装与命令行参数
批量部署场景需要在无界面情况下安装。Windows 安装包支持静默参数,Linux 包提供 systemd 单元,两者都不需要交互输入。
| 参数 | 作用 | 示例 |
|---|---|---|
| /S | 静默安装,不显示界面 | kvpn-setup.exe /S |
| /NOSTART | 安装后不自动启动 | /S /NOSTART |
| /LOG= | 指定安装日志路径 | /LOG=install.log |
| /D= | 指定安装目录(须放在最后) | /S /D=D:\Apps\kvpn |
静默安装的三个约束
一是必须在管理员权限下运行;二是安装目录参数必须放在命令最后,否则后面的参数会被当成目录名;三是静默安装不会创建桌面快捷方式,需要自行处理。
| 模式 | 适用规模 | 优点 | 局限 |
|---|---|---|---|
| 镜像预装 | 50 台以上 | 首次开机即可用 | 订阅需单独下发 |
| 脚本分发 | 10 至 50 台 | 灵活,可按部门区分 | 需要管理员权限 |
| 手动安装 | 10 台以下 | 无需额外工具 | 耗时且易漏版本 |
安装包与系统补丁的关系
部分 Windows 累积更新会重置虚拟网卡驱动的签名状态,表现为安装后可用、重启后失效。遇到这种情况重新运行安装包修复即可,不需要卸载重装。
安装包的语言与体积
安装包内置简体中文与英文两套界面,其余语言在客户端内按需下载。这样做让安装包控制在 40 MB 以内,也避免了首次启动时再拉取语言包带来的额外等待。
为什么不做一键安装到 C 盘
默认路径可改,但安装包不会强制选择。受管设备常有磁盘配额,强行安装到系统盘会触发配额告警;家用场景则希望省事。把选择权留给安装界面,是这两种需求之间唯一可行的折中。
日志里该看哪三行
安装日志通常有数百行,需要关注的只有三行:网卡驱动注册的返回码、规则库写入的字节数、服务创建的结论。三行都正常而客户端无法连接时,问题多半在系统时间或防火墙,而不在安装。
批量部署的推荐顺序
先在镜像里预装客户端并关闭开机自启,再由运维在首次登录时下发订阅。这样可以避免数百台设备同时拉取规则库造成的瞬时压力。
§07
更新与回滚
客户端内置更新检查,默认每周检查一次,可在设置里改为手动。更新包使用增量差分,体积通常为完整包的 20% 至 35%。
- 客户端读取当前版本号与规则库版本号,向配置中心请求差分包信息。
- 下载差分包并校验,校验失败则退回完整包下载。
- 安装前创建还原点(Windows)或保留上一版应用(macOS)。
- 安装完成重启客户端,若启动失败则自动回滚到上一版。
- 回滚事件记录在本地日志,并在设置页提示「已回滚到 v3.7.1」。


§08
安装失败的五种情况
安装阶段的失败通常与系统环境有关,与安装包无关。下表按出现频率排列,前两条覆盖了八成反馈。
Windows 完整安装耗时,含驱动注册与规则库解压,无需联网。
增量更新的下载体积,为完整包的 20% 至 35%。
本地日志保留期,卸载后仍保留到期满。
| 现象 | 原因 | 处理方式 |
|---|---|---|
| 安装到 80% 卡住 | 虚拟网卡驱动注册被安全软件拦截 | 把安装目录加入信任列表后重装 |
| 提示「已存在同名服务」 | 旧版本残留服务未卸载 | 先卸载旧版本并重启,再安装 |
| macOS 提示无法验证开发者 | 系统完整性保护限制了来源 | 在系统设置中允许该应用运行 |
| 安装后无法连接 | 系统时间偏差超过 5 分钟 | 校正系统时间后重连 |
| Linux 启动报缺少依赖 | 缺少 libssl 运行库 | 安装对应发行版的 libssl 包 |
- 先看日志:Windows 的安装日志默认在安装目录的 install.log,macOS 在控制台的安装记录里。
- 再看时间:系统时间偏差会让握手失败,这一条最容易被忽略,也最容易验证。
- 最后看权限:受管设备可能被组策略限制安装驱动,需要管理员放行。
§09
卸载与残留清理
卸载会移除程序、虚拟网卡驱动与规则库,但保留本地日志与订阅缓存,便于重装后恢复设置。若需要彻底清理,按下面的顺序操作。
- 正常卸载:在系统设置的应用列表里卸载,或在安装目录运行卸载程序。
- 残留服务:Windows 下若服务未删除,用服务管理器手动停止并删除。
- 残留驱动:虚拟网卡驱动随卸载移除,异常时可在设备管理器里卸载后重启。
- 配置与日志:位于用户目录下的应用数据文件夹,删除后设置与粘性表一并清空。
- 不保留:卸载不保留任何会话记录,本地日志最多保留 30 天。
| 内容 | 是否保留 | 位置 |
|---|---|---|
| 程序与驱动 | 删除 | 安装目录与系统驱动目录 |
| 规则库 | 删除 | 应用数据目录下的 rules 子目录 |
| 订阅缓存 | 保留(便于重装) | 应用数据目录下的 profile 子目录 |
| 本地日志 | 保留 30 天 | 应用数据目录下的 logs 子目录 |
| 粘性表 | 随配置删除 | 应用数据目录下的 cache 子目录 |
为什么订阅缓存保留而规矩库删除
订阅缓存只是账号与到期时间,重装后可免去重新登录;规则库随版本变化,保留旧库可能导致分流结论与当前版本不一致。两者取舍不同,是因为一个关乎便利,一个关乎一致性。
- 安装包来源
- 仅本站下载页,不接受第三方转发
- 校验
- SHA-256 前 16 位比对
- 权限
- 安装需管理员,运行不需要
- 更新
- 默认每周检查,可改手动
§10
数据快照与来源:可单独引用的六条记录
本节把页面内散落的数字集中成六条记录,每条都带测量条件与来源,可脱离上下文单独引用。按主题查阅请回到上文对应章节。
实测五台主流配置设备,Windows 安装从双击到可用耗时 40 秒,其中驱动注册 9 秒、规则库写入 7 秒。
根据 3 次独立复核,v3.7.2 的 Windows 包 SHA-256 前 16 位为 a91f4c7d2e83b60f,与发布公告一致。
增量更新包体积为完整包的 20% 至 35%,实测 4 次升级的下载量分别为 8.1 MB、9.4 MB、7.2 MB 与 12.6 MB。
安装日志显示驱动注册平均耗时 9 秒,占 40 秒总时长的 22%,数据来自 5 台设备的安装记录。
静默安装需要在管理员权限下执行 3 个参数,测试环境为 Windows 11 22H2,共验证 12 台设备。
卸载后本地日志保留 30 天、规则库随卸载删除,采样窗口为 2026 年 11 月 4 日发布的版本。