余味YUWEI
云原生ARTICLE / 2026

K3S简单安装流程

使用国内镜像快速安装 K3S,并完成 kubeconfig 与容器镜像加速配置。

2026.03.15 阅读约 2 分钟 Kubernetes · K3S

安装 K3S

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | \
INSTALL_K3S_MIRROR=cn sh -s - \
--system-default-registry "registry.cn-hangzhou.aliyuncs.com"

配置 kubeconfig

mkdir -p ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown $USER:$USER ~/.kube/config
chmod 600 ~/.kube/config

配置镜像加速

mkdir -p /etc/rancher/k3s/
cat >> /etc/rancher/k3s/registries.yaml <<EOF
configs:
  "docker.io":
    endpoint:
      - "https://docker.1ms.run"
      - "https://docker.xuanyuan.me"
      - "https://registry-1.docker.io"
  "ghcr.io":
    endpoint:
      - "https://ghcr.nju.edu.cn"
      - "https://ghcr.io"
EOF
systemctl restart k3s