> ## Content Index
> Fetch the complete content index at: https://blog.k3s.9zf.net/llms.txt
> Use this file to discover other available public pages before exploring further.

# K3S安装手记
- URL: https://blog.k3s.9zf.net/k3s-e5-ae-89-e8-a3-85-e6-89-8b-e8-ae-b0/
- Published: 2023-03-13T16:45:00.000Z
- Updated: 2023-03-13T16:45:00.000Z
- Author: liu
- Tags: 生活日记, #wordpress, #Import 2026-10-29 06:11

安装master节点 坑1，本地移动线路，官方脚本会镜像下载失败，只能用阿里云的脚本（不用安装docker）

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

用命令查看token，并复制

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

安装worker节点,这个用官方命令没问题

```
curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn K3S_URL=https://IP
:6443 K3S_TOKEN=上面复制的 INSTALL_K3S_EXEC="--node-ip 节点IP" sh -。
```

```
k3s kubectl get node  #查看节点是否安装成功
```

安装Kuboard 管理，又是移动网络坑，官方命令下载不来镜像，会ImagePullBackOff 和ErrImagePull，用下面的命令解决，安装后打开http://IP:30080，用户admin，密码 Kuboard123

```
kubectl apply -f https://addons.kuboard.cn/kuboard/kuboard-v3.yaml
# 您也可以使用下面的指令，唯一的区别是，该指令使用华为云的镜像仓库替代 docker hub 分发 Kuboard 所需要的镜像
# kubectl apply -f https://addons.kuboard.cn/kuboard/kuboard-v3-swr.yaml

```

## 如安装失败，执行以下命令看是否有没运行的容器或下载失败的。

`kubectl get pods --all-namespaces`

## 配置 Containerd[​](https://docs.k3s.io/zh/advanced?ref=blog.k3s.9zf.net#%E9%85%8D%E7%BD%AE-containerd)

K3s 会在 `/var/lib/rancher/k3s/agent/etc/containerd/config.toml` 中为 containerd 生成 config.toml。

如果要对这个文件进行高级定制，你可以在同一目录中创建另一个名为 `config.toml.tmpl` 的文件，此文件将会代替默认设置。

k3s设置containerd镜像加速

拷贝配置文件

```
cp /var/lib/rancher/k3s/agent/etc/containerd/config.toml /var/lib/rancher/k3s/agent/etc/containerd/config.toml.tmpl
```

打开拷贝的配置文件

```
vi /var/lib/rancher/k3s/agent/etc/containerd/config.toml.tmpl
```

将下面的内容添加到配置文件  

```
[plugins."io.containerd.grpc.v1.cri".registry]
      [plugins."io.containerd.grpc.v1.cri".registry.mirrors]
        [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
          endpoint = ["https://nn1duwi0.mirror.aliyuncs.com", "https://registry-1.docker.io"]
```

重启k3s

```
systemctl restart k3s
```

查看是否生效(如果显示了镜像加速地址则代表生效)

```
crictl info|grep  -A 5 registry
```

貌似要每个节点都要修改镜像加速