选项
- bwlimit: [clone=<LIMIT>] [,default=<LIMIT>] [,migration=<LIMIT>] [,move=<LIMIT>] [,restore=<LIMIT>]
-
为各种操作设置 I/O 带宽限制（单位为 KiB/s）。
- clone=<LIMIT>
-
克隆磁盘时的带宽限制，单位为 KiB/s。
- default=<LIMIT>
-
默认带宽限制，单位为 KiB/s。
- migration=<LIMIT>
-
迁移客户机时的带宽限制，单位为 KiB/s（包括移动本地磁盘）。
- move=<LIMIT>
-
移动磁盘时的带宽限制，单位为 KiB/s。
- restore=<LIMIT>
-
从备份还原客户机时的带宽限制，单位为 KiB/s。
- consent-text: <string>
-
登录前显示的同意文本。
- console: <applet | html5 | vv | xtermjs>
-
选择默认控制台查看器。可以使用内置 Java applet（VNC；已弃用，并映射到 html5）、外部 virt-viewer 兼容应用程序（SPICE）、基于 HTML5 的 VNC 查看器（noVNC），或基于 HTML5 的控制台客户端（xtermjs）。如果所选查看器不可用（例如虚拟机未启用 SPICE），则回退为 noVNC。
- crs: [ha=<basic|static>] [,ha-rebalance-on-start=<1|0>]
-
集群资源调度设置。
- ha=<basic | static> (default = basic)
-
配置 HA 管理器应如何选择用于启动或恢复服务的节点。使用 basic 时，只考虑服务数量；使用 static 时，会考虑服务的静态 CPU 和内存配置。
- ha-rebalance-on-start=<boolean> (default = 0)
-
设置后，当 HA 服务的请求状态从 stop 变为 start 时，使用 CRS 选择合适的节点。
- description: <string>
-
数据中心说明。显示在 Web 界面的数据中心备注面板中，并作为注释保存在配置文件内。
- email_from: <string>
-
指定发送通知时使用的发件人电子邮件地址（默认为 root@$hostname）。
- fencing: <both | hardware | watchdog> (default = watchdog)
-
设置 HA 集群的 fencing 模式。hardware 模式需要在 /etc/pve/ha/fence.cfg 中配置有效的 fence 设备。使用 both 时会同时使用两种模式。
hardware 和 both 仍为实验性功能，且处于开发中。 - ha: shutdown_policy=<enum>
-
集群范围的 HA 设置。
- shutdown_policy=<conditional | failover | freeze | migrate> (default = conditional)
-
描述节点关机或重启时处理 HA 服务的策略。Freeze 会始终冻结关机时仍位于该节点上的服务，这些服务不会由 HA 管理器恢复。Failover 不会将服务标记为冻结，因此如果关机节点未能很快重新上线（< 1 分钟），服务会恢复到其他节点。conditional 会根据关机类型自动选择；也就是说，重启时服务会被冻结，而关机时服务会保持原状，并在大约 2 分钟后被恢复。Migrate 会在触发重启或关机时尝试将所有运行中的服务移动到其他节点。只有当该节点上不再存在运行中的服务时，关机流程才会继续。如果该节点再次上线，并且期间没有发生其他迁移、重定位或恢复，服务会被移回之前关机的节点。
- http_proxy: http://.*
-
指定用于下载的外部 http 代理（示例：http://username:password@host:port/）。
- keyboard: <da | de | de-ch | en-gb | en-us | es | fi | fr | fr-be | fr-ca | fr-ch | hu | is | it | ja | lt | mk | nl | no | pl | pt | pt-br | sl | sv | tr>
-
VNC 服务器的默认键盘布局。
- language: <ar | ca | da | de | en | es | eu | fa | fr | he | hr | it | ja | ka | kr | nb | nl | nn | pl | pt_BR | ru | sl | sv | tr | ukr | zh_CN | zh_TW>
-
默认 GUI 语言。
- mac_prefix: <string> (default = BC:24:11)
-
虚拟客户机自动生成 MAC 地址时使用的前缀。默认值 BC:24:11 是 IEEE 分配给 Proxmox Server Solutions GmbH 的 Organizationally Unique Identifier（OUI），用于 MAC Address Block Large（MA-L）。允许在本地网络中使用该前缀，即公众无法直接访问的网络（例如 LAN 或 NAT/Masquerading 环境）。
请注意，当运行多个集群，并且这些集群的虚拟客户机网络存在（部分）共享时，强烈建议扩展默认 MAC 前缀，或生成一个自定义的有效前缀，以降低 MAC 冲突概率。例如，可为每个集群在 Proxmox OUI 后追加一个不同的十六进制值，如第一个集群使用 BC:24:11:0，第二个集群使用 BC:24:11:1，依此类推。 也可以通过 VLAN 等方式在逻辑上隔离客户机网络。
+ 对于可公网访问的客户机，建议注册自己的 IEEE OUI，或与你方及托管服务提供商的网络管理员协调。
- max_workers: <integer> (1 - N)
-
定义在执行 stopall VMs 或 ha-manager 任务等操作时，每个节点最多启动多少个 worker。
- migration: [type=]<secure|insecure> [,network=<CIDR>]
-
集群范围的迁移设置。
- network=<CIDR>
-
用于迁移的（子）网络 CIDR。
- type=<insecure | secure> (default = secure)
-
默认情况下，迁移流量使用 SSH 隧道加密。在安全且完全私有的网络上，可以禁用此加密以提高性能。
- migration_unsecure: <boolean>
-
默认情况下，迁移会通过 SSH 隧道保障安全。对于安全的私有网络，可以禁用该机制以加快迁移速度。此项已弃用，请改用 migration 属性。
- next-id: [lower=<integer>] [,upper=<integer>]
-
控制空闲 VMID 自动选择池的范围。
- lower=<integer> (default = 100)
-
空闲 next-id API 范围的下边界，包含该值。
- upper=<integer> (default = 1000000)
-
空闲 next-id API 范围的上边界，不包含该值。
- notify: [fencing=<always|never>] [,package-updates=<auto|always|never>] [,replication=<always|never>] [,target-fencing=<TARGET>] [,target-package-updates=<TARGET>] [,target-replication=<TARGET>]
-
集群范围的通知设置。
- fencing=<always | never>
-
未使用 - 请改用数据中心通知设置。
- package-updates=<always | auto | never> (default = auto)
-
已弃用：请改用数据中心通知设置。 控制每日更新任务发送通知的频率：
-
auto 对具有有效订阅的系统每天发送一次，因为这些系统被认为已用于生产环境，因此应了解待处理更新。
-
always 每次更新时，如果存在新的待处理更新，则发送通知。
-
never 不对新的待处理更新发送通知。
-
- replication=<always | never>
-
未使用 - 请改用数据中心通知设置。
- target-fencing=<TARGET>
-
未使用 - 请改用数据中心通知设置。
- target-package-updates=<TARGET>
-
未使用 - 请改用数据中心通知设置。
- target-replication=<TARGET>
-
未使用 - 请改用数据中心通知设置。
- registered-tags: <tag>[;<tag>...]
-
设置和删除时需要对 / 拥有 Sys.Modify 权限的标签列表。在此设置且同时出现在 user-tag-access 中的标签也需要 Sys.Modify。
- tag-style: [case-sensitive=<1|0>] [,color-map=<tag>:<hex-color>[:<hex-color-for-text>][;<tag>=...]] [,ordering=<config|alphabetical>] [,shape=<enum>]
-
标签样式选项。
- case-sensitive=<boolean> (default = 0)
-
控制在更新时过滤唯一标签是否区分大小写。
- color-map=<tag>:<hex-color>[:<hex-color-for-text>][;<tag>=...]
-
标签的手动颜色映射（用分号分隔）。
- ordering=<alphabetical | config> (default = alphabetical)
-
控制 Web 界面和 API 更新中的标签排序。
- shape=<circle | dense | full | none> (default = circle)
-
Web UI 树中的标签形状。full 绘制完整标签。circle 只绘制带背景色的圆点。dense 只绘制一个小矩形（当每个客户机分配了大量标签时很有用）。none 禁用标签显示。
- u2f: [appid=<APPID>] [,origin=<URL>]
-
u2f
- appid=<APPID>
-
U2F AppId URL 覆盖值。默认为 origin。
- origin=<URL>
-
U2F Origin 覆盖值。主要适用于使用单一 URL 的单节点环境。
- user-tag-access: [user-allow=<enum>] [,user-allow-list=<tag>[;<tag>...]]
-
用户可设置标签的权限选项。
- user-allow=<existing | free | list | none> (default = free)
-
控制用户可在其管理的资源（如客户机）上设置或删除哪些标签。对 / 拥有 Sys.Modify 权限的用户始终不受限制。
-
none 不允许使用任何标签。
-
list 允许使用 user-allow-list 中的标签。
-
existing 与 list 类似，但资源上已存在的标签也可使用。
-
free 不限制标签。
-
- user-allow-list=<tag>[;<tag>...]
-
当 user-allow 的值为 list 或 existing 时，允许用户设置和删除的标签列表（用分号分隔）。
- webauthn: [allow-subdomains=<1|0>] [,id=<DOMAINNAME>] [,origin=<URL>] [,rp=<RELYING_PARTY>]
-
webauthn 配置。
- allow-subdomains=<boolean> (default = 1)
-
是否允许 origin 为子域名，而不是必须精确匹配 URL。
- id=<DOMAINNAME>
-
Relying party ID。必须是不包含协议、端口或路径的域名。更改此项*会*破坏现有凭据。
- origin=<URL>
-
站点 origin。必须是 https:// URL（或 http://localhost）。应包含用户在浏览器中输入以访问 Web 界面的地址。更改此项*可能*破坏现有凭据。
- rp=<RELYING_PARTY>
-
Relying party 名称。可使用任意文本标识符。更改此项*可能*破坏现有凭据。
版权和免责声明
Copyright © 2022-2025 成都市梨儿方信息技术有限责任公司.
本程序是自由软件：你可以依据自由软件基金会发布的 GNU Affero General Public License 条款重新分发和/或修改本程序；可使用该许可证第 3 版，或（由你选择）任何后续版本。
发布本程序是希望它能够有用，但不提供任何担保；甚至不包含对适销性或特定用途适用性的默示担保。更多详情请参见 GNU Affero General Public License。
你应当已经随本程序收到一份 GNU Affero General Public License 的副本。如果没有，请访问： https://www.gnu.org/licenses/
Copyright © 2007-2022 Proxmox Server Solutions GmbH
本程序是自由软件：你可以依据自由软件基金会发布的 GNU Affero General Public License 条款重新分发和/或修改本程序；可使用该许可证第 3 版，或（由你选择）任何后续版本。
发布本程序是希望它能够有用，但不提供任何担保；甚至不包含对适销性或特定用途适用性的默示担保。更多详情请参见 GNU Affero General Public License。
你应当已经随本程序收到一份 GNU Affero General Public License 的副本。如果没有，请访问： https://www.gnu.org/licenses/