温馨提示×

debian k8s能离线装吗

小樊
74
2026-10-22 20:02:57
栏目: 智能运维

可以,Debian 上的 Kubernetes 完全支持离线安装,但前提是你提前把所需的软件包、镜像和工具都准备好。

下面按常见场景给你说清楚怎么做,以及要注意什么。


一、离线安装的核心思路

离线安装 K8s,本质上就是解决 3 类依赖:

  1. 系统软件包(Debian apt)

    • kubelet、kubeadm、kubectl
    • containerd / docker
    • 内核模块、依赖库
  2. 容器镜像

    • k8s 核心组件镜像(如 k8s.gcr.io/kube-apiserver)
    • 网络插件镜像(Calico / Flannel / Cilium 等)
    • DNS、Metrics 等附加组件
  3. 二进制工具(可选)

    • crictl、helm、etcdctl 等

二、常见的离线安装方式(推荐)

✅ 方式 1:apt 离线仓库(最规范)

适合:多节点、生产环境

步骤概要:

  1. 在一台能联网的 Debian 机器上:

    apt-get download kubelet kubeadm kubectl containerd
    

    或使用 apt-mirror / reprepro 建立本地 apt 源

  2. 将 deb 包拷贝到目标机器

  3. 离线机器配置本地源:

    dpkg -i *.deb
    

✅ 优点:

  • 版本管理清晰
  • 易于批量部署

✅ 方式 2:kubeadm + 提前导入镜像(最常见)

适合:单集群、POC、内网环境

1. 在有网机器拉取镜像

kubeadm config images list
kubeadm config images pull
docker save -o k8s-images.tar \
  k8s.gcr.io/kube-apiserver:xxx \
  k8s.gcr.io/kube-controller-manager:xxx \
  ...

2. 离线机器导入

docker load -i k8s-images.tar

3. 初始化集群

kubeadm init --image-repository=本地仓库或直接使用离线镜像

⚠️ 注意:

  • kubeadm init 不会再去拉镜像,前提是镜像已存在
  • 网络插件(Calico 等)也必须提前导入

✅ 方式 3:私有镜像仓库(企业最推荐)

  • 搭建 Harbor / Nexus
  • 所有镜像推送到内网 registry
  • kubeadm 使用:
    kubeadm init --image-repository=registry.local/k8s
    

✅ 优点:

  • 后续扩容节点非常方便
  • 符合安全合规

三、Debian 离线安装特别注意点

1. 内核 & 模块

确保:

  • overlay、br_netfilter 已加载
  • sysctl 参数已设置
modprobe br_netfilter

2. containerd 离线

  • containerd 本身是 deb 包
  • 但 sandbox 镜像(pause)必须离线存在

3. 网络插件一定要离线

例如 Calico:

docker save calico/node calico/cni -o calico.tar

四、能不能“完全不联网装”?

✅ 可以 只要满足:

  • apt 包齐全
  • 所有镜像已导入
  • 不依赖公网 DNS / NTP(或内网提供)

❌ 不适合:

  • 直接用 apt install kubeadm(会联网)
  • 用默认 k8s.gcr.io 且没镜像

五、简单判断你适合哪种

场景 推荐方式
内网测试 kubeadm + 镜像导入
生产集群 私有仓库 + 本地 apt
多节点批量 apt 离线源
安全隔离 Harbor + 离线 ISO

如果你愿意,可以告诉我:

  • Debian 版本(11 / 12)
  • K8s 版本
  • 单节点还是多节点
  • 是否允许搭建私有仓库

我可以直接给你一套可执行的离线安装步骤。

0 踩