Pulse v6.1.0-rc.3 深度解读:受管动作生命周期、Fail-Closed 安全加固与存储身份修复
Pulse v6.1.0-rc.3 深度解读:受管动作生命周期、Fail-Closed 安全加固与存储身份修复
v6.1.0-rc.3 是 Pulse 下一个 v6 小版本线的发布候选(Release Candidate),紧随稳定版 v6.0.5 之后,在保留监控优先产品形态、类型化 Pulse Intelligence 动作生命周期、独立 Actions 工作区、更安全的原生 Agent 更新与恢复行为的基础上,集中修复了来自 RC 反馈的多个关键问题——覆盖 Agent 命令注册、Docker 更新动作、存储身份、TrueNAS 准确性、Patrol 可靠性与更新选择。读完本文,你将理解这套"类型化动作生命周期 + Fail-Closed 安全加固"如何在监控平台上落地,掌握 RC 版本的升级、回滚与验证方法,并能依据源码定位每个机制的真实实现。
RC 定位:从 v6.0.5 到 v6.1.0 的受控过渡
v6.1.0-rc.3 是 v6.1.0 正式发布前的第三个候选版本,它继承了前序候选(rc.1、rc.2)的绝大部分成果,并在此之上替换 rc.2,其核心定位是通过候选反馈驱动修复:本轮修复点集中在 Agent 命令注册、Docker 更新动作、存储身份(ZFS 池归属)、TrueNAS 数据准确性、Patrol 可靠性和更新版本选择六个方向。
由于该候选版本改变了认证与原生安装器/更新器的安全边界,因此它刻意走"受控 RC 路径"而非直接走 stable-patch 路径——这一点对所有希望评估 RC 的运维人员非常重要:只有确认自己愿意在非稳定分支上测试,才应使用常规 v6 安装或更新流程升级到 v6.1.0-rc.3。
类型化动作生命周期:Patrol 发现到执行验证的单一管道
v6.1.0-rc.3 最具代表性的能力,是让 Patrol(巡逻)发现结果可以进入统一的 Actions 收件箱,并携带清晰的"审批 → 执行 → 验证"状态流转。从源码结构看,这一机制由传输无关的 actionlifecycle 服务承载:internal/actionlifecycle/service.go 的包注释明确写道——规划、审批决策、执行必须全部经过这一个服务,任何调用方(REST 处理器、进程内 Broker 如 Patrol 调查提案)都不能绕过它直接派发资源变更。
该服务的核心契约包括:
Plan:将请求对组织实时资源注册表校验,产出类型化计划,同时执行 Executor 侧的可用性检查,并持久化计划阶段审计轨迹;Decide:唯一的人类决策边界,负责审批授权、审批下限(approval floor)校验、证据绑定(approval evidence 必须绑定到行为者、组织、动作、计划哈希与结果),并以 append-only 方式持久化;Execute/ExecuteUnderPolicy:分别对应人类执行与策略驱动的自动执行两条边界,所有拒绝路径均 Fail-Closed——过期计划、未审批动作、计划漂移(plan drift)、运维补救锁都会被记录为"拒绝执行"而绝不静默丢弃;Refresh:为过期或漂移的动作重新生成不可变计划,替换动作必须重新评审后才能决定。
值得注意的工程细节是生命周期动词同义词解析(lifecycleCapabilitySynonym):Proxmox 客户机通告 reboot,而容器平台通告 restart,规划器与模型可以互换使用这两个词,服务会在进入计划、审计记录与执行器之前将其重写为资源实际通告的动词,从而保证各阶段看到一致的语义。
在权限等级上,internal/agentcapabilities/control_level.go 定义了全产品共享的三级词汇表,取代了各处的本地字符串:
read_only:仅允许读取/查询工具;controlled:控制类工具必须走审批背书路径;autonomous:符合条件的控制工具无需逐条审批。
NormalizeControlLevel 对未设置或未知值默认回落到 read_only——这正是文档所述"unsupported、out-of-window 或 downgraded-mode 动作保持审批门控并 Fail-Closed"的底层实现。
自动执行的安全边界:能力白名单与维护窗口
RC 中 Patrol 可以对低风险 Docker 与 Podman 重启进行授权,但前提是显式的"按资源能力白名单"与可选的"周期性维护窗口"。也就是说,容器重启这类自动授权不是全局开关,而是逐资源声明的:
- 白名单内的资源、且处于维护窗口内 → 策略自动准入;
- 白名单外、窗口外、或降级模式 → 保持审批门控并 Fail-Closed。
与之配套,治理范围内的主机更新、Debian/Ubuntu 软件包维护、存储压力清理、受支持的 Proxmox 客户机生命周期操作,现在统一采用"已评审计划 + 持久化执行回执(durable execution receipts)+ 独立结果验证"的流程。从源码看,ExecuteUnderPolicy 是唯一的自动派发边界:它在准入读锁下重新验证完整策略,并在调用执行器之前原子化地提交策略审批与执行状态(见 internal/actionlifecycle/service.go 中 beginPolicyExecution 与 PolicyAdmissionCoordinator 的实现)。
此外,调查提示现在接收的是真实的类型化能力目录(包括审批要求与参数约束),而不是让模型猜测有哪些动作可用——这直接消除了"模型幻觉动作"的一类根因。
Agent 命令注册修复:安装令牌真的携带命令权限
RC 修复了一个颇具代表性的注册缺陷:此前"添加 Pulse Agent"界面即便勾选了 Enable Pulse command execution,生成的安装令牌也不含命令执行作用域,导致 Agent 永远无法注册命令通道。修复后:
- 令牌在服务端按勾选所需的作用域铸造(mint),并携带命令通道所要求的绑定;
- 勾选框切换时令牌会重新生成;
- 拒绝消息会明确指出实际的恢复步骤。
在源码中,这一机制体现在 internal/api/agent_exec_token_binding.go:admitAgentExecToken 会先检查令牌记录是否持有 config.ScopeAgentExec 作用域(缺失即拒绝并记录"Agent exec token missing required scope: agent:exec"),而 canBindAgentInstallExecToken 则负责将安装令牌与首次命令 Agent 注册进行绑定。对应地,cmd/pulse-agent/main.go 中 --enable-commands 标志的说明也明确其为"Patrol 动作与 Proxmox LXC Docker 盘点启用命令执行(默认关闭)",从 Agent 侧再次印证了该能力默认收敛的立场。
原生更新 Fail-Closed:签名自检、回滚与 allowed_signers
本轮 RC 在原生 Agent 更新上的加固具有典型的"默认拒绝"特征:
- 替换二进制前先对候选版本做自检(self-test);
- 拒绝静默的版本降级(silent edition downgrade);
- 保留受认可的(sanctioned)回滚路径;
- 签名配置不完整时快速失败;
- 绝不静默回落到社区构建,而是在加固服务下保留可写的配置备份;
- 验证密钥以文档化验证命令所需的精确 OpenSSH
allowed_signers形式发布。
其底层实现在 internal/updates/signature.go:发布构建流水线(scripts/build-release.sh、scripts/release_asset_common.sh)用 ssh-keygen -Y sign 签名所有发布资产,身份为 pulse-installer、命名空间为 pulse-install,并固定 Ed25519 公钥。应用内更新器调用 ssh-keygen -Y verify 验证 .sshsig 边车签名,与 scripts/pulse-auto-update.sh、scripts/install.sh 的 Shell 路径共享完全相同的信任根。签名文件被限制在 16 KiB 以内、下载超时 30 秒,任何一步失败(缺 ssh-keygen、端点不可达、验签失败)都会中止更新——不存在降级信任等级的旁路。源码注释还特别指出:一旦轮换签名密钥,四处位置(两个脚本、公共引导脚本与本文件)必须同步更新。
Docker 动作治理与阈值页
Docker 相关动作在本轮 RC 中有多处可验证的行为修正:
- 更新 = recreate 而非 restart:RC 明确指出 Docker 更新现在"重建容器"而不是尝试"重启",因为 restart 无法应用新镜像;
- 容器更新按钮在服务器拒绝更新能力时前置禁用,失败的更新计划会浮出拒绝原因,Agent 过旧导致的拒绝会解释后续操作;
- Docker 阈值页暴露容器更新告警延迟,并新增显式 off 状态彻底关闭更新告警;全部禁用容器/服务告警时会同步清除已活跃的更新告警,而不是任其继续通知;
- Docker 盘点在两个机器上报同一 Agent 身份时发出警告,registry pull 可从认证挑战中协商 bearer token;
- Docker Agent 的收集循环由 watchdog 限定,挂起的容器守护进程无法再拖垮上报。
存储身份与 TrueNAS 准确性
本轮修复聚焦两个此前易被忽视的数据一致性问题:
- ZFS 池成员身份解析:此前按
nvme-eui.<hex>或带尾部命名空间后缀(namespace suffix)引用的磁盘无法解析池成员关系,导致这些磁盘显示通用 ZFS 标签而非其所属池名。RC 修复后物理磁盘能正确解析其 ZFS 池归属; - TrueNAS API 形状:TrueNAS 数据集、磁盘、池在底层系统健康时不再误报 Offline/Attention/Unknown,按系统的存储页面也不再与 Overview 中所选系统互换名称。
同时,"物理磁盘不再在宽节点布局下消失、待机 SSD 不再报告误导状态"也属于同一存储一致性主题,配合"受限 NAS 安装不再依赖 od、恢复点/TrueNAS/nvme-eui 身份对账保留权威来源"这两条修复,形成了"展示层→解析层→身份对账层"的完整校正。
Patrol 可靠性:证据预算、超时误报与通知渠道
Patrol 在本轮 RC 的改进集中在"有限资源下的可靠性与诚实性":
- 调查保持证据与模型轮次预算有界,能保留多个有依据的发现(grounded findings),并把 Watch 检测与模型主导调查分离;
- 手动 Patrol 不再误报超时:此前慢速自托管模型在 15 秒内未完成流式输出时,即使运行已经开始也会报告连接超时;现在只有在状态刷新确认没有运行进行中时才报告失败;
- Provider/运行时失败与提议校验失败保持分离,失败的调查不会被误报为"已完成的需要关注结果";
- 新的 Patrol 发现可通过与告警相同的渠道通知,API 与 Patrol 设置页均暴露该配置;
- Patrol 拒绝不可信的提示指令、不支持的二次确认捷径与无依据的健康断言;重复重启与 Docker OOM 事件改用权威证据;
- 多发现 Patrol 运行保留已接受的兄弟发现与顺序发现,provider 重试与重放处理保留持久结果而不升级不完整证据。
在本地 AI 侧,RC 为 qwen3:8b 提供引导式 Ollama 快速上手,并给出更清晰的 Provider & Models 就绪引导。仓库测试 internal/ai/manual_ollama_preflight_test.go 印证了这一点——其注释指出在 4 次预检运行中该模型零失败,因此 qwen3:8b 是被"祝福"(blessed)为默认的本地模型。
平台体验与一致性改进
- 平台页与已连接系统页以"监控优先"的注意力顺序和面向任务的流程为主,并统一了响应式与移动端布局;
- Pulse Intelligence 设置与日常使用面统一产品词汇,Patrol 聚焦"检测 + 调查";
- 调查交付后直接打开相关 Actions 评审,后台 Patrol 工作不再出现在 Assistant 快速恢复列表,Actions 标签页显示待审批计数;
- Docker、Kubernetes、TrueNAS、vSphere、Proxmox 节点表通过共享平台表格模型保留用户控制的列排序;
- Assistant 会话支持重试、重新生成、编辑与重发,并可在响应运行中引导;长粘贴输入折叠为 composer 附件;最后一轮摘要在有数据时报告估算模型成本;
- provider MSP 门户使用产品设计系统、支持深色模式,并在未配置邮件服务商时诚实呈现自助服务行为;
- 商业计划、节奏、权益、撤销与降级处理共享安装级生命周期,并保留客户数据。
其他值得注意的修复清单
- 应用内更新按最高版本选择发行版(而非 GitHub 列表顺序),格式异常的发布说明 Fail-Closed;
- Webhook 投递与出站安全拨号会尝试每个允许的已解析 IP,而非固定第一个;
- 已审批动作的派发在客户端断开后依然存活,不可用的已评审动作浮出其真实原因;
- 无系统连接时页头与 setup-band 的 CTA 命名区分,mock 模式启用时抑制遥测 ping;
- Docker 与 Kubernetes Agent 在评估存活时容忍现实时钟偏移;姿态告警不再忽略预期的 guest-suppression 规则;
- 旧版 OIDC 回调正确恢复发起方 provider;无刷新令牌的 OIDC 会话在允许处保持有效,混合认证启动避免死锁,Basic-auth 身份可到达动作授权;
- 已删除主机可用全新凭据重新注册;重载窗口期间 Agent 配置仍可从连续性状态获得;Windows 版本检查规范化前导
v; - 可用性轮询遵循配置的间隔,告警邮件时间带时区,no-op Docker 更新状态不再产生虚假历史。
升级、回滚与发布约束
回滚命令
v6.1.0-rc.3 的回滚目标是 v6.0.5,精确回滚重装命令为:
./scripts/install.sh --version v6.0.5
升级到该 RC 前请务必确认:你愿意测试 RC、且知道如何回滚;本候选改变认证与原生安装器/更新器边界,刻意走受控 RC 路径而非直接 stable-patch 路径。
移动端与 Windows 签名状态
- Pulse Mobile iOS 候选构建 10 与 Android 候选 versionCode 8 携带配套的"计划绑定动作评审与审批"客户端,仍停留在 TestFlight 与 Google Play 内部测试轨道,本 RC 不包含任何公开商店发布;
- Windows Unified Agent 二进制保留与
v6.0.5相同的校验和与分离签名验证,但尚未 Authenticode 签名,Windows 可能显示"未知发布者"警告;公开 Windows Authenticode 签名是稳定版晋升的前置条件。
付费客户
Pulse Pro、Relay 及符合条件的遗留付费客户应继续使用私有下载页与私有运行时镜像获取付费运行时功能。
结语
v6.1.0-rc.3 是一份典型的"反馈驱动"候选发布:它没有引入新的产品范式,而是把类型化动作生命周期、Fail-Closed 安全加固与存储身份准确性打磨到可交付状态。对于评估者而言,最有价值的三件事是:在受控环境验证 ./scripts/install.sh --version v6.0.5 的回滚路径;确认 Agent 安装令牌确实携带了所勾选的命令执行作用域;以及在 Docker 更新、ZFS 池成员解析与 Patrol 超时行为上做回归观察。这些能力都能在上述源码路径中找到可直接验证的实现。