跳到主要内容
版本:Latest

功能

General

General 选项卡提供了社区 channel 的信息,用户可以通过这些 channel 联系 Rancher Desktop 团队和社区,并提出问题、报告错误或讨论 Rancher Desktop。

Port Forwarding

如需转发端口:

  1. 找到 Service 并单击 Forward
  2. 指定要使用的端口或使用随机分配的端口。
  3. 点击 按钮来确认你的选择。
  4. 可选:单击 Cancel 来移除分配的端口。

Images

Images 选项卡允许你管理虚拟机上的镜像。

要改用 nerdctl 管理镜像,请参阅镜像

Scanning Images

此功能使用 Trivy 来扫描你的镜像,从而查找漏洞和配置问题。

要扫描镜像:

  1. 从镜像列表中,找到要扫描的镜像。
  2. 单击 ⋮ > Scan
  3. 将显示按严重程度排序的漏洞摘要。
  4. 单击 > 查看​​每个漏洞的详细信息,其中包括漏洞详情的链接。

Adding Images

Pulling Images

此选项可以让你将镜像从镜像仓库拉取到你的虚拟机中。

要拉取镜像:

  1. 单击右上角的 + 按钮。
  2. 单击 Pull 选项卡。
  3. 输入要拉取的镜像的名称。

    注意:默认情况下,镜像是从 Docker Hub 中提取的(格式:repo/image[:tag])。要从其他镜像仓库中拉取,请包含主机名 registry.example.com/repo/image[:tag]

  4. 单击 Pull

Building Images

使用此选项构建镜像并将其添加到你的虚拟机。

要构建镜像:

  1. 单击右上角的 + 按钮。
  2. 单击 Build 选项卡。
  3. 输入构建的镜像的名称,例如 repo/imagerepo/image:tagregistry.example.com/repo/imageregistry.example.com/repo/image:tag
  4. 单击 Build
  5. 在文件浏览器中,选择要用来构建镜像的 Dockerfile。

Troubleshooting

Show Logs

使用此选项打开包含所有 Rancher Desktop 日志文件的文件夹。

Enable Debug Mode

启用 debug 级别日志记录。

Reset Kubernetes

重置 Kubernetes 并删除所有工作负载和配置。在重置之前,用户会看到确认信息以及删除容器镜像的选项。

要重置 Kubernetes:

  1. 单击 Reset Kubernetes,然后,你会看到一个确认窗口。
  2. 可选:选择是否同时删除容器镜像。
  3. 单击 Reset。Kubernetes 会停止并重新启动。

Factory Reset

删除集群和所有其他 Rancher Desktop 设置。必须再次执行初始设置流程。

要恢复出厂设置:

  1. 单击 Reset。然后,你会看到一个确认窗口。
  2. 可选:选择是否保留缓存的 Kubernetes 镜像。
  3. 单击 Factory Reset。Kubernetes 会停止,Rancher Desktop 会关闭。
  4. 可选:再次启动 Rancher Desktop。

Diagnostics

注意:Rancher Desktop 不会将诊断数据发送到任何远程服务器进行处理或存储。

Diagnostics 功能通过在后台运行多项检查来检测环境中的常见问题(例如不满足最低要求、配置错误等),帮助你自行排除和修复 Rancher Desktop 应用程序的问题。

每次启动应用程序时都会运行诊断检查。如果发现任何问题,则失败检查的数量会显示在左侧导航栏中的 Diagnostics 菜单文本的旁边。Diagnostics 选项卡会显示诊断测试的结果,突出显示需要注意的区域,并指导你解决问题。

如果你进行了非标准设置,并且知道这些检查不适用于你的情况,你可以在此选项卡上 mute/unmute 个别检查。你还可以随时重新运行诊断程序,从而验证你对环境所做的更改是否已经解决了问题。

Preferences

此页面允许你修改 Rancher Desktop 实例的设置。

  1. 要访问 Preferences,请单击右上角的 图标。
  2. 你可以使用左侧的选项卡来访问不同类别的 Rancher Desktop 首选项。
  3. 根据需要更新首选项。下方概述了可用的首选项设置。
  4. 要应用更新,请单击 Apply

Application

Automatic Updates

当一个新版本发布时,用户会得到一个通知和升级目标的发行版说明。无论是否启用了自动更新,用户都会收到通知。如果启用此选项,更新会被下载,然后在下次启动 Rancher Desktop 时安装更新。

Statistics

该选项允许 Rancher Desktop 收集关于你与 Rancher Desktop 应用程序交互的信息,但不会收集你运行的工作负载等信息。

WSL (Windows)

该选项使 Rancher Desktop Kubernetes 配置能够被任何 WSL 配置的 Linux 发行版所访问。一旦启用,你可以使用 WSL 发行版中的 kubectl 等工具与 Rancher Desktop Kubernetes 集群进行通信。

WSL 让你在所有 Linux 发行版中全局配置内存和 CPU 分配。请参阅 WSL 文档中的说明。

Virtual Machine (macOS & Linux)

Memory

分配给 Rancher Desktop 的内存。可选范围取决于你的系统。红色区域表示分配可能会影响系统服务。

CPU

分配给 Rancher Desktop 的 CPU 数量。可选范围取决于你的系统。红色区域表示分配可能会影响系统服务。

Container Runtime

为 Rancher Desktop 设置容器运行时。用户可以选择 containerd 为容器提供命名空间,也可以使用 nerdctl 或 dockerd (moby) 来启用 D​​ocker API 和 Docker CLI。一次只能运行一个容器运行时。

切换到不同的容器运行时:

  • 使用现有容器运行时构建或拉取的工作负载和镜像在切换的容器运行时不可用。

Kubernetes

Enable Kubernetes

此选项允许你启用或禁用 Kubernetes。禁用 Kubernetes 后,你可以只运行 containerddockerd 来减少资源消耗。默认情况下,Kubernetes 是启用的。

要启用/禁用 Kubernetes,只需选中/取消选中 Enable Kubernetes 复选框。启用/禁用 Kubernetes 时,该应用程序将重新启动。禁用 Kubernetes 不会删除现有资源,重新启用 Kubernetes 时,你可以再次使用这些资源。

Kubernetes Version

该选项显示了 Rancher Desktop 实例可以使用的 Kubernetes 版本列表。

升级时:

  • 会进行检查,看目标 Kubernetes 版本是否可以在本地使用。如果没有,它会下载对应文件。
  • 保留工作负载。
  • 保留镜像。

降级时:

  • 移除工作负载。
  • 保留镜像。

要切换版本:

  1. 点击 Kubernetes version 下拉菜单。
  2. 选择要转换的版本。

Kubernetes Port

设置 Kubernetes 暴露的端口。如果有多个 K3s 实例正在运行,使用此设置可以避免端口冲突。

Enable Traefik

此选项允许你启用或禁用 Traefik。禁用 Traefik 后,你可以释放端口 80 和 443,以便将其用于备用 ingress 配置。默认情况下,Traefik 是启用的。

禁用 Traefik 不会删除现有资源。