资讯详情

离线安装k3s。

集群规划（3 节点）

master节点，主机名：k8s-master-01，ip：172.29.128.1

工作节点1：主机名：k8s-worker-01，ip：172.29.132.68 

工作节点2：主机名：k8s-worker-02，ip：172.29.132.69 

 

一，前置统一操作（所有 3 台节点全部执行）

1.1 分别设置每台机器主机名

# master节点执行
hostnamectl set-hostname k8s-master-01# worker01节点执行
hostnamectl set-hostname k8s-worker-01# worker02节点执行
hostnamectl set-hostname k8s-worker-02

 

1.2 所有节点统一写入 /etc/hosts

cat >> /etc/hosts <<EOF
172.29.128.1    k8s-master-01
172.29.132.68   k8s-worker-01
172.29.132.69   k8s-worker-02
EOF

 

1.3. 关闭防火墙、SELinux、swap（K3s 强制要求）

# 关闭防火墙
systemctl stop firewalld
systemctl disable firewalld# 关闭selinux（centos/rhel系，ubuntu可忽略）
setenforce 0
sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config# 永久关闭swap
swapoff -a
sed -i '/swap/s/^/#/' /etc/fstab

 

1.4. 内核参数（容器网络必需）

modprobe overlay
modprobe br_netfiltercat >> /etc/sysctl.d/k8s.conf <<EOF
net.bridge.bridge-nf-call-iptables  = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward                 = 1
EOF
sysctl --systemcat >> /etc/sysctl.conf <<EOF
net.bridge.bridge-nf-call-iptables=1
net.bridge.bridge-nf-call-ip6tables=1
net.ipv4.ip_forward=1
EOF
sysctl -p

 

1.5 4. 时间同步（避免证书过期、节点失联）

yum install chrony -y || apt install chrony -y
systemctl enable --now chronyd

 

二，下载k3s离线包

下载k3s二进制：https://github.com/k3s-io/k3s/releases/download/v1.33.6+k3s1/k3s

下载airgap镜像包：https://github.com/k3s-io/k3s/releases/latest/download/k3s-airgap-images-amd64.tar

下载官方安装脚本：https://get.k3s.io

将安装脚本保存为 k3s-install.sh 文件

将下载的三个文件：k3s、k3s-airgap-images-amd64.tar、k3s-install.sh 上传到所有节点

在powershell窗口扫行：

#上传到k8s-master-01节点
scp D:\softs\k3s\k3s-airgap-images-amd64.tar root@121.40.63.235:/data/k3s
scp D:\softs\k3s\k3s-install.sh root@121.40.63.235:/data/k3s
scp D:\softs\k3s\k3s root@121.40.63.235:/data/k3s#上传到k8s-worker-01节点
scp D:\softs\k3s\k3s-airgap-images-amd64.tar root@116.62.212.143:/data/k3s
scp D:\softs\k3s\k3s-install.sh root@116.62.212.143:/data/k3s
scp D:\softs\k3s\k3s root@116.62.212.143:/data/k3s#上传到k8s-worker-02节点
scp D:\softs\k3s\k3s-airgap-images-amd64.tar root@121.199.21.41:/data/k3s
scp D:\softs\k3s\k3s-install.sh root@121.199.21.41:/data/k3s
scp D:\softs\k3s\k3s root@121.199.21.41:/data/k3s

 

在三个节点上都要查看，确保文件已上传：

 

 三，部署k3s （master节点）

1. 分发二进制、离线镜像、授权安装脚本

# 1. 将k3s二进制复制到系统全局PATH
cp /data/k3s/k3s /usr/local/bin/
chmod +x /usr/local/bin/k3s# 2. 创建镜像自动加载目录，拷贝离线镜像包
mkdir -p /var/lib/rancher/k3s/agent/images/
cp /data/k3s/k3s-airgap-images-amd64.tar /var/lib/rancher/k3s/agent/images/# 3. 脚本增加执行权限，校验版本
chmod +x /data/k3s/k3s-install.sh
k3s --version

 

2，Master 节点（172.29.128.1）执行安装

INSTALL_K3S_SKIP_DOWNLOAD=true INSTALL_K3S_EXEC="server \
--cluster-init \
--server https://172.29.128.1:6443 \
--tls-san 172.29.128.1 \
--airgap \
--write-kubeconfig-mode 644" \
/data/k3s/k3s-install.sh

 

3，查看 k3s 服务运行状态

systemctl status k3s
kubectl get nodes

 

4，配置 kubectl 管理凭证（在master 节点上执行）

mkdir -p ~/.kube
cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sed -i 's/127.0.0.1/172.29.128.1/g' ~/.kube/config

 

 

 

 

四，部署k3s工作工点

1，在master节点上获取 Worker 节点接入 Token（保存，两台 worker 都要用）

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

 

 

2，两台 Worker 节点分别执行安装（替换 Token）

INSTALL_K3S_SKIP_DOWNLOAD=true \
INSTALL_K3S_EXEC="agent \
--server https://172.29.128.1:6443 \
--token 替换为你的token" \
bash /data/k3s/k3s-install.sh

 

如果输出下面的错误，说明是windows换行符导致的。

: invalid optionstall.sh: line 2: set: -
set: usage: set [-abefhkmnptuvxBCEHPT] [-o option-name] [--] [-] [arg ...]
: invalid option name.sh: line 3: set: noglob
/data/k3s/k3s-install.sh: line 4: $'\r': command not found
/data/k3s/k3s-install.sh: line 101: $'\r': command not found
/data/k3s/k3s-install.sh: line 105: $'\r': command not found
/data/k3s/k3s-install.sh: line 107: syntax error near unexpected token `$'\r''
'data/k3s/k3s-install.sh: line 107: `info()

解决方式：

第一步：修复 Windows 换行符（CRLF→LF，根治 \r 报错）

sed -i 's/\r$//' /data/k3s/k3s-install.sh

第二步：拷贝二进制到系统目录（必须先执行）

cp /data/k3s/k3s /usr/local/bin/
chmod +x /usr/local/bin/k3s
mkdir -p /var/lib/rancher/k3s/agent/images/
cp /data/k3s/k3s-airgap-images-amd64.tar /var/lib/rancher/k3s/agent/images/
chmod 755 /data/k3s/k3s-install.sh

第三步，重新执行：

INSTALL_K3S_SKIP_DOWNLOAD=true \
INSTALL_K3S_EXEC="agent \
--server https://172.29.128.1:6443 \
--token 替换为你的token" \
bash /data/k3s/k3s-install.sh

 

3，安装完成验证

systemctl start k3s-agent
systemctl status k3s-agent

 

4，在master节点验证

kubectl get nodes

 

  

五，运维启停 / 卸载命令

# Master节点操作
systemctl restart k3s
/usr/local/bin/k3s-uninstall.sh# Worker节点操作
systemctl restart k3s-agent
/usr/local/bin/k3s-agent-uninstall.sh