Linux 与国产系统部署指南
平台版本说明
| 版本 | 平台 | 打印后端 | 安装包 |
|---|---|---|---|
| Windows 版 | Windows 10/11 | 内置静默打印引擎 | .exe 安装程序 |
| Linux 版 | Linux x64 / arm64 | 系统标准打印服务 | .deb / .rpm |
官网提供 Windows 与 Linux 两套客户端，安装包形态不同，但对外暴露同一套 WebSocket API（/websocket/standard），前端 web-print-pdf 代码无需区分平台。
终端用户安装（deb）
# 命令行安装示例
sudo dpkg -i Web打印专家_*_amd64.deb
sudo apt-get install -f # 修复依赖
# 启动（安装后从菜单或命令行均可）| 项 | 说明 |
|---|---|
| 安装方式 | deb 双击或 dpkg -i |
| 安装位置 | 系统应用程序目录（由安装包自动配置） |
| 启动 | 桌面菜单「Web打印专家」或安装目录快捷方式 |
| 架构 | x64（amd64）与 arm64 分别提供 deb |
系统依赖（deb 包声明）
Linux 安装包会声明运行时依赖，典型包括：
- 系统打印客户端组件 — Linux 静默出纸所必需
- 图形界面与字体渲染相关运行库
- 建议预装常用中文字体包，避免 PDF 或打印输出中文缺字
若终端缺少打印服务或系统运行库，客户端启动时会打开内置环境说明页，按提示补装依赖即可，终端用户无需 Node.js 环境。
自行构建 Linux 安装包（进阶）
适用于有定制打包需求的团队：获取官方工程源码，按随附文档完成依赖安装与打包。
# 示意流程（具体命令以工程文档为准）
1. 安装构建依赖与前端工具链
2. 拉取源码并安装项目依赖
3. 执行 Linux 打包命令（deb / rpm）
4. 在目标系统上安装验证典型流程包括：准备前端资源 → 校验本地排版引擎与系统库 → 产出安装包。
rpm 格式需额外安装系统打包工具链，具体命令以工程随附说明为准。
跨平台打印实现概览
HTML→PDF 由客户端内置排版渲染引擎完成；实际出纸阶段由平台打印栈接管：
- Windows：经客户端内置静默打印组件投递至系统打印队列
- Linux：对接系统标准打印服务完成静默出纸
对前端而言，printOptions.printerName 仍传入打印机名称；各平台名称列表由客户端统一封装后通过 API 返回。
部署要点
- Linux 客户端支持检查更新，按架构读取对应的更新描述文件。