SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

單一 VPS 跑 k3s 值得嗎?與 Docker Compose 比較

了解單一 VPS 執行 k3s 的實際代價:完整 Kubernetes API 會占用多少 RAM、為何安裝時 port 80 會衝突,以及何時 Docker Compose 更適合。

k3s 是什麼,以及單一節點能提供什麼

k3s 是以單一二進位檔封裝的完整 Kubernetes 發行版。在單一 VPS 上執行 k3s,即可取得真正的 Kubernetes API,無須建立由 3 台機器組成的控制平面。k3s 是通過認證的 Kubernetes 發行版,因此在此套用的 manifest,日後也能套用到受管理的叢集。安裝只需執行一個命令,約需 1 分鐘。代價是可供應用程式使用的記憶體會減少,並且會引入 Docker Compose 不會遇到的一組失效情境。

SUSE 為邊緣站點與小型安裝環境打造 k3s。k3s 與上游 Kubernetes 的差異,都是為了讓系統更精簡、更容易執行。預設資料儲存區是位於名為 kine 的 shim 後方的 sqlite,而不是 etcd,因此不需要維護 etcd 仲裁。containerd 已嵌入二進位檔,不必另外安裝。同一個二進位檔也會提供叢集 DNS 所需的 CoreDNS、作為 ingress controller 的 Traefik、ServiceLB(也稱為 klipper-lb),讓 LoadBalancer 服務在沒有雲端提供者的情況下運作、用於持久性磁碟區的 local-path provisioner、metrics-server,以及 pod 網路所需的 flannel。這些元件預設都會啟動。這些預設值會讓 Traefik 使用 80 與 443 埠,因此如果 VPS 原本已提供其他服務,請在安裝前決定由哪個服務使用這些埠。

何時值得使用單一 k3s 節點

請依照以下原則。當你需要的是 Kubernetes API 時,才執行 k3s:例如,你想在自己管理的機器上學習 Kubernetes,或是所需軟體只提供 Helm chart。Manifest 的可攜性也是考量因素,因為你在這裡撰寫的 Deployment,可以原樣移轉到受管理的叢集。當你需要的是應用程式本身時,請使用 Docker Compose。Compose 能以少得多的元件啟動相同的容器,而 VPS 上的 Compose 檔案 也比一整個 manifest 目錄更容易在一年後讀懂。

請清楚了解單一節點無法提供的功能。

  • 不具備高可用性。VPS 重新開機時,所有工作負載都會停止。Kubernetes 會將 pod 重新排程到其他節點,但這裡沒有其他節點。
  • 無法在不中斷服務的情況下進行 rolling update,除非應用程式能在同一台機器上容納 2 個 replica,且節點有足夠資源同時執行兩者。
  • 儲存空間會綁定在該主機上,原因如下方 local-path 區段所述。
  • 無論是否部署任何工作負載,control plane 都會耗用約 1 GB RAM。

這些限制不代表 k3s 是錯誤的選擇。它們代表 k3s 不適合人們通常提出的理由,也就是可靠性。如果你真正需要的是多台機器,以建立實際的多節點叢集,那項決策應先完成:自行管理硬體上的 Proxmox 與租用的 VPS 會先決定節點的來源,再由 k3s 決定節點上執行的內容。

部署前評估 k3s 的 RAM 與 CPU 成本

k3s 專案發布的是測量數據,而不是估算值。請仔細閱讀,因為一般人引用的數字並不是閒置狀態下的 k3s。

圖表Published k3s resource use, 95th percentile, Intel 8375C, k3s v1.26.5
此圖表背後的資料
[
  {
    "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 node 在第 95 百分位使用 1,596 MB RAM,約使用單一核心的 6%。這些是專案發布的數據,不是本指南測得的結果。測試使用 k3s v1.26.5,啟用所有隨附元件,並加入 Prometheus 與 Grafana monitoring stack,因此叢集處於忙碌狀態,而不是空載狀態。不過,專案表示這些數據只涵蓋 Kubernetes datastore 與 control plane,不包含工作負載特有的需求。你自己的 containers 需要額外佔用資源。將 sqlite 改為 embedded etcd 後,RAM 使用量變為 1,606 MB。只執行 kubelet 與 containerd、不包含 control plane 的 agent node 使用 275 MB。文件記載的 server 最低需求為 2 cores 與 2 GB RAM;這項最低需求涵蓋 k3s 及其隨附元件,但不包含你的工作負載。

實際解讀是:在 2 GB VPS 上,control plane 與隨附 add-ons 會幾乎耗盡可用資源。記憶體壓力升高時,kubelet 會驅逐 pods;但如果記憶體使用量快速增加,kernel 的 OOM killer 可能在 kubelet 偵測到壓力前就開始處理。對於執行幾個小型服務的單一 node,4 GB 是較寬裕的起點。請測量自己的主機,不要盲目採信任何已發布的數據,包括本節數據。

free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -A

安裝前先執行 free -h,並在 kube-system 中的每個 pod 都顯示 Running 後再執行一次。兩次結果的差異,就是 control plane 在你的硬體上消耗的資源。安裝後最初一兩分鐘,k3s kubectl top node 會回傳 error: Metrics API not available,因為 metrics-server 尚未擷取任何資料。這不是錯誤。如果你要讓同一台主機同時執行此服務與其他工作,為 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 -A

kubectl 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 來處理這項要求。這些 pod 的名稱以 svclb- 為前綴,並在每個節點上以 hostPort 方式占用這些埠號。hostPort 會透過網路規則,將節點埠的流量轉送至 pod。排程器會檢查 Kubernetes pod 宣告的 hostPort,不會檢查主機服務或獨立 Docker 容器占用的 socket。另一個 pod 若保留相同的 hostPort,就會阻止排程;在埠 80 上監聽的 nginx、Caddy、Apache 或獨立 Docker 容器本身,不會導致排程遭拒。

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。Volume 儲存在 /var/lib/rancher/k3s/storage,每個 Volume 在節點本身的磁碟上各使用一個子目錄。

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 後等待,不會讓它脫離 Pending 狀態。

完成繫結後,Volume 會帶有建立它的節點親和性,導致使用該 claim 的所有 Pod 在 Volume 的生命週期內都必須排程到該節點。在單一節點上不會察覺這個限制。日後加入第二個節點時,若 Pod 無法移動,看起來會像是 scheduler 發生錯誤;直到執行 kubectl get pv -o yaml,並在 nodeAffinity 中找到該主機名稱,才會知道原因。

備份由你負責。重建 VPS 會刪除該目錄,下面的解除安裝 script 也會刪除它。請備份 /var/lib/rancher/k3s/storage,以及停止服務後複製的 sqlite datastore 目錄 /var/lib/rancher/k3s/server/db/,因為它是使用中的資料庫;同時也要備份位於 /var/lib/rancher/k3s/server/token 的 server token 檔案。此 token 不可省略:k3s 文件指出,從備份還原 datastore 時,必須還原該檔案,或將其值傳給 --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

憑證不會自行出現。一般做法是從其發布的 manifest 安裝 cert-manager,再建立一個 ClusterIssuer。截至 2026 年 10 月,現行版本是 2026 年 10 月 23 日發布的 v1.21.3。

sudo k3s kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.21.3/cert-manager.yaml
apiVersion: 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: traefik

HTTP-01 challenge 代表 ACME(automatic certificate management environment)伺服器會從公開網際網路連線至 http://hello.example.com/.well-known/acme-challenge/...。因此,該 hostname 的 DNS 記錄必須已指向 VPS,可以是 A record;若 VPS 可透過 IPv6 連線,也可以是 AAAA record,且 port 80 必須能連到 Traefik。若兩者同時存在,Let’s Encrypt 會先嘗試 IPv6 位址;只有初始 IPv6 連線逾時時,才會改用 IPv4。其他錯誤,包括 challenge 回應錯誤,都不會觸發此回退機制;重新導向的請求也不會重試。請修正或移除過時的 AAAA record。若你已停用 ServiceLB,並在前方部署自己的 proxy,該 proxy 也必須轉送 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 時,kubectl 會讀取 ~/.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 metrics 使用 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 預設為 Always 的 imagePullPolicy,kubelet 因此仍會連線到 registry。其他任何標籤的預設值都是 IfNotPresent,會使用剛匯入的映像檔。在同一台 VPS 上同時執行兩者沒有問題;另外請注意,VPS 上的一般 Docker 安裝與 k3s 在同一台機器上各自維護獨立的映像檔存放區與 iptables 規則。

如何移除 k3s

安裝程式會寫入解除安裝指令碼。此程序不支援部分移除,也無法復原。

sudo /usr/local/bin/k3s-uninstall.sh

此指令碼會停止並移除服務、刪除資料儲存區、刪除持久性磁碟區資料、移除節點設定,以及移除安裝程式新增的工具。在 agent node 上,指令碼則是 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 上,常見原因是 kernel out-of-memory killer 終止了該程序;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。 節點無法拉取映像。請檢查映像名稱與 tag、registry 存取權限及認證資訊,或確認是否使用 Docker 建置映像後,卻未將映像匯入 containerd。

Traefik 有回應,但應用程式沒有。 回應本文若為 404 page not found,表示內容來自 Traefik 本身,也表示請求已抵達,但沒有符合的 router。請確認 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 的 resolver,而 /etc/resolv.conf 中的 loopback 位址會造成這種情況。使用 --resolv-conf /run/systemd/resolve/resolv.conf 將 k3s 指向實際的上游檔案。

FAQ

在單一 VPS 上執行 k3s 是否值得?

如果您需要 Kubernetes API,這樣做就值得:在自己管理的機器上學習 Kubernetes、以 manifest 保持部署可攜性、執行只能透過 Helm chart 發布的軟體,或建立日後要移轉至代管叢集的環境。如果您只是想執行容器,這樣做就不值得,因為 Docker Compose 維護成本低得多,且可多保留約 1 GB 的可用 RAM。單一節點不具備高可用性,因此可靠性不應成為選擇單一節點的理由。

為什麼我的 k3s LoadBalancer 服務一直處於 Pending?

ServiceLB 會建立 svclb- 個 pod,並在節點上以 hostPort 佔用服務的連接埠,因此只有在這些連接埠可用的節點上才能排程。如果其他 Kubernetes pod 已經保留相同的 hostPort,該 pod 就會停留在 Pending,服務也不會取得外部位址。主機 proxy 或獨立的 Docker 容器在 port 80 上監聽,本身不會造成這項排程拒絕。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,並將請求 proxy 到服務仍會配置的 NodePort。

k3s 在 VPS 上需要多少 RAM?

文件記載的 server node 最低需求為 2 cores 和 2 GB,這只涵蓋 k3s 及其隨附元件,尚未包含您的工作負載。該專案自行進行的效能分析顯示,server node 的 control plane 與 datastore 在執行 monitoring stack 時使用 1,596 MB;此數值不包含工作負載本身的記憶體,因此請將 2 GB 視為最低配置,並將 4 GB 視為單一節點能舒適運作的起始規格。請在安裝前先使用 free -h 測量您的主機,並在 kube-system 中每個 pod 都顯示 Running 後再次測量。

我可以在同一台 VPS 上執行 Docker 和 k3s 嗎?

可以,兩者會彼此分離。k3s 使用自己的內嵌 containerd,因此以 docker build 建立的映像檔在執行 docker save myapp:0.1 | sudo k3s ctr images import - 前,k3s 無法看見該映像檔。兩者也各自寫入自己的 iptables 規則,並使用各自的 bridge network。請監控記憶體總量,因為 Docker、k3s 和您的容器會共用這台主機的 RAM。

如何完整移除 k3s?

在 server node 上執行 sudo /usr/local/bin/k3s-uninstall.sh,或在 agent 上執行 sudo /usr/local/bin/k3s-agent-uninstall.sh。這會停止服務、刪除 datastore、刪除 /var/lib/rancher/k3s/storage 下的 persistent volume 資料,並移除隨附工具。請先將要保留的資料複製到主機外,因為此操作無法復原。遺留的 cni0 或 flannel.1 network interface 會在下次重新開機時消失。

這篇文章對您有幫助嗎?

#kubernetes#k3s#docker-compose#ingress#sizing