在云原生技术栈中Kubernetes 的部署和管理一直是开发者、运维人员乃至整个团队需要面对的核心挑战。从虚拟机到物理机从单节点到高可用集群每一步都涉及复杂的网络配置、证书管理、组件安装和版本兼容性问题。对于希望快速搭建开发测试环境或是为中小型项目构建生产级 K8s 集群的团队来说一个简单、快速、全栈且开源的部署工具至关重要。Sealos 正是为解决这一痛点而生它并非另一个 Kubernetes 发行版而是一个以 Kubernetes 为内核的“操作系统”分发与集群生命周期管理工具。Sealos 的核心设计理念是“像使用传统操作系统一样使用云”。它将 Kubernetes 及其生态应用如数据库、中间件、AI框架打包成一个不可变的“镜像”通过极简的命令即可在任意基础设施上拉起一个完整的集群。这意味着你不再需要分别安装 Docker、kubeadm、etcd、网络插件再小心翼翼地配置它们之间的协作。Sealos 通过封装最佳实践将复杂的部署过程标准化、自动化让用户能够专注于应用本身而非底层基础设施的搭建与维护。本文将带你从零开始快速理解 Sealos 的核心概念并完成一个单机版 Kubernetes 集群的部署实践让你亲身体验其“三分钟”快速上手的承诺。1. 理解 Sealos 的核心机制从“镜像”到“集群”要高效使用 Sealos首先需要理解其两个核心抽象集群镜像和集群生命周期管理。这与 Docker 的“镜像”和“容器”概念有异曲同工之妙但操作的对象是整个分布式系统。1.1 什么是集群镜像 (ClusterImage)集群镜像是 Sealos 的灵魂。它不是一个容器镜像而是一个包含了运行一个分布式系统所需所有依赖和配置的压缩包。一个典型的 Sealos 集群镜像至少包含以下层次Kubernetes 内核特定版本的 kubelet、kubeadm、kubectl、容器运行时如 containerd等二进制文件。系统依赖与配置操作系统初始化脚本、内核参数调优、防火墙规则、SELinux 配置等。核心组件网络插件如 Calico、Flannel、存储插件如 Local PV、Ingress 控制器等。应用软件可选的数据库MySQL、PostgreSQL、消息队列Redis、监控栈Prometheus, Grafana等。例如一个名为labring/kubernetes:v1.27.0的镜像就代表了一个纯净的、版本为 v1.27.0 的 Kubernetes 集群环境。而labring/helm:v3.12.0则是在此基础上预装了 Helm 工具。这种封装方式带来了不可变性和可移植性。一旦镜像构建完成在任何符合要求的环境干净的 CentOS 7.9, Ubuntu 20.04 等上部署得到的结果都是完全一致的彻底消除了“环境差异”问题。1.2 Sealos 的集群生命周期管理Sealos 通过几个简单的命令管理集群的整个生命周期其工作流程可以概括为“拉取 - 安装 - 运行 - 管理”。sealos run这是最核心的命令。它负责从镜像仓库拉取指定的集群镜像并在目标机器上安装并运行一个集群。对于单节点集群它会在当前机器上完成所有工作对于多节点集群它会通过 SSH 自动将镜像分发到各个节点并执行安装。sealos exec在已运行的集群节点上执行命令常用于批量操作或调试。sealos scp在集群节点间复制文件。sealos reset彻底清理当前机器上的 Sealos 集群包括删除所有相关容器、配置文件、数据卷和网络配置将系统恢复到安装前的状态。sealos images列出本地已拉取的集群镜像。这种设计将复杂的 K8s 部署简化为一个类似docker run的体验。用户无需关心 kubeadm init 的配置参数、证书生成细节或网络插件的 YAML 文件Sealos 已经将这些最佳实践固化在了镜像中。2. 环境准备与依赖检查在开始“三分钟部署”之前必须确保基础环境满足要求。一个常见的问题是直接在已有 Docker 或旧版 K8s 的环境上安装导致端口冲突、文件残留和不可预知的错误。2.1 系统要求与前置条件Sealos 对目标机器有明确且严格的要求不符合要求直接安装大概率会失败。请逐项核对以下清单检查项要求检查命令说明操作系统CentOS 7.9 / Ubuntu 20.04 / Ubuntu 22.04cat /etc/os-release推荐使用全新或最小化安装的系统。其他版本可能兼容但需自行承担风险。内核版本≥ 3.10 (CentOS) / ≥ 5.4 (Ubuntu)uname -r一般现代发行版都满足。CPU架构x86_64 / arm64arch支持主流架构。内存≥ 2 GBfree -h运行 K8s 控制平面组件的最小要求生产环境建议更高。磁盘空间≥ 20 GBdf -h /用于存放镜像、容器和系统文件。主机名非localhost包含点(.)或横杠(-)hostnameK8s 对主机名有要求。如果为localhost需修改。网络各节点间网络互通可访问外网ping -c 4 8.8.8.8拉取镜像和组件需要外网。生产环境需考虑内网镜像仓库。防火墙关闭或放行端口systemctl status firewalld(CentOS)sudo ufw status(Ubuntu)学习环境建议直接关闭避免端口冲突。生产环境需精细配置。SELinux关闭 (仅限 CentOS/RHEL)getenforce如果为Enforcing需设置为Permissive或关闭。注意强烈建议使用一台全新的、最小化安装的虚拟机或云服务器进行首次尝试。这能最大程度避免因系统残留旧版 Docker、K8s、containerd导致的诡异问题。2.2 环境初始化脚本对于一台干净的 CentOS 7.9 服务器你可以执行以下脚本来完成基础环境配置。Ubuntu 系统命令略有不同但逻辑类似。#!/bin/bash # 环境初始化脚本 (CentOS 7.9 示例) set -e # 1. 关闭防火墙 systemctl stop firewalld systemctl disable firewalld # 2. 关闭 SELinux (仅CentOS/RHEL) setenforce 0 sed -i s/^SELINUXenforcing/SELINUXdisabled/ /etc/selinux/config # 3. 关闭 swap swapoff -a sed -i / swap / s/^\(.*\)$/#\1/g /etc/fstab # 4. 配置内核参数并加载模块 cat /etc/modules-load.d/k8s.conf EOF br_netfilter ip_vs ip_vs_rr ip_vs_sh ip_vs_wrr nf_conntrack EOF modprobe br_netfilter modprobe ip_vs modprobe ip_vs_rr modprobe ip_vs_sh modprobe ip_vs_wrr modprobe nf_conntrack cat /etc/sysctl.d/k8s.conf EOF net.bridge.bridge-nf-call-ip6tables 1 net.bridge.bridge-nf-call-iptables 1 net.ipv4.ip_forward 1 EOF sysctl --system # 5. 同步时间 yum install -y ntpdate ntpdate time.windows.com # 6. 配置主机名 (如果当前是localhost) CURRENT_HOSTNAME$(hostname) if [ $CURRENT_HOSTNAME localhost ] || [ $CURRENT_HOSTNAME localhost.localdomain ]; then echo 当前主机名为 $CURRENT_HOSTNAME需要修改。 # 例如修改为 sealos-node # hostnamectl set-hostname sealos-node # 请根据实际情况修改并确保 /etc/hosts 中有对应记录 fi echo 环境初始化完成请重启系统以使部分更改生效。执行完脚本后重启服务器是必要的以确保内核参数和 SELinux 设置完全生效。3. 安装 Sealos 并部署单机 Kubernetes 集群环境准备就绪后安装 Sealos 本身非常简单。Sealos 是一个静态编译的 Go 二进制文件只需下载并赋予执行权限即可。3.1 一键安装 Sealos通过以下命令安装最新稳定版的 Sealos。该命令会自动识别系统架构并下载对应的二进制文件到/usr/bin目录下。# 下载并安装 sealos curl -sfL https://raw.githubusercontent.com/labring/sealos/main/scripts/install.sh | sh -s -- -c labring/sealos -v latest # 验证安装 sealos version执行sealos version后如果看到类似sealos version 4.3.7的输出说明安装成功。3.2 使用sealos run部署集群这是最关键的一步。我们将使用一个包含了 Kubernetes v1.27.0 和 Calico 网络插件的集群镜像在当前机器上部署一个单控制平面的集群。# 使用 sealos run 命令部署一个单节点 Kubernetes 集群 sealos run labring/kubernetes:v1.27.0 labring/calico:v3.25.0 \ --masters 192.168.1.100 \ --nodes 192.168.1.100 \ -p your-strong-password命令参数详解labring/kubernetes:v1.27.0: 核心 Kubernetes 集群镜像。labring/calico:v3.25.0: Calico 网络插件镜像。Sealos 支持通过多个run参数来叠加功能这里同时安装了网络插件。--masters: 指定控制平面节点Master的 IP 地址。对于单节点集群Master 和 Node 是同一个。--nodes: 指定工作节点Node的 IP 地址。同上。-p: 设置集群的 root 用户密码用于 SSH 连接和部分服务认证。请务必替换your-strong-password为一个复杂的密码。执行该命令后Sealos 会开始自动化流程检查当前主机环境。从镜像仓库拉取指定的集群镜像到本地首次运行需要下载耗时取决于网络。根据镜像内容自动安装容器运行时默认是 containerd、Kubernetes 各组件。初始化 Kubernetes 控制平面。安装并配置 Calico 网络插件。将当前节点加入集群作为工作节点。整个过程无需人工干预你会在终端看到详细的日志输出。当看到Sealos applied successfully或类似的成功提示时部署就完成了。3.3 验证集群状态部署完成后需要验证集群是否健康运行。# 1. 查看节点状态应显示 READY 状态 kubectl get nodes -o wide # 2. 查看所有命名空间下的核心 Pod 状态所有 Pod 应为 Running 或 Completed kubectl get pods --all-namespaces -o wide # 3. 查看集群信息 kubectl cluster-info正常输出示例# kubectl get nodes NAME STATUS ROLES AGE VERSION your-hostname Ready control-plane 5m v1.27.0 # kubectl get pods -A NAMESPACE NAME READY STATUS RESTARTS AGE kube-system calico-kube-controllers-5c6b5c4c6-xxxxx 1/1 Running 0 4m kube-system calico-node-xxxxx 1/1 Running 0 4m kube-system coredns-7b5b75b6bb-xxxxx 1/1 Running 0 5m kube-system etcd-your-hostname 1/1 Running 0 5m kube-system kube-apiserver-your-hostname 1/1 Running 0 5m kube-system kube-controller-manager-your-hostname 1/1 Running 0 5m kube-system kube-proxy-xxxxx 1/1 Running 0 5m kube-system kube-scheduler-your-hostname 1/1 Running 0 5m如果所有 Pod 都处于Running状态且节点状态为Ready恭喜你一个单节点的 Kubernetes 集群已经成功运行。4. 关键配置解析与日常操作4.1 集群配置文件位置Sealos 将集群的配置和状态信息存储在特定目录下了解这些位置有助于排查问题。集群配置目录/root/.sealos/。这是 Sealos 的默认工作目录包含集群清单、证书、kubeconfig 文件等。Kubeconfig 文件/root/.sealos/your-cluster-name/admin.conf。这是访问该集群的凭证文件。Sealos 会自动将其合并到系统的~/.kube/config中这也是为什么你能直接使用kubectl的原因。容器运行时默认使用 containerd其数据根目录为/var/lib/containerd。Kubernetes 数据目录/var/lib/kubelet(节点数据)/etc/kubernetes(配置文件)。4.2 安装其他应用以 Helm 为例Sealos 的强大之处在于任何符合其规范的应用都可以被打包成集群镜像进行一键安装。例如安装 Helm 客户端工具sealos run labring/helm:v3.12.0安装后直接在命令行输入helm version即可使用无需手动下载解压配置环境变量。4.3 清理集群当你需要销毁这个测试集群时使用sealos reset命令。这是一个不可逆的破坏性操作会清除所有集群相关的数据。# 谨慎执行这将清理当前机器上的整个集群。 sealos reset --force执行后Kubernetes 服务、容器、镜像、配置都将被移除系统会尽可能恢复到安装前的状态但已拉取的集群镜像文件仍会保留在本地缓存中。5. 常见问题排查 (QA)即使按照步骤操作也可能遇到问题。以下是部署过程中最常见的几个错误及其解决方法。问题现象可能原因排查命令/步骤解决方案sealos run失败提示ssh: connect to host ... port 22: Connection refused1. SSH 服务未启动。2. 防火墙阻止了22端口。3. IP地址错误。systemctl status sshdping master-iptelnet master-ip 221. 启动SSHsystemctl start sshd systemctl enable sshd。2. 关闭防火墙或放行22端口。3. 检查IP确保命令中IP与主机实际IP一致。节点状态为NotReady1. 网络插件如Calico未成功安装或启动失败。2. 容器运行时containerd异常。3. 内核模块未加载。kubectl get pods -n kube-systemsystemctl status containerdjournalctl -u kubelet -f(查看kubelet日志)1. 检查Calico Pod日志kubectl logs -n kube-system calico-pod-name。2. 重启containerdsystemctl restart containerd。3. 确保已加载br_netfilter等模块见2.2节脚本。CoreDNS Pod 处于Pending或CrashLoopBackOff状态1. 节点资源CPU/内存不足。2. 网络插件未就绪导致Pod无法调度。3. 镜像拉取失败。kubectl describe pod -n kube-system coredns-pod-name1. 查看describe命令输出中的Events部分根据具体错误信息处理。2. 通常是网络问题确保Calico等网络插件Pod先于CoreDNS运行起来。执行kubectl命令报错The connection to the server ... was refused1. Kubernetes API Server 未启动。2.~/.kube/config配置错误或丢失。systemctl status kube-apiserverls -la /root/.sealos/1. 重启API Serversystemctl restart kube-apiserver。2. 检查Sealos生成的admin.conf是否存在并确认kubectl config view中当前上下文正确。sealos reset后仍有残留Reset 过程被中断或某些进程锁定了文件。docker ps -a(如果之前有docker)crictl ps -a检查/var/lib/containerd,/etc/kubernetes目录1. 手动停止相关服务systemctl stop kubelet containerd。2. 手动删除目录rm -rf /etc/kubernetes /var/lib/containerd /var/lib/kubelet。3. 清理CNI网络rm -rf /etc/cni/net.d。排查黄金法则当部署失败时首先查看sealos run命令的最后几十行错误输出。其次使用journalctl -u kubelet -f实时跟踪 kubelet 日志。最后通过kubectl describe pod和kubectl logs检查具体故障 Pod 的状态和日志。90%的问题都能通过这三步定位。6. 生产环境考量与最佳实践虽然 Sealos 能让你三分钟拉起一个集群但用于生产环境需要考虑更多因素。6.1 高可用集群部署生产环境至少需要三个 Master 节点以实现控制平面高可用。Sealos 支持通过一条命令部署多节点高可用集群前提是你已经准备好多台满足条件的服务器并配置了 SSH 免密互信。# 假设有三台机器IP分别为 192.168.1.10, 192.168.1.11, 192.168.1.12 # 需要提前在所有机器间配置 SSH 免密登录 sealos run labring/kubernetes:v1.27.0 labring/calico:v3.25.0 \ --masters 192.168.1.10,192.168.1.11,192.168.1.12 \ --nodes 192.168.1.10,192.168.1.11,192.168.1.12 \ -p your-strong-password6.2 镜像与版本管理版本选择不要盲目使用latest标签。生产环境应固定明确的版本号例如labring/kubernetes:v1.27.0。在部署前查阅官方仓库的 Release Notes 和镜像清单。私有镜像仓库如果服务器无法访问公网或出于安全、速度考虑需要搭建私有集群镜像仓库并修改 Sealos 的配置以指向私有仓库。镜像构建对于定制化需求如预装特定监控Agent、安全基线配置可以学习 Sealos 的 ClusterImage 构建方法制作属于自己的集群镜像确保环境标准化。6.3 安全与维护密码与密钥-p参数设置的密码要足够复杂并妥善保管。生产环境考虑使用密钥对而非密码进行 SSH 认证。网络规划提前规划好 Pod 和 Service 的 CIDR避免与主机网络冲突。Calico 默认使用192.168.0.0/16如需修改需使用自定义配置或选择其他网络插件镜像。持久化存储单节点实验集群可以使用hostPath或local卷。生产环境必须规划网络存储方案如 NFS、Ceph、云盘 CSI 驱动并确保数据持久化和高可用。Sealos 也提供了存储类镜像如labring/openebs。监控与日志部署完成后首要任务就是安装监控和日志收集系统。可以使用 Sealos 一键安装labring/prometheus和labring/loki等镜像快速搭建可观测性栈。备份与恢复定期备份/etc/kubernetes和/var/lib/etcd对于多节点集群等关键目录。Sealos 集群本身是 stateless 的但 etcd 中的数据需要备份。Sealos 极大地降低了 Kubernetes 的入门和日常管理复杂度它将最佳实践产品化让用户通过“应用商店”的方式获取复杂的分布式系统能力。从单节点学习到多节点生产从纯净 K8s 到满载应用Sealos 提供了一条清晰的路径。下一步你可以尝试用它部署一个完整的应用栈例如通过sealos run labring/mysql:8.0和labring/redis:7.0来快速获得数据库服务亲身体验“云操作系统”的便捷性。记住任何工具在带来便利的同时也要求使用者理解其背后的原理这样才能在出现问题时从容应对。