按五步完成部署
流程约数分钟,全过程不重启宿主机网络栈
从准备规则文件、拉取并校验镜像,到创建业务网络、设置分流标签,最后验证命中与宿主机零改动。每步都给出可直接复制的命令。
前往快连VPN 部署文档本页是快连VPN 的唯一下载入口。容器镜像通过官方仓库 registry.kiualanad.com.cn/kl/kl-proxy 分发,桌面客户端安装包仅在本页提供。下载后请按「来源核验与防钓鱼」一节核对 tag 与 digest,确认运行的是未被替换的官方构建。
官方镜像仓库地址为 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
| 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 内置的协议集合见 镜像矩阵。
快连下载只经 kiualanad.com.cn 直供。任何要求提供订阅地址换镜像、要求额外付费解锁、或引导到第三方下载站的内容都不是本站内容,请立即停止并举报。
官方镜像仅通过 registry.kiualanad.com.cn 仓库分发,官方桌面客户端安装包仅在本页 快连下载 提供。官方不通过网盘、即时通讯工具或第三方下载站分发安装包,也不存在「输入订阅地址后生成专属镜像」的流程——订阅地址属于凭据,不应提交给任何下载页面。
tag 可以被重新指向,digest 不行。部署基线里应当记录完整 digest,并在每次发布后重新核对:
终端 · 核对 RepoDigestdocker 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 才继续导入
| 仿冒特征 | 官方表现 |
|---|---|
| 要求提供订阅地址才能换镜像 | 下载与拉取都不需要订阅地址,凭据只写入你自己的规则文件 |
| 镜像仓库域名非 kiualanad.com.cn | 仓库固定为 registry.kiualanad.com.cn/kl/kl-proxy |
| 要求额外付费解锁或充值 | 无解锁步骤,镜像与客户端均在本页直接获取 |
| 不提供 digest 或只给体积 | tag、体积与 digest 前缀同时给出,可用 docker image inspect 复核 |
| 引导到网盘、IM 或第三方下载站 | 分发入口仅限 kiualanad.com.cn 本页与官方仓库 |
发现仿冒页面、镜像被重新打包,或收到索要订阅地址与账号凭据的请求,请把页面地址、截图与时间一并发送到 [email protected]。核实后会由本站在该页公示处理结果。请勿在邮件正文中附带订阅地址等凭据。
桌面客户端与容器镜像是两种不同的生效范围。宿主机上已有其他出口工具、且希望完全不影响宿主机路由时,应选容器镜像;只有单台个人设备需要加速时才用桌面客户端。
| 系统 | 版本 | 架构 | 格式 | 说明 |
|---|---|---|---|---|
| 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 内,通过调整本机路由与默认网关来接管整台机器的出口。若宿主机上已运行其他出口工具(软路由、网关、另一套加速进程),两者会争抢默认路由。容器镜像只作用于容器自身的命名空间,宿主机路由与其它容器的出口不受影响,隔离原理见 隔离架构。
内网无外网时,走「外网侧导出 → 介质传输 → 内网侧导入 → 私有仓库 mirror」四步,不依赖任何第三方镜像站。
介质上必须同时携带镜像归档与对应的 .sha256 校验文件。导入前先用 sha256sum -c 校验,通过后再 docker load;未校验的归档一律不导入。
docker save,得到单个归档文件,并立即生成校验和文件。.sha256,两者必须成对出现。docker load 后重打标签指向内网私有仓库,规则文件里的镜像引用随之改成私有地址。registry-mirrors 指向内网地址,容器拉取统一从内网取,不再回源到外网。# 外网侧:导出镜像并生成校验和
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。
拉取完成后按顺序走完下面三件事:先起容器,再确认分流行为,最后对照常见问题排查。
流程约数分钟,全过程不重启宿主机网络栈
从准备规则文件、拉取并校验镜像,到创建业务网络、设置分流标签,最后验证命中与宿主机零改动。每步都给出可直接复制的命令。
前往快连VPN 部署文档Hysteria2 / TUIC / Shadowsocks-2022 / WireGuard / SOCKS5
确认所选 tag 内置了哪些协议、各自监听哪些端口,以及在 Linux、Windows、macOS 容器平台上的支持情况,避免启动后端口不匹配。
查看快连VPN 镜像矩阵分流未命中、路由冲突、digest 不一致
按症状定位问题:容器能启动但流量没走加速、命中了错误的规则、digest 与基线不符,分别对应不同的排查路径。
查看快连VPN 常见问题