单节点 VPS 部署 k3s 是否值得?优缺点深度分析
在单台 VPS 上运行 k3s 能获得完整 Kubernetes API,但会额外占用约 1GB 内存并面临端口冲突风险。本文分析 k3s 与 Docker Compose 的适用场景,助你判断是否需要为学习或迁移需求承担这些运维成本。
k3s 是什么,以及单个节点能提供什么
k3s 是以单个二进制文件打包的完整 Kubernetes 发行版。在单台 VPS 上运行 k3s,可以获得完整的 Kubernetes API,而不需要由 3 台机器组成的控制平面。它是经过认证的 Kubernetes 发行版,因此现在应用于此处的清单,之后也可以应用于托管集群。安装只需执行一条命令,大约需要 1 分钟。代价是部分内存将不再可供应用使用,并且会引入 Docker Compose 不会遇到的一些故障模式。
SUSE 面向边缘站点和小型安装场景构建 k3s。它与上游 Kubernetes 的差异,目的是让 k3s 更小、更易运行。默认数据存储是通过名为 kine 的适配层使用 sqlite,而不是 etcd,因此不需要维护 etcd 仲裁。containerd 已嵌入该二进制文件,无需单独安装。同一个二进制文件还默认提供用于集群 DNS 的 CoreDNS、作为入口控制器的 Traefik、ServiceLB(也称为 klipper-lb),使 LoadBalancer 服务无需云服务提供商即可工作;此外还提供用于持久卷的 local-path provisioner、metrics-server,以及用于 Pod 网络的 flannel。上述组件默认都会启动。这些默认设置会让 Traefik 占用 80 和 443 端口。因此,如果 VPS 上已经运行其他服务,请在安装前确定这些端口由哪个服务使用。
单个 k3s 节点何时值得使用
遵循以下规则:当您需要的是 Kubernetes API 时运行 k3s:例如,您要在自己控制的机器上学习 Kubernetes,或者所需软件只提供 Helm chart。清单的可移植性也很重要,因为您在这里编写的 Deployment 可以原样迁移到托管集群。需要的是应用本身时运行 Docker Compose。Compose 可以用少得多的组件启动相同的容器,而且一年后,VPS 上的 Compose 文件也比一整个清单目录更容易阅读。
请明确单个节点无法提供什么。
- 不提供高可用性。VPS 重启时,所有工作负载都会停止。Kubernetes 可以将 Pod 重新调度到其他节点,但这里没有其他节点。
- 不提供能够保持服务运行的滚动更新,除非应用可以容忍在同一台机器上运行两个副本,并且节点有足够资源同时运行它们。
- 存储固定在本机上,原因见下文的 local-path 部分。
- 无论您是否部署任何内容,控制平面都会占用约 1 GB 内存。
这些限制并不意味着 k3s 是错误的选择。但如果您选择 k3s 的通常理由是可靠性,那么它就不适合这个理由。如果您真正需要的是多台机器,以便构建实际的多节点集群,那么应先做出这个决定:自有硬件上的 Proxmox 还是租用的 VPS决定节点的来源,然后再由 k3s 决定节点上运行什么。
部署前,k3s 会占用多少 RAM 和 CPU
k3s 项目发布的是实测数据,而不是估算值。请仔细阅读这些数据,因为人们经常引用的数字并不是空闲状态下的 k3s。
此图表背后的数据
[
{
"label": "Server, sqlite datastore",
"ram_mb": "1,596",
"cpu_percent_of_one_core": 6
},
{
"label": "Server, embedded etcd",
"ram_mb": "1,606",
"cpu_percent_of_one_core": 6
},
{
"label": "Agent node only",
"ram_mb": "275",
"cpu_percent_of_one_core": 3
}
]在该测试中,一个 server 节点在第 95 百分位时使用了 1,596 MB RAM,约占一个 CPU 核心的 6%。这些是项目发布的数据,不是本指南中的测量结果。测试运行的是启用了所有打包组件的 k3s v1.26.5,同时还运行了 Prometheus 和 Grafana 监控栈。因此集群处于繁忙状态,而不是空闲状态。但项目说明,这些数据只涵盖 Kubernetes 数据存储和控制平面,不包括工作负载自身的需求。您自己的容器还需要额外资源。将 sqlite 换成嵌入式 etcd 后,RAM 使用量增加到 1,606 MB。agent 节点只运行 kubelet 和 containerd,不运行控制平面,使用了 275 MB。文档规定 server 的最低配置为 2 个核心和 2 GB RAM。该最低配置只覆盖 k3s 及其打包组件,不包括您的工作负载。
实际应这样理解:在 2 GB VPS 上,控制平面和随附的附加组件会占用大部分资源,剩余空间很少。内存压力过大时,kubelet 会驱逐 Pod;但如果内存使用量快速上升,内核的 OOM killer 可能会在 kubelet 检测到压力前介入。对于运行少量小型服务的单节点,4 GB 是较为宽裕的起点。请测量您自己的服务器,不要盲目相信任何发布的数据,包括本文中的数据。
free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -A在安装前运行 free -h,然后等到 kube-system 中的每个 Pod 都显示为 Running 后,再运行一次。两次结果的差值就是控制平面在您硬件上的资源开销。安装后的最初一两分钟内,k3s kubectl top node 会返回 error: Metrics API not available,因为 metrics-server 还没有抓取任何数据。这不是故障。如果您要让同一台服务器同时运行 k3s 和其他工作负载,为 VPS 规划 RAM 和 CPU 中的计算方法同样适用。
将 k3s 固定到指定版本,而不是使用 latest
快速入门命令会使用你执行命令当天稳定频道所指向的版本。对于准备长期运行的机器,应固定版本。k3s 为每个 Kubernetes 次要版本提供一个频道,因此 INSTALL_K3S_CHANNEL=v1.36 会跟随 v1.36 内的补丁版本更新,不会自行跳到其他次要版本。截至 2026 年 10 月,稳定频道指向 v1.36.5+k3s1。
先写入配置文件,再执行安装。k3s 启动时会读取 /etc/rancher/k3s/config.yaml,因此其中的配置不仅会应用于首次启动,也会应用于之后的每次启动。
sudo mkdir -p /etc/rancher/k3s
sudo tee /etc/rancher/k3s/config.yaml >/dev/null <<'EOF'
tls-san:
- k3s.example.com
EOF
curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=v1.36 sh -如需固定到某个确切版本,而不是某个频道,请使用 INSTALL_K3S_VERSION=v1.36.5+k3s1。加号是标签的一部分。然后确认服务已启动。
k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -Akubectl get node 应在大约三十秒内列出一个 STATUS 为 Ready 的节点,并且 kube-system 中的每个 pod 都应达到 Running 或 Completed 状态。节点卡在 NotReady 通常表示容器运行时从未启动,因此请查看 sudo journalctl -u k3s -n 100 --no-pager。如果 VPS 使用了不常见的镜像,请先运行 sudo k3s check-config,再进行其他排查:它会报告缺失的内核功能,比阅读日志更快找到原因。
端口 80 已被占用时的原因,以及修复时需要放弃什么
如果 VPS 之前已经提供过服务,就容易遇到此故障。安装可以成功,但如果另一个 Kubernetes Pod 已在唯一节点上预留相同的 hostPort,Traefik 就无法获得地址。
工作机制如下:内置的 Traefik chart 会在端口 80 和 443 上创建一个类型为 LoadBalancer 的 Service。ServiceLB 收到请求后,会创建一组小型 Pod 组成的 DaemonSet。其名称带有 svclb- 前缀,并在每个节点上通过 hostPort 占用这些端口。hostPort 通过网络规则,将节点端口的流量转发到 Pod。调度器检查的是 Kubernetes Pod 声明的 hostPort,不是主机服务或独立 Docker 容器占用的套接字。另一个 Pod 预留相同的 hostPort 会阻止调度;nginx、Caddy、Apache 或独立 Docker 容器监听端口 80,本身不会导致调度被拒绝。
sudo k3s kubectl -n kube-system get pods
sudo k3s kubectl -n kube-system get svc traefik
sudo ss -lntp '( sport = :80 or sport = :443 )'如果另一个 Kubernetes Pod 预留了冲突的 hostPort,您会看到 svclb Pod 处于 Pending 状态,并且 Service 没有外部地址:
svclb-traefik-8f2c1a-r6k9x 0/2 Pending 0 3m
traefik LoadBalancer 10.43.62.11 <pending> 80:31480/TCP,443:30219/TCP运行 kubectl -n kube-system describe pod svclb-traefik-... 可以直接显示原因:
0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports.ss -lntp 可以告诉您哪个进程正在监听端口,但不会显示调度器检查的 hostPort 预留情况。解决方法不止一种,但每种方法都会让您放弃一些东西。
将端口交给 k3s。 删除其他 Kubernetes Pod 中冲突的 hostPort 预留,并停止和禁用现有的主机 Web 服务器,让 Traefik 处理端口 80 和 443 上的入站流量。如果这台 VPS 将专门运行 k3s,并且现有服务都会迁移到 Ingress 后面,这是正确的选择。
禁用 ServiceLB,保留现有代理。 使用 --disable=servicelb 安装。类型为 LoadBalancer 的 Service 仍会分配一个 NodePort,因此 Traefik 仍可通过 31480 之类的高位端口访问,您的 nginx 或 Caddy 再代理到 127.0.0.1:31480。您放弃的是外部地址:Service 会一直显示 <pending>。这看起来像故障,但实际上是您主动选择的结果。
禁用 Traefik,使用自己的代理进行路由。 使用 --disable=traefik 安装。这样集群中不会有 Ingress controller,因此 Ingress 对象完全不会生效:它们会留在 API 中,但没有 controller 监视它们。如果您通过主机代理将流量路由到 NodePort,这种方式没有问题。如果您已经确定如何处理 HTTP,这也是诚实的选择。如果您还不确定应该使用哪种入口代理,请先确定 nginx、Caddy 和 Traefik 之间的反向代理选择,再禁用任何组件。
这两个标志都应传给安装程序,也可以写入配置文件:
tls-san:
- k3s.example.com
disable:
- traefik
- servicelb安装后编辑该文件,再运行 sudo systemctl restart k3s 也可以生效,因为 --disable 不只是安装时跳过组件。它还会删除已经部署的组件,因此修改会在运行中的集群上生效。
如果要保留 Traefik,但修改 chart 的配置方式,不要编辑 /var/lib/rancher/k3s/server/manifests/traefik.yaml。k3s 每次启动时都会使用默认值重写该文件。请在同一目录中添加单独的文件,因为 /var/lib/rancher/k3s/server/manifests 中的内容会在启动时以及文件在磁盘上发生变化时自动应用。
apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
name: traefik
namespace: kube-system
spec:
valuesContent: |-
ports:
web:
forwardedHeaders:
trustedIPs:
- 10.0.0.0/8该示例设置了一个 Traefik chart 值,即受信任的代理地址。相同机制也可以设置 chart 暴露的其他值,包括端口。
单节点上的持久化存储
k3s 提供了一个名为 local-path 的默认 StorageClass,由 Rancher 的 local-path provisioner 提供支持。未指定 storageClassName 的 PersistentVolumeClaim 会使用该 StorageClass。卷位于 /var/lib/rancher/k3s/storage 中,每个卷在节点自身的磁盘上使用一个独立子目录。
sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storage“位于节点自身的磁盘上”会带来两个后果,而且通常不会立即显现,而是在之后造成问题。
该 StorageClass 使用 volumeBindingMode: WaitForFirstConsumer,因此新的 PVC 会一直处于 Pending 状态,直到某个 pod 实际挂载它。kubectl describe pvc 会输出:
waiting for first consumer to be created before binding这是正常现象。因此,单独创建 PVC 后一直等待,不会解除该状态。
绑定后,卷会携带指向创建它的节点的节点亲和性。在该卷的整个生命周期内,使用此声明的每个 pod 都会被固定到该节点。在单节点环境中,你不会注意到这一点。之后添加第二个节点时,如果某个 pod 无法迁移,看起来就像是调度器出现了问题;直到运行 kubectl get pv -o yaml,并在 nodeAffinity 中发现保存的主机名。
备份由你负责。重建 VPS 会删除该目录,下面的卸载脚本也会删除它。请备份 /var/lib/rancher/k3s/storage,以及在停止服务后复制的 sqlite 数据存储目录 /var/lib/rancher/k3s/server/db/,因为它是一个正在使用的数据库;同时还要备份位于 /var/lib/rancher/k3s/server/token 的服务器令牌文件。令牌不是可选项:k3s 文档说明,从备份恢复数据存储时,必须恢复该文件,或将其值传递给 --token。另一种做法是将集群视为可随时丢弃,并将所有 manifest 保存在 git 中。
Ingress 和 TLS
启用 Traefik 后,标准的 Ingress 对象即可满足需求。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: hello
annotations:
cert-manager.io/cluster-issuer: letsencrypt
spec:
ingressClassName: traefik
tls:
- hosts:
- hello.example.com
secretName: hello-tls
rules:
- host: hello.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: hello
port:
number: 80证书不会自动生成。通常使用 cert-manager,并从其发布的清单安装,再配置一个 ClusterIssuer。v1.21.3 于 23 October 2026 发布,截至 October 2026 为当前版本。
sudo k3s kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.21.3/cert-manager.yamlapiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
name: letsencrypt
spec:
acme:
email: you@example.com
server: https://acme-v02.api.letsencrypt.org/directory
privateKeySecretRef:
name: letsencrypt-account-key
solvers:
- http01:
ingress:
ingressClassName: traefikHTTP-01 challenge 要求 ACME(自动证书管理环境)服务器从公网连接到 http://hello.example.com/.well-known/acme-challenge/...。因此,主机名的 DNS 记录必须已经指向 VPS。该记录可以是 A 记录;如果 VPS 可通过 IPv6 访问,也可以是 AAAA 记录。同时,80 端口必须能够到达 Traefik。两种记录都存在时,Let's Encrypt 会优先尝试 IPv6 地址;如果初始 IPv6 连接超时,则回退到 IPv4。其他错误(包括 challenge 响应错误)不会触发回退,重定向的请求也不会重试。请修复或删除过时的 AAAA 记录。如果已禁用 ServiceLB 并在前面部署了自己的代理,该代理也必须转发 challenge 路径,否则 cert-manager 会卡住,并在 Challenge 对象中显示:
Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'使用 sudo k3s kubectl describe certificate hello-tls 和 sudo k3s kubectl get order,challenge -A 监控证书签发过程。
kubeconfig 以及 API server 为何保持私有
k3s 会将管理员凭据写入 /etc/rancher/k3s/k3s.yaml。该文件归 root 所有,默认权限为 600。文件中包含具有 cluster-admin 权限的客户端证书,因此任何能够读取该文件的人都可以完全控制集群。
sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get node单独安装的 kubectl 不会自动识别 k3s 文件。未设置 KUBECONFIG 时,它会读取 ~/.kube/config;如果该文件不存在,则会因没有配置任何集群而返回 The connection to the server localhost:8080 was refused - did you specify the right host or port?。设置 KUBECONFIG,将文件复制到 ~/.kube/config(如下所示),或者使用 sudo k3s kubectl,后者会自动读取正确的文件。
你可能会看到建议使用 --write-kubeconfig-mode 644,以便普通用户运行 kubectl。请明确了解其影响:这会让本机上的每个本地账户都能读取 cluster-admin 凭据。在只有一名管理员的主机上,这种取舍可能可以接受。在共享主机上则不应这样做。复制文件可以只授予一个用户访问权限,而不会将凭据公开:
mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/config该文件中的 server: 行读取 https://127.0.0.1:6443。要从笔记本电脑使用 kubectl,不要将 6443 端口开放到互联网。公开的 Kubernetes API 会持续成为攻击目标;API 暴露后,小型集群可能被他人用于挖掘加密货币。通过 SSH 创建隧道,并保持文件中的地址不变:
ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get node如果必须通过私有网络地址访问 API,请在安装时使用 tls-san,并列出该名称或地址,然后编辑复制文件中的 server: 行,使其匹配。没有 SAN(subject alternative name)条目时,kubectl 会拒绝连接:
x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10集群文档规定的入站端口包括:用于 API 的 TCP 6443、用于节点间 flannel VXLAN 的 UDP 8472,以及用于 kubelet 指标的 TCP 10250。在单节点集群中,这些端口都无需向互联网开放。
containerd 不是 Docker
k3s 使用其内置的 containerd,并且不会与 Docker 共享镜像存储。使用 docker build 刚构建的镜像对 k3s 不可见,因此 Pod 会因 ErrImagePull 失败,即使 docker images 能列出该镜像。请显式导入:
docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl images然后不要为该容器使用 :latest 标签,因为 :latest 默认使用 imagePullPolicy 的 Always,kubelet 仍会访问镜像仓库。其他任何标签默认使用 IfNotPresent,该策略会使用已导入的镜像。在同一台 VPS 上同时运行两者没有问题。但需要注意,VPS 上的标准 Docker 安装和 k3s 在同一台机器上分别维护自己的镜像存储和 iptables 规则。
如何删除 k3s
安装程序会写入卸载脚本。删除操作不支持部分卸载,也无法撤销。
sudo /usr/local/bin/k3s-uninstall.sh该脚本会停止并删除服务,删除数据存储和持久卷数据,移除节点配置,以及删除安装程序添加的工具。在 agent 节点上,脚本则是 k3s-agent-uninstall.sh。请先将 /var/lib/rancher/k3s/storage 下的所有内容复制到其他位置,因为该目录也会被删除。完成后,使用 ip link show 和 sudo ss -lntp 检查是否仍有进程占用端口或网络接口。残留的 cni0 或 flannel.1 接口会在下次重启时清除。
发现 Kubernetes 的单节点部署比任务实际需要的复杂度更高,并不意味着操作失败,这是很常见的结果。通常花一个下午,就可以将这些工作负载迁回 Compose。
故障模式与将看到的字符串
Node NotReady,或 k3s 反复重启。 先阅读 sudo journalctl -u k3s -n 200 --no-pager。在小型 VPS 上,常见原因是内核的内存不足终止程序机制终止了该进程;dmesg 中会出现一行列出 k3s-server 的记录。文档规定的 2 GB 最低要求是实际下限。
Pod 一直处于 Pending。 kubectl describe pod 每次都会指出原因。Insufficient memory 或 Insufficient cpu 表示节点已没有可用资源。didn't have free ports 表示另一个 Kubernetes pod 保留了冲突的 hostPort。PVC 上的 waiting for first consumer 表示 WaitForFirstConsumer 正常工作。
ImagePullBackOff。 节点无法拉取镜像。检查镜像名称和标签、镜像仓库访问权限及凭据,或者确认是否使用 Docker 构建了镜像却未将其导入 containerd。
Traefik 返回响应,但应用没有响应。 响应正文为 404 page not found 时,表示该响应由 Traefik 本身返回,说明请求已到达,但没有路由匹配。检查 Ingress host 是否与输入的名称匹配,并确认 ingressClassName 是 traefik。
集群 DNS 失败,但主机解析正常。 使用 sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns 检查 CoreDNS。类似 plugin/loop: Loop ... detected for zone "." 的消息会阻止 CoreDNS 启动。原因是 CoreDNS 将请求转发到一个又转发回 CoreDNS 的解析器;/etc/resolv.conf 中的回环地址会导致这种情况。使用 --resolv-conf /run/systemd/resolve/resolv.conf 让 k3s 指向实际的上游配置文件。
FAQ
在单个 VPS 上运行 k3s 是否值得?
如果您需要 Kubernetes API,运行它就有价值:在自己控制的机器上学习 Kubernetes,将部署保存为可移植的清单,运行只能通过 Helm chart 发布的软件,或构建将来要迁移到托管集群的系统。如果您只是需要运行容器,则不值得这样做,因为 Docker Compose 的维护成本低得多,并且通常能多出约 1 GB 可用内存。单节点不提供高可用性,因此可靠性不能作为选择单节点 k3s 的理由。
为什么我的 k3s LoadBalancer 服务一直处于 Pending 状态?
ServiceLB 会创建 svclb- 个 Pod,在节点上通过 hostPort 占用服务端口,因此这些 Pod 只能调度到端口空闲的节点。如果另一个 Kubernetes Pod 已经占用了相同的 hostPort,该 Pod 就会保持 Pending 状态,服务也不会获得外部地址。监听 80 端口的主机代理或独立 Docker 容器本身不会导致这种调度拒绝。kubectl -n kube-system describe pod svclb-... 报告 0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports。移除冲突 Pod 的 hostPort 配置,或使用 --disable=servicelb 禁用 ServiceLB,然后将请求代理到该服务仍会分配的 NodePort。
k3s 在 VPS 上需要多少 RAM?
文档规定服务器节点的最低配置为 2 个核心和 2 GB,这只够 k3s 及其随附组件运行,不包括您的工作负载。该项目的实测数据显示,在运行监控栈时,服务器节点的控制平面和数据存储占用 1,596 MB;这个数值不包含工作负载自身的内存。因此,应将 2 GB 视为最低配置,将 4 GB 视为单节点运行舒适的起始配置。安装前使用 free -h 测量一次自己的主机,并在 kube-system 中的每个 Pod 都显示为 Running 后再次测量。
可以在同一个 VPS 上运行 Docker 和 k3s 吗?
可以,两者彼此独立。k3s 使用自己的内置 containerd,因此使用 docker build 构建的镜像不会自动对 k3s 可见,除非运行 docker save myapp:0.1 | sudo k3s ctr images import -。两者都会分别写入自己的 iptables 规则,并分别创建自己的桥接网络。请监控内存总量,因为 Docker、k3s 和您的容器会共享这台主机的 RAM。
如何彻底删除 k3s?
在服务器节点上运行 sudo /usr/local/bin/k3s-uninstall.sh,在 agent 上运行 sudo /usr/local/bin/k3s-agent-uninstall.sh。该命令会停止服务、删除数据存储、删除 /var/lib/rancher/k3s/storage 下的持久卷数据,并移除随附工具。请先将需要保留的数据复制到主机外部,因为此操作无法撤销。残留的 cni0 或 flannel.1 网络接口会在下次重启时消失。