Proxmox VE 使用简单,无需安装单独的管理工具,所有操作都可以通过 Web 浏览器完成(建议使用最新 Firefox 或 Google Chrome)。内置 HTML5 控制台可用于访问客户机控制台。也可以改用 SPICE

由于使用 Proxmox cluster file system(pmxcfs),你可以连接到任意节点来管理整个集群。 每个节点都可以管理整个集群,因此不需要专用管理节点。

可以使用任何现代浏览器访问基于 Web 的管理界面。当 Proxmox VE 检测到你从移动设备连接时, 会重定向到更简单的触控式用户界面。

Web 界面可通过 https://youripaddress:8006 访问(默认登录用户为 root,密码在安装 过程中指定)。

功能

  • 对 Proxmox VE 集群进行无缝集成和管理

  • 使用 AJAX 技术动态更新资源

  • 通过 SSL 加密(https)安全访问所有虚拟机和容器

  • 快速、搜索驱动的界面,可处理数百台甚至可能上千台 VM

  • 安全的 HTML5 控制台或 SPICE

  • 面向所有对象(VM、存储、节点等)的基于角色的权限管理

  • 支持多个认证源(例如 local、MS ADS、LDAP 等)

  • 双因素认证(OATH、Yubikey)

  • 基于 ExtJS 7.x JavaScript 框架

登录

screenshot/gui-login-window.png

连接到服务器时,首先会看到登录窗口。Proxmox VE 支持多种认证后端(Realm),也可以在此处 选择语言。GUI 已翻译为 20 多种语言。

Note 可以勾选底部复选框,将用户名保存在客户端。这样下次登录时可以减少输入。

GUI 概览

screenshot/gui-datacenter-summary.png

Proxmox VE 用户界面由四个区域组成。

页眉

位于顶部。显示状态信息,并包含最重要操作的按钮。

资源树

位于左侧。可在该导航树中选择特定对象。

内容面板

位于中间区域。所选对象的配置选项和状态会显示在这里。

日志面板

位于底部。显示最近任务的日志条目。可以双击这些日志条目查看更多详情,或中止 正在运行的任务。

Note 可以缩小和展开资源树及日志面板,也可以完全隐藏日志面板。在小屏幕上工作、需要更多 空间查看其他内容时,这会很有帮助。

页眉

左上角首先看到的是 Proxmox 标志。旁边是当前运行的 Proxmox VE 版本。在附近的搜索栏中,可以 搜索特定对象(VM、容器、节点等)。有时这比在资源树中选择对象更快。

页眉右侧包含四个按钮:

Documentation

打开新的浏览器窗口,显示参考文档。

Create VM

打开虚拟机创建向导。

Create CT

打开容器创建向导。

User Menu

显示当前登录用户身份;点击后会打开包含用户专属选项的菜单。

在用户菜单中,可以找到提供本地 UI 设置的 My Settings 对话框。其下方有 TFA (双因素认证)和 Password 自助服务快捷入口。还可以找到用于更改 LanguageColor Theme 的选项。菜单底部是 Logout 选项。

我的设置

screenshot/gui-my-settings.png

My Settings 窗口允许设置本地保存的设置。其中包括 Dashboard Storages,可启用或 禁用特定存储是否计入数据中心摘要中可见的总量。如果未勾选任何存储,则总量为所有存储之和, 等同于启用每一个存储。

在仪表板设置下方,可以看到已保存的用户名、清除用户名的按钮,以及将 GUI 中所有布局重置为 默认值的按钮。

右侧是 xterm.js Settings,包含以下选项:

Font-Family

xterm.js 中使用的字体(例如 Arial)。

Font-Size

首选字体大小。

Letter Spacing

增大或减小文本中字母之间的间距。

Line Height

指定一行的绝对高度。

资源树

这是主导航树。树顶部可以选择一些预定义视图,这会改变下方树的结构。默认视图是 Server View,它显示以下对象类型:

Datacenter

包含集群范围设置(与所有节点相关)。

Node

表示集群中的主机,客户机在其上运行。

Guest

VM、容器和模板。

Storage

数据存储。

Pool

可以使用池对客户机分组,以简化管理。

可使用以下视图类型:

Server View

显示所有类型对象,并按节点分组。

Folder View

显示所有类型对象,并按对象类型分组。

Pool View

显示 VM 和容器,并按池分组。

Tag View

显示 VM 和容器,并按标签分组。

日志面板

日志面板的主要用途是显示集群中当前正在发生的事情。创建新 VM 等操作会在后台执行, 这类后台作业称为 task

此类任务的任何输出都会保存到单独的日志文件中。只需双击任务日志条目即可查看该日志。 也可以在那里中止正在运行的任务。

请注意,这里会显示所有集群节点上的最新任务。因此可以实时看到其他人何时正在另一个集群节点上 工作。

Note 为保持列表简短,我们会从日志面板中移除较旧且已完成的任务。但仍可在节点面板的 Task History 中找到这些任务。

一些短时操作只会向所有集群成员发送日志。可以在 Cluster log 面板中看到这些消息。

内容面板

在资源树中选择项目时,对应对象会在内容面板中显示配置和状态信息。以下章节会简要概述这些 功能。更多详细信息请参阅参考文档中的相应章节。

数据中心

screenshot/gui-datacenter-search.png

在数据中心级别,可以访问集群范围的设置和信息。

  • Search: 对节点、VM、容器、存储设备和池执行集群范围搜索。

  • Summary: 简要概览集群健康状态和资源使用情况。

  • Cluster: 提供创建或加入集群所需的功能和信息。

  • Options: 查看并管理集群范围默认设置。

  • Storage: 提供管理集群存储的界面。

  • Backup: 计划备份任务。该功能在集群范围内运行,因此调度时无需关心 VM/容器位于集群中的 哪个节点。

  • Replication: 查看并管理复制任务。

  • Permissions: 管理用户、组和 API token 权限,以及 LDAP、MS-AD 和双因素认证。

  • HA: 管理 Proxmox VE High Availability。

  • ACME: 为服务器节点设置 ACME(Let’s Encrypt)证书。

  • Firewall: 配置 Proxmox Firewall,并创建集群范围模板。

  • Metric Server: 为 Proxmox VE 定义外部指标服务器。

  • Notifications: 配置 Proxmox VE 的通知行为和目标。

  • Support: 显示支持订阅信息。

节点

screenshot/gui-node-summary.png

可以在该级别分别管理集群中的节点。

顶部页眉包含 RebootShutdownShellBulk ActionsHelp 等常用按钮。 Shell 包含 noVNCSPICExterm.js 选项。Bulk Actions 包含 Bulk StartBulk ShutdownBulk Migrate 选项。

  • Search: 在节点中搜索 VM、容器、存储设备和池。

  • Summary: 简要显示节点资源使用情况。

  • Notes: 使用 Markdown 语法编写自定义备注。

  • Shell: 访问节点的 shell 界面。

  • System: 配置网络、DNS 和时间设置,并访问 syslog。

  • Updates: 升级系统并查看可用的新软件包。

  • Firewall: 管理特定节点的 Proxmox Firewall。

  • Disks: 概览已连接磁盘,并管理其使用方式。

  • Ceph: 仅在主机上安装了 Ceph server 时使用。在这种情况下,可以在此管理 Ceph 集群并 查看其状态。

  • Replication: 查看并管理复制任务。

  • Task History: 查看历史任务列表。

  • Subscription: 上传订阅密钥,并生成用于支持案例的系统报告。

客户机

screenshot/gui-qemu-summary.png

客户机有两种不同类型,并且都可以转换为模板。一种是 Kernel-based Virtual Machine(KVM), 另一种是 Linux Container(LXC)。两者的导航大体相同,仅部分选项不同。

要访问各种客户机管理界面,请从左侧菜单选择 VM 或容器。

页眉包含电源管理、迁移、控制台访问和类型、克隆、HA、帮助等命令。其中一些按钮带有下拉 菜单,例如 Shutdown 还包含其他电源选项,Console 包含不同控制台类型:SPICEnoVNCxterm.js

右侧面板会显示左侧菜单中所选项目对应的界面。

可用界面如下。

  • Summary: 简要概览 VM 活动,并提供用于 Markdown 语法备注的 Notes 字段。

  • Console: 访问 VM/容器的交互式控制台。

  • (KVM)Hardware: 定义 KVM VM 可用的硬件。

  • (LXC)Resources: 定义 LXC 可用的系统资源。

  • (LXC)Network: 配置容器网络设置。

  • (LXC)DNS: 配置容器 DNS 设置。

  • Options: 管理客户机选项。

  • Task History: 查看与所选客户机相关的所有历史任务。

  • (KVM) Monitor: 与 KVM 进程交互通信的界面。

  • Backup: 创建和还原系统备份。

  • Replication: 查看并管理所选客户机的复制任务。

  • Snapshots: 创建和还原 VM 快照。

  • Firewall: 在 VM 级别配置防火墙。

  • Permissions: 管理所选客户机的权限。

存储

screenshot/gui-storage-summary-local.png

与客户机界面类似,存储界面由左侧的存储元素菜单和右侧用于管理这些元素的界面组成。

该视图采用左右两栏的分割视图。左侧是存储选项,右侧显示所选选项的内容。

  • Summary: 显示存储的重要信息,例如类型、使用情况以及存放的内容。

  • Content: 针对该存储保存的每种内容类型提供菜单项,例如 Backups、ISO Images、 CT Templates。

  • Permissions: 管理该存储的权限。

screenshot/gui-pool-summary-development.png

同样,池视图由两部分组成:左侧菜单,以及右侧每个菜单项对应的界面。

  • Summary: 显示池的描述。

  • Members: 显示并管理池成员(客户机和存储)。

  • Permissions: 管理池的权限。

标签

screenshot/gui-qemu-summary-tags-edit.png

出于组织管理目的,可以为客户机设置 tags。目前这些标签仅为用户提供信息价值。标签会显示在 Web 界面的两个位置:Resource Tree 中,以及选择客户机时的状态行中。

点击客户机状态行中的 pencil 图标,可以添加、编辑和移除标签。按 + 按钮可以添加多个 标签,按 - 按钮可以移除标签。可分别使用 x 按钮保存或取消更改。

也可以通过 CLI 设置标签,多个标签用分号分隔。例如:

# qm set ID --tags 'myfirsttag;mysecondtag'

样式配置

screenshot/gui-datacenter-tag-style.png

默认情况下,标签颜色会根据其文本以确定性方式派生。可以自定义颜色、资源树中的形状、 大小写敏感性,以及标签排序方式。这可以通过 Web 界面的 Datacenter → Options → Tag Style Override 完成,也可以通过 CLI 完成。例如:

# pvesh set /cluster/options --tag-style color-map=example:000000:FFFFFF

将标签 example 的背景颜色设置为黑色(#000000),文本颜色设置为白色(#FFFFFF)。

权限

screenshot/gui-datacenter-options.png

默认情况下,在客户机(/vms/ID)上拥有 VM.Config.Options 权限的用户可以设置任意标签 (参见 权限管理)。如果要限制此行为,可以在 Datacenter → Options → User Tag Access 下设置相应权限:

  • free: 用户设置标签不受限制(默认)

  • list: 用户可以基于预定义标签列表设置标签

  • existing: 类似 list,但用户也可以使用已经存在的标签

  • none: 用户被限制,不能使用标签

同样也可以通过 CLI 完成。

请注意,在 / 上拥有 Sys.Modify 权限的用户始终可以设置或删除任何标签,不受此处设置 影响。此外,还有一个可配置的 registered tags 列表,只有在 / 上拥有 Sys.Modify 权限的用户才能添加和移除其中的标签。registered tags 列表可以在 Datacenter → Options → Registered Tags 下编辑,也可以通过 CLI 编辑。

关于具体选项以及如何在 CLI 中调用它们的更多详情,请参见 数据中心配置

可以在 Datacenter → Options → Consent Text 中配置自定义同意横幅,用户必须先接受它 才能登录。如果没有内容,则不会显示同意横幅。该文本会以 base64 字符串形式存储在 /etc/pve/datacenter.cfg 配置文件中。