0

0

Linux k0s 的零依赖安装与 air-gapped 离线部署流程

冷漠man

冷漠man

发布时间:2026-02-25 18:40:02

|

161人浏览过

|

来源于php中文网

原创

k0s无需systemd因单二进制静态链接核心组件,但离线部署需手动补全iptables、ip、modprobe等系统工具及so依赖,并正确配置service路径、worker join token和containerd镜像导入。

linux k0s 的零依赖安装与 air-gapped 离线部署流程

为什么 k0s 不需要 systemd 也能跑,但离线部署必须手动处理二进制依赖

k0s 本身是单二进制,k0s 文件里已静态链接了大部分运行时(比如容器运行时、etcd),但实际启动时仍会调用系统级工具:比如 iptablesmodprobesysctl。这些不是 k0s 自带的,离线环境若没预装,节点会卡在 “waiting for node to be ready” 或报 failed to setup iptables rules

实操建议:

  • 离线前,在同构系统(相同 OS 版本 + 架构)上运行 k0s install controller 并观察日志,用 strace -e trace=execve k0s start 捕获所有外部命令调用
  • 把缺失的二进制(如 iptablesipmodprobesysctl)连同它们的 so 依赖(用 ldd 检查)一并打包进离线介质
  • 别指望用 --disable-components 关掉网络策略就能绕过 iptables——kube-proxy 默认启用,且 k0s v1.28+ 强制校验 iptables 可用性

k0s air-gapped 部署时,如何让 worker 节点跳过 controller 的 TLS 证书校验

离线环境下,controller 的证书通常是自签名的,worker 启动时默认会校验 CA,失败就停在 failed to join cluster: x509: certificate signed by unknown authority。这不是 bug,是设计行为。

实操建议:

  • 不要改 worker 的 k0s.yaml 去删 CA 字段——k0s 会拒绝加载不完整配置
  • 正确做法是在 controller 初始化时,用 --config 指定含 spec.api.tlsSanspec.network.podCIDR 的配置,并提前生成好 CA;或更简单:用 k0s token create --role=worker --expiry=24h 生成带嵌入式 CA 的 join token
  • token 本质是 base64 编码的 JSON,里面包含 ca.crt 内容,worker 用它 join 就自动信任,无需额外传证书文件
  • 注意 token 有效期:离线环境无法自动续期,务必用 --expiry 设长一点,比如 8760h(1年)

离线集群里,k0s 如何加载本地 containerd 镜像而不依赖 registry

k0s 默认用 containerd,但它不支持直接从本地 tar 文件加载镜像(像 docker load 那样)。如果离线环境没搭 registry,又想预置 corednskube-proxy 等镜像,容易卡在 ImagePullBackOff

AI Background Remover
AI Background Remover

AI背景移除工具,免费使用

下载

实操建议:

  • 先在有网机器上用 ctr --namespace=k8s.io images pull 拉取所需镜像,再用 ctr --namespace=k8s.io images export coredns.tar ghcr.io/coredns/coredns:1.11.3 导出为 tar
  • 离线节点上,用 ctr --namespace=k8s.io images import coredns.tar 导入——注意 namespace 必须是 k8s.io,否则 k0s 容器运行时不认
  • 别用 nerdctldocker save/load 替代:containerd 的镜像存储格式和 layer 解析逻辑与 docker 不完全兼容,导入后可能显示 missing blob
  • 验证是否成功:ctr --namespace=k8s.io images list | grep coredns,看到 status 是 ready 才算真正可用

k0s v1.27+ 离线安装时,systemd 服务文件为什么不能直接用 k0s install 生成

k0s install 默认生成的 systemd unit 会写死 ExecStart=/usr/bin/k0s,并依赖 /usr/bin/k0s 存在。但在 air-gapped 场景下,你很可能把 k0s 放在 /opt/k0s/k0s 这类自定义路径,直接运行 install 会导致服务启动失败,报 Failed at step EXEC spawning /usr/bin/k0s: No such file or directory

实操建议:

  • 不要运行 k0s install,改用手动创建 service 文件:sudo cp k0s /opt/k0s/k0s && sudo chmod +x /opt/k0s/k0s
  • k0s default-config > k0s.yaml 生成基础配置,修改其中 spec.dataDir 指向离线路径(如 /opt/k0s/data
  • service 文件里明确写 ExecStart=/opt/k0s/k0s server --config /opt/k0s/k0s.yaml,并加 Environment="K0S_DATA_DIR=/opt/k0s/data"
  • 特别注意:k0s v1.28 开始,k0s install 加了 --bin-dir 参数,但仅限 controller;worker 仍不支持,必须手写 service

离线部署最麻烦的从来不是 k0s 本身,而是它默许依赖的那些“系统常识”——比如哪个路径该有 iptables,哪个 namespace containerd 认,甚至 systemd 服务里一个硬编码路径。这些细节不记日志、不报明确错误,只让你等在 “node not ready” 里干瞪眼。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

448

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

323

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6438

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

838

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

1087

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

1693

2024.03.01

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

127

2026.02.25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 9.7万人学习

Git 教程
Git 教程

共21课时 | 3.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号