一个控制台,许多客户
如果你替别人照看 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,而每个站点仍然拿到自己的应答。
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 字段里可用 MiniJinja | installation_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 挑选应答的方式,是用过滤器去比对安装程序上报的系统信息。 所以问题在于那份文档里有什么,因为不在里面的东西就没法匹配。
| 键 | 内容 | 能否指明站点? |
|---|---|---|
product | fullname、product(pve、pbs、pmg)、enable_btrfs | 不能 |
iso | release、isorelease | 不能 |
dmi | 系统、主板和机箱:名称、序列号、UUID、SKU、资产标签 | 只有有人把站点写进资产标签时才能 |
network_interfaces | {link, mac} 的列表 | 只能通过你自己维护的清单 |
全部就这些8,9。 没有地址,没有主机名,没有 DHCP 选项,没有任何关于这台机器插在哪里的信息。
桌面管理接口(DMI)字段看上去很有希望,直到你读到真实的值。
我实验室里的每一次安装,系统名称都是 Standard PC (Q35 + ICH9, 2009),序列号和资产标签都是空的。
真实服务器会填这些字段,但填的是厂商放进去的东西,不是你客户的名字;而按序列号或 MAC 地址匹配,只有在你维护一份将来要安装的每一台机箱的清单时才行得通,而这恰恰是这套东西本该省掉的记账活。
按主机,可以。按站点,不行。
那么这台机器插在哪个网络上?PDM 永远不知道。 安装程序上报时手里就握着它的 DHCP 租约,而 MSP 对一个新节点唯一确知的事实,偏偏就是它丢下不报的那一个。 按源地址匹配(IPv4 或 IPv6)是一个尚未处理的功能请求,是我自己提的,编号 826310。
选择规则里还藏着第二个限制,我的实验室一头撞了上去。
令牌最先检查,只有授权给该令牌的应答才会被考虑,包括默认应答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 上,什么也不干。
这对 MSP 来说比对任何人都更要紧。
安装程序产出的节点是一个裸系统,带一个哈希过的 root 密码和几把 SSH 密钥。
它不是 PDM 的 remote,不在任何集群里,你的监控、软件源和存储一样都没有。
在我的实验室里,三个节点都装完并回报了,PDM 里的 SITEA remote 事后还是得手工添加。
所以无论你用什么来收尾一个节点,Ansible 也好,别的也好,都得从外部触发:从安装后 webhook,从一个盯着安装列表的作业,或者由一个人来做。 我就讲到这里。 本文讲的是让一套 PXE 环境服务所有站点,而首次启动的缺口是要绕着规划的限制,不是我打算在这里糊过去的东西。
令牌就是站点
PDM 看不见站点,但它确实按令牌限定应答,而令牌不过是一个请求头。 谁设置这个请求头,谁就决定安装程序能拿到哪一组应答。 整个窍门就这么简单。
所以在 PDM 前面放一个知道请求从哪里来的东西:
- 启动镜像携带一个通用令牌,
catch-all:not-a-secret,每个镜像里都一样,就公开在这里。它不是 PDM 令牌,自己什么都打不开。 - PDM 前面的 Caddy 反向代理查看携带通用令牌的应答请求的源子网,把请求头换成该站点真正的令牌。
- PDM 看到的是
site2-2026q4:<secret>,于是只提供 site2 的应答。
机密从不靠近启动镜像,所以丢一个 U 盘或者被人复制一份 ISO,谁也得不到任何东西。 轮换一个站点的令牌是改 Caddy,不是重建镜像。 而增加一个站点,就是一行 Caddy 配置加 PDM 里一个新令牌。
这依赖于源地址是诚实的,而这是你网络的属性,不是代理的属性。 这个取舍和其他取舍都列在下文“还剩什么要决定”里。
镜像里不写 URL,安装程序怎么找到 PDM
所有站点一个镜像,前提是镜像里也不带 PDM 的地址。 安装程序按顺序在三个地方找它的应答 URL14:
| 规则 | 代码做了什么 | 对你意味着什么 |
|---|---|---|
| 顺序 | 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 恰好有两条不需要 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 h2 | Caddy 默认在 UDP 443 上监听 HTTP/322;这一行把它关掉,而不是留着一个谁也没打算开的端口 |
@hidden | file_server 会提供其根目录下的每个文件,包括点文件,而文档明确说 hide 不是安全边界23 |
Csrfpreventiontoken replace REDACTED | Caddy 默认会在访问日志里遮蔽 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-restart | Caddy 在运行就重载,不在运行就什么也不做 |
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 自己的日志里也没有,全都来自那一个参数。
所以密钥文件只放密钥,别的什么都不放:
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 |
| 同样的探测用编造的令牌直接发给 PDM | 401 |
不带通用令牌的应答 POST,或以 /api2/extjs/… 形式发送 | 被中止 |
存放 PDM 机密的文件,以 caddy 身份读取 | 一个都读不了 |
| 改动之后,站点密钥在 journal、访问日志或 Caddy 数据里出现的次数 | 0 |
DHCP、iPXE 与循环
服务器固件只能通过 TFTP 获取第一个文件,所以 TFTP 提供小小的 iPXE 加载器,其余一切由 iPXE 通过 HTTP 获取。
陷阱在于 iPXE 会发出自己的 DHCP 请求,而如果服务器再次回答 ipxe.efi,机器就会永远绕圈子。
DHCP 服务器必须分得清固件和 iPXE。
| DHCP 服务器 | 如何打破循环 |
|---|---|
| dnsmasq | 给携带 option 175(只有 iPXE 发送)的请求打标签,把 HTTP URL 交给它们31 |
| ISC dhcpd | if exists user-class and option user-class = "iPXE"32 |
| FortiGate | filename 字段只接受一个值,所以构建一个内嵌 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 上的网卡,就能重现整条链路。
以及按顺序的全过程,从开机到 PDM 标记为 Finished 的安装:
| 步骤 | 发生了什么 | 去哪里看 |
|---|---|---|
| 1 | 固件通过 TFTP 取得 ipxe.efi,iPXE 通过 HTTP 取得 boot.ipxe | journalctl -u dnsmasq,Caddy 的日志 |
| 2 | 十秒后菜单启动自动安装条目;下载内核、initrd 和 ISO | 四个 GET,其中一个约 1.6 GB |
| 3 | 安装程序拿到租约,读取搜索域,查询两条 TXT 记录 | 目标机上的 /tmp/fetch_answer.log |
| 4 | POST 到 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 应答。
自始至终没有任何东西靠手工选择,一个节点变成什么产品,写在一个地方:预留,就在它的地址旁边。
| 由什么决定 | 存放在哪里 |
|---|---|
| 启动哪个 ISO | DHCP 预留上的 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 服务器,就是十样东西以十种不同的速度过时,而每一样只有在你需要它的那天出故障时才会被看一眼。 一套环境,只需保持更新一次,站点由网络判断,机密放在一个地方,要你负责的东西就少。 要负责的少,出错的就少,而这差不多就是这份工作的大部分。
Proxmox — Proxmox Datacenter Manager 1.1 press release — 自动安装,Remotes 下新增一个跟踪安装进度的选项卡。 ↩︎
Proxmox Datacenter Manager documentation — Automated Installations — 预备应答、目标过滤器、模板,以及 “a dedicated token mechanism, separate from the normal API tokens”。 ↩︎ ↩︎
proxmox-datacenter-manager,
lib/pdm-api-types/src/auto_installer.rs— 目标过滤器的键 “are JSON Pointers as per [RFC6901], the values globs”;只有一个默认应答。 ↩︎proxmox-datacenter-manager,
server/src/api/auto_installer/mod.rs— 令牌检查先于默认应答、按文件顺序第一个匹配、first_boot: None、计数器递增、一次性 post-hook 令牌、无需 PDM 登录即可访问的两条路由,以及/system/auto-installation上的Sys.Audit/Sys.Modify权限。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎Proxmox VE Roadmap — Proxmox VE 9.2 — PXE 和 iPXE 准备、“at least 6 GiB of available memory on the host”,以及
megaraid_sas和 NVMe JBOD 的已知问题。 ↩︎ ↩︎ ↩︎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。 ↩︎
Proxmox Bugzilla 7699 — “Add on-first-boot parameter to the PDM remote installation”,2026年6月12日提交,2026年11月7日状态为 NEW。 ↩︎ ↩︎
proxmox,
proxmox-installer-types/src/lib.rs—SystemInfo:产品、ISO、DMI 和网络接口。 ↩︎Proxmox VE wiki — Automated Installation —
[first-boot]和[network]选项、上报的系统信息,以及认证令牌 “is stored in plain text inside the prepared ISO”。 ↩︎ ↩︎ ↩︎ ↩︎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。 ↩︎
proxmox-datacenter-manager,
debian/changelog— 1.1.1:“match prepared answers in the configuration’s stable order and let the first match win”。 ↩︎proxmox,
proxmox-installer-types/src/answer.rs—AutoInstallerConfig带有first_boot: Option<FirstBootHookInfo>。 ↩︎pve-installer,
proxmox-auto-installer/src/bin/proxmox-auto-installer.rs— 只有应答带first_boot段时才设置首次启动可执行文件。 ↩︎pve-installer,
proxmox-fetch-answer/src/fetch_plugins/http.rs— 先 ISO URL,再 DHCP,再 DNS;TXT 名称;resolv.conf解析;去掉引号的dig txt +short;Bearer 请求头。 ↩︎ ↩︎pve-installer,
proxmox-auto-install-assistant/src/main.rs—--pxe-loader隐含--pxe、输出目录、gzip 的 initrd、从 ISO 中去掉/boot,以及生成的boot.ipxe。 ↩︎ ↩︎ ↩︎proxmox-datacenter-manager,
server/src/bin/proxmox-datacenter-api/main.rs—PDM_LISTEN_ADDR是PDM_PORT(8443)上的 IPv6 未指定地址,构建时固定。 ↩︎Caddy releases — 2.11.1 修复了 CVE-2026-27587,一个通过转义序列绕过路径匹配器的漏洞。 ↩︎
Debian sources — caddy — trixie 中为
2.6.2-12+deb13u1,trixie-backports 中为2.11.2-1~bpo13+1。 ↩︎Caddy —
request_header— “With no prefix, the field is set (overwritten).” ↩︎Caddy — Request matchers —
remote_ip是直接对端;路径匹配不区分大小写、经 URL 解码和清理,重复斜杠会合并。 ↩︎ ↩︎Caddy —
handle— “only the first matchinghandleblock will be evaluated”。 ↩︎Caddy — Global options — admin 默认为
localhost:2019;protocols默认为h1 h2 h3。 ↩︎ ↩︎Caddy —
file_server—hide不应被当作安全边界。 ↩︎Caddy —
log—Cookie、Set-Cookie、Authorization和Proxy-Authorization记录为REDACTED。 ↩︎systemd.service —
ExecCondition=— 退出码为 1 到 254 时 “the remaining commands are skipped and the unit is not marked as failed”。 ↩︎systemd.path —
PathChanged=— “activated if the file which was open for writing gets closed”。 ↩︎caddyserver/dist,
init/caddy.service—ExecStart=/usr/bin/caddy run --environ --config /etc/caddy/Caddyfile。 ↩︎ ↩︎Caddy — Command line —
--environ在启动前打印环境。 ↩︎Caddy — Caddyfile concepts, environment variables —
{$NAME}在解析 Caddyfile 之前就被替换。 ↩︎caddyserver/caddy,
replacer.go— 任何以env.开头的键都会传给os.Getenv。 ↩︎dnsmasq manual page —
dhcp-match、dhcp-boot、带set:<tag>的dhcp-host、enable-tftp、tftp-secure、tftp-mtu、tftp-no-blocksize和static范围。 ↩︎ ↩︎ ↩︎iPXE — Configuring ISC dhcpd —
if exists user-class and option user-class = "iPXE"把脚本交给 iPXE、把加载器交给固件。 ↩︎pve-installer,
unconfigured.sh—proxmox-post-hook在proxmox-auto-installer成功后立即运行,早于重启。 ↩︎pve-installer,
proxmox-first-boot/proxmox-first-boot-subscription— “always drop the staged key, regardless of whether activation succeeded”。 ↩︎pdm-devel — “add auto-installer integration”, v4, 40 patches — 加入该功能的补丁系列,附 v3 到 v4 的变更说明。 ↩︎