kubeasz

easzlab活跃维护

用 Ansible 脚本一键部署 Kubernetes 集群，附带组件交互原理讲解，不依赖外网，国内环境也能顺畅安装。

使用Ansible脚本安装K8S集群，介绍组件交互原理，方便直接，不受国内网络环境影响

3.7.0发布于 2026-08-09 08:53 UTC11,448star +2 / 7 天3,649fork同步于 2026-11-10 23:29 UTC

Kubernetes部署 Ansible 集群安装离线安装容器编排

对比 GitHub 官网 ansible calico cilium docker etcd

怎么上手

由 README 提炼，执行前请确认

原文

单机快速体验参见 docs/setup/quickStart.md 的 AllinOne 部署

硬件要求按 README 说明

README 未说明 CPU、内存或显存要求；仅说明支持 amd64/arm64 架构及多种使用 systemd 的 Linux 发行版

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

用 Ansible 脚本以二进制方式快速部署高可用 K8s 集群，不受国内网络环境影响

用 Ansible 脚本一键部署 Kubernetes 集群，附带组件交互原理讲解，不依赖外网，国内环境也能顺畅安装。

核心能力

用 ansible-playbook 自动化分步安装各组件
支持 Master 高可用与离线安装
支持 amd64/arm64 多架构部署
可选 calico、cilium、flannel 等网络插件
预置默认配置，也可自定义组件参数

容易踩的坑

需先按安装指南准备证书与系统环境；离线安装需提前准备离线资源；不同 Kubernetes 版本需对应匹配的 kubeasz 版本

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

最近发版

5 个版本3.7.0

全部 release

3.7.0kubeasz 3.7.0最新正式版2026-08-09 · 2026-08-09 08:53 UTC
kubeasz 3.7.0

首个 kubeasz 3.7.x 版本发布，默认使用nftables 模式，包含大量组件更新。

版本/组件更新
- k8s: v1.36.3
- etcd: v3.7.1
- containerd: 2.3.3
- runc: v1.5.1
- cni: v1.9.1
- calico: v3.32.1
- flannel: v0.28.9
- coredns: 1.14.6
- nodelocaldns: 1.26.8
- metrics: v0.9.0
- pause: 3.10.2
- headlamp: 0.43.0
- openebs: 4.5.1
- higress: 2.2.3
- node-problem-detector: v1.35.3
- kube-prometheus-stack: 88.1.5
重要更新
- 支持 k8s v1.36集群默认使用 kube-proxy 的nftables 模式，需要较新的系统内核支持(kernal >= 5.13 and nft >= 1.0.0)；更新默认支持的操作系统列表，尽量选择较新系统内核的稳定linux发行版。
- 新增组件node-problem-detector 和若干自定义检查插件。
- 新增组件 headlamp 替换 dashboard，使用更加方便。
- 新增组件 higress ingress controller 替换 ingress-nginx。
其他更新
- 新增 easzlab/kubeasz 镜像签名信息和SBOM 信息，感谢kobihikri #1538
- 新增openeuler22/24系统软件离线包下载，感谢whowhopipi
- 部分文档更新
3.6.10kubeasz 3.6.102026-07-21 · 2026-07-21 10:46 UTC
查看更新说明
kubeasz 3.6.10

kubeasz 3.6.10 发布：支持k8s v1.36 版本，组件更新和bugfix。

版本更新
- k8s: v1.35.6
- kubeblocks: 1.0.1
重要更新
- ezctl 脚本对于已有集群，支持批量增加节点
- 修复containerd 创建镜像加速配置的问题
其他更新
- fix github workflow to build docker images
- fix: misleading arch config in containerd to #1536
3.6.9kubeasz 3.6.92026-05-06 · 2026-05-06 14:59 UTC
查看更新说明
kubeasz 3.6.9

kubeasz 3.6.9 发布：支持k8s v1.35 版本，组件更新和bugfix。

版本更新
- k8s: v1.35.4
- etcd: v3.6.7
- kubeblocks: 1.0.1
- kubernetes-dashboard: 7.14.0
重要更新
- 增加harbor aarch64架构离线安装包，使用circleci 自动化构建（#1510），参考：https://github.com/gjmzj/build-harbor-aarch64
- 新增自定义containerd 安装配置项，支持独立部署实例，详见：docs/blog/seperated_containerd_services_for_docker_and_k8s.md
- 优化镜像下载逻辑，失败情况下可以回退直接从指定mirror地址下载（0975932643df25）
- 修复containerd 配置非安全证书的镜像仓库（#1515）
- 优化ezdown 脚本下载二进制逻辑
- 更新国内可用的docker镜像仓库
- 修复etcd 备份恢复问题（#1516）
- 优化支持Redhat-variant Linux发行版使用dnf包管理的情况
- 新增/优化项目github 自动化流水线任务
文档更新
- 更新etcd 安装文档
- 更新自定义配置部署containerd实例文档 docs/blog/seperated_containerd_services_for_docker_and_k8s.md
感谢贡献者：

wuxie0ne #1529 lswzw #1523 pansx #1519 piano-wow #1515 bookgh #1516
3.6.8kubeasz 3.6.82025-09-14 · 2025-09-14 11:53 UTC
查看更新说明
kubeasz 3.6.8

kubeasz 3.6.8 发布：支持k8s v1.34 版本，组件更新和bugfix。

版本更新
- k8s: v1.34.1
- etcd: v3.6.4
- containerd: 2.1.4
- runc: v1.3.1
- coredns: 1.12.4
- cni: v1.8.0
- dnsNodeCache: 1.26.4
- metrics: v0.8.0
- flannel: v0.27.3
- kubeblocks: 1.0.0
- kube-prometheus-stack: 75.7.0
重要更新
- 调整系统内核设置 commit f9bdbeb4e3bd6b98a03a900d3e50ef29da6a590f, #1478
- 新增支持 openEuler 22.03 LTS, 24.03 LTS
- 优化节点只需运行一次 prepare task
- 增加可选开启集群审计功能
- 修复 calico mtu 设置 #1444
- 修复 calico vxlan overlay 设置 #1492
- 更新 containerd 配置容器镜像仓库方式
文档更新
- 实验性混合架构部署文档 https://github.com/easzlab/kubeasz/blob/master/docs/setup/mix_arch.md
- updat kernel_upgrade.md for centos7 by Zlanghu #1483
感谢新增贡献者：

vistamin #1444 newfzk #1477 learn0208 #1478 Zlanghu #1483 newfzk #1492 TOT-JIN #1495
3.6.7kubeasz 3.6.72025-06-08 · 2025-06-08 09:32 UTC
查看更新说明
kubeasz 3.6.7

kubeasz 3.6.7 发布：支持k8s v1.33 版本，组件更新和bugfix。

版本更新
- k8s: v1.33.1
- etcd: v3.5.21
- containerd: 2.1.1
- runc: v1.2.6
- calico: v3.28.4
- cilium: 1.17.4
- coredns: 1.12.1
- cni: v1.7.1
- dnsNodeCache: 1.25.0
- harbor: v2.12.4
- local-path-provisioner: v0.0.31
- dashboard 7.12.0
更新
- 增加可选组件kubeblocks集成，增加多种数据库高可用方案
- 重写脚本ezdown中关于镜像下载保存部分，清理冗余，增加错误错误处理
- 修复添加/删除master节点时/etc/hosts问题 #1464
- 修复使用静态编译的containerd二进制，并设置日志为warn级别，避免当容器使用exec类健康检查时产生过多日志
- 修复./ezdown -D 偶发403报错 #1470
- 修复cilium 组件原cilium_connectivity_check脚本执行条件
文档更新
- 更新一致性认证文档 conformance.md

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

kubeasz 致力于提供快速部署高可用k8s集群的工具, 同时也努力成为k8s实践、使用的参考书；基于二进制方式部署和利用ansible-playbook实现自动化；既提供一键安装脚本, 也可以根据安装指南分步执行安装各个组件。

kubeasz 从每一个单独部件组装到完整的集群，提供最灵活的配置能力，几乎可以设置任何组件的任何参数；同时又为集群创建预置一套运行良好的默认配置，甚至自动化创建适合大规模集群的BGP Route Reflector网络模式。

集群特性 Master高可用、离线安装、多架构支持(amd64/arm64)
集群版本 kubernetes v.1.33, v1.34, v1.35, v1.36
运行时 containerd v2.3.x
网络 calico, cilium, flannel, kube-ovn, kube-router

[news] kubeasz 通过cncf一致性测试详情

推荐版本对照

支持系统

Alibaba Cloud Linux 3.2104
Alma Linux 8, 9
Anolis OS 8.x RHCK, 8.x ANCK
RHEL 8, 9
Debian 12, 13(notes)
Fedora 36, 37
Kylin Linux Advanced Server V10 麒麟V10 Tercel, Lance, Halberd
openEuler 22.03 LTS, 24.03 LTS(notes)
openSUSE Leap 15.x(notes)
Rocky Linux 8, 9
Ubuntu 22.04, 24.04

能够支持大部分使用systemd的linux发行版，如果安装有问题先请查看文档；如果某个能够支持安装的系统没有在列表中，欢迎提PR 告知。

快速指南

单机快速体验k8s集群的测试环境--AllinOne部署

安装指南

使用指南

沟通交流

微信：k8s&kubeasz实践, 搜索微信号badtobone, 请按格式备注（${城市}-${github用户名}）, 验证后加入群聊。
推荐链接

贡献&致谢

欢迎提Issues和PRs参与维护项目！感谢您的关注与支持！

怎么上手

项目说明

核心能力

容易踩的坑

最近发版

kubeasz 3.7.0

版本/组件更新

重要更新

其他更新

kubeasz 3.6.10

版本更新

重要更新

其他更新

kubeasz 3.6.9

版本更新

重要更新

文档更新

kubeasz 3.6.8

版本更新

重要更新

文档更新

kubeasz 3.6.7

版本更新

更新

文档更新

用户点评

README 原文

支持系统

快速指南

安装指南

使用指南

沟通交流

贡献&致谢

相关项目