SSD Nodes Learn Hosting plans →
คู่มือ Matt Connorโดย Matt Connor

รัน k3s บน VPS เครื่องเดียวคุ้มไหม? ข้อดีและข้อควรระวัง

เรียนรู้การติดตั้ง k3s บน VPS โหนดเดียวเพื่อใช้งาน Kubernetes API เต็มรูปแบบ วิเคราะห์การใช้ RAM ปัญหาพอร์ต 80 ชนกัน และเหตุผลที่คุณควรเลือกใช้ Docker Compose แทนในบางกรณี

k3s คืออะไร และคุณจะได้อะไรจากโหนดเดียว

k3s คือ Kubernetes distribution ฉบับสมบูรณ์ที่รวมอยู่ใน binary ไฟล์เดียว การรันบน VPS เพียงโหนดเดียวจะทำให้คุณได้รับ Kubernetes API ของจริงโดยไม่ต้องมี control plane ถึง 3 เครื่อง k3s เป็น Kubernetes distribution ที่ผ่านการรับรอง ดังนั้น manifest ที่ใช้ในที่นี้จึงสามารถนำไปใช้กับ cluster แบบ managed ในภายหลังได้ การติดตั้งทำได้ด้วยคำสั่งเดียวและใช้เวลาประมาณ 1 นาที สิ่งที่คุณต้องแลกคือหน่วยความจำที่แอปพลิเคชันของคุณจะใช้งานไม่ได้อีกต่อไป รวมถึงรูปแบบความล้มเหลวบางอย่างที่ไม่เคยเกิดขึ้นกับ Docker Compose

SUSE พัฒนา k3s สำหรับ edge site และการติดตั้งขนาดเล็ก ความแตกต่างจาก Kubernetes ต้นฉบับมีไว้เพื่อให้ k3s มีขนาดเล็กลงและรันได้ง่ายขึ้น datastore เริ่มต้นคือ sqlite ที่ทำงานผ่าน shim ที่เรียกว่า kine ไม่ใช่ etcd ดังนั้นจึงไม่มีเรื่อง quorum ของ etcd ให้ต้องดูแล containerd ถูกฝังมาใน binary แทนที่จะต้องติดตั้งแยกต่างหาก binary เดียวกันนี้ยังมาพร้อมกับ CoreDNS สำหรับ cluster DNS, Traefik ในฐานะ ingress controller, ServiceLB (หรือที่เรียกว่า klipper-lb) เพื่อให้ service ประเภท LoadBalancer ทำงานได้โดยไม่ต้องมี cloud provider รองรับ, local-path provisioner สำหรับ persistent volumes, metrics-server และ flannel สำหรับเครือข่ายของ pod ทุกส่วนประกอบเหล่านี้จะเริ่มทำงานโดยค่าเริ่มต้น ค่าเริ่มต้นเหล่านี้จะทำให้ Traefik เข้ายึดพอร์ต 80 และ 443 ดังนั้นควรตัดสินใจให้ดีว่าจะให้ใครใช้พอร์ตเหล่านี้ก่อนทำการติดตั้งบน VPS ที่มีการให้บริการอื่นอยู่แล้ว

เมื่อใดที่ควรใช้ k3s แบบโหนดเดียว

ให้ใช้กฎนี้ในการตัดสินใจ: ให้รัน k3s เมื่อสิ่งที่คุณต้องการคือ Kubernetes API เช่น คุณกำลังเรียนรู้ Kubernetes บนเครื่องที่คุณควบคุมเอง หรือซอฟต์แวร์ที่คุณต้องการมีให้ใช้งานในรูปแบบ Helm chart เท่านั้น ความสามารถในการย้าย Manifest ได้ก็เป็นปัจจัยสำคัญ เพราะ Deployment ที่คุณเขียนขึ้นที่นี่สามารถนำไปใช้กับ Managed cluster ได้โดยไม่ต้องแก้ไขอะไร ให้รัน Docker Compose เมื่อสิ่งที่คุณต้องการคือตัวแอปพลิเคชันเอง Compose จะเริ่มคอนเทนเนอร์ชุดเดียวกันโดยมีส่วนประกอบที่ซับซ้อนน้อยกว่ามาก และ Compose file บน VPS นั้นอ่านเข้าใจได้ง่ายกว่าในอีกหนึ่งปีให้หลัง เมื่อเทียบกับไดเรกทอรีที่เต็มไปด้วยไฟล์ Manifest

โปรดทำความเข้าใจให้ชัดเจนว่าการใช้โหนดเดียวไม่ได้มอบสิ่งใดให้คุณบ้าง

  • ไม่มีความพร้อมใช้งานสูง (High availability): เมื่อ VPS รีบูต เวิร์กโหลดทุกอย่างจะหยุดทำงาน Kubernetes จะพยายามย้าย Pod ไปยังโหนดอื่น แต่ในกรณีนี้ไม่มีโหนดอื่นให้ย้ายไป
  • ไม่มีการอัปเดตแบบ Rolling update ที่ช่วยให้เซอร์วิสทำงานได้อย่างต่อเนื่อง เว้นแต่แอปพลิเคชันจะรองรับการรัน 2 Replica บนเครื่องเดียว และโหนดนั้นมีทรัพยากรเพียงพอสำหรับทั้งสองตัว
  • พื้นที่จัดเก็บข้อมูลถูกผูกติดอยู่กับเครื่องนั้นๆ ด้วยเหตุผลที่อธิบายไว้ในส่วน local-path ด้านล่าง
  • Control plane ที่ใช้ RAM ประมาณ 1 GB ไม่ว่าคุณจะติดตั้งอะไรลงไปหรือไม่ก็ตาม

ข้อจำกัดเหล่านี้ไม่ได้ทำให้ k3s เป็นตัวเลือกที่ไม่ดี แต่มันทำให้ k3s เป็นตัวเลือกที่ไม่เหมาะสมหากคุณเลือกด้วยเหตุผลเรื่องความน่าเชื่อถือซึ่งเป็นเหตุผลที่คนส่วนใหญ่มักเข้าใจผิด หากสิ่งที่คุณต้องการจริงๆ คือเครื่องหลายเครื่องเพื่อสร้าง Cluster แบบหลายโหนด การตัดสินใจนั้นต้องมาก่อน: Proxmox บนฮาร์ดแวร์ของคุณเทียบกับ VPS ที่เช่ามา จะเป็นตัวกำหนดว่าโหนดมาจากที่ใด ก่อนที่ k3s จะเป็นตัวกำหนดว่าสิ่งใดจะรันอยู่บนโหนดเหล่านั้น

ปริมาณการใช้ RAM และ CPU ของ k3s ก่อนเริ่มติดตั้งใช้งานจริง

โครงการ k3s เผยแพร่ตัวเลขที่วัดผลได้จริงแทนการประมาณการ โปรดอ่านข้อมูลเหล่านี้อย่างละเอียด เนื่องจากตัวเลขที่ผู้คนมักอ้างถึงไม่ใช่ค่าสถานะ idle ของ 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
  }
]

โหนดเซิร์ฟเวอร์ในการทดสอบนั้นใช้ RAM ไป 1,596 MB ที่เปอร์เซ็นไทล์ที่ 95 และใช้ CPU ประมาณ 6 เปอร์เซ็นต์ของหนึ่งคอร์ ตัวเลขเหล่านี้เป็นตัวเลขที่เผยแพร่อย่างเป็นทางการ ไม่ใช่การวัดผลจากคู่มือนี้ การทดสอบดังกล่าวรัน k3s v1.26.5 โดยเปิดใช้งานส่วนประกอบที่มาพร้อมกับแพ็กเกจทั้งหมด รวมถึง stack การตรวจสอบอย่าง Prometheus และ Grafana ดังนั้นคลัสเตอร์จึงอยู่ในสถานะที่มีภาระงาน ไม่ใช่สถานะว่างเปล่า แต่ทางโครงการระบุว่าตัวเลขดังกล่าวครอบคลุมเฉพาะ datastore ของ Kubernetes และ control plane เท่านั้น โดยไม่รวมความต้องการเฉพาะของภาระงาน (workload) คอนเทนเนอร์ของคุณจะใช้ทรัพยากรเพิ่มเติมจากส่วนนี้ การเปลี่ยนจาก sqlite มาใช้ etcd แบบฝังตัวทำให้การใช้ RAM เพิ่มขึ้นเป็น 1,606 MB ส่วนโหนดที่เป็น agent ซึ่งรัน kubelet และ containerd โดยไม่มี control plane จะใช้ RAM ไป 275 MB ข้อกำหนดขั้นต่ำที่ระบุไว้สำหรับเซิร์ฟเวอร์คือ 2 คอร์ และ RAM 2 GB ซึ่งขั้นต่ำนี้ครอบคลุมเฉพาะ k3s และส่วนประกอบที่มาพร้อมกันก่อนที่จะรวมภาระงานของคุณ

ในทางปฏิบัติ: บน VPS ขนาด 2 GB ตัว control plane และส่วนเสริมที่มาพร้อมกันจะเหลือพื้นที่ให้คุณใช้งานน้อยมาก ภายใต้สภาวะหน่วยความจำตึงตัว kubelet จะทำการ evict pod ออก แต่หากการใช้หน่วยความจำพุ่งสูงขึ้นอย่างรวดเร็ว OOM killer ของ kernel อาจทำงานก่อนที่ kubelet จะตรวจพบสภาวะดังกล่าว ขนาด 4 GB เป็นจุดเริ่มต้นที่เหมาะสมสำหรับหนึ่งโหนดที่มีบริการขนาดเล็กจำนวนหนึ่ง คุณควรวัดผลบนเครื่องของคุณเองแทนที่จะเชื่อตัวเลขที่เผยแพร่ รวมถึงตัวเลขนี้ด้วย

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

ให้รัน free -h ก่อนการติดตั้ง และรันอีกครั้งเมื่อทุก pod ใน kube-system แสดงสถานะ Running ผลต่างที่ได้คือต้นทุนที่ control plane ใช้บนฮาร์ดแวร์ของคุณ k3s kubectl top node จะแสดงค่า error: Metrics API not available ในช่วงหนึ่งหรือสองนาทีแรกหลังการติดตั้ง เนื่องจาก metrics-server ยังไม่ได้ดึงข้อมูลใดๆ ซึ่งไม่ใช่ความผิดปกติ หากคุณกำลังคำนวณขนาดเครื่องเพื่อใช้สำหรับงานนี้และงานอื่นไปพร้อมกัน หลักการคำนวณใน การกำหนดขนาด RAM และ CPU สำหรับ VPS สามารถนำมาใช้ได้ทันทีโดยไม่ต้องปรับเปลี่ยนใดๆ

ติดตั้ง k3s โดยระบุ release ไม่ใช้ latest

คำสั่งเริ่มต้นแบบสั้นที่ทุกคนคัดลอก จะติดตั้งค่าที่ stable channel ชี้ไปในวันที่เรียกใช้ หากเป็นเครื่องที่ตั้งใจใช้งานต่อเนื่อง ควรระบุ release ไว้ k3s เผยแพร่ channel แยกตาม minor version ของ Kubernetes ดังนั้น INSTALL_K3S_CHANNEL=v1.36 จะติดตามเฉพาะ patch release ภายใน v1.36 และจะไม่เปลี่ยนไปใช้ minor version อื่นโดยอัตโนมัติ ณ เดือน October 2026 stable channel ชี้ไปที่ v1.36.5+k3s1

ให้เขียนไฟล์ config ก่อน แล้วจึงติดตั้ง 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 -

หากต้องการระบุ release ที่แน่นอนแทนการใช้ channel ให้ใช้ INSTALL_K3S_VERSION=v1.36.5+k3s1 เครื่องหมายบวกเป็นส่วนหนึ่งของ tag จากนั้นตรวจสอบว่า k3s เริ่มทำงานแล้ว

k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -A

kubectl get node ควรแสดง node 1 รายการที่มี STATUS เป็น Ready ภายในเวลาประมาณสามสิบวินาที และ pod ทุกตัวใน kube-system ควรมีสถานะ Running หรือ Completed หาก node ค้างอยู่ที่ NotReady มักหมายความว่า container runtime ไม่ได้เริ่มทำงาน ให้ตรวจสอบ sudo journalctl -u k3s -n 100 --no-pager หากเป็น VPS image ที่มีการปรับแต่งผิดปกติ ให้เรียกใช้ sudo k3s check-config ก่อนตรวจสอบปัญหาอื่น คำสั่งนี้จะแสดง kernel feature ที่ขาดหายไป ซึ่งช่วยหาสาเหตุได้เร็วกว่าการอ่าน logWinvalid

เหตุใดพอร์ต 80 จึงถูกใช้งานอยู่ และต้องสละสิ่งใดเพื่อแก้ไข

นี่คือความล้มเหลวที่มักพบใน VPS ที่มีการให้บริการบางอย่างอยู่ก่อนแล้ว การติดตั้งอาจเสร็จสมบูรณ์ แต่ Traefik จะไม่ได้รับที่อยู่หากมี Kubernetes pod อื่นจอง hostPort เดียวกันไว้บนโหนดนั้น

กลไกการทำงาน: Traefik chart ที่มาพร้อมกับระบบจะสร้าง Service ประเภท LoadBalancer บนพอร์ต 80 และ 443 โดย ServiceLB จะตอบสนองคำขอนี้ด้วยการสร้าง DaemonSet ของ pod ขนาดเล็กที่มีคำนำหน้าชื่อเป็น svclb- ซึ่งจะจองหมายเลขพอร์ตเหล่านั้นเป็น hostPort บนทุกโหนด hostPort จะส่งต่อ traffic จาก node port ไปยัง pod ผ่านกฎเครือข่าย ตัว scheduler จะตรวจสอบ host port ที่ประกาศโดย Kubernetes pod ไม่ใช่ socket ที่ถูกถือครองโดย host service หรือ standalone Docker container อื่นๆ การที่ pod อื่นจอง hostPort เดียวกันจะขัดขวางการจัดตารางเวลา (scheduling) แต่การที่ nginx, Caddy, Apache หรือ standalone Docker container ฟังพอร์ต 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 )'

หากมีการจอง hostPort ซ้ำจาก Kubernetes pod อื่น คุณจะเห็นสถานะ pod ของ svclb เป็น Pending และ service ไม่มี external address:

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 จะบอกคุณว่า process ใดกำลังฟังพอร์ตนั้นอยู่ แต่มันไม่แสดงการจอง hostPort ที่ scheduler ตรวจสอบ มีทางออกมากกว่าหนึ่งวิธี และแต่ละวิธีมีสิ่งที่ต้องแลกเปลี่ยน

ยกพอร์ตให้ k3s: ลบการจอง hostPort ที่ขัดแย้งกันออกจาก Kubernetes pod อื่น และหยุดรวมถึงปิดการใช้งานเว็บเซิร์ฟเวอร์เดิมบนโฮสต์ เพื่อให้ Traefik จัดการ traffic ขาเข้าบนพอร์ต 80 และ 443 นี่เป็นวิธีที่ถูกต้องเมื่อ VPS จะถูกใช้เป็น k3s box เพียงอย่างเดียว และทุกบริการที่คุณเคยให้บริการถูกย้ายไปอยู่หลัง Ingress

ปิดการใช้งาน ServiceLB และใช้ proxy เดิมของคุณ: ติดตั้งด้วย --disable=servicelb Service ประเภท LoadBalancer จะยังคงจัดสรร NodePort ดังนั้น Traefik จะยังคงเข้าถึงได้ผ่านพอร์ตสูง เช่น 31480 และ nginx หรือ Caddy ของคุณจะทำหน้าที่ proxy ไปยัง 127.0.0.1:31480 สิ่งที่คุณต้องเสียไปคือ external address: service จะแสดงสถานะเป็น <pending> ตลอดไป ซึ่งดูเหมือนเป็นข้อผิดพลาดทั้งที่เป็นทางเลือกที่คุณตัดสินใจเอง

ปิดการใช้งาน Traefik และกำหนดเส้นทางด้วย proxy ของคุณเอง: ติดตั้งด้วย --disable=traefik คุณจะไม่มี ingress controller ดังนั้น Ingress object จะไม่ทำงานใดๆ เลย มันจะค้างอยู่ใน API โดยไม่มี controller คอยเฝ้าดู ซึ่งเป็นเรื่องปกติเมื่อคุณกำหนดเส้นทางจาก host proxy ไปยัง NodePorts และเป็นทางเลือกที่ตรงไปตรงมาหากคุณรู้อยู่แล้วว่าต้องการจัดการ HTTP อย่างไร หากคุณยังตัดสินใจไม่ได้ว่าควรใช้อะไรเป็นหน้าด่าน ให้ตัดสินใจ เลือกระหว่าง nginx, Caddy และ Traefik ในฐานะ reverse proxy ก่อนที่จะปิดการใช้งานสิ่งใด

flag ทั้งสองตัวนี้ใช้กับตัวติดตั้ง หรือใส่ไว้ในไฟล์ config:

tls-san:
  - k3s.example.com
disable:
  - traefik
  - servicelb

การแก้ไขไฟล์ดังกล่าวหลังการติดตั้งและรัน sudo systemctl restart k3s ก็สามารถทำได้เช่นกัน เพราะ --disable ไม่ได้ทำเพียงแค่ข้ามส่วนประกอบในขณะติดตั้งเท่านั้น แต่ยังลบส่วนประกอบที่ถูก deploy ไปแล้วออกด้วย ดังนั้นการเปลี่ยนแปลงจะมีผลกับ cluster ที่กำลังทำงานอยู่

หากต้องการเก็บ 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 value หนึ่งรายการ คือ trusted proxy addresses กลไกเดียวกันนี้สามารถใช้ตั้งค่า value อื่นๆ ที่ chart เปิดให้เข้าถึงได้ รวมถึงพอร์ตต่างๆ ของมัน

พื้นที่จัดเก็บแบบถาวรบนโหนดเดียว

k3s มี StorageClass เริ่มต้นชื่อ local-path ซึ่งใช้ Rancher's local-path provisioner เป็นกลไกจัดสรรพื้นที่ PersistentVolumeClaim ที่ไม่ได้ระบุ storageClassName จะใช้ StorageClass นี้ พื้นที่จัดเก็บจะอยู่ใน /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

คำว่า “บนดิสก์ของโหนดนั้นเอง” มีผลตามมา 2 ประการ และทั้งสองประการมักสร้างปัญหาในภายหลัง ไม่ใช่ทันที

StorageClass นี้ใช้ volumeBindingMode: WaitForFirstConsumer ดังนั้น PVC ใหม่จะยังอยู่ในสถานะ Pending จนกว่า pod จะ mount PVC นั้นจริง kubectl describe pvc จะแสดงผลดังนี้:

waiting for first consumer to be created before binding

นี่เป็นพฤติกรรมปกติ ดังนั้นการสร้าง PVC เพียงอย่างเดียวแล้วรอ จะไม่ทำให้สถานะเปลี่ยน

เมื่อ bind แล้ว volume จะมี node affinity ที่ระบุโหนดซึ่งสร้าง volume นั้น ทำให้ pod ทุกตัวที่ใช้ claim ดังกล่าวต้องทำงานบนโหนดนั้นตลอดอายุของ volume หากมีเพียงโหนดเดียวจะไม่สังเกตเห็นปัญหา แต่เมื่อเพิ่มโหนดที่สองในภายหลัง pod ที่ไม่ยอมย้ายโหนดอาจดูเหมือนเป็นข้อผิดพลาดของ scheduler จนกว่าจะเรียกใช้ kubectl get pv -o yaml แล้วพบชื่อโฮสต์อยู่ใน nodeAffinity

การสำรองข้อมูลเป็นหน้าที่ของคุณ การสร้าง VPS ใหม่จะลบไดเรกทอรีดังกล่าว และสคริปต์ถอนการติดตั้งด้านล่างก็ลบเช่นกัน ให้สำรองข้อมูล /var/lib/rancher/k3s/storage รวมถึงไดเรกทอรี datastore ของ sqlite ที่ /var/lib/rancher/k3s/server/db/ โดยคัดลอกขณะหยุด service เนื่องจากเป็นฐานข้อมูลที่กำลังใช้งานอยู่ และสำรองไฟล์ server token ที่ /var/lib/rancher/k3s/server/token ด้วย token นี้เป็นข้อมูลที่จำเป็น k3s ระบุว่าต้องกู้คืนไฟล์ดังกล่าว หรือส่งค่าให้กับ --token เมื่อกู้คืน datastore จากข้อมูลสำรอง อีกทางเลือกหนึ่งคือถือว่า cluster สามารถสร้างใหม่ได้ และเก็บ manifest ทุกไฟล์ไว้ใน git

Ingress และ TLS

เมื่อเปิดใช้งาน Traefik ไว้แล้ว สิ่งที่คุณต้องใช้มีเพียง Ingress object มาตรฐานเท่านั้น

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 ซึ่งติดตั้งจาก manifest ที่เผยแพร่ไว้ พร้อมด้วย ClusterIssuer หนึ่งรายการ เวอร์ชัน v1.21.3 ซึ่งปล่อยออกมาเมื่อวันที่ 23 ตุลาคม 2026 เป็นเวอร์ชันปัจจุบัน ณ เดือนตุลาคม 2026

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/... จากอินเทอร์เน็ตสาธารณะ ดังนั้นระเบียน DNS ของชื่อโฮสต์ ไม่ว่าจะเป็นระเบียน A หรือระเบียน AAAA หาก VPS สามารถเข้าถึงได้ผ่าน IPv6 จะต้องชี้มาที่ VPS อยู่ก่อนแล้ว และพอร์ต 80 จะต้องเข้าถึง Traefik ได้ Let’s Encrypt จะพยายามใช้ที่อยู่ IPv6 ก่อนหากมีทั้งสองแบบ แต่จะเปลี่ยนไปใช้ IPv4 หากการเชื่อมต่อ IPv6 เริ่มต้นหมดเวลา ข้อผิดพลาดอื่น ๆ รวมถึงการตอบสนอง challenge ที่ไม่ถูกต้อง จะไม่ทำให้เกิดการเปลี่ยนไปใช้ IPv4 และคำขอที่ถูก redirect จะไม่ได้รับการลองใหม่ ให้แก้ไขหรือลบระเบียน AAAA ที่ล้าสมัยออก หากคุณปิดใช้งาน ServiceLB และวาง proxy ของคุณเองไว้ด้านหน้า proxy นั้นจะต้องส่งต่อเส้นทาง challenge ด้วย มิฉะนั้น cert-manager จะค้างอยู่ที่สถานะนี้บน Challenge object:

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 ยังคงเป็น private

k3s จะเขียนข้อมูลรับรองของผู้ดูแลระบบไปที่ /etc/rancher/k3s/k3s.yaml ไฟล์นี้เป็นของ root และโดยค่าเริ่มต้นจะเขียนด้วย mode 600 ภายในมี client certificate ที่มีสิทธิ์ cluster-admin ดังนั้นผู้ใดก็ตามที่อ่านไฟล์นี้ได้ก็จะควบคุม cluster ได้ทั้งหมด

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? เพราะยังไม่ได้กำหนด cluster เลย ให้ตั้งค่า KUBECONFIG, คัดลอกไฟล์ไปที่ ~/.kube/config ตามตัวอย่างด้านล่าง หรือใช้ sudo k3s kubectl ซึ่งจะอ่านไฟล์ที่ถูกต้องให้เอง

คุณอาจเห็นคำแนะนำให้ใช้ --write-kubeconfig-mode 644 เพื่อให้ผู้ใช้ทั่วไปเรียกใช้ kubectl ได้ ควรเข้าใจผลของคำสั่งนี้ก่อน: คำสั่งจะทำให้ทุก account ภายในเครื่องอ่านข้อมูลรับรองที่มีสิทธิ์ cluster-admin ได้ บนเครื่องที่มีผู้ดูแลเพียงคนเดียว อาจยอมรับความเสี่ยงนี้ได้ แต่ไม่ควรใช้บนเครื่องที่มีผู้ใช้ร่วมกัน การคัดลอกไฟล์จะให้สิทธิ์แก่ผู้ใช้คนเดียวโดยไม่เปิดเผยไฟล์แก่ทุก account:

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 จาก laptop อย่าเปิดพอร์ต 6443 สู่อินเทอร์เน็ต Kubernetes API ที่เปิดสาธารณะจะเป็นเป้าหมายที่ถูกโจมตีอย่างต่อเนื่อง และ API ที่เปิดเผยเช่นนี้อาจทำให้ cluster ขนาดเล็กถูกนำไปขุด cryptocurrency ให้ผู้อื่นได้ ให้ tunnel ผ่าน SSH และคง address ในไฟล์ไว้ตามเดิม:

ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get node

หากจำเป็นต้องเข้าถึง API ผ่าน private network address ให้ติดตั้งโดยใช้ tls-san พร้อมระบุชื่อหรือ address ดังกล่าว จากนั้นแก้ไขบรรทัด server: ในไฟล์ที่คัดลอกให้ตรงกัน หากไม่มีรายการ SAN (subject alternative name), kubectl จะปฏิเสธการเชื่อมต่อ:

x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10

พอร์ตขาเข้าที่มีการระบุไว้สำหรับ cluster คือ TCP 6443 สำหรับ API, UDP 8472 สำหรับ flannel VXLAN ระหว่าง node และ TCP 10250 สำหรับ kubelet metrics หากเป็น node เดียว ไม่มีพอร์ตใดที่จำเป็นต้องเปิดสู่อินเทอร์เน็ต

containerd ไม่ใช่ Docker

k3s ทำงานโดยใช้ containerd ที่ฝังตัวอยู่ภายใน และไม่ได้ใช้ image store ร่วมกับ Docker ดังนั้น image ที่คุณเพิ่งสร้างด้วย docker build จะไม่ปรากฏให้ k3s เห็น ส่งผลให้ pod ล้มเหลวด้วยข้อผิดพลาด ErrImagePull แม้ว่า docker images จะแสดงรายการ image นั้นอยู่ก็ตาม คุณต้องนำเข้า (import) image ดังกล่าวอย่างชัดเจน:

docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl images

จากนั้นให้หลีกเลี่ยงการใช้ tag :latest กับ container นั้น เนื่องจาก :latest จะตั้งค่า imagePullPolicy เป็น Always โดยค่าเริ่มต้น ทำให้ kubelet พยายามดึง image จาก registry อยู่ดี สำหรับ tag อื่นๆ จะใช้ค่าเริ่มต้นเป็น IfNotPresent ซึ่งจะเรียกใช้ image ที่คุณนำเข้าไว้ การรันทั้งสองระบบบน VPS เดียวกันสามารถทำได้ และควรทราบว่า การติดตั้ง Docker ปกติบน VPS และ k3s ต่างก็แยกเก็บ image store และกฎ iptables ของตนเองบนเครื่องเดียวกัน

วิธีการลบ k3s

ตัวติดตั้งจะสร้างสคริปต์สำหรับการถอนการติดตั้งไว้ให้ โดยไม่มีตัวเลือกสำหรับการลบเพียงบางส่วนหรือการย้อนกลับการตั้งค่า

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

สคริปต์นี้จะหยุดการทำงานและลบ service, ลบ datastore, ลบข้อมูล persistent volume, ลบการตั้งค่า node และลบเครื่องมือต่างๆ ที่ตัวติดตั้งเพิ่มเข้าไป สำหรับ node ที่เป็น agent สคริปต์จะเป็น k3s-agent-uninstall.sh แทน ให้คัดลอกข้อมูลทุกอย่างภายใต้ /var/lib/rancher/k3s/storage ออกจากเครื่องก่อนดำเนินการ เนื่องจากไดเรกทอรีดังกล่าวจะถูกลบไปด้วย หลังจากนั้นให้ตรวจสอบว่าไม่มีกระบวนการใดค้างอยู่โดยการตรวจสอบพอร์ตหรืออินเทอร์เฟซด้วย ip link show และ sudo ss -lntp หากยังมีอินเทอร์เฟซ cni0 หรือ flannel.1 หลงเหลืออยู่ อินเทอร์เฟซเหล่านั้นจะถูกล้างออกเมื่อรีบูตเครื่องในครั้งถัดไป

การตัดสินใจว่าการใช้ Kubernetes node เดียวเป็นภาระเกินความจำเป็นสำหรับงานนั้นถือเป็นเรื่องปกติ ไม่ใช่ความล้มเหลว การย้าย workload เหล่านั้นกลับไปใช้ 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 ที่ขัดแย้งกันอยู่ waiting for first consumer บน PVC หมายความว่า WaitForFirstConsumer กำลังทำงานตามหน้าที่ของมัน

ImagePullBackOff โหนดไม่สามารถดึง image ได้ ให้ตรวจสอบชื่อและ tag ของ image, สิทธิ์การเข้าถึง registry และข้อมูลยืนยันตัวตน หรือตรวจสอบว่าคุณสร้าง image ด้วย Docker แต่ไม่ได้นำเข้า (import) ไปยัง containerd หรือไม่

Traefik ตอบสนอง แต่แอปพลิเคชันไม่ตอบสนอง เนื้อหาการตอบกลับที่เป็น 404 page not found มาจากตัว Traefik เอง ซึ่งหมายความว่าคำขอมาถึงแล้วแต่ไม่มี router ใดตรงกับเงื่อนไข ให้ตรวจสอบว่า Ingress host ตรงกับชื่อที่คุณระบุ และ ingressClassName มีค่าเป็น traefik

Cluster DNS ล้มเหลวในขณะที่โฮสต์แก้ไขชื่อได้ปกติ ให้ตรวจสอบ CoreDNS ด้วย sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns ข้อความเช่น plugin/loop: Loop ... detected for zone "." จะทำให้ CoreDNS ไม่สามารถเริ่มทำงานได้ ซึ่งเกิดขึ้นเพราะ CoreDNS กำลังส่งต่อคำขอไปยัง resolver ที่ส่งคำขอกลับมาที่ตัวมันเอง ซึ่งเป็นสิ่งที่เกิดขึ้นเมื่อใช้ loopback address ใน /etc/resolv.conf ให้ชี้ k3s ไปยังไฟล์ upstream จริงด้วย --resolv-conf /run/systemd/resolve/resolv.conf

FAQ

การรัน k3s บน VPS เครื่องเดียวคุ้มค่าหรือไม่?

คุ้มค่าหากคุณต้องการใช้งาน Kubernetes API เพื่อเรียนรู้บนเครื่องที่คุณควบคุมได้, ต้องการเก็บการตั้งค่า deployment ไว้ในรูปแบบ manifest ที่ย้ายไปที่อื่นได้ง่าย, ต้องการรันซอฟต์แวร์ที่มีเฉพาะ Helm chart หรือกำลังสร้างระบบเพื่อเตรียมย้ายไปรันบน managed cluster ในอนาคต แต่จะไม่คุ้มค่าหากคุณเพียงต้องการรัน container เท่านั้น เพราะ Docker Compose ทำงานได้โดยมีภาระในการดูแลรักษาน้อยกว่ามากและประหยัด RAM ได้มากกว่าประมาณ 1 GB การรันบนโหนดเดียวไม่ช่วยเรื่อง high availability ดังนั้นความน่าเชื่อถือจึงไม่ใช่เหตุผลในการเลือกใช้

ทำไม service ประเภท LoadBalancer ของ k3s ถึงค้างอยู่ที่สถานะ Pending?

ServiceLB จะสร้าง svclb- pod ที่จองพอร์ตของ service ไว้เป็น hostPort บนโหนด ดังนั้น pod จะถูกจัดสรรเฉพาะในจุดที่พอร์ตเหล่านั้นว่างอยู่เท่านั้น หากมี Kubernetes pod อื่นจอง hostPort เดียวกันไว้ pod นั้นจะค้างอยู่ที่สถานะ Pending และ service จะไม่ได้รับ external address ทั้งนี้ host proxy หรือ Docker container ที่รันแยกต่างหากและฟังพอร์ต 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 ให้คุณลบการจอง hostPort ของ pod ที่ขัดแย้งกันออก หรือปิดการใช้งาน ServiceLB ด้วย --disable=servicelb แล้วทำ proxy ไปยัง NodePort ที่ service ยังคงจัดสรรไว้ให้แทน

k3s ต้องการ RAM เท่าใดบน VPS?

ข้อกำหนดขั้นต่ำสำหรับ server node คือ 2 core และ 2 GB ซึ่งครอบคลุม k3s และส่วนประกอบที่มาพร้อมกันก่อนจะรัน workload ของคุณ จากการวัดผลของโครงการพบว่า control plane และ datastore ของ server node ใช้ RAM ไป 1,596 MB ในขณะที่มี monitoring stack รันอยู่ด้วย ตัวเลขนี้ยังไม่รวมหน่วยความจำที่ workload ของคุณใช้ ดังนั้นให้ถือว่า 2 GB เป็นค่าเริ่มต้นขั้นต่ำ และ 4 GB เป็นขนาดแรกที่โหนดเดียวจะทำงานได้อย่างราบรื่น ให้วัดผลบนเครื่องของคุณด้วย free -h ก่อนการติดตั้ง และวัดอีกครั้งหลังจากทุก pod ใน kube-system มีสถานะเป็น Running

ฉันสามารถรัน Docker และ k3s บน VPS เครื่องเดียวกันได้หรือไม่?

ได้ ทั้งสองระบบจะทำงานแยกจากกัน k3s ใช้ containerd ที่ฝังมาในตัว ดังนั้น image ที่สร้างด้วย docker build จะไม่ปรากฏใน k3s จนกว่าคุณจะรัน docker save myapp:0.1 | sudo k3s ctr images import - นอกจากนี้ ทั้งสองระบบยังเขียน iptables rules และสร้าง bridge network ของตนเองแยกกัน ให้คอยตรวจสอบปริมาณ RAM รวม เพราะ Docker, k3s และ container ของคุณทั้งหมดต้องใช้ RAM ร่วมกันในเครื่องเดียว

ฉันจะลบ k3s ออกทั้งหมดได้อย่างไร?

รัน sudo /usr/local/bin/k3s-uninstall.sh บน server node หรือ sudo /usr/local/bin/k3s-agent-uninstall.sh บน agent ระบบจะหยุดการทำงานของ service, ลบ datastore, ลบข้อมูล persistent volume ภายใต้ /var/lib/rancher/k3s/storage และลบเครื่องมือที่มาพร้อมกันออกทั้งหมด ให้คัดลอกข้อมูลที่คุณต้องการเก็บไว้ออกจากเครื่องก่อน เพราะการดำเนินการนี้ไม่สามารถย้อนกลับได้ ส่วน network interface อย่าง cni0 หรือ flannel.1 ที่อาจหลงเหลืออยู่จะหายไปเองเมื่อรีบูตเครื่องครั้งถัดไป

บทความนี้มีประโยชน์หรือไม่