Windows 部署与集成指南

在 Windows 10/11 办公机、收银 POS 或仓库 PC 上部署 Web打印专家客户端,并接入 web-print-pdf 实现网页静默打印与 HTML 转 PDF。与 macOS、Linux/信创版 API 完全一致,便于混合环境统一前端代码。

三端客户端对照

版本平台打印后端安装包
Windows 版Windows 10/11内置静默打印引擎.exe
Linux 版x64 / arm64系统标准打印服务.deb / .rpm
macOS 版macOS 11+CUPS.dmg

官网提供 Windows、macOS、Linux 三套客户端,安装包形态不同,但对外暴露同一套 WebSocket API(/websocket/standard),前端 web-print-pdf 代码无需区分平台。

安装步骤(exe)

  1. 从 下载页 获取 Windows exe 安装包
  2. 双击安装,按向导完成;安装后从开始菜单启动「Web打印专家」
  3. 确认托盘或主界面显示服务已启动(WebSocket 监听本地端口)
  4. 前端项目 npm install web-print-pdf,与 Mac/Linux 使用相同 API

防火墙与 WebSocket 联调

客户端在本机 127.0.0.1 提供 WebSocket;浏览器页面通过 npm 包连接。若提示连接失败,请检查:

  • 客户端是否已启动(托盘图标/主窗口)
  • Windows 防火墙是否拦截该应用(首次运行可允许专用/公用网络)
  • 安全软件是否阻止本地 WebSocket
  • 调用 webPrintPdf.utils.getConnectStatus() 预检;详见 错误处理专题

前端接入

Windows 终端浏览器中的页面与 Mac、Linux 使用相同 npm 包:

npm install web-print-pdf
import webPrintPdf from 'web-print-pdf';

await webPrintPdf.printHtml(
  '<h1>Hello Windows</h1>',
  { paperFormat: 'A4', printBackground: true },
  { printerName: 'Default printer' }
);

本地服务地址为 ws://127.0.0.1:{端口}/websocket/standard,端口以客户端界面为准;web-print-pdf 默认自动连接。

部署要点

  • Windows 与 Linux/信创可共用同一套前端打印代码,适合办公 PC + 国产桌面混合 rollout。
  • 静默打印由客户端内置引擎完成,不依赖浏览器打印对话框。
  • 多打印机环境通过 printOptions.printerName 指定;枚举 API 见开发文档。

常见问题

Windows 10 和 Windows 11 都支持吗?

支持。请从官网下载页获取当前支持的 Windows 版本对应的 exe 安装包。

浏览器提示无法连接客户端怎么办?

先确认客户端已启动;检查防火墙与安全软件;使用 getConnectStatus 预检。仍失败请参考错误处理专题。

能否与 Mac、信创 Linux 混用同一套前端?

可以。三端 clients 共用 web-print-pdf API,仅终端安装包不同。

需要管理员权限吗?

安装 exe 时可能需要管理员确认;日常运行与打印一般不需要持续管理员权限。

各平台客户端部署

同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。

免费下载 Windows 客户端 查看 npm 包 开发文档