快连VPN 官方站点 · 容器网络加速服务 镜像版本 v2.4.1 · 文档更新
下载中心 · 版本 v2.4.1

快连VPN 官方下载:镜像、客户端与来源核验

本页是快连VPN 的唯一下载入口。容器镜像通过官方仓库 registry.kiualanad.com.cn/kl/kl-proxy 分发,桌面客户端安装包仅在本页提供。下载后请按「来源核验与防钓鱼」一节核对 tag 与 digest,确认运行的是未被替换的官方构建。

01 · 容器镜像

容器镜像下载

官方镜像仓库地址为 registry.kiualanad.com.cn/kl/kl-proxy。生产环境建议锁定版本 tag 并进一步锁定 digest,避免 tag 被覆盖后拉到不同构建。

终端 · 拉取并启动
# 拉取官方镜像(生产建议锁定 tag + digest)
docker pull registry.kiualanad.com.cn/kl/kl-proxy:v2.4.1

# 启动加速容器:--mode container 表示只作用于容器命名空间
docker run -d --name kl-proxy \
  --restart unless-stopped \
  --cap-add NET_ADMIN --device /dev/net/tun \
  -v /opt/kl/rules.yaml:/etc/kl/rules.yaml:ro \
  registry.kiualanad.com.cn/kl/kl-proxy:v2.4.1 \
  --config /etc/kl/rules.yaml --mode container
表 1:官方镜像 tag 对照(示例口径,实际 tag、体积与 digest 以官方仓库 registry.kiualanad.com.cn/kl/kl-proxy 的实时输出为准)
Tag 用途 体积 digest 前缀
latest 生产推荐,跟随最新稳定构建 约 86 MB sha256:9f2c…
v2.4.1 锁定版本,可复现,回滚安全 约 86 MB sha256:3ab7…
v2.4.1-alpine 轻量镜像,基础库更小 约 41 MB sha256:71d4…
v2.4.1-debug 排障镜像,带调试符号与诊断工具 约 214 MB sha256:c05e…
关于上表数值

体积为压缩后的镜像层体积,digest 为 RepoDigests 的前 4 位便于肉眼比对。以上为示例值,以官方仓库为准;请用下方命令输出完整 digest 再写入部署基线。不同 tag 内置的协议集合见 镜像矩阵。

02 · 来源核验

来源核验与防钓鱼

快连下载只经 kiualanad.com.cn 直供。任何要求提供订阅地址换镜像、要求额外付费解锁、或引导到第三方下载站的内容都不是本站内容,请立即停止并举报。

核验第一步:确认分发路径

官方镜像仅通过 registry.kiualanad.com.cn 仓库分发,官方桌面客户端安装包仅在本页 快连下载 提供。官方不通过网盘、即时通讯工具或第三方下载站分发安装包,也不存在「输入订阅地址后生成专属镜像」的流程——订阅地址属于凭据,不应提交给任何下载页面。

核验第二步:用 digest 对齐构建

tag 可以被重新指向,digest 不行。部署基线里应当记录完整 digest,并在每次发布后重新核对:

终端 · 核对 RepoDigest
docker image inspect registry.kiualanad.com.cn/kl/kl-proxy:v2.4.1 \
  --format '{{index .RepoDigests 0}}'

# 输出示例:registry.kiualanad.com.cn/kl/kl-proxy@sha256:3ab7…
# 与上表 digest 前缀一致,即为同一构建

核验第三步:校验离线包完整性

内网环境通过介质导入镜像或安装包时,用随包提供的校验和文件确认文件未被篡改或传输损坏:

终端 · sha256 校验
# 校验镜像归档文件
sha256sum -c kl-proxy-v2.4.1.tar.sha256

# 校验桌面安装包
sha256sum -c kl-desktop-2.4.1.sha256

# 全部输出 OK 才继续导入
表 2:仿冒页面的常见特征与官方表现对照(判定依据来自本页核验流程)
仿冒特征 官方表现
要求提供订阅地址才能换镜像 下载与拉取都不需要订阅地址,凭据只写入你自己的规则文件
镜像仓库域名非 kiualanad.com.cn 仓库固定为 registry.kiualanad.com.cn/kl/kl-proxy
要求额外付费解锁或充值 无解锁步骤,镜像与客户端均在本页直接获取
不提供 digest 或只给体积 tag、体积与 digest 前缀同时给出,可用 docker image inspect 复核
引导到网盘、IM 或第三方下载站 分发入口仅限 kiualanad.com.cn 本页与官方仓库
举报渠道

发现仿冒页面、镜像被重新打包,或收到索要订阅地址与账号凭据的请求,请把页面地址、截图与时间一并发送到 [email protected]。核实后会由本站在该页公示处理结果。请勿在邮件正文中附带订阅地址等凭据。

03 · 桌面客户端

桌面客户端选择

桌面客户端与容器镜像是两种不同的生效范围。宿主机上已有其他出口工具、且希望完全不影响宿主机路由时,应选容器镜像;只有单台个人设备需要加速时才用桌面客户端。

表 3:桌面客户端版本矩阵(示例口径,实际以官方发布页为准)
系统 版本 架构 格式 说明
Windows 2.4.1 x64 / arm64 .exe / .msi 安装包内含协议配置模板
macOS 2.4.1 Apple Silicon / Intel .dmg 首次启动需在系统设置中授权网络扩展
Linux 2.4.1 x64 / arm64 .AppImage / .deb systemd 服务模式可选
关键区别:桌面客户端会接管本机路由

桌面客户端工作在宿主机的 network namespace 内,通过调整本机路由与默认网关来接管整台机器的出口。若宿主机上已运行其他出口工具(软路由、网关、另一套加速进程),两者会争抢默认路由。容器镜像只作用于容器自身的命名空间,宿主机路由与其它容器的出口不受影响,隔离原理见 隔离架构。

需要哪些协议、监听哪些端口,请对照 镜像矩阵;下载完成后按 部署文档 的五步流程接入。

04 · 离线环境

离线与内网环境

内网无外网时,走「外网侧导出 → 介质传输 → 内网侧导入 → 私有仓库 mirror」四步,不依赖任何第三方镜像站。

离线导入的前提

介质上必须同时携带镜像归档与对应的 .sha256 校验文件。导入前先用 sha256sum -c 校验,通过后再 docker load;未校验的归档一律不导入。

外网侧:导出镜像归档
在可访问官方仓库的机器上执行 docker save,得到单个归档文件,并立即生成校验和文件。
介质传输
通过审批过的介质或内部制品库转运归档与 .sha256,两者必须成对出现。
内网侧:导入并打上私有标签
docker load 后重打标签指向内网私有仓库,规则文件里的镜像引用随之改成私有地址。
私有仓库 mirror 同步
内网私有仓库配置 registry-mirrors 指向内网地址,容器拉取统一从内网取,不再回源到外网。
镜像签名验证
镜像按内容签名(referrer 签名),内网侧启用容器运行时签名策略,只放行带官方签名且签名者身份匹配预期的镜像;未签名或签名者不符的镜像在部署时被拒绝。
升级节奏
离线环境按版本发布节奏重新导出归档,重复「导出 → 校验 → 导入 → 验证命中」流程。
终端 · 离线导出与导入
# 外网侧:导出镜像并生成校验和
docker save registry.kiualanad.com.cn/kl/kl-proxy:v2.4.1 -o kl-proxy-v2.4.1.tar
sha256sum kl-proxy-v2.4.1.tar > kl-proxy-v2.4.1.tar.sha256

# 内网侧:先校验,再导入
sha256sum -c kl-proxy-v2.4.1.tar.sha256
docker load -i kl-proxy-v2.4.1.tar

# 重打标签指向内网私有仓库
docker tag registry.kiualanad.com.cn/kl/kl-proxy:v2.4.1 \
  registry.internal.corp/kl/kl-proxy:v2.4.1

离线场景下的规则文件仍然按六个维度生效,写法见 分流规则优先级;云元数据等必须直连的地址在任何环境都应保持 direct。

05 · 下一步

下一步

拉取完成后按顺序走完下面三件事:先起容器,再确认分流行为,最后对照常见问题排查。

按五步完成部署

流程约数分钟,全过程不重启宿主机网络栈

从准备规则文件、拉取并校验镜像,到创建业务网络、设置分流标签,最后验证命中与宿主机零改动。每步都给出可直接复制的命令。

前往快连VPN 部署文档

对照镜像与协议矩阵

Hysteria2 / TUIC / Shadowsocks-2022 / WireGuard / SOCKS5

确认所选 tag 内置了哪些协议、各自监听哪些端口,以及在 Linux、Windows、macOS 容器平台上的支持情况,避免启动后端口不匹配。

查看快连VPN 镜像矩阵

排查常见问题

分流未命中、路由冲突、digest 不一致

按症状定位问题:容器能启动但流量没走加速、命中了错误的规则、digest 与基线不符,分别对应不同的排查路径。

查看快连VPN 常见问题