Linux 与国产系统部署指南
在银河麒麟、统信 UOS、Ubuntu、Debian 等环境部署 Web打印专家客户端，并接入 web-print-pdf 完成网页打印与 HTML 转 PDF。
平台版本说明
| 版本 | 平台 | 打印后端 | 安装包 |
|---|---|---|---|
| Windows 版 | Windows 10/11 | 内置静默打印引擎 | .exe installer |
| Linux 版 | x64 / arm64 | 系统标准打印服务 | .deb / .rpm |
| macOS 版 | macOS 11+ | CUPS | .dmg |
官网提供 Windows 与 Linux 两套客户端，安装包形态不同，但对外暴露同一套 WebSocket API（/websocket/standard），前端 web-print-pdf 代码无需区分平台。
终端用户安装（deb）
- 从 下载页 获取 Linux deb 安装包。
- 银河麒麟 / 统信 UOS：一般可直接双击 deb 安装；或使用
sudo dpkg -i安装。 - 安装完成后启动客户端，完成初始配置并确认本地打印服务正常运行。
- 在前端项目中
npm install web-print-pdf，与 Windows 环境使用相同 API。
# 命令行安装示例
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. 在目标系统上安装验证典型流程包括：准备前端资源 → 校验本地排版引擎与系统库 → 产出 deb/rpm 安装包。
rpm 格式需额外安装系统打包工具链，具体命令以工程随附说明为准。
跨平台打印实现概览
HTML→PDF 由客户端内置排版渲染引擎完成；实际出纸阶段由平台打印栈接管：
- Windows：经客户端内置静默打印组件投递至系统打印队列
- Linux：对接系统标准打印服务完成静默出纸
对前端而言，printOptions.printerName 仍传入打印机名称；各平台名称列表由客户端统一封装后通过 API 返回。
部署要点
- Linux 与 Windows 可共用同一套前端打印代码，便于信创终端与办公 PC 混合部署。
- 安装 deb 需要 root 权限；日常运行可不使用管理员账户。
- 内网环境无需外网，HTML 转 PDF 在本地客户端完成。
- Linux 客户端支持检查更新，按架构读取对应的更新描述文件。