K3s工作节点连接主节点后未在API中显示问题排查求助

1核1GB VPS主节点配置符合性说明 #

K3s作为轻量级Kubernetes发行版，官方给出的单主节点最低运行要求为1核CPU、512MB内存，因此你使用的1核1GB配置满足基础运行要求，可正常运行空集群及轻量工作负载，若后续部署服务较多建议升级内存避免资源不足。

工作节点加入集群失败排查与解决方法 #

按优先级从高到低排查以下问题：

• 查看安装过程详细报错
  安装命令中的s参数会屏蔽脚本输出，导致无法看到错误原因，你可以在工作节点执行去掉s参数的安装命令查看完整报错：

  curl -fL https://get.k3s.io | K3S_URL=https://myserver:6443 K3S_TOKEN=mynodetoken sh -
  

  也可以执行journalctl -u k3s-agent.service --no-pager查看k3s-agent服务的运行日志定位问题。
• 验证6443端口连通性
  即使VPN网络连通，也需要确认主节点6443端口对工作节点开放，在工作节点执行以下命令验证端口可达性：

  nc -zv 主节点VPN IP 6443
  

  如果端口无法访问，需要检查主节点的防火墙、云服务商安全组规则，放行VPN网段的6443端口入站权限。同时确认K3s主节点服务绑定了VPN网段的IP，若未绑定需要在主节点K3s启动参数中加入--tls-san 主节点VPN IP，重启k3s服务后再尝试加入。
• 校验节点令牌准确性
  确认你复制的主节点/var/lib/rancher/k3s/server/node-token内容完整，没有多余的空格、换行符，执行加入命令时K3S_TOKEN的值需要和令牌完全一致。
• 确认域名解析正常
  若你在K3S_URL中使用的是域名而非IP，需要确认工作节点可以正常将域名解析到主节点的VPN IP，可直接将K3S_URL中的域名替换为主节点VPN IP进行测试，排除解析故障。
• 清理节点残留配置
  若工作节点之前安装过K3s相关组件，残留配置会导致加入失败，先执行卸载命令清理残留：

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

  清理完成后重新执行加入命令即可。
• 关闭swap分区
  Kubernetes类组件默认要求关闭系统swap分区，在工作节点执行swapoff -a，同时编辑/etc/fstab文件注释掉swap相关挂载行，避免重启后swap自动挂载，修改完成后重新执行加入命令。

内容的提问来源于stack exchange，提问作者tymur999