- K3s常见问题

title: K3s常见问题 description: 常见问题定期更新，旨在回答用户最常问到的关于 K3s 的问题。 keywords:

• k3s中文文档
• k3s 中文文档
• k3s中文
• k3s 中文
• k3s
• k3s教程
• k3s中国
• rancher
• k3s 中文教程
• K3s常见问题

常见问题定期更新，旨在回答用户最常问到的关于 K3s 的问题。

K3s 是否适合替代 k8s？

K3s 几乎可以胜任 k8s 的所有工作, 它只是一个更轻量级的版本。有关更多详细信息，请参见主要文档页面。

如何用自己的 Ingress 代替 Traefik？

只需用--disable traefik启动 K3s server，然后部署你需要的 ingress。

K3s 是否支持 Windows？

目前，K3s 本身不支持 Windows，但是我们对将来的想法持开放态度。

如何通过源码构建？

请参考 K3s BUILDING.md的说明。

K3s 的日志在哪里？

安装脚本会自动检测你的操作系统是 systemd 或 openrc 并启动服务。

当使用 openrc 运行时，日志将在/var/log/k3s.log中创建。

当使用 systemd 运行时，日志将在/var/log/syslog中创建，并使用journalctl -u k3s查看。

常见安装问题

执行官网提供的安装命令没反应？

执行官网提供的安装脚本安装 K3s，无返回：

解决方案：

1. 使用国内安装脚本安装 k3s，详情参考快速入门指南

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh -

1. 或采用离线安装方式安装 k3s

INSTALL_K3S_SKIP_DOWNLOAD=true ./install.sh

注册 k3s 节点失败

报错：

level=error msg="Node password rejected, duplicate hostname or contents of '/etc/rancher/node/password' may not match server node-passwd entry, try enabling a unique node name with the --with-node-id flag"

原因分析：

根据日志提示大概的原因是两个 k3s 节点主机名重复，或者/etc/rancher/node/password 与 k3s server 的 node-passwd 不匹配造成。

节点注册到 k3s 集群，会在节点的/etc/rancher/node/password生成一串随机的 password。如果 agent 首次注册，master 节点会把 agent 发送的 node-name 和 node-passwd 解析出来存储到/var/lib/rancher/k3s/server/cred/node-passwd 中。如果 agent 是非首次注册，k3s master 会结合 node-name 和 node-passwd 进行比对，如果信息不一致会拒绝添加节点请求。

解决方案：

为什么会出现 passwd 不一致呢？正常来说如果用 k3s-agent-uninstall.sh 来清理安装过的 agent node，并不会删除 password 文件（/etc/rancher/node/password），那么问题很可能是 VM 重建或者手动操作删除的这个文件。因为 agent 上删除了 password，agent 再次注册时会重新生成 password，就导致了新的 password 和 k3s master 上原先存储的不一致。

1. 手动在 agent 上创建 password，内容和 server 中存储保持一致
2. 修改 server 中的原始内容，让 password 和 agent 上新生成的保持一致
3. 可以试试 agent 注册时使用—with-node-id，这样 server 中认为这完全是新 node，不会用原始信息比对
4. 如果是因为主机名冲突导致的报错，可以修改主机名之后从新注册集群

如何创建只带有 master 角色的节点？

默认情况下，k3s 启动 master 节点也同时具有 worker 角色，是可调度的，因此可以在它们上启动工作

解决方案

1. 通过 —node-taint

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn INSTALL_K3S_EXEC="--node-taint k3s-controlplane=true:NoExecute" sh -

1. 通过 —disable-agent

curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn INSTALL_K3S_EXEC="--disable-agent" sh -

跨主机 pod 无法通信？

请参考k3s 网络要求检查主机网络或防火墙，查看 vxlan 对应的 UDP/8472 端口是否开放。

如何指定某个网卡添加 K3S 集群？

可以通过--advertise-address设置 apiserver 向集群成员发布的 IP 地址，详细说明参考K3s Server 配置参考

Demo：

K3s1(master):

# curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn \
INSTALL_K3S_EXEC="--advertise-address 192.168.99.211" sh –

K3s2(worker):

# curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn \
INSTALL_K3S_EXEC="--node-ip 192.168.99.212" K3S_URL=https://192.168.99.211:6443 K3S_TOKEN=mynodetoken sh -

使用 netstat 无法查到 80 和 443 端口?

K3s 使用 traefik 作为默认的 ingress controller。启动之后是通过 iptables 转发 80/443 端口，所以用netstat无法查到对应端口，可以通过iptables，nmap等命令去确认端口是否开启。更多说明请参考k3s 功能扩展之 Helm、Traefik LB、ServiceLB 存储及 RootFS

为什么当 k3s 节点故障后，Pod 需要大于 5 分钟时间才能被重新调度？

参考Rancher2.x FAQ

可以参考下面这个示例调整tolerationSeconds时间：

kubectl create -f https://raw.githubusercontent.com/kingsd041/rancher-k3s/master/demo-busybox.yaml

如何使用 crictl 清理未使用的镜像

k3s crictl rmi --prune

K3s worker 节点的角色默认为none，如果修改？

可以通过kubectl label node ${node} node-role.kubernetes.io/worker=worker为节点增加 worker 角色。

Helm: Error: Kubernetes cluster unreachable

解决方案参考集群访问章节。