企业部署与机器策略

静默安装、用机器策略锁定关键配置，以及更新通道的集中管控。

本页面向 IT 管理员。

机器策略

优先级：受管策略 > 用户设置 > 内置默认值。被策略锁定的字段在控制台里显示锁图标且不可编辑，运行时修改会被拒绝（POLICY_LOCKED）。

文件位置

平台	路径
Windows	`%ProgramData%\PrintLink\policy.json`
Linux	`/etc/printlink/policy.json`
macOS	`/Library/Application Support/PrintLink/policy.json`

测试或特殊部署可用环境变量 PRINTLINK_POLICY_PATH 覆盖。

文件结构

{
  "version": 1,
  "policy": {
    "playground_enabled": false,
    "update_channel": "stable"
  },
  "signature": "<base64 ed25519 签名，可选>",
  "keyId": "corp-2026"
}

policy 里出现的字段即被锁定。可锁定字段：

字段	取值	说明
`port`	1024–65535	服务端口
`listen_scope`	`local` / `lan` / `public`	监听范围（锁定 `local` 会同时清空更宽的绑定地址）
`browser_access_enabled`	bool	是否允许浏览器站点接入
`new_site_policy`	`confirm` / `allowlist` / `deny`	新站点接入策略
`playground_enabled`	bool	调试台开关
`playground_real_print_enabled`	bool	调试台真实打印开关
`update_channel`	`stable` / `beta`	更新通道
`idempotency_mode`	`on` / `off`	打印幂等键开关
`health_monitor_enabled`	bool	打印机健康监控
`progress_window_enabled`	bool	浮动进度窗口

未知字段会导致整个策略被拒绝——避免管理员以为写错的字段已经生效。

签名与验签

signature 是对 policy 对象规范化 JSON 的 ed25519 签名（base64）。
验签公钥来自环境变量 PRINTLINK_POLICY_PUBKEY（base64，32 字节）。
带签名但验不过（签名错误、被篡改、或没配公钥）的策略会被整体拒绝，并记入审计；此时不应用任何锁定，用户设置照常生效，控制台会显示拒绝原因。
不带签名的策略按「受管文件」接受——机器级路径的文件权限就是信任边界。

导入 / 导出

控制台设置页的「机器策略」卡片提供：

导入：选择文件后先做差异确认（逐字段展示「当前值 → 策略值」），确认后才写入机器路径，并记审计事件。
导出：通过系统保存对话框导出当前策略文件（保留签名）。

端口 / 监听范围 / 站点 / 健康开关的锁定在下次服务启动时完全生效；其余字段立即生效。

Windows 静默安装

# 静默安装（默认目录）
PrintLink_x.y.z_x64-setup.exe /S

# 静默安装到指定目录（/D= 必须是最后一个参数，且不加引号）
PrintLink_x.y.z_x64-setup.exe /S /D=C:\Apps\PrintLink

策略文件可以在安装前或后放到 %ProgramData%\PrintLink\policy.json （GPO 文件分发 / MDM 均可）。PrintLink 每次启动与每次读取设置时都会重新读策略，无需重装。

更新通道

安装包版本集中在发布端管理。控制台「设置」或版本号旁的检查更新可获取最新版本与下载链接；企业环境可用机器策略统一指定通道（stable / beta）。