当前位置：首页 > news >正文

Ubuntu 安装 Rancher

news 2025/10/31 18:36:24

在 Ubuntu 上安装 Rancher 开源版，推荐使用 K3s + Helm 的方式。这是一种轻量、快速且适合生产环境的部署方法。以下是在 Ubuntu 20.04/22.04 上安装 Rancher 的完整步骤。

一、准备工作

1. 系统要求

操作系统：Ubuntu 20.04 LTS 或 22.04 LTS
硬件：
- CPU：2 核以上
- 内存：8 GB 以上
- 磁盘：20 GB 以上（用于存储 etcd 数据）
网络：
- 固定 IP 地址
- 开放端口：80 和 443
域名（推荐）：如 rancher.yourdomain.com，指向该服务器 IP

2. 更新系统

sudo apt update && sudo apt upgrade -y

二、安装 Docker

Rancher 需要容器运行时，我们安装 Docker。

# 1. 安装依赖
sudo apt install -y ca-certificates curl gnupg lsb-release# 2. 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg# 3. 添加 Docker 仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null# 4. 安装 Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin# 5. 启动并启用 Docker
sudo systemctl enable docker
sudo systemctl start docker# 6. 将当前用户加入 docker 组（避免使用 sudo）
sudo usermod -aG docker $USER
# 退出并重新登录以生效

三、安装 K3s（轻量级 Kubernetes）

K3s 是一个轻量级的 Kubernetes 发行版，非常适合运行 Rancher。

# 使用官方中国区镜像
curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | \INSTALL_K3S_MIRROR=cn \sh -s - --write-kubeconfig-mode 644

这条命令会自动安装 K3s 并启动一个单节点 Kubernetes 集群，作为 Rancher 的“Local 集群”。如果下载失败，登录https://rancher-mirror.oss-cn-beijing.aliyuncs.com/k3s/手动下载安装

验证 K3s 安装

# 检查 K3s 状态
sudo systemctl status k3s# 查看节点
sudo k3s kubectl get nodes# 查看 Pod（需要等待几分钟）
sudo k3s kubectl get pods -A

四、安装 Helm

Helm 是 Kubernetes 的包管理器，用于部署 Rancher。

# 下载并安装 Helm
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash# 验证
helm version

五、安装 Rancher

1. 添加 Rancher Helm 仓库

helm repo add rancher-stable https://releases.rancher.com/server-charts/stable
helm repo update

2. 创建命名空间

sudo k3s kubectl create namespace cattle-system

3. 安装 Rancher

# 使用 Helm 安装 Rancher
# 替换 rancher.yourdomain.com 为你的实际域名或服务器IP
helm install rancher rancher-stable/rancher \--namespace cattle-system \--set hostname=119.29.23.92 \--set bootstrapPassword=admin \--set replicas=1 \--set letsEncrypt.email=your-email@example.com

参数说明：
hostname：访问 Rancher 的域名或 IP。
bootstrapPassword：首次登录的默认密码（登录后会强制修改）。
replicas=1：单节点模式。
letsEncrypt.email：证书过期提醒邮箱。

六、访问 Rancher Web 界面

打开浏览器，访问：

https://rancher.yourdomain.com

或

https://<你的服务器IP>

首次登录：
- 用户名：admin
- 密码：admin（或你在 bootstrapPassword 中设置的）
- 系统会提示你设置新密码。

七、常用维护命令

# 查看 Rancher Pod 状态
sudo k3s kubectl get pods -n cattle-system# 查看日志（排查问题）
sudo k3s kubectl logs -n cattle-system <pod-name># 升级 Rancher
helm upgrade rancher rancher-stable/rancher \--namespace cattle-system \--set hostname=rancher.yourdomain.com# 卸载 Rancher
helm uninstall rancher -n cattle-system# 卸载 K3s（完全清理）
/usr/local/bin/k3s-uninstall.sh