快速验证：用国内镜像1小时搭建K8s测试环境

最新推荐文章于 2026-03-29 10:49:35 发布

原创最新推荐文章于 2026-03-29 10:49:35 发布 · 70 阅读

本内容遵循CC 4.0 BY-SA版权协议

最近在尝试搭建Kubernetes测试环境时，最头疼的就是镜像拉取问题。很多教程默认的镜像源都在海外，比如gcr.io，在国内网络环境下基本无法访问，导致部署过程频繁卡壳，一个简单的测试环境搭建可能要折腾一整天。为了解决这个问题，我决定写一个脚本，目标是利用国内镜像仓库，在一小时内快速搭建起一个可用的K8s单节点测试集群。下面就把我的实现思路和踩坑经验记录下来。

明确目标与核心痛点。我的核心需求是快速搭建一个用于学习和功能验证的K8s环境，而不是生产级的高可用集群。因此，单节点（All-in-One）部署模式完全够用。最大的障碍就是镜像，必须将所有默认的海外镜像替换为国内可稳定访问的镜像源，例如阿里云、中科大、网易等提供的镜像仓库。脚本需要自动化完成这个替换过程。
环境准备与系统适配。考虑到团队或个人可能使用不同的Linux发行版，我决定让脚本同时支持CentOS 7/8和Ubuntu 18.04/20.04/22.04。第一步就是系统检测，根据不同的发行版执行相应的初始化操作，比如关闭防火墙、禁用SELinux（针对CentOS）、配置主机名、关闭swap分区等。这些是K8s运行的基础前提条件，必须优先处理。
自动化配置国内镜像源。这是脚本的灵魂。我将其分为几个层次：首先是操作系统本身的软件源，如Docker和Kubernetes的安装源，需要替换为国内的镜像站点以加速包下载。其次是Docker本身的镜像加速器，需要配置/etc/docker/daemon.json文件，添加阿里云或腾讯云的镜像加速地址。最后，也是最关键的一步，是Kubernetes核心组件镜像的替换。
核心：替换K8s组件镜像。使用kubeadm部署时，它会默认从k8s.gcr.io拉取kube-apiserver、kube-controller-manager、kube-scheduler、kube-proxy等核心镜像，以及coredns、etcd和pause镜像。我的脚本会在kubeadm init之前，预先通过docker pull命令，从国内镜像仓库（如registry.aliyuncs.com/google_containers）拉取对应版本的镜像，并重新打上k8s.gcr.io的标签。这样，kubeadm在执行时就会直接使用本地已存在的、从国内源拉取的镜像，完美绕过网络障碍。
部署与初始化集群。镜像准备就绪后，就可以执行kubeadm init命令了。这里我添加了--pod-network-cidr参数来指定Pod网络段，为后续安装网络插件做准备。初始化成功后，脚本会按照提示，自动为当前用户配置kubectl的认证信息（复制config文件到.kube目录），这样就能立刻使用kubectl命令了。
安装网络插件与基础监控。没有网络插件的K8s集群，Pod之间是无法通信的。我选择了比较常用的Flannel网络插件，同样需要将其镜像（如quay.io/coreos/flannel）替换为国内可访问的镜像源后再进行部署。为了让测试环境更有价值，我还加入了基础监控组件metrics-server的安装步骤，这样就能使用kubectl top命令查看节点和Pod的资源使用情况了。安装metrics-server时，同样需要注意其镜像的国内替换。
提供一键清理功能。测试环境可能经常需要推倒重来。因此，脚本还包含了一个清理功能，可以一键执行kubeadm reset -f，并清理掉相关的Docker镜像、网络配置和iptables规则，让系统恢复到安装前的状态，方便下次重新部署。
日志输出与错误处理。为了让整个过程透明化，脚本在每个关键步骤都设置了清晰的日志输出，标明正在执行的操作和进度。同时，加入了基本的错误检查，如果某个步骤（如镜像拉取、命令执行）失败，脚本会给出明确的错误提示并中止，而不是继续执行导致更混乱的结果，方便使用者定位问题。

整个脚本写下来大概两百多行，但逻辑很清晰。实际跑一遍，从执行脚本开始到看到一个完整的、带监控的单节点K8s集群，确实控制在一小时以内，大部分时间花在了镜像下载上，而由于使用了国内源，下载速度非常快。这个实践让我深刻体会到，对于原型验证和快速测试，自动化脚本加上可靠的国内基础设施（镜像仓库）能极大提升效率。

这次搭建过程，我是在InsCode(快马)平台上完成的代码编写和思路整理。这个平台用起来很顺手，打开网站就能直接写，不需要在本地配置任何环境。最让我惊喜的是它的一键部署能力，像这类需要持续运行并提供服务的项目（比如一个Web管理界面或者API服务），写完代码后点一下部署按钮，平台就会自动处理好运行环境并生成一个可公开访问的链接，整个过程非常省心，对于快速分享和演示成果特别有帮助。

示例图片