安装要求

安装要求

本文描述了对需要安装 Rancher Server 的节点的软件、硬件和网络要求。Rancher Server 可以安装在单个节点或高可用的 Kubernetes 集群上。

重要提示：

如果你需要在 Kubernetes 集群上安装 Rancher，该节点的要求与用于运行应用和服务的下游集群的节点要求不同。

Rancher UI 在基于 Firefox 或 Chromium 的浏览器（Chrome、Edge、Opera、Brave）中效果最佳。

查看我们的最佳实践页面，获取在生产环境中运行 Rancher Server 的建议。

Kubernetes 与 Rancher 的兼容性

Rancher 需要安装在支持的 Kubernetes 版本上。请查阅 Rancher 支持矩阵，确保你的 Kubernetes 版本受支持。

操作系统和容器运行时要求

所有支持的操作系统都使用 64-bit x86 架构。Rancher 兼容当前所有的主流 Linux 发行版。

Rancher 支持矩阵列出了每个 Rancher 版本测试过的操作系统和 Docker 版本。

运行 RKE 集群的节点需要安装 Docker。RKE2 或 K3s 集群不需要它。

请安装 ntp（Network Time Protocol），以防止在客户端和服务器之间由于时间不同步造成的证书验证错误。

某些 Linux 发行版的默认防火墙规则可能会阻止 Kubernetes 集群内的通信。从 Kubernetes v1.19 开始，你必须关闭 firewalld，因为它与 Kubernetes 网络插件冲突。

如果你不太想这样做的话，你可以查看相关问题中的建议。某些用户已能成功使用 ACCEPT 策略为 Pod CIDR 创建一个独立的 firewalld 区域。

如果你需要在 ARM64 上使用 Rancher，请参见在 ARM64（实验功能）上运行 Rancher。

RKE 要求

容器运行时方面，RKE 可以兼容当前的所有 Docker 版本。

有关详细信息，请参阅安装 Docker。

K3s 要求

对于容器运行时，K3s 默认附带了自己的 containerd。你也可以将 K3s 配置为使用已安装的 Docker 运行时。有关在 Docker 中使用 K3s 的更多信息，请参阅 K3s 文档。

Rancher 需要安装在支持的 Kubernetes 版本上。如需了解你使用的 Rancher 版本支持哪些 Kubernetes 版本，请参见 Rancher 支持矩阵。如需指定 K3s 版本，在运行 K3s 安装脚本时，使用 INSTALL_K3S_VERSION 环境变量。

如果你使用 Raspbian Buster 在 K3s 集群上安装 Rancher，请按照这些步骤切换到旧版 iptables。

如果你使用 Alpine Linux 的 K3s 集群上安装 Rancher，请按照这些步骤进行其他设置。

RKE2 要求

对于容器运行时，RKE2 附带了自己的 containerd。RKE2 安装不需要 Docker。

如需了解 RKE2 通过了哪些操作系统版本的测试，请参见 Rancher 支持矩阵。

硬件要求

本节描述安装 Rancher Server 的节点的 CPU、内存和磁盘要求。

CPU 和内存

硬件要求根据你的 Rancher 部署规模而定。请根据要求配置每个节点。通过单节点容器安装 Rancher，和在 Kubernetes 集群上安装 Rancher 的要求有所不同。

RKE 和托管 Kubernetes

这些 CPU 和内存要求适用于每个安装 Rancher Server 的 Kubernetes 集群中的主机。

这些要求适用于 RKE Kubernetes 集群以及托管的 Kubernetes 集群，例如 EKS。

部署规模	集群	节点	vCPUs	内存
小	最多 150 个	最多 1500 个	2	8 GB
中	最多 300 个	最多 3,000 个	4	16 GB
大	最多 500 个	最多 5,000 个	8	32 GB
特大	最多 1,000 个	最多 10,000 个	16	64 GB
超大	最多 2,000 个	最多 20,000 个	32	128 GB

每个用例和环境都是不同的。请联系 Rancher 来审核你的情况。

K3s Kubernetes

这些 CPU 和内存要求适用于每个安装 Rancher Server 的 Kubernetes 集群中的主机。

部署规模	集群	节点	vCPUs	内存	数据库大小
小	最多 150 个	最多 1500 个	2	8 GB	2 核，4 GB + 1,000 IOPS
中	最多 300 个	最多 3,000 个	4	16 GB	2 核，4 GB + 1,000 IOPS
大	最多 500 个	最多 5,000 个	8	32 GB	2 核，4 GB + 1,000 IOPS
特大	最多 1,000 个	最多 10,000 个	16	64 GB	2 核，4 GB + 1,000 IOPS
超大	最多 2,000 个	最多 20,000 个	32	128 GB	2 核，4 GB + 1,000 IOPS

每个用例和环境都是不同的。请联系 Rancher 来审核你的情况。

RKE2 Kubernetes

这些 CPU 和内存要求适用于安装了 RKE2 的每个实例。最低配置要求如下：

部署规模	集群	节点	vCPUs	内存
小	最多 5 个	最多 50 个	2	5 GB
中	最多 15 个	最多 200 个	3	9 GB

Docker

这些 CPU 和内存要求适用于单节点安装 Rancher 的主机。

部署规模	集群	节点	vCPUs	内存
小	最多 5 个	最多 50 个	1	4 GB
中	最多 15 个	最多 200 个	2	8 GB

Ingress

安装 Rancher 的 Kubernetes 集群中的每个节点都应该运行一个 Ingress。

Ingress 需要部署为 DaemonSet 以确保负载均衡器能成功把流量转发到各个节点。

如果是 RKE，RKE2 和 K3s 安装，你不需要手动安装 Ingress，因为它是默认安装的。

对于托管的 Kubernetes 集群（EKS、GKE、AKS），你需要设置 Ingress。

Amazon EKS：在 Amazon EKS 上安装 Rancher 以及如何安装 Ingress 以访问 Rancher Server。
AKS：使用 Azure Kubernetes 服务安装 Rancher 以及如何安装 Ingress 以访问 Rancher Server。
GKE：使用 GKE 安装 Rancher 以及如何安装 Ingress 以访问 Rancher Server。

磁盘

etcd 在集群中的性能决定了 Rancher 的性能。因此，为了获得最佳速度，我们建议使用 SSD 磁盘来支持 Rancher 管理的 Kubernetes 集群。在云提供商上，你还需使用能获得最大 IOPS 的最小大小。在较大的集群中，请考虑使用专用存储设备存储 etcd 数据和 wal 目录。

网络要求

本节描述了安装 Rancher Server 的节点的网络要求。

警告

如果包含 Rancher 的服务器带有 X-Frame-Options=DENY 标头，在升级旧版 UI 之后，Rancher UI 中的某些页面可能无法渲染。这是因为某些旧版页面在新 UI 中是以 iFrames 模式嵌入的。

节点 IP 地址

无论你是在单个节点还是高可用集群上安装 Rancher，每个节点都应配置一个静态 IP。如果使用 DHCP，则每个节点都应该有一个 DHCP 预留，以确保节点分配到相同的 IP 地址。

端口要求

为了确保能正常运行，Rancher 需要在 Rancher 节点和下游 Kubernetes 集群节点上开放一些端口。不同集群类型的 Rancher 和下游集群的所有必要端口，请参见端口要求。

Dockershim 支持

有关 Dockershim 支持的详情，请参见此页面。