k3s v1.37.0+k3s1 版本更新介绍
发布日期: 2026-09-14
版本号: v1.37.0+k3s1
K3s v1.37.0+k3s1 发布,将 Kubernetes 升级至 v1.37.0 并修复了若干问题。相对 v1.36.3+k3s1 的主要变更包括:升级 Kubernetes 到 v1.37、etcd 到 v3.7.1-k3s1、containerd 到 v2.3.4、Traefik 到 v3.7.13、metrics-server 到 v0.9.0、CoreDNS 镜像、critools 到 v1.37,并将 google.golang.org/grpc 升级到 v1.83.2 以修复 CVE-2026-84445;新增 –write-kubeconfig-name 服务器参数用于设置生成的 kubeconfig 中集群、用户和上下文的名称;修复了 airgap 镜像导入在系统默认 registry 与镜像原有 registry 相同时报"已存在"错误或每次重启累积重复镜像标签的问题;修复了 apiserver 服务证书未将 –advertise-address 值纳入主题备用名的问题;修复了生产构建总是启用 Go 覆盖率插桩的问题;简化了 WriteSubnetFile 的清理逻辑并使其原子化写入;加入 etcd 客户端锁;要求节点密码 informer 同步完成后才使用缓存;SLES 改用 slemicro RPM 包;stable 频道更新至 v1.36.3+k3s1;此外还启用了单元测试、CI 中 Docker 升级到 29、精简了 Dockerfile 与构建阶段、为 apiserver 证书生成前加入 advertise-address、bump 了 helm-controller、kine、Local Path Provisioner、gateway-api CRD 等依赖版本。内嵌组件版本为 Kubernetes v1.37.0、Kine v0.17.0、SQLite 3.53.4、Etcd v3.7.1-k3s1、Containerd v2.3.4-k3s1、Runc v1.4.2、Flannel v0.28.4、Metrics-server v0.9.0、Traefik v3.7.13、CoreDNS v1.14.7、Helm-controller v0.17.7、Local-path-provisioner v0.0.37。
更新内容 (中文)
此版本将 Kubernetes 更新至 v1.37.0,并修复了若干问题。
有关新增内容的更多详情,请参阅 Kubernetes 发行说明。
自 v1.36.3+k3s1 以来的变更:
- 升级 mirrored-pause 至 3.10.2 (#14339)
- 构建(deps):升级 action-deps 组,共 14 项更新 (#14394)
- 升级 dynamiclistener 以修复原子写入问题 (#14382)
- 升级 helm-controller/klipper-helm (#14403)
- 简化 WriteSubnetFile 的清理逻辑并使其原子化 (#14405)
- 修复快照 prune 事件中的拼写错误 (#14410)
- 升级 rancher/mirrored-coredns-coredns 镜像版本 (#14415)
- 添加 updatecli 清单,用于在多个发布分支间升级 Kubernetes (#14402)
- 升级 metrics-server 至 v0.9.0 (#14416)
- Updatecli:放宽 metrics-server 的 semver 过滤器等 (#14429)
- Updatecli:添加缺失的 requiredEnv (#14434)
- 升级 helm-controller 和 klipper-helm 以支持
--force-conflicts(#14446) - 升级 k3s-io/kubernetes 及 Go 版本引用 (#14457)
- 升级 etcd 至 v3.6.14 (#14460)
- 修复生产构建始终启用 Go 覆盖率插桩的问题 (#14465)
- 新功能:支持自定义 kubeconfig 名称 (#14440)
- 新增
--write-kubeconfig-name服务端标志,用于设置生成的 kubeconfig 中集群、用户和上下文的名称。
- 新增
- 使用缓存前要求节点密码 informer 完成同步 (#14459)
- 升级 helm-controller 和 klipper-helm (#14474)
- 启用单元测试 (#14480)
- 修复:将 sles 改为使用 slemicro rpm 而非 microos (#14472)
- 测试:使 rootless uidmap 安装能够抵御过期的 apt 缓存 (#14490)
- 将 stable 通道更新至 v1.36.3+k3s1 (#14492)
- Etcd 客户端锁 (#14488)
- 测试:为 multus e2e 测试安装 rke2-multus-crd chart (#14489)
- 过滤大型未模板化 issue (#14435)
- 修复 spegel deferred store 注释中的拼写错误 (#14485)
- 明确应在何处进行 coredns 自定义配置 (#14503)
- 将 CI 中的 docker 版本升级至 29 (#14506)
- 不为镜像已托管的 registry 重新打标签 (#14484)
- 修复了这样一个问题:当 system-default-registry 与镜像原本所属的 registry 相同时,airgap 镜像导入可能因 “already exists” 错误而失败,或在每次重启后累积重复的镜像标签。
- 整理 dockerfile 和构建阶段 (#14511)
- 在生成 apiserver 证书前将 advertise-address 加入 SAN (#14516)
- 修复了 apiserver 服务证书的主题备用名(subject alternative names)中未包含 –advertise-address 值的问题。
- 升级 Local Path Provisioner 版本 (#14496)
- 升级 containerd 至 v2.3.4-k3s1.36 (#14510)
- 升级 kine 至 v0.16.4 以修复 nats 重放问题 (#14521)
- 新功能:将 Project Bluefin 加入采用者列表 (#14549)
- 升级 k8s 至 v1.37 (#14509)
- 升级 Traefik 并打包 gateway-api crds (#14573)
- 升级 rancher/mirrored-coredns-coredns 镜像版本 (#14577)
- 升级 critools 至 v1.37 (#14579)
- 升级 gateway-api-crd 至版本 3,其中包含 keep 注解 (#14586)
- 升级 Traefik 至 v3.7.13 (#14606)
- 为修复 CVE-2026-84445 升级 google.golang.org/grpc 至 v1.83.2 (#14614)
- 升级 google.golang.org/grpc 至 v1.83.2,而非 v1.82.2 (#14619)
内嵌组件版本
| 组件 | 版本 |
|---|---|
| Kubernetes | v1.37.0 |
| Kine | v0.17.0 |
| SQLite | 3.53.4 |
| Etcd | v3.7.1-k3s1 |
| Containerd | v2.3.4-k3s1 |
| Runc | v1.4.2 |
| Flannel | v0.28.4 |
| Metrics-server | v0.9.0 |
| Traefik | v3.7.13 |
| CoreDNS | v1.14.7 |
| Helm-controller | v0.17.7 |
| Local-path-provisioner | v0.0.37 |
有用链接
一如既往,我们欢迎并感谢社区用户的反馈。请随时:
- 在此提交 issue
- 加入我们的 Slack 频道
- 查看我们的文档,了解如何入门或深入了解 K3s。
- 在此了解如何参与贡献
更新内容 (原始)
This release updates Kubernetes to v1.37.0, and fixes a number of issues.
For more details on what’s new, see the Kubernetes release notes.
Changes since v1.36.3+k3s1:
- Bump mirrored-pause to 3.10.2 (#14339)
- Build(deps): bump the action-deps group with 14 updates (#14394)
- Bump dynamiclistener for atomic write fix (#14382)
- Bump helm-controller/klipper-helm (#14403)
- Simplify WriteSubnetFile cleanup and make atomic (#14405)
- Fix typo in snapshot prune event (#14410)
- Bump rancher/mirrored-coredns-coredns image version (#14415)
- Add updatecli manifest to bump Kubernetes across multiple release branches (#14402)
- Bump metrics-server to v0.9.0 (#14416)
- Updatecli: relax metrics-server semver filter et al. (#14429)
- Updatecli: add missing requiredEnv (#14434)
- Bump helm-controller and klipper-helm for
--force-conflictssupport (#14446) - Bump k3s-io/kubernetes and Go references (#14457)
- Bump etcd to v3.6.14 (#14460)
- Fix production builds always enabling Go coverage instrumentation (#14465)
- Feat: support custom kubeconfig name (#14440)
- Added
--write-kubeconfig-nameserver flag to set the name for cluster, user and context in generated kubeconfig.
- Added
- Require node password informer sync before using cache (#14459)
- Bump helm-controller and klipper-helm (#14474)
- Enable unit tests (#14480)
- Fix: change sles to use slemicro rpms instead of microos (#14472)
- Tests: make rootless uidmap install robust against stale apt cache (#14490)
- Update stable channel to v1.36.3+k3s1 (#14492)
- Etcd client locking (#14488)
- Tests: Install rke2-multus-crd chart for multus e2e test (#14489)
- Filter large untemplated issues (#14435)
- Fix typo in spegel deferred store comment (#14485)
- Make explicit where coredns customizations should be made (#14503)
- Bump docker version in CI to 29 (#14506)
- Don’t retag images for a registry they are already hosted by (#14484)
- Fixed an issue where airgap image imports could fail with an “already exists” error, or accumulate duplicate image tags on every restart, when system-default-registry matched the registry the images were already tagged for.
- Tidy dockerfile and build stages (#14511)
- Add advertise-address to SANs before generating apiserver cert (#14516)
- Fixed the apiserver serving certificate not including the value of –advertise-address in its subject alternative names.
- Bump Local Path Provisioner version (#14496)
- Bump containerd to v2.3.4-k3s1.36 (#14510)
- Bump kine to v0.16.4 for nats replay fix (#14521)
- Feat: Add Project Bluefin to adopters list (#14549)
- Bump k8s to v1.37 (#14509)
- Bump Traefik and bundle gateway-api crds (#14573)
- Bump rancher/mirrored-coredns-coredns image version (#14577)
- Bump critools to v1.37 (#14579)
- Bump gateway-api-crd version 3, which includes the keep annotation (#14586)
- Bump Traefik to v3.7.13 (#14606)
- Bump google.golang.org/grpc to v1.83.2 for CVE-2026-84445 (#14614)
- Bump google.golang.org/grpc to v1.83.2, not v1.82.2 (#14619)
Embedded Component Versions
| Component | Version |
|---|---|
| Kubernetes | v1.37.0 |
| Kine | v0.17.0 |
| SQLite | 3.53.4 |
| Etcd | v3.7.1-k3s1 |
| Containerd | v2.3.4-k3s1 |
| Runc | v1.4.2 |
| Flannel | v0.28.4 |
| Metrics-server | v0.9.0 |
| Traefik | v3.7.13 |
| CoreDNS | v1.14.7 |
| Helm-controller | v0.17.7 |
| Local-path-provisioner | v0.0.37 |
Helpful Links
As always, we welcome and appreciate feedback from our community of users. Please feel free to:
- Open issues here
- Join our Slack channel
- Check out our documentation for guidance on how to get started or to dive deep into K3s.
- Read how you can contribute here
下载链接
- k3s
- k3s-airgap-images-amd64.tar
- k3s-airgap-images-amd64.tar.gz
- k3s-airgap-images-amd64.tar.zst
- k3s-airgap-images-arm.tar
- k3s-airgap-images-arm.tar.gz
- k3s-airgap-images-arm.tar.zst
- k3s-airgap-images-arm64.tar
- k3s-airgap-images-arm64.tar.gz
- k3s-airgap-images-arm64.tar.zst
- k3s-arm64
- k3s-armhf
- k3s-images.txt
- sha256sum-amd64.txt
- sha256sum-arm.txt
- sha256sum-arm64.txt