一个控制台,许多客户

如果你替别人照看 Proxmox,那么每个新节点都是同一件活,只是每次做法略有不同。 每个客户都有自己的国家、时区、root 密钥、磁盘布局、主机命名和订阅密钥。 新节点上错了其中任何一项,你要么在第一次有人登录时发现,要么在第一次审计问为什么时钟差了一小时时发现。

我是为一个正好有这个问题的客户搭的这套东西,他们的要求朴素得让人舒心。 每个站点都按自己的命名、自己的 root 密码和自己的 SSH 密钥来构建。 站点上的人不用做任何花哨的事:把服务器上架,插进正确的 VLAN,开机。 没人去收集序列号,也没人为每台机器写应答文件。 而这样加进来的服务器,最终要进入该站点现有的集群。

他们要的这里由什么来实现
站点自己的命名、密码和密钥每个站点一份预备应答,由该站点的令牌选中
插进正确的 VLAN,开机,走人DNS 发现、iPXE,以及 Caddy 按源子网选择令牌
不要序列号,不要每台机器一份应答文件应答只按产品过滤;站点信息来自网络
新服务器加入现有集群不在本文范围:PDM 没有首次启动钩子,见下文

本文讲前三项:让一台裸服务器从开机走到一个装好的 Proxmox 节点,并带上正确站点的设置。 这一半几乎任何拥有不止一个站点的人都会碰到,不管是不是 MSP,所以值得单独成篇。 加入集群是另一件活,讲缺失的首次启动钩子那一节会解释为什么 PDM 目前还替你做不了。

Proxmox Datacenter Manager(PDM)1.1 补上了缺失的那一块1。 它现在可以充当 Proxmox 自动安装程序的应答服务器,于是一台裸机启动后,上报自己是什么,拿回一份预备好的应答,然后在控制台前没有人的情况下自行安装。 对一个已经把 PDM 当作管理控制台在用的托管服务提供商(MSP)来说,这显然就是存放每个客户安装设置的地方。

你不想要的是每个客户一台 PXE 服务器。 每一台都是一个简单文件传输协议(TFTP)服务器、一份 DHCP 配置、一套启动文件,外加一个每次 Proxmox 发布小版本都要重建的 ISO。 十个客户就是十套这样的东西要保持更新。 这扩展不了。 这里的目标是一套 PXE 环境:一个启动镜像、一条 DNS 记录、一个 PDM,而每个站点仍然拿到自己的应答。

所有站点一套 PXEsite110.10.50.0/24site210.20.50.0/24site310.30.50.0/24443 上的 Caddy进:通用令牌出:站点令牌,按子网选择PDM应答按令牌限定8443 在回环上所有站点共用一个启动镜像、一条 DNS 记录和一个 DHCP 服务
最终设计。每个站点都启动同一个镜像。Caddy 按子网判断请求来自哪个站点,把该站点的令牌交给 PDM,而 PDM 只提供限定于该令牌的应答。

PDM 1.1 自己就能走完大部分路。 它在两处做不到,在你围绕它规划部署之前,这两处都值得知道:它没有办法把应答匹配到一个站点,也没有办法给新节点一个首次启动脚本。 本文用 PDM 自己的源代码证明这两点,绕过第一点,并在我实验室里运行 1.1.9 的 PDM 上把整套东西搭起来,代理经过加固,保存机密的部分都关得严严实实。

PDM 1.1 给了你什么

这个功能位于 Remotes → Automated Installations,分三部分:安装记录、预备应答和认证令牌2。 预备应答就是 PDM 版本的安装程序 answer.toml,通过表单填写,而不是手写。

部分作用要紧的细节
预备应答国家、键盘、时区、root 密码哈希、SSH 密钥、网络、磁盘布局、订阅密钥、安装后动作每次请求都重新渲染
目标过滤器决定哪台机器拿哪份应答用 JSON Pointer 指向安装程序的系统信息,值用通配符匹配3
模板FQDN、管理员邮箱、IP、网关和 DNS 字段里可用 MiniJinjainstallation_nr 这类计数器每送出一次应答就加一4
认证令牌安装程序发送 Authorization: Bearer <name>:<secret>与 PDM 的 API 令牌是不同类型;每份应答列出它接受的令牌2
安装记录每次请求一条记录,带完整系统信息安装后 webhook 回调时从进行中变为已完成
权限查看要 Sys.Audit,修改要 Sys.Modify都在 /system/auto-installation 上4

安装程序这一侧早就有了。 proxmox-auto-install-assistant prepare-iso 命令会构建一个通过 HTTP 获取应答的 ISO;从 Proxmox VE 9.2 的 ISO 起,它还能生成 iPXE 通过网络启动整套东西所需的内核、initrd、ISO 和 boot.ipxe5。

计数器是单独一个 answer.toml 完全没有的东西。 一份预备应答就能给它构建的每台主机编号,而静态文件得每台机器复制一份。 这是实打实的进步,但仍然只是初版。 表单还没赶上独立的应答文件6,而且有一块完全缺失:1.1 里没有任何形式的首次启动脚本7。 这个缺口,以及它无法匹配的站点,就是接下来两节的内容。

它无法按站点匹配

PDM 挑选应答的方式,是用过滤器去比对安装程序上报的系统信息。 所以问题在于那份文档里有什么,因为不在里面的东西就没法匹配。

键内容能否指明站点?
productfullname、product(pve、pbs、pmg)、enable_btrfs不能
isorelease、isorelease不能
dmi系统、主板和机箱:名称、序列号、UUID、SKU、资产标签只有有人把站点写进资产标签时才能
network_interfaces{link, mac} 的列表只能通过你自己维护的清单

全部就这些8,9。 没有地址,没有主机名,没有 DHCP 选项,没有任何关于这台机器插在哪里的信息。

桌面管理接口(DMI)字段看上去很有希望,直到你读到真实的值。 我实验室里的每一次安装,系统名称都是 Standard PC (Q35 + ICH9, 2009),序列号和资产标签都是空的。 真实服务器会填这些字段,但填的是厂商放进去的东西,不是你客户的名字;而按序列号或 MAC 地址匹配,只有在你维护一份将来要安装的每一台机箱的清单时才行得通,而这恰恰是这套东西本该省掉的记账活。 按主机,可以。按站点,不行。

那么这台机器插在哪个网络上?PDM 永远不知道。 安装程序上报时手里就握着它的 DHCP 租约,而 MSP 对一个新节点唯一确知的事实,偏偏就是它丢下不报的那一个。 按源地址匹配(IPv4 或 IPv6)是一个尚未处理的功能请求,是我自己提的,编号 826310。

选择规则里还藏着第二个限制,我的实验室一头撞了上去。

PDM 如何挑选应答1. 令牌有效?已启用,未过期否约半秒后返回 401不记录2. 该令牌上的应答按文件顺序,别无其他3. 过滤器全部匹配?只匹配字符串,可用通配符第一个渲染应答其上每个计数器加 1都不4. 该令牌上有默认应答?整个 PDM 只有一个默认应答否400: no answer file found记录在 Installations 下
PDM 的选择逻辑,取自源代码。令牌最先检查,并限定其后的一切,包括默认应答。

令牌最先检查,只有授权给该令牌的应答才会被考虑,包括默认应答4。 PDM 整个系统只允许一个默认应答。 所以你没法用默认标志给每个站点各自一个兜底。 我的实验室有一个叫 fallback 的默认应答,挂在它自己的令牌上,它一次都没被送出过,因为从来没有东西发送那个令牌。 每个站点需要的是在自己的令牌上放一个全匹配过滤器,比如 /product/product=*,放在文件最后。

同一份代码里还有两件事,排错时值得记在脑子里:

  • 按文件顺序,第一个匹配胜出,第二个匹配只记一条警告。从 1.1.1 起就是这个规则11。
  • 过滤器只匹配字符串。 /product/enable_btrfs 是布尔值,永远匹配不上任何东西;数组需要索引,比如 /network_interfaces/0/mac。

在 1.1.9 上,未知或过期的令牌会在故意延迟约半秒后得到 401,而且不留任何记录。 有效令牌但没有任何匹配,会得到 400,正文是 no answer file found,而这次尝试会被记录,连同完整的系统信息。 在为一台新机箱写过滤器之前,那条记录是读出它真实序列号和 MAC 地址的最快办法。

它无法运行首次启动脚本

安装程序本身支持首次启动钩子。 应答可以带一个 [first-boot] 段,source = "from-iso" 或 "from-url",顺序可选 before-network、network-online 或 fully-up,另有一个可选的证书指纹9。 prepare-iso --on-first-boot 会为 from-iso 的情况把脚本嵌入 ISO。

PDM 从不发送这个段。 一次都没有。 安装程序自己的应答类型有这个字段,first_boot: Option<FirstBootHookInfo>12。 PDM 的预备应答根本没有对应字段,而由它构建应答的代码无条件写入 first_boot: None4。 表单里没有,API 里没有,配置文件里也没有你能手工加的东西。 这是一个尚未处理的功能请求,编号 7699,2026年6月提交,写本文时仍无人认领7。 将近五个月过去,Proxmox 一个回复都没有,8263 也一样。 这种沉默才是让人担心的地方。有人花时间写下你的产品可以如何改进,就该得到一个答复,哪怕答复是不行,这是起码的职业礼貌。 更何况写信来的人是付费客户和合作伙伴,他们在投入时间之前,就已经在这个产品上投了钱。

而 ISO 上的脚本也救不了你。 安装程序只在 if let Some(first_boot) = &answer.first_boot 时才设置首次启动服务,而那是唯一会读取嵌入文件的路径13。 你嵌入一个永远不会有应答来要的脚本,prepare-iso 不会给任何警告。 它就躺在 ISO 上,什么也不干。

首次启动的缺口ISO 上的脚本prepare-iso --on-first-boot来自 PDM 的应答first_boot: None,始终如此安装程序设置首次启动钩子仅当应答带有[first-boot]脚本留在 ISO 上永远不运行,也没有警告
两半都到达了安装程序,而来自 PDM 的那一半从不要求这个钩子。ISO 上的脚本是死重。

这对 MSP 来说比对任何人都更要紧。 安装程序产出的节点是一个裸系统,带一个哈希过的 root 密码和几把 SSH 密钥。 它不是 PDM 的 remote,不在任何集群里,你的监控、软件源和存储一样都没有。 在我的实验室里,三个节点都装完并回报了,PDM 里的 SITEA remote 事后还是得手工添加。

所以无论你用什么来收尾一个节点,Ansible 也好,别的也好,都得从外部触发:从安装后 webhook,从一个盯着安装列表的作业,或者由一个人来做。 我就讲到这里。 本文讲的是让一套 PXE 环境服务所有站点,而首次启动的缺口是要绕着规划的限制,不是我打算在这里糊过去的东西。

令牌就是站点

PDM 看不见站点,但它确实按令牌限定应答,而令牌不过是一个请求头。 谁设置这个请求头,谁就决定安装程序能拿到哪一组应答。 整个窍门就这么简单。

所以在 PDM 前面放一个知道请求从哪里来的东西:

  1. 启动镜像携带一个通用令牌,catch-all:not-a-secret,每个镜像里都一样,就公开在这里。它不是 PDM 令牌,自己什么都打不开。
  2. PDM 前面的 Caddy 反向代理查看携带通用令牌的应答请求的源子网,把请求头换成该站点真正的令牌。
  3. PDM 看到的是 site2-2026q4:<secret>,于是只提供 site2 的应答。

机密从不靠近启动镜像,所以丢一个 U 盘或者被人复制一份 ISO,谁也得不到任何东西。 轮换一个站点的令牌是改 Caddy,不是重建镜像。 而增加一个站点,就是一行 Caddy 配置加 PDM 里一个新令牌。

这依赖于源地址是诚实的,而这是你网络的属性,不是代理的属性。 这个取舍和其他取舍都列在下文“还剩什么要决定”里。

镜像里不写 URL,安装程序怎么找到 PDM

所有站点一个镜像,前提是镜像里也不带 PDM 的地址。 安装程序按顺序在三个地方找它的应答 URL14:

安装程序从哪里找到应答 URL1. ISO 里写死了 URL?prepare-iso --url是采用,不再问 DHCP 和 DNS每个 PDM 一个镜像:本文避免否2. DHCP option 250?从安装程序的租约中读取是采用,并用 option 251 提供指纹:本文不发送否,或任何 DHCP 错误3. DNS TXT 查询搜索域取自 resolv.confproxmox-auto-installer.example.docURL 和指纹都来自 DNS
安装程序遵循的顺序。镜像里不写 URL,也不发送 option 250,每个站点都会落到 DNS。
规则代码做了什么对你意味着什么
顺序ISO 里的 URL 优先;其次 DHCP;任何 DHCP 失败都退回 DNS14构建镜像时不加 --url,任何地方都不发送 option 250
记录名URL 用 proxmox-auto-installer.<search domain>,指纹用 proxmox-auto-installer-cert-fingerprint.<search domain>一个区,两条 TXT 记录
搜索域/etc/resolv.conf 的第一行 search,按单个空格切分只下发一个域;两个会变成一个无效名称
没有域以 Could not find search domain in resolv.conf. 失败检查 DHCP option 15 或 119 有没有发出
TXT 值dig txt +short,去掉所有 ",再去首尾空白TXT 值拆成多个字符串会在 URL 里留下空格;保持为一个字符串
指纹只有 URL 也来自 DNS、且镜像里没写死指纹时才从 DNS 取发布 PDM 的证书指纹,Caddy 提供的也是这张证书
令牌以 Authorization: Bearer <token> 发送,以明文存放在 ISO 上9这就是镜像只带通用令牌的原因

安装程序检查的证书,是在 443 上应答的那一张。 在这个设计里,Caddy 在那里提供 PDM 自己的证书,所以客户端在 443 上看到的证书和 PDM 在 8443 上的一样,只需要发布一个指纹。

动手搭建:PDM、启动文件和 DNS

示例使用域名 example.doc 和三个站点:10.10.50.0/24、10.20.50.0/24 和 10.30.50.0/24。 .doc 不是真实的顶级域名,换成你自己的。 PDM、Caddy、dnsmasq 和启动文件都在一台主机上,pdm.example.doc,地址 10.10.50.10,远程站点通过网关上的 DHCP 中继到达它。 管理网络是 10.99.0.0/24,因此也是唯一能看到 PDM 网页界面的网络。

PDM 里的令牌和应答

在 Remotes → Automated Installations → Authentication Tokens 下,为每个站点加一个令牌,过期时间与你的部署窗口对齐。 名称不是机密,而且会出现在日志里,所以让它有点意义:site1-2026q4。 密钥显示时就复制下来。

然后为每个站点的每个产品加一份预备应答,只授权给该站点的令牌:

字段site1,Proxmox VE
授权令牌site1-2026q4
目标过滤器/product/product=pve
国家、键盘、时区gb、en-gb、Europe/London
Root 访问SSH 密钥,外加通过表单设置的密码,PDM 只以哈希形式存储和发送4
网络DHCP,固定网卡名称
FQDN{{ product.product }}-site1-{{ installation_nr }}.example.doc
磁盘你的布局,例如两块指定磁盘上的 ZFS 镜像
安装后 webhook基础 URL https://pdm.example.doc,带 PDM 的证书指纹

每送出一次应答计数器就加一,重试也算,所以名字可能跳号。 我实验室的计数器在三次完成安装后停在 4。 如果你需要可预测的名字,就用 FQDN from DHCP,把主机名放到 DHCP 预留里。

webhook 基础 URL 是这个设计里唯一必须改的设置。 很自然会把它指向 PDM 本身的 8443 端口,我实验室原来就是这样,而 8443 马上就要关掉。 把它指向 Caddy。

启动文件

在任何装了 Proxmox 软件源的 Proxmox VE 或 Debian 主机上:

apt install proxmox-auto-install-assistant xorriso
mkdir -p /srv/www/pve-9.2
proxmox-auto-install-assistant prepare-iso proxmox-ve_9.2-1.iso \
  --fetch-from http \
  --answer-auth-token 'catch-all:not-a-secret' \
  --pxe-loader ipxe \
  --output /srv/www/pve-9.2/

不加 --url,因为 DNS 会提供。 --pxe-loader ipxe 隐含 --pxe,而有了 --pxe,输出必须是一个已经存在的目录15。 你会得到四个文件:vmlinuz;initrd.img,从 zstd 重新压缩为 gzip,因为 iPXE 加载不了 zstd 的 initrd;去掉了 /boot 的预备 ISO;以及一个 boot.ipxe 菜单,十秒后默认进入自动安装,并以相对名称引用其他文件15。 四个文件放在同一个目录里。

每台目标机需要足够的内存来容纳内核、initrd 和整个 ISO。 Proxmox VE 9.2 的说明写的是 “at least 6 GiB of available memory on the host”5。 同一份说明还列出一个已知问题:9.2 ISO 的内核在 megaraid_sas 控制器以及部分处于 JBOD(just a bunch of disks)模式的 NVMe 盘上有问题,建议用 9.1 ISO 安装后再升级5。 在把网络路径托付给你的硬件之前,先测一测。

DNS 记录

在与 DHCP 下发的那唯一一个搜索域相对应的区里:

$ORIGIN example.doc.
pdm                                      IN A    10.10.50.10
proxmox-auto-installer                   IN TXT  "https://pdm.example.doc/api2/json/auto-install/answer"
proxmox-auto-installer-cert-fingerprint  IN TXT  "63:C4:D6:...:85:07"

指纹是 PDM 自己的证书:

openssl x509 -in /etc/proxmox-datacenter-manager/auth/api.pem -noout -fingerprint -sha256

按安装程序的方式检查它们:

dig txt +short proxmox-auto-installer.example.doc @10.10.50.10
# one quoted string, nothing split

Caddy,进入 PDM 的唯一一扇门

PDM 的 API 监听 [::]:8443,这是编译进二进制的常量,不是一个设置项16。 你没法把它绑定到回环地址。 所以 Caddy 成为唯一的入口,防火墙来确保这一点。

PDM 前面的 Caddy 路由请求结果应答 POST,站点子网,通用令牌改写为该站点的令牌post-hook POST,站点子网去掉 Authorization,放行网页界面或 API,管理子网原样放行,需 PDM 登录其他一切,来自任何地方中止,永远到不了 PDM8443 端口,来自本机之外被 nftables 丢弃
Caddy 看到的每个请求都落到五个去处之一。只有前三个会到达 PDM。

PDM 恰好有两条不需要 PDM 登录就能用的路由:带安装程序令牌的 POST /api2/json/auto-install/answer,以及正文里带一次性令牌的 POST …/installations/{uuid}/post-hook4。 置备网络应该能到达的,只有这两条。

使用 Caddy 2.11.1 或更高版本。 2.11.1 修复了一个路径匹配器绕过漏洞 CVE-2026-27587,而这正是本方案所依赖的那种路径把关17。 Debian 13 自带的软件包是 2.6.2,所以从 trixie-backports(带 2.11.2)或 Caddy 自己的软件源获取18。

Caddyfile,/etc/caddy/Caddyfile:

{
	# the admin API on a socket only root can open, never on TCP
	admin unix//run/caddy/admin.sock|0600
	auto_https disable_redirects
	servers {
		protocols h1 h2
	}
}

# PDM itself, on the loopback, trusted by its own certificate
(pdm_upstream) {
	reverse_proxy https://[::1]:8443 {
		transport http {
			tls_trust_pool file /etc/proxmox-datacenter-manager/auth/api.pem
			tls_server_name pdm.example.doc
		}
	}
	log_append pdm_status {http.reverse_proxy.status_code}
}

# one site: name, subnet, PDM token name, PDM token secret
(site) {
	@{args[0]} {
		method POST
		path /api2/json/auto-install/answer
		remote_ip {args[1]}
		header Authorization "Bearer catch-all:not-a-secret"
	}
	handle @{args[0]} {
		log_append site {args[0]}
		log_append pdm_token {args[2]}
		request_header Authorization "Bearer {args[2]}:{args[3]}"
		import pdm_upstream
	}
}

pdm.example.doc, 10.10.50.10 {
	tls /etc/proxmox-datacenter-manager/auth/api.pem /etc/proxmox-datacenter-manager/auth/api.key

	import site site1 10.10.50.0/24 site1-2026q4 {env.PDM_SECRET_SITE1}
	import site site2 10.20.50.0/24 site2-2026q4 {env.PDM_SECRET_SITE2}
	import site site3 10.30.50.0/24 site3-2026q4 {env.PDM_SECRET_SITE3}

	@post_hook {
		method POST
		path /api2/json/auto-install/installations/*/post-hook
		remote_ip 10.10.50.0/24 10.20.50.0/24 10.30.50.0/24
	}
	handle @post_hook {
		request_header -Authorization
		import pdm_upstream
	}

	# the PDM web UI and API, from the management network only
	@mgmt remote_ip 10.99.0.0/24
	handle @mgmt {
		import pdm_upstream
	}

	# anything else, from anywhere, never reaches PDM
	handle {
		abort
	}

	log {
		output file /var/log/caddy/pdm.log
		format filter {
			request>headers>Csrfpreventiontoken replace REDACTED
		}
	}
}

# boot files, to the sites and management only
http://:80 {
	@hidden path_regexp /\.
	handle @hidden {
		abort
	}
	@boot remote_ip 10.10.50.0/24 10.20.50.0/24 10.30.50.0/24 10.99.0.0/24
	handle @boot {
		root * /srv/www
		file_server
	}
	handle {
		abort
	}
}

承担安全职责的部分,以及各自存在的理由:

行原因
站点匹配器里的 header Authorization "Bearer catch-all:not-a-secret"没有它,来自站点子网的任何 POST 都会拿到真令牌;请求必须既来自正确的子网,又携带通用令牌
request_header Authorization …设置请求头,覆盖客户端发来的任何值,所以伪造的令牌会被替换,绝不会被转发19
remote_ip直接对端;安装程序和 Caddy 之间不要放 NAT 或负载均衡器20
命名的 handle 块按书写顺序保留且互斥,所以裸的 handle { abort } 是最终裁决21
@mgmt完整的 PDM 界面和 API,原样不动,所以 PDM 自己的登录、API 令牌和 cookie 照常工作;站点子网一样都拿不到
admin unix//…|0600管理 API 默认监听 TCP localhost:2019,没有任何认证22
protocols h1 h2Caddy 默认在 UDP 443 上监听 HTTP/322;这一行把它关掉,而不是留着一个谁也没打算开的端口
@hiddenfile_server 会提供其根目录下的每个文件,包括点文件,而文档明确说 hide 不是安全边界23
Csrfpreventiontoken replace REDACTEDCaddy 默认会在访问日志里遮蔽 Authorization 和 Cookie,但不遮蔽 PDM 的 CSRF 请求头24

路径匹配器比 PDM 宽松,这个方向是对的。 Caddy 在匹配之前会清理路径、解码百分号编码、合并重复斜杠并忽略大小写20。 所以 //answer、%61nswer 和 ANSWER 都算作应答路由,而 /api2/extjs/… 变体或末尾斜杠匹配不上站点路由,会落到 abort。

里面有两个选择需要解释。

Caddy 直接从 PDM 的文件提供 PDM 的证书。 Caddy 在 PDM 存放 api.pem 和 api.key 的地方读取它们,所以安装程序、webhook 和浏览器看到的都是 PDM 在 8443 上出示的证书,也没有第二份副本会走样。 给它这个访问权限的显而易见的办法,是把 caddy 用户加进 www-data。 我在实验室里检查了这个组成员身份实际能碰到什么,以 caddy 用户逐个测试文件:

/etc/proxmox-datacenter-manager/ 下的文件www-data 里的 caddy 能否读取
remotes.shadow,每个受管 remote 的凭据能
autoinst/tokens.shadow,每个安装程序令牌的密钥能
auth/api.key、auth/csrf.key能
access/user.cfg、subscriptions/能

这张清单里没有一样东西该靠近网页代理。 那样的话,代理里的一个 bug 就等于 PDM 管理的每一个集群都被攻破。

所以 Caddy 不进 www-data,只在它需要的那两个文件上拿一条 ACL,外加穿过其上两级目录、但不能列出目录内容的权限:

#!/bin/sh
# /usr/local/sbin/pdm-cert-acl
# let Caddy read PDM's certificate and key in place, and nothing else of PDM's
set -e
D=/etc/proxmox-datacenter-manager; A=$D/auth
setfacl -m u:caddy:x "$D" "$A"
setfacl -m u:caddy:r "$A/api.pem" "$A/api.key"

运行之后,在实验室里以 caddy 用户测试:

路径caddy
auth/api.pem、auth/api.key能读
auth/csrf.key、auth/authkey.key、auth/authkey.pub不能读
remotes.shadow、remotes.cfg、autoinst/tokens.shadow、access/user.cfg不能读
列出 auth/被拒绝

问题出在续期上。 PDM 把续期后的证书写到一个新文件,再重命名到位,而新文件不会带上旧文件的 ACL。 所以 PDM 续期时,由 systemd 把 ACL 补回去并重载 Caddy,不需要任何人参与。

检查证书和私钥是否配对,因为续期时它们是一个接一个写入的:

#!/bin/sh
# /usr/local/sbin/pdm-cert-pair-ok
# exit 0 only when PDM's certificate and key belong together
d=/etc/proxmox-datacenter-manager/auth
c=$(openssl x509 -noout -pubkey -in "$d/api.pem") || exit 1
k=$(openssl pkey -pubout -in "$d/api.key") || exit 1
[ "$c" = "$k" ]

一个同时监视两个文件的 path 单元,以及它启动的服务:

# /etc/systemd/system/caddy-pdm-cert.path
[Unit]
Description=Watch the PDM certificate and key for renewal

[Path]
PathChanged=/etc/proxmox-datacenter-manager/auth/api.pem
PathChanged=/etc/proxmox-datacenter-manager/auth/api.key
Unit=caddy-pdm-cert.service

[Install]
WantedBy=multi-user.target

# /etc/systemd/system/caddy-pdm-cert.service
[Unit]
Description=Let Caddy read the renewed PDM certificate in place, then reload Caddy

[Service]
Type=oneshot
ExecCondition=/usr/local/sbin/pdm-cert-pair-ok
ExecStart=/usr/local/sbin/pdm-cert-acl
ExecStart=/usr/bin/systemctl try-reload-or-restart caddy.service
apt install acl
systemctl daemon-reload
systemctl enable --now caddy-pdm-cert.path

下文的覆盖配置会在每次 Caddy 启动前运行同一个 ACL 脚本,所以即使续期发生在 Caddy 停止期间,也不会漏掉。

让它运转起来的细节,每一项都验证过:

组件原因
两个文件都监视第一次写入触发单元;在两者不匹配期间条件会跳过它,第二次写入时以匹配的一对再次触发
ExecCondition条件失败会跳过本次运行而不是让它失败,所以写了一半的续期永远到不了 Caddy25
PathChanged被监视的文件以写方式打开后关闭时触发26;在实验室里,新文件重命名覆盖旧文件时也会触发
每次运行都执行 ACL 脚本重命名进来的文件没有 ACL,脚本再次运行之前 Caddy 读不了它
try-reload-or-restartCaddy 在运行就重载,不在运行就什么也不做
Caddy 单元里的 reload --force不加 --force,Caddy 看到配置相同,会继续提供旧证书

最后一行不是猜的。 我在一个一次性的 Caddy 2.11.7 容器里,在服务器运行时替换了证书文件:普通的 caddy reload 继续提供旧证书,caddy reload --force 提供了新证书。 打包的单元本来就用 --force 重载27,所以如果你覆盖 ExecReload,保留那一行。

在实验室里,我按续期的方式替换了 PDM 的 api.key 和 api.pem:写入新文件,再重命名覆盖旧文件。 刚重命名完,api.key 上没有 caddy 的 ACL 条目。 四秒之内,path 单元已经触发,两个文件的 ACL 都回来了,Caddy 原地重载,进程 ID 不变。

令牌名称和密钥分开存放。 名称写在 Caddyfile 里,会被记录到日志。 密钥放在只有 root 能读的环境文件里,Caddy 在请求时通过 {env.*} 读取。

记录用了哪个令牌,绝不记录密钥

我实验室的第一版就泄露了。 Caddy 打包的单元以 caddy run --environ 启动它,而 --environ 会在启动前打印整个环境28,27。 每次重启都把站点令牌以明文写进 journal:我数的时候已经有八行。 访问日志里没有,PDM 自己的日志里也没有,全都来自那一个参数。

令牌密钥和令牌名称的去向密钥pdm-secrets.env仅 root,0600Caddy 的环境{env.PDM_SECRET_SITE1}Authorization 请求头只在通往 PDM 的回环一跳名称Caddyfile 中的import 行访问日志,每个应答请求"pdm_token":"site1-2026q4"从不写入journal已去掉 --environ管理 APIunix 套接字,0600配置导出只有占位符
密钥只有一个用途、一条路径。记录日志用的是名称。

所以密钥文件只放密钥,别的什么都不放:

install -m 0600 /dev/null /etc/caddy/pdm-secrets.env
printf 'PDM_SECRET_SITE1=%s\nPDM_SECRET_SITE2=%s\nPDM_SECRET_SITE3=%s\n' \
  '<secret1>' '<secret2>' '<secret3>' > /etc/caddy/pdm-secrets.env

而单元覆盖配置去掉 --environ,并给管理套接字安个家:

# systemctl edit caddy
[Service]
EnvironmentFile=/etc/caddy/pdm-secrets.env
RuntimeDirectory=caddy
RuntimeDirectoryMode=0700
# PDM's certificate and key, read where PDM keeps them
ExecStartPre=+/usr/local/sbin/pdm-cert-acl
# the access log directory and its files belong to Caddy
ExecStartPre=+/usr/bin/install -d -o caddy -g caddy -m 0750 /var/log/caddy
ExecStartPre=+/usr/bin/chown -R caddy:caddy /var/log/caddy
ExecStart=
ExecStart=/usr/bin/caddy run --config /etc/caddy/Caddyfile
ExecReload=
ExecReload=/usr/bin/caddy reload --config /etc/caddy/Caddyfile --force

+ 让这几行在 Caddy 以自己的用户启动之前以 root 运行。 一旦有别的东西碰 /var/log/caddy,这几行日志相关的配置就要紧了:被 root 轮转的日志,或者测试时手工创建的文件,都会让 Caddy 打不开自己的访问日志。 在实验室里我把 pdm.log 设成 root:root 再重启 Caddy;它变回了 caddy:caddy,Caddy 没有记录任何权限错误。

改完之后要重启而不是重载,因为重载不会重新读取环境。 用 {env.NAME},绝不要用 {$NAME}:后一种形式在适配 Caddyfile 时就被替换掉,于是密钥会落进 JSON 配置、自动保存文件以及任何导出它们的东西里29。 管理套接字在这里也要紧。 {env.*} 会解析进程环境里的任何变量,没有白名单,所以任何能通过 TCP 管理 API 加载配置的人,都能让 Caddy 把密钥读回给他们30。

现在访问日志里的每一行应答都写明站点和令牌,而请求头本身被遮蔽。以下来自实验室,两者都叫 siteA:

{"site":"siteA","pdm_token":"siteA","pdm_status":400,"status":400,
 "request":{"headers":{"Authorization":["REDACTED"]}}}

我验证过,而不是相信它。 先在这份配置的一个 podman 副本上用假密钥,再在实验室上,我把能想到的每条路径都走了一遍发送应答:正常情况、开启调试日志、上游宕机得到 502、一次重载和一次重启。 然后我在 journal、访问日志、Caddy 的配置和数据目录以及适配后的 JSON 里逐个统计每个密钥的出现次数。 每个计数都是零。 对照组,也就是同一份配置以 --environ 启动,把密钥打印了两次。

那次测试有两点保留意见。 开启 debug 时,Caddy 会记录整个适配后的配置,所以通用令牌和 {env.*} 占位符会出现在那里;它们背后的值没有出现。 无论如何,生产环境里关掉调试。 另外,如果某个密钥已经进过 journal,像我的那样,就在 PDM 里重新生成它并更新文件;删日志行不是解决办法。

防火墙:8443 永远不出这台机器

我的实验室根本没有防火墙,所以 8443 对置备网络上的每台主机都有应答,Caddyfile 里的每条规则都能被绕过去。 把它关掉。 nftables,默认丢弃:

#!/usr/sbin/nft -f
flush ruleset

define SITES = { 10.10.50.0/24, 10.20.50.0/24, 10.30.50.0/24 }
define MGMT  = { 10.99.0.0/24 }

table inet filter {
	chain input {
		type filter hook input priority filter; policy drop;

		iifname "lo" accept
		ct state established,related accept
		ct state invalid drop
		meta l4proto { icmp, ipv6-icmp } accept

		# PDM's API listens on [::]:8443 and cannot be rebound
		tcp dport 8443 counter drop

		ip saddr $MGMT tcp dport { 22, 80, 443 } accept

		udp dport { 67, 69 } accept
		ip saddr $SITES meta l4proto { tcp, udp } th dport 53 accept
		ip saddr $SITES tcp dport { 80, 443 } accept
	}
	chain forward {
		type filter hook forward priority filter; policy drop;
	}
}

PDM 连接它的 remote 都是出站方向,所以关闭入站 8443 对那边没有任何影响。 第一次加载新规则集时带一个定时回滚,这样出错只会让你损失九十秒,而不是跑一趟控制台:

systemd-run --unit=nft-rollback --on-active=90 /usr/sbin/nft flush ruleset
nft -f /etc/nftables.conf
# still connected? then:
systemctl stop nft-rollback.timer && systemctl enable nftables

在实验室里,全部完成之后:

检查结果
从管理网络访问 8443连不上;丢弃计数在增长
从管理网络经 Caddy 的 443 访问 PDM 网页界面能登录,正常工作
从站点地址访问 PDM 网页界面被中止
站点带通用令牌发送应答 POST带着站点令牌到达 PDM:一个故意不匹配的探测得到 400 no answer file found
同样的探测用编造的令牌直接发给 PDM401
不带通用令牌的应答 POST,或以 /api2/extjs/… 形式发送被中止
存放 PDM 机密的文件,以 caddy 身份读取一个都读不了
改动之后,站点密钥在 journal、访问日志或 Caddy 数据里出现的次数0

DHCP、iPXE 与循环

服务器固件只能通过 TFTP 获取第一个文件,所以 TFTP 提供小小的 iPXE 加载器,其余一切由 iPXE 通过 HTTP 获取。 陷阱在于 iPXE 会发出自己的 DHCP 请求,而如果服务器再次回答 ipxe.efi,机器就会永远绕圈子。 DHCP 服务器必须分得清固件和 iPXE。

为什么普通 DHCP 回复会循环普通回复:循环固件请求启动文件回复:ipxe.efiiPXE 启动,再次请求同样回复:ipxe.efi服务器分不清固件和 iPXE,所以永远前进不了识别 iPXE:可行固件请求启动文件不是 iPXE:经 TFTP 给 ipxe.efiiPXE 再次请求,带 option 175回复:boot.ipxe 的 URL,走 HTTP内核、initrd 和 ISO,然后安装
同样的请求两次,得到同样的回答两次。只有 iPXE 才发送的 option 175,就是服务器区分第二次请求和第一次请求的依据。
DHCP 服务器如何打破循环
dnsmasq给携带 option 175(只有 iPXE 发送)的请求打标签,把 HTTP URL 交给它们31
ISC dhcpdif exists user-class and option user-class = "iPXE"32
FortiGatefilename 字段只接受一个值,所以构建一个内嵌 URL 的 iPXE 加载器,统一提供给所有请求

dnsmasq,服务它自己的网络,并通过中继服务另外两个网络,只用预留:

# /etc/dnsmasq.d/pxe.conf
local=/example.doc/
domain=example.doc
address=/pdm.example.doc/10.10.50.10
txt-record=proxmox-auto-installer.example.doc,"https://pdm.example.doc/api2/json/auto-install/answer"
txt-record=proxmox-auto-installer-cert-fingerprint.example.doc,"63:C4:D6:...:85:07"

dhcp-authoritative
dhcp-range=set:site1,10.10.50.0,static,255.255.255.0,1h
dhcp-range=set:site2,10.20.50.0,static,255.255.255.0,1h
dhcp-range=set:site3,10.30.50.0,static,255.255.255.0,1h
dhcp-option=tag:site1,option:router,10.10.50.1
dhcp-option=tag:site2,option:router,10.20.50.1
dhcp-option=tag:site3,option:router,10.30.50.1
dhcp-option=option:dns-server,10.10.50.10
dhcp-option=option:domain-search,example.doc

dhcp-match=set:ipxe,175
dhcp-match=set:efi64,option:client-arch,7
dhcp-match=set:efi64,option:client-arch,9
dhcp-boot=tag:efi64,tag:!ipxe,ipxe.efi
dhcp-boot=tag:ipxe,http://pdm.example.doc/pve-9.2/boot.ipxe
# no option 250 anywhere: DNS discovery depends on it

enable-tftp
tftp-root=/srv/tftp
tftp-secure
# TFTP block-size ceiling: lower it for an IPsec or other tunnel in the path
tftp-mtu=1500

# dhcp-host=<mac>,<ip inside that site's /24>,<hostname>
dhcp-host=aa:bb:cc:dd:ee:01,10.10.50.21,pve01
dhcp-host=aa:bb:cc:dd:ee:02,10.20.50.21,pve01

static 表示没有地址池:只有做了预留的机器才能拿到地址,这样陌生机器就进不了安装路径。 每条预留的地址必须落在它自己站点的 /24 里,因为 Caddy 正是用这个地址来挑选令牌。 预留到错误子网的节点会拿到错误站点的应答,或者什么也拿不到。

预留是一张 MAC 地址清单,而这恰恰是客户不想要的那种按机器记账的活。 如果“插上就启动”真的是硬要求,那就给每个置备 VLAN 一个小的动态范围,例如 dhcp-range=set:site1,10.10.50.100,10.10.50.150,255.255.255.0,1h。 站点信息仍然来自子网,所以 Caddy 仍然挑对令牌,而带 installation_nr 的 FQDN 模板会给节点命名。 代价是“还剩什么要决定”的第一行:插进那个 VLAN 的任何东西现在都能取到该站点的应答,所以 VLAN 本身成了那道门。

dnsmasq 会与客户端协商 TFTP 块大小。 不去管它的话,它会把上限设为它自己接口的 MTU31,这在通往某站点的路径比 dnsmasq 所在链路的 MTU 小之前都没问题。 所以配置里把上限写明为 tftp-mtu=1500,而不是继承。 这样,负责某个位于 IPsec 隧道或其他会占用包空间的东西后面的站点的人,就能看到这个数字,把它调低到路径真正能承载的值,而不是从一次卡在半路的传输里才发现。 如果某个网卡 ROM 只要这个选项被批准就出毛病,tftp-no-blocksize 可以关掉协商。

从 Debian 的 ipxe 软件包里把 ipxe.efi 复制到 /srv/tftp,属主设为 dnsmasq 用户,因为 tftp-secure 会拒绝其他任何属主的文件。 优先用 UEFI。 Secure Boot 需要签名过的 iPXE,所以要么配好它,要么安装时关掉 Secure Boot、装完再打开。

启动、观察,以及哪里会出问题

在碰硬件之前,先在一个站点网络上用一台虚拟机测试:UEFI 固件、8 GiB 内存、一块接在该 VLAN 上的网卡,就能重现整条链路。

启动时发生了什么目标服务器UEFI 网络启动6 GiB 或更多1. DHCP 和 TFTP一个租约、一个搜索域,然后是 ipxe.efi2. 80 端口上的 HTTPboot.ipxe、vmlinuz、initrd.img 和 ISO,载入内存3. DNS两条 TXT 记录:应答 URL 和 PDM 的指纹4. 443 上的 Caddy,然后是 PDM现在是应答,重启后是 webhook
四段独立的对话,每段失败时都有自己该去查看的地方。

以及按顺序的全过程,从开机到 PDM 标记为 Finished 的安装:

从开机到完全装好目标机dnsmasq, :80Caddy :443PDMDHCP:一个租约TFTP:ipxe.efiiPXE 再次请求HTTP:内核、initrd、ISO安装程序:一个域DNS:两条 TXT 记录POST,通用令牌站点令牌进行中渲染好的应答,经 Caddy安装到磁盘webhook,一次性令牌去掉 AuthorizationFinished重启;首次启动激活密钥
每一步,按顺序。webhook 由安装程序在重启之前发送,所以 Finished 表示已安装,不表示已启动;订阅密钥是之后在首次启动时激活的。
步骤发生了什么去哪里看
1固件通过 TFTP 取得 ipxe.efi,iPXE 通过 HTTP 取得 boot.ipxejournalctl -u dnsmasq,Caddy 的日志
2十秒后菜单启动自动安装条目;下载内核、initrd 和 ISO四个 GET,其中一个约 1.6 GB
3安装程序拿到租约,读取搜索域,查询两条 TXT 记录目标机上的 /tmp/fetch_answer.log
4POST 到 Caddy,令牌被替换,PDM 挑选应答Caddy 的日志写明令牌;PDM 显示一条新的安装记录
5安装运行/tmp/auto_installer.log、/tmp/install-low-level-start-session.log
6仍在安装程序里时,webhook 经 Caddy 回调,然后机器重启33安装记录变为 Finished,附带磁盘、网卡和 SSH 主机密钥

失败时安装程序会落到一个 shell,除非应答设置了 Reboot on Error,所以测试期间别开它。

症状可能原因
Could not find search domain in resolv.conf.DHCP 没有发送域
对一个带空格的名字做 TXT 查询不止一个搜索域
Got empty response.记录缺失、区不对,或 option 6 指向了另一台 DNS 服务器
URL 中间有一个空格TXT 值被拆成了多个字符串
日志说 URL 来自 DHCP网络上某处有 option 250
POST 时出现 TLS 错误DNS 里的指纹不是 Caddy 当前的证书
连接被关闭,没有响应Caddy 中止了它:子网不对、没带通用令牌,或者路由不是那两条之一
400 no answer file found令牌有效;没有过滤器匹配,且该令牌上没有默认应答
应答不对过滤器重叠;文件里第一个胜出
状态一直是进行中webhook 基础 URL 仍指向 8443
iPXE 无休止地重新加载自己DHCP 服务器没有区分 iPXE 和固件
PXE-E32 TFTP 超时next-server 不对,或者 UDP 69 被拦截

加入 Proxmox Backup Server

这条路径没有任何部分是 Proxmox VE 专属的。 用 PBS 4 的 ISO 和同一个通用令牌再构建一套启动文件,放进 /srv/www/pbs-4/,并为每个站点加一份 PBS 应答,过滤器为 /product/product=pbs,授权给该站点的令牌。 DNS 记录、Caddy、令牌和防火墙都不用变。

对同时有两者的站点,得有东西来决定一台机器装哪个产品,而菜单不是做这个决定的合适东西。 iPXE 的 choose 不加 --timeout 会在控制台前永远等一次按键,这和无人值守恰恰相反。

改由 DHCP 预留来决定。 你本来就按 MAC 地址预留了每个节点,所以给 PBS 那些打上标签,并给每个标签发送它自己的 boot.ipxe:

# /etc/dnsmasq.d/pxe.conf, replacing the single iPXE dhcp-boot line
dhcp-host=aa:bb:cc:dd:ee:01,10.10.50.21,pve01
dhcp-host=aa:bb:cc:dd:ee:31,set:pbs,10.10.50.31,pbs01

dhcp-boot=tag:ipxe,tag:!pbs,http://pdm.example.doc/pve-9.2/boot.ipxe
dhcp-boot=tag:ipxe,tag:pbs,http://pdm.example.doc/pbs-4/boot.ipxe

预留上的 set:pbs 只给那一台机器打标签31,而 tag:!pbs 让两条启动行互斥,所以不存在哪条胜出的问题。 每个产品自己的 boot.ipxe 本来就会在十秒后无人操作地启动其自动安装条目15。

这几行在 2.91(我实验室的版本)上通过了 dnsmasq --test,并遵循文档中的 dhcp-host 和标签语法。 我还没有通过它们 PXE 启动过一个 PBS 节点,所以在依赖它之前,先拿一台打了标签的机器试一试。

从这里开始,路径和 Proxmox VE 一样。 PBS 安装程序上报 "product": "pbs",Caddy 换入该站点的令牌,PDM 挑选该站点的 PBS 应答。 自始至终没有任何东西靠手工选择,一个节点变成什么产品,写在一个地方:预留,就在它的地址旁边。

由什么决定存放在哪里
启动哪个 ISODHCP 预留上的 set:pbs 标签
适用哪个站点的应答源子网,通过 Caddy 的令牌替换
该站点内的哪份应答PDM 里的 /product/product=pbs 过滤器

安装程序只铺下操作系统。 数据存储放在与系统盘分开的存储上,这是收尾节点的那个东西的另一件活,于是又回到了缺失的首次启动钩子。

还剩什么要决定

这些都不妨碍你使用这个设计。每一项都需要有人负责。

取舍为什么要紧怎么办
源地址就是那道门置备 VLAN 上的任何东西,或能在上面伪造地址的东西,都能取到该站点的应答:root 密码哈希、SSH 密钥、订阅密钥隔离 VLAN、端口安全、只用预留、令牌过期、两次部署之间禁用令牌
通用令牌不是机密它在每个镜像里,也在本页上它只过滤掉零散请求;子网和 Caddy 里保存的真令牌才是那道门
Caddy 能读 PDM 的私钥提供 PDM 的证书意味着代理要读那一把私钥只在 api.pem 和 api.key 上加 ACL,PDM 的其他东西一概不可读,主机锁好;私钥从不离开它
DNS 是被信任的伪造的 TXT 记录会把安装程序引到别处,如果指纹也来自 DNS,伪造者就两样都控制了保护置备用 DNS,或用 --cert-fingerprint 把 PDM 的指纹写进镜像,变了就重建
启动文件走明文 HTTP在线路上可被读取或替换保持网络隔离;如果你的构建支持,就让 iPXE 走 HTTPS
webhook 令牌16 个随机字节,一次性,回调后清除,但没有时限4清理旧的安装记录
订阅密钥网络起来后激活一次;失败时密钥被删除,单元失败,不重试34在新节点上检查 systemctl --failed
PDM 是单点目前没有高可用宕机会停掉新安装,不影响运行中的集群
只有一块管理网卡应答里没有 bond、VLAN 或网桥选项9那是安装后的活,面临同样的首次启动问题

一个初版,在其上好好构建

这是该功能的第一个版本,作为第一个版本,它不错。 应答表单合理,选择规则读懂之后很清楚,webhook 能用,代码是开放的,而这正是上面所有内容能被证明而不是被猜测的唯一原因。 这个补丁系列在公开邮件列表上走了四轮才合入35,看得出来。

缺口在于把安装服务器变成置备系统的那两样东西。 站点是 MSP 思考问题的单位,而安装程序发出请求时就站在站点上。 首次启动钩子,是“装好了”的节点和“完工了”的节点之间的区别。 两者都已经有了一半:安装程序有钩子,PDM 有令牌。 我预计两者都会到来,到那时,这个设计中间的 Caddy 会变得更简单,而不是消失,因为一个把 PDM 的机密挡在够不着的地方、把 8443 挡在网络之外的代理,无论如何都值得拥有。

在那之前这样做的理由,就是开头那一条。 十台 PXE 服务器,就是十样东西以十种不同的速度过时,而每一样只有在你需要它的那天出故障时才会被看一眼。 一套环境,只需保持更新一次,站点由网络判断,机密放在一个地方,要你负责的东西就少。 要负责的少,出错的就少,而这差不多就是这份工作的大部分。


  1. Proxmox — Proxmox Datacenter Manager 1.1 press release — 自动安装,Remotes 下新增一个跟踪安装进度的选项卡。 ↩︎

  2. Proxmox Datacenter Manager documentation — Automated Installations — 预备应答、目标过滤器、模板,以及 “a dedicated token mechanism, separate from the normal API tokens”。 ↩︎ ↩︎

  3. proxmox-datacenter-manager, lib/pdm-api-types/src/auto_installer.rs — 目标过滤器的键 “are JSON Pointers as per [RFC6901], the values globs”;只有一个默认应答。 ↩︎

  4. proxmox-datacenter-manager, server/src/api/auto_installer/mod.rs — 令牌检查先于默认应答、按文件顺序第一个匹配、first_boot: None、计数器递增、一次性 post-hook 令牌、无需 PDM 登录即可访问的两条路由,以及 /system/auto-installation 上的 Sys.Audit/Sys.Modify 权限。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  5. Proxmox VE Roadmap — Proxmox VE 9.2 — PXE 和 iPXE 准备、“at least 6 GiB of available memory on the host”,以及 megaraid_sas 和 NVMe JBOD 的已知问题。 ↩︎ ↩︎ ↩︎

  6. Proxmox Bugzilla 8078 — “prepared answer disk setup does not allow to specify multiple udev filters with same name”,2026年9月26日提交,2026年11月7日状态为 NEW。 ↩︎

  7. Proxmox Bugzilla 7699 — “Add on-first-boot parameter to the PDM remote installation”,2026年6月12日提交,2026年11月7日状态为 NEW。 ↩︎ ↩︎

  8. proxmox, proxmox-installer-types/src/lib.rs — SystemInfo:产品、ISO、DMI 和网络接口。 ↩︎

  9. Proxmox VE wiki — Automated Installation — [first-boot] 和 [network] 选项、上报的系统信息,以及认证令牌 “is stored in plain text inside the prepared ISO”。 ↩︎ ↩︎ ↩︎ ↩︎

  10. Proxmox Bugzilla 8263 — “[Feature Request] auto-installer: client source IP (or X-Forwarded-For) for answer selection and templating”,2026年10月31日提交,2026年11月7日状态为 NEW。 ↩︎

  11. proxmox-datacenter-manager, debian/changelog — 1.1.1:“match prepared answers in the configuration’s stable order and let the first match win”。 ↩︎

  12. proxmox, proxmox-installer-types/src/answer.rs — AutoInstallerConfig 带有 first_boot: Option<FirstBootHookInfo>。 ↩︎

  13. pve-installer, proxmox-auto-installer/src/bin/proxmox-auto-installer.rs — 只有应答带 first_boot 段时才设置首次启动可执行文件。 ↩︎

  14. pve-installer, proxmox-fetch-answer/src/fetch_plugins/http.rs — 先 ISO URL,再 DHCP,再 DNS;TXT 名称;resolv.conf 解析;去掉引号的 dig txt +short;Bearer 请求头。 ↩︎ ↩︎

  15. pve-installer, proxmox-auto-install-assistant/src/main.rs — --pxe-loader 隐含 --pxe、输出目录、gzip 的 initrd、从 ISO 中去掉 /boot,以及生成的 boot.ipxe。 ↩︎ ↩︎ ↩︎

  16. proxmox-datacenter-manager, server/src/bin/proxmox-datacenter-api/main.rs — PDM_LISTEN_ADDR 是 PDM_PORT(8443)上的 IPv6 未指定地址,构建时固定。 ↩︎

  17. Caddy releases — 2.11.1 修复了 CVE-2026-27587,一个通过转义序列绕过路径匹配器的漏洞。 ↩︎

  18. Debian sources — caddy — trixie 中为 2.6.2-12+deb13u1,trixie-backports 中为 2.11.2-1~bpo13+1。 ↩︎

  19. Caddy — request_header — “With no prefix, the field is set (overwritten).” ↩︎

  20. Caddy — Request matchers — remote_ip 是直接对端;路径匹配不区分大小写、经 URL 解码和清理,重复斜杠会合并。 ↩︎ ↩︎

  21. Caddy — handle — “only the first matching handle block will be evaluated”。 ↩︎

  22. Caddy — Global options — admin 默认为 localhost:2019;protocols 默认为 h1 h2 h3。 ↩︎ ↩︎

  23. Caddy — file_server — hide 不应被当作安全边界。 ↩︎

  24. Caddy — log — Cookie、Set-Cookie、Authorization 和 Proxy-Authorization 记录为 REDACTED。 ↩︎

  25. systemd.service — ExecCondition= — 退出码为 1 到 254 时 “the remaining commands are skipped and the unit is not marked as failed”。 ↩︎

  26. systemd.path — PathChanged= — “activated if the file which was open for writing gets closed”。 ↩︎

  27. caddyserver/dist, init/caddy.service — ExecStart=/usr/bin/caddy run --environ --config /etc/caddy/Caddyfile。 ↩︎ ↩︎

  28. Caddy — Command line — --environ 在启动前打印环境。 ↩︎

  29. Caddy — Caddyfile concepts, environment variables — {$NAME} 在解析 Caddyfile 之前就被替换。 ↩︎

  30. caddyserver/caddy, replacer.go — 任何以 env. 开头的键都会传给 os.Getenv。 ↩︎

  31. dnsmasq manual page — dhcp-match、dhcp-boot、带 set:<tag> 的 dhcp-host、enable-tftp、tftp-secure、tftp-mtu、tftp-no-blocksize 和 static 范围。 ↩︎ ↩︎ ↩︎

  32. iPXE — Configuring ISC dhcpd — if exists user-class and option user-class = "iPXE" 把脚本交给 iPXE、把加载器交给固件。 ↩︎

  33. pve-installer, unconfigured.sh — proxmox-post-hook 在 proxmox-auto-installer 成功后立即运行,早于重启。 ↩︎

  34. pve-installer, proxmox-first-boot/proxmox-first-boot-subscription — “always drop the staged key, regardless of whether activation succeeded”。 ↩︎

  35. pdm-devel — “add auto-installer integration”, v4, 40 patches — 加入该功能的补丁系列,附 v3 到 v4 的变更说明。 ↩︎