Linux & domestic OS deployment
Deploy the Web Print Expert client on Kylin, UOS, Ubuntu, Debian, and more; integrate web-print-pdf for web printing and HTML to PDF.
Platform editions
| 版本 | 平台 | 打印后端 | 安装包 |
|---|---|---|---|
| Windows 版 | Windows 10/11 | 内置静默打印引擎 | .exe 安装程序 |
| Linux 版 | Linux x64 / arm64 | 系统标准打印服务 | .deb / .rpm |
Windows and Linux ship as separate installers but share the same WebSocket API (<code>/websocket/standard</code>)—front-end code stays platform-agnostic.
End-user deb install
- Download the Linux deb from the download page.
- On Kylin / UOS: double-click the deb or run
sudo dpkg -i. - Launch the client, complete setup, and verify the local print service.
npm install web-print-pdf—same APIs as on Windows.
# 命令行安装示例
sudo dpkg -i Web打印专家_*_amd64.deb
sudo apt-get install -f # 修复依赖
# 启动（安装后从菜单或命令行均可）| 项 | 说明 |
|---|---|
| 安装方式 | deb 双击或 dpkg -i |
| 安装位置 | 系统应用程序目录（由安装包自动配置） |
| 启动 | 桌面菜单「Web打印专家」或安装目录快捷方式 |
| 架构 | Separate deb for x64 (amd64) and arm64 |
System dependencies (deb)
The Linux installer declares runtime dependencies, typically including:
- 系统打印客户端组件 — Linux 静默出纸所必需
- 图形界面与字体渲染相关运行库
- Install common CJK font packages to avoid missing glyphs in PDF or print output
Building Linux packages (advanced)
For custom builds: obtain the project sources and follow the bundled packaging guide.
# 示意流程（具体命令以工程文档为准）
1. 安装构建依赖与前端工具链
2. 拉取源码并安装项目依赖
3. 执行 Linux 打包命令（deb / rpm）
4. 在目标系统上安装验证Typical steps: prepare front-end assets → verify layout engine and system libs → produce deb/rpm packages.
RPM builds need extra system packaging tools; see the project documentation for commands.
Cross-platform print overview
HTML→PDF uses the client’s built-in layout engine; output is handed to each platform’s print stack:
- Windows：经客户端内置静默打印组件投递至系统打印队列
- Linux：对接系统标准打印服务完成静默出纸
Front-end still passes <code>printOptions.printerName</code>; printer lists are normalized by the client API.
Notes
- Share one front-end print codebase across Linux and Windows endpoints.
- deb install needs root; runtime can use a normal user.
- Works offline on intranet; PDF generation is local.
- Linux clients support updates via architecture-specific update descriptors.