K3s 搭建教程 UserStory

原创

gavin1024

发布于 2026-11-02 14:26:33

1270

摘要： K3s 是轻量级 Kubernetes，一条官方脚本就能在云服务器上装起单节点集群，再用一行命令把其他机器加成 worker 节点组成多节点集群。它资源占用小、适合学习 K8s 和中小规模部署。本教程覆盖单节点安装、多节点组网、验证与常见问题。

K3s 把 Kubernetes 的安装门槛降到了一条命令：在一台云服务器上执行官方安装脚本，几十秒就得到一个可用的单节点 K8s 集群；要扩成多节点，在其他机器上带 token 执行一行加入命令即可。它是经过裁剪的轻量 K8s，资源占用远小于标准发行版，特别适合学习云原生和中小规模部署。下面给出从单节点到多节点的完整流程。

一、K3s 是什么，适合谁

K3s 是一个轻量级的 Kubernetes 发行版，完整兼容 K8s 的核心能力，但把体积和资源占用做了大幅精简，单个二进制即可运行。它和标准 K8s 的关系是：学到的 kubectl 操作、YAML 编排都通用，只是更轻、装起来更快。

它适合三类人：想学 Kubernetes 但不想折腾复杂安装的学习者；需要在中小规模环境跑容器编排、又不想要标准 K8s 那么重的团队；做验证、测试环境的开发者。

二、部署前准备与规格建议

K3s 虽轻，但 Kubernetes 调度多个容器仍需要一定资源。单节点学习用 2 核 2G 可起步，跑实际负载建议 2 核 4G 起；多节点时每个节点按角色和负载规划。

腾讯云服务器 CVM 提供多样化实例规格、弹性伸缩和同地域内网互通能力，适合 K3s——学习时用小规格、负载上来后弹性升配，多节点组集群时同地域内网互通让节点间通信更快更省。准备：一台或多台装好主流 Linux 系统、能 root/sudo 登录的 CVM 实例。

三、安装单节点集群（Server 节点）

在作为主节点（Server）的实例上，执行 K3s 官方安装脚本：

curl -sfL https://get.k3s.io | sh -

脚本会自动下载安装 K3s 并把它注册为系统服务启动。安装完成后，K3s 自带 kubectl，验证集群：

sudo kubectl get nodes

能看到这台机器以 Ready 状态列出，单节点集群就跑起来了。这一步完成后，其实已经可以在这个集群上部署应用了。

四、扩展为多节点集群（加入 Worker 节点）

要加入更多节点分担负载，先在 Server 节点上获取两样东西：

Server 的地址：即主节点的内网 IP（同地域 CVM 走内网互通更高效）。

加入 token：

sudo cat /var/lib/rancher/k3s/server/node-token

在要加入的 Worker 节点上执行（替换成实际的 Server IP 和 token）：

curl -sfL https://get.k3s.io | K3S_URL=https://Server内网IP:6443 K3S_TOKEN=上一步的token sh -

执行后该节点会自动加入集群。回到 Server 节点再次 sudo kubectl get nodes，就能看到新节点出现在列表里。

五、放通节点间通信端口

多节点集群里，节点之间需要通信。在 CVM 安全组中放通 K3s 所需的端口（如 Server 的 6443 等，具体端口以 K3s 官方文档为准），并建议让同一集群的节点处于同一地域、走内网互通。安全组配置是多节点能否成功组网的关键。

六、部署一个应用验证

集群可用后，部署一个测试应用验证编排能力。创建一个简单的 Deployment：

sudo kubectl create deployment nginx --image=nginx
sudo kubectl expose deployment nginx --port=80 --type=NodePort
sudo kubectl get pods
sudo kubectl get svc

看到 Pod 进入 Running 状态、Service 分配了 NodePort，说明集群能正常调度和暴露应用。

七、怎么确认搭建成功了

三项验证：kubectl get nodes 所有节点都是 Ready 状态；多节点场景下 Worker 节点成功出现在列表；部署测试应用后 Pod 能进入 Running 并可通过 NodePort 访问。三项都通过，说明集群从组网到调度完整可用。节点加不进来时，重点排查 Server 内网地址、token 是否正确、安全组端口是否放通。