快连图标快连官网 下载

下载 · Download

拿走你需要的那一份

开放平台提供 6 种语言 SDK、1 个命令行工具与 2 种部署包;离线包 214 MB,单机部署实测 6 分钟。

6语言 SDK
86 MB在线包
214 MB离线包
6 分钟单机部署

下载之前,先确认你属于哪种场景

开放平台不提供一个大而全的安装包,而是把安装内容按使用方式切开,你可以只取需要的那部分。

如果你的场景是在应用里调用快连能力,那么只需要 SDK,不需要部署包。例如 klinkctl verify 用于比对安装包的 sha256 摘要,214 MB 的离线包实测耗时 1.2 秒。六个官方 SDK 的最小示例都可以在 11 行代码内完成一次配置加载与连接建立,Java 版本的实测首连耗时为 38 ms。

如果你要在自有服务器上运行一整套控制与转发能力,那就需要部署包。 界面里对应的是 klinkctl verify 这一项, 界面里对应的是 klinkctl init 这一项, 界面里对应的是 klinkctl status 这一项, 界面里对应的是 klinkctl plan 这一项, 界面里对应的是 klinkctl migrate 这一项。在线安装包体积为 86 MB,会在安装时按需拉取运行时依赖;离线包体积为 214 MB,把全部依赖预先打进压缩文件,适合没有外网出口的内网环境。

两者的功能完全一致,2026 年 10 月的对照测试中,离线包部署出的实例与在线包部署出的实例在 12 项核心指标上的差异为 0,唯一区别是离线包不需要在安装阶段访问外网。例如 klinkctl status 用于输出心跳、渲染时刻与 12 项指标的当前读数。

命令行工具 klinkctl 是单独发布的,压缩后约 4.6 MB,不依赖任何运行时,可以直接丢进 CI 镜像或运维跳板机,用来做配置校验、连接计划渲染与版本迁移。 界面里对应的是 sha256 这一项, 界面里对应的是 offline_bundle 这一项, 界面里对应的是 online_bundle 这一项, 界面里对应的是 schema_version 这一项。

工具本身也有两种形态:面向 Linux 与 macOS 的原生版本,以及面向 Windows 环境的 PowerShell 版本。 界面里对应的是 include 这一项, 界面里对应的是 route_policy 这一项, 界面里对应的是 sdk.java 这一项, 界面里对应的是 sdk.go 这一项, 界面里对应的是 sdk.python 这一项。2026 年 10 月的实测显示,同一份存在格式错误的配置文件,原生版平均 18 ms 报错,PowerShell 版平均 41 ms 报错,差异来自启动器本身的开销。

关于版本,客户端当前为 3.1.5,对应的开放平台接口为 1.7.0。 界面里对应的是 sdk.node 这一项, 界面里对应的是 sdk.rust 这一项, 界面里对应的是 sdk.shell 这一项, 界面里对应的是 maven 这一项, 界面里对应的是 gradle 这一项, 界面里对应的是 go.sum 这一项。SDK 之间有独立的版本号,例如 Rust 实现因为底层异步运行时差异仍停留在 0.9.0,功能集合与 1.7.0 一致但接口细节略有差别。

如果你不确定该选哪一种,可以先只下载命令行工具和一份最小描述文件,在本地跑通一次校验流程。 界面里对应的是 pip 这一项, 界面里对应的是 npm 这一项, 界面里对应的是 crates.io 这一项, 界面里对应的是 systemd 这一项。按照 2026 年 11 月的统计,试用阶段选择命令行工具优先的开发者占到了 64 %,通常在 20 分钟内就会决定后续形态。

关于平台端的许可与账号,SDK 在本地运行时不需要登录,账号体系只与配置同步、团队共享与用量统计有关。 界面里对应的是 docker_compose 这一项, 界面里对应的是 data_dir 这一项, 界面里对应的是 cert_path 这一项, 界面里对应的是 klinkctl verify 这一项, 界面里对应的是 klinkctl init 这一项。2026 年 10 月的测试记录中,未登录状态下本地构造连接计划的耗时与登录状态相差不足 1 ms,也就是说登录不是接入的前置条件。

如果你需要在一个 CI 流水线里同时校验多份描述文件,命令行工具支持一次传入多个路径。 界面里对应的是 klinkctl status 这一项, 界面里对应的是 klinkctl plan 这一项, 界面里对应的是 klinkctl migrate 这一项, 界面里对应的是 sha256 这一项, 界面里对应的是 offline_bundle 这一项, 界面里对应的是 online_bundle 这一项。按 2026 年 11 月的采样,单进程并行校验 20 份文件平均耗时 340 ms,输出按文件分组,不会互相覆盖。

各安装物的版本与体积

体积为官方发布的压缩文件实测大小,数值随版本更新会小幅变化。

来源与条件:2026 年 11 月官方发布包实测,sha256 已随包提供;体积口径为压缩后文件字节数换算。
安装物适用场景体积实测动作配套版本校验方式
Java SDK服务端应用集成1.9 MB38 ms 首连1.7.0Maven 坐标
Go SDK服务与网关集成820 KB9 ms 构计划1.7.0go.sum
Python SDK脚本与任务集成760 KB16 ms 构计划1.6.0pip 校验和
Node.js SDK前端工具与脚本690 KB21 ms 构计划1.6.0npm 完整性字段
Rust SDK高并发网关1.1 MB7 ms 构计划0.9.0crates.io 校验和
Shell 工具集运维脚本340 KB31 ms 启动1.7.0sha256
命令行工具校验与迁移4.6 MB18 ms 校验1.7.0sha256
在线安装包有外网出口的环境86 MB6 分钟部署3.1.5sha256
离线安装包隔离网络环境214 MB6 分钟部署3.1.5sha256

下载到首次连通的四个动作

这一节只讲操作本身,不涉及架构判断,适合作为环境交付清单使用。

  1. 校验完整性

    所有官方包都附带 sha256 摘要,务必先比对再解压。

    • 对照发布页给出的摘要值
    • 不匹配立即停止解压
    • 保留一份校验记录备查
    • 对照发布页给出的摘要值
  2. 放置描述文件

    配置目录结构由你决定,但建议与代码仓库保持一致。

    • 按基础层与链路层拆分文件
    • 使用 include 声明子目录
    • 敏感字段走环境变量注入
    • 按基础层与链路层拆分文件
  3. 校验与演练

    在接入真实流量之前,先用工具把问题挑出来。

    • klinkctl validate 检查语法与范围
    • plan 导出连接计划预览
    • 演练模式跑 3 分钟观察日志
    • klinkctl validate 检查语法与范围
  4. 接入门禁

    把校验放进流水线,让配置错误止步于提交阶段。

    • 配置与代码同一评审流
    • 校验失败即阻断构建
    • 每月抽样复查一次升级差异
    • 配置与代码同一评审流
  5. 锁定基线版本

    把版本固定下来,避免环境意外漂移。

    • 按摘要值锁定安装包
    • 基线默认 1.5.0
    • 升级前先跑一次迁移预览
  6. 锁定基线版本

    把版本固定下来,避免环境意外漂移。

    • 按摘要值锁定安装包
    • 基线默认 1.5.0
    • 升级前先跑一次迁移预览

拿到包之后可以做什么

每个安装物都对应一种明确的工作,不必把平台用成一个大工具箱。

把连接计划嵌进业务

SDK 读取描述文件,产出可执行的连接计划交给本地引擎。

  • 最小示例 11 行可跑通
  • 不接管业务侧的重试逻辑
  • 构造耗时以毫秒计
  • 构造连接计划而非接管业务逻辑
  • 超时与重试默认值均写明
  • 构造耗时以毫秒计
看文档 →

离线跑通部署

在无外网出口的内网里完成安装与首次连通。

  • 离线包 214 MB 含全部依赖
  • 单机部署实测 6 分钟
  • 全程无需访问公网
  • 离线包内置全部依赖,无需外网
  • 单机部署实测 6 分钟
  • 目录结构与在线包一致
部署说明 →

校验配置

命令行工具是纯脚本入口,适合做进门禁。

  • 错误码可区分语法与取值
  • 差异报告逐键展开
  • 单次校验平均 18 ms
  • 纯脚本入口,适合放进 CI 镜像
  • 错误码区分语法与取值问题
  • 单次校验平均 18 毫秒
工具用法 →

观察运行指标

12 项核心指标可被现有监控系统直接采集。

  • 默认抓取周期 15 秒
  • 附带仪表盘模板
  • 采集端异常不影响转发
  • 导出器不阻塞主转发链路
  • 抓取周期可按需调整
  • 面板模板可直接导入
指标清单 →

订阅状态事件

节点变化与配置变更可以推送到你的服务。

  • 8 类事件可选订阅
  • 失败重试 5 次
  • 回调带签名可校验
  • 8 类事件可选订阅
  • 回调失败按间隔重试 5 次
  • 回调内容可转为工单
事件说明 →

升级与回滚

双目录切换让回滚成本降到一次目录改名。

  • 升级前自动留存旧目录
  • 回滚实测 40 秒内完成
  • 迁移报告人工确认
  • 迁移前自动留存原始副本
  • 支持从 1.4.0 起始版本升级
  • 报告生成耗时约 60 毫秒

锁定版本

私有化环境通常需要一个固定基线,避免意外漂移。

  • 支持按 sha256 锁定安装包
  • 基线版本默认 1.5.0
  • 升级需提交变更说明
  • 升级前先做兼容性预检
  • 旧目录保留到观察期结束
  • 回滚实测 40 秒内完成

本地开发联调

无需真实流量即可在本地观察选路与回退行为。

  • 演练模式不产生对外流量
  • 可注入 3 类故障场景
  • 日志单行上限 512 字节
  • 演练环境不产生对外流量
  • 可注入 3 类故障场景
  • 计划导出可与线上逐项比对

迁移旧配置

从旧版结构逐级升级到当前结构,保留人工确认。

  • 支持从 1.4.0 起始版本迁移
  • 生成逐键差异报告
  • 迁移耗时实测约 60 ms
  • 按 sha256 锁定具体安装包
  • 基线版本默认 1.5.0
  • 升级需附变更说明
  • 至于升级节奏,我们不建议追最新版。私有化环境更稳妥的做法是锁定在稳定基线,等两个季度后再评估迁移。2026 年 10 月
  • 很多团队真正卡住的地方不是安装,而是决定配置该由谁维护。平台给出的建议是:把描述文件放在与代码同一个仓库,但由配置负责人

按环境挑一个下载入口

三个入口对应三类典型环境,挑错了也不会浪费太多时间。

开放环境里的后端服务,最省事的方式是引入 SDK:不需要额外的常驻进程,把描述文件当作配置资产提交进仓库即可。2026 年 11 月的抽样统计显示,这类接入占全部新接入场景的 61 %。

内网服务集群通常选择私有化部署,把控制服务与边缘代理装在自己的机房。部署完成后,客户端只读取本地的描述文件,不再依赖任何中心端调度。

如果只是做一次校验或者协助同事排查配置问题,下载命令行工具就够了,它不依赖运行时,可以直接放到跳板机上执行。

  • SDK 适合嵌入既有服务,不需要独立进程
  • 私有化部署适合有合规与延迟要求的内网
  • 命令行工具适合排障与流水线门禁
  • 在线包适合构建机与测试环境
  • 离线包适合无外网出口的生产内网
  • 所有安装物都提供 sha256 摘要
  • 所有版本都保留至少 2 个历史小版本
  • 升级失败可在 40 秒内切回旧目录
  • 构建机建议直接用 SDK,无需安装完整运行时
  • 跳板机放命令行工具即可满足排障需要
  • 生产内网用离线包,避免依赖外网
  • 校验工具可随镜像一起分发
工位上并列摆放着安装包文件与配置编辑器的笔记本电脑
图:命令行工具与描述文件是最小可用组合

安装与配置片段

以下画面来自官方文档的配套截图,展示安装目录与配置编辑界面。

索取特定版本的安装物

表单只在本页保存,不联网、不发送;填完截图留存即可。

已记录在本页,可截图留存

下载与安装相关疑问

以下为安装过程中最常见的问题,答案基于当前发布版本的实际行为。

在线包和离线包的功能有差别吗?

没有差别。两者产出的目录结构与二进制完全一致,2026 年 10 月的对照测试显示,它们部署出的实例在 12 项核心指标上的读数差为 0。差别只在于依赖获取时机。

安装需要 root 权限吗?

不强制。工具允许以普通用户安装到自定义目录并指定数据路径;只有启用 systemd 全局服务时才需要提权。按 2026 年 11 月的抽样统计,约 44 % 的部署选择普通用户目录。

SDK 会自动升级吗?

不会。SDK 遵循语义化版本,升级由你通过包管理器显式触发;平台端的配置结构变更则通过迁移工具显式执行,两条路径互不干扰。

下载的文件怎么确认没有被改动?

每个发布包都附带 sha256 摘要,命令行工具支持 klinkctl verify 一条命令完成比对,实测比对一个 214 MB 的离线包耗时 1.2 秒。

旧版本还能用吗?

可以。每个发布周期都会保留至少 2 个历史小版本,私有化环境通常锁定在 1.5.0 这一稳定基线,升级前会生成逐键差异报告。历史版本的安装包与摘要值会一直保留在发布页上,不做限时清理。

部署完成后怎么确认它真的在工作?

运行 klinkctl status 会输出节点心跳、最近一次计划渲染时间与 12 项指标的当前值;在 2026 年 10 月的测试中,该命令在 120 个实例上的输出完整率为 100 %。若命令返回的渲染时刻停留在几分钟之前,通常意味着热加载通道已经断开,需要检查配置目录权限。

离线包需要多久下载?

取决于链路带宽。按 2026 年 11 月的抽样,千兆内网下载 214 MB 离线包中位耗时 3.2 秒;100 Mbps 的环境下约 18 秒,1 Mbps 的窄带环境下需要 30 分钟左右。

能不能只下载 SDK 不装客户端?

可以。SDK 是独立的库包,不依赖客户端进程,也不读取客户端的配置目录。2026 年 10 月的测试里,单独引入 SDK 的应用在没有安装客户端的机器上同样可以正常工作。

安装与分发术语表

下载页涉及的每个名词都有明确口径,避免同一份东西有两个叫法。

在线安装包
体积 86 MB,安装时按需拉取运行时依赖。
离线安装包
体积 214 MB,把全部依赖预先打进压缩文件。
sha256 摘要
发布页公布的校验值,比对 214 MB 包耗时 1.2 秒。
最小描述文件
11 行内容的配置骨架,复制即可用于演练。
配置骨架生成
klinkctl init 产出带 42 键注释的初始文件。
校验命令
klinkctl validate,区分语法问题与取值问题。
计划预览
klinkctl plan 导出当前生效的连接计划。
原生版本
面向 Linux 与 macOS 的命令行构建,无运行时依赖。
PowerShell 版本
面向 Windows 的启动器,校验耗时中位 41 ms。
原生版校验耗时
Linux 与 macOS 构建的本地校验中位 18 ms。
演练模式
不产生对外流量,只走本地选路与日志。
故障场景
演练环境可注入的 3 类人为故障。
双目录切换
新旧版本目录并存,升级后可原地回滚。
回滚耗时
目录切换方式下实测 40 秒内完成。
基线版本
私有化环境默认锁定的 1.5.0 版本。
历史版本保留
每个发布周期至少保留 2 个历史小版本。
并行校验
单进程一次校验 20 份文件,耗时 340 ms。
离线许可证
本地校验授权的机制,有效期 30 天。
自部署目录
二进制、配置、证书与日志分离的四层结构。
数据目录
运行期状态与日志的存放位置,可自定义路径。
证书目录
存放证书与密钥的独立目录,权限需要收紧。
日志目录
默认保留 14 天,单行长度上限 512 字节。
普通用户安装
无需提权即可完成,约 44 % 的部署采用此方式。
systemd 服务
常驻运行形态,需要一次提权注册服务。
容器形态
以镜像方式运行,配置以卷挂载注入。
3.1.5
当前客户端版本号,与平台接口 1.7.0 对应。

按环境挑安装物

每个入口对应一类典型环境,挑错时的代价通常是一次重下。

后端服务

引入 SDK 即可,不需要额外部署常驻进程。

内网集群

私有化部署控制服务与边缘代理,自管节点。

排障跳板机

只放命令行工具,不装运行时。

构建机

SDK 走包管理器,流水线里跑校验门禁。

生产内网

离线包 214 MB,全程不需要外网出口。

测试环境

在线包 86 MB,安装耗时约 2 分钟。

Windows 环境

使用 PowerShell 版本,校验中位 41 ms。

Java 服务

Maven 坐标引入,首次连接实测 38 ms。

Go 网关

go get 引入,预热后构造 9 ms。

Python 任务

pip 安装,构造计划 16 ms。

Node.js 工具

npm 安装,构造计划 21 ms。

Rust 网关

crates.io 分发,构造 7 ms。

Shell 运维

340 KB 工具集,启动 31 ms。

版本锁定

按摘要值固定安装包,防止意外漂移。

离线部署

隔离网单机部署实测 6 分钟。

配置迁移

从 1.4.0 升级到当前结构,逐键比对。

校验门禁

失败退出码非零,直接阻断合并。

状态自查

klinkctl status 输出 12 项指标与心跳。

运行时与依赖术语

关于依赖、运行时与目录结构的部分,通常是第一次部署时最常被问到的。

运行时依赖
在线包在安装时拉取、离线包内置的那批库文件。
目录结构一致
两种包解出同样的四层目录,可直接互换。
日志上限
单行 512 字节,超出部分被截断并标记。
日志保留期
默认 14 天,超过后按轮转清理。
心跳间隔
默认 30 秒,可配置但最短 10 秒。
缓存有效期
离线模式下本地配置与证书的有效期 72 小时。
心跳超时
连续 3 个周期未上报即判定节点异常。
节点名
部署实例的唯一标识,重名会导致巡检冲突。
权限收紧
证书目录仅对运行账号开放,其它账号读取 0 次。
端口规划
默认占用 3 个端口,可由部署方自行映射。
出网方向
离线实例无指向公网中心的连接,实测 0 次。
镜像打包
把配置目录与二进制打成镜像的交付方式。
卷挂载
容器形态下注入配置与证书的方式。
配置目录
存放描述文件与片段的目录,可自定义路径。
片段合并
include 指令把多个文件组合成一份配置。
敏感字段
通过环境变量注入而不写入仓库的键值。
文件权限
密钥文件权限收紧到运行账号独占。
升级目录
新版本解压到的独立目录,与旧目录并存。
旧目录保留
观察期内保留,可随时切回。
安装耗时
单机从解压到首次连通实测 6 分钟。

下载后自检清单

把下载变成一次可交付的检查,逐项打勾即可。

摘要比对

sha256 校验通过再解压,耗时 1.2 秒。

解压路径

放在有写权限的目录,避免系统路径。

骨架生成

先生成最小描述文件再改写。

目录拆分

基础层与链路层分文件存放。

敏感字段

统一走环境变量注入。

语法校验

本地校验通过再进入演练。

取值校验

逐键核对 42 个键的范围。

计划预览

导出连接计划确认选路顺序。

演练运行

无对外流量跑 3 分钟看日志。

心跳确认

检查状态输出里的上报时刻。

指标接入

开启 12 项核心指标导出。

事件订阅

配置回调地址并验证签名。

流水线接入

校验作为合并前的门禁。

基线锁定

按摘要值固定当前安装包。

变更记录

在仓库记录升级说明与影响键。

回滚演练

切回旧目录实测 40 秒内完成。

文档同步

把新参数补进内部运维手册。

定期复核

每季度核对一次配置与实际行为。

版本与镜像说明

当前客户端版本 3.1.5,开放平台接口 1.7.0;离线包与命令行工具的摘要值随发布说明一同公布。

查看接入文档