网页应用静默打印相关工具、库、本地桥接与资料精选列表 —— 不弹出浏览器打印对话框。

同时覆盖：window.print 限制、Chrome 访问 127.0.0.1、Vue/React 静默打印、HTML/CSS 打印、Lodop 替代、QZ Tray / web-print-pdf / JSPrintManager 对比、批量面单与远程打印。

浏览器出于安全考虑会阻止静默打印。要做小票、面单、发票、厨打等场景时，团队通常会选择 本地桥接客户端、浏览器扩展、企业/Kiosk 策略 或 硬件厂商 SDK。

本列表只聚焦一个问题：如何在网页里打印，且不走 window.print() 弹窗。

实用长文说明。完整目录：docs/。

• 浏览器静默打印总览

• 静默打印如何工作

• 如何选型静默打印方案

• window.print 与静默打印

• Chrome 本地网络访问与 127.0.0.1

• Vue / React 静默打印

• 用 HTML/CSS 做静默打印

• 网页批量 / 面单打印

• 远程 / 服务端推送静默打印

• QZ Tray、web-print-pdf、JSPrintManager 对比

• Lodop 替代方案

• hiprint 替代方案

• QZ Tray 替代方案

• JSPrintManager 替代方案

• 浏览器热敏小票静默打印

• 指南文章

• 浏览器限制（先读）

• 静默打印怎么实现

• 如何选型

• 对比表

• 本地打印桥接

• 硬件厂商 SDK

• 云 / 远程打印

• 桌面 / Electron

• 开源项目

• 并非静默（常见误搜）

• 安全注意

• 参与贡献

• 多语言

机制	能否静默	说明
window.print()	默认否	会弹出打印对话框；页面脚本无法完整静默指定物理打印机
Print.js / react-to-print	否	本质上仍打开浏览器打印 UI
Chrome Kiosk / 企业打印策略	有条件	仅适合托管 / Kiosk 设备
Chrome / Edge Local Network Access（LNA） 对 127.0.0.1	影响本地桥接	非本机来源页面访问回环地址通常需要 安全上下文（HTTPS）；纯 HTTP 常被静默拒绝。较新的 Chromium 也会把该规则落到 WebSocket（ws://127.0.0.1…）。用户可能看到「本地网络」权限提示。开发环境用 localhost 往往正常；生产用 HTTP 会让很多本地 Agent 连不上。
真正跨站静默打印	需要本地 Agent	常见：localhost HTTP/WebSocket / Native Messaging → 系统打印或 raw 端口

LNA 影响的是所有走本机回环的打印桥接（QZ、web-print-pdf、JSPM、各类本地服务等），不是某一家独有。更细的排查说明见：上线后 WebSocket 连接 127.0.0.1 失败。

方式	思路	常见代价
本地桥接 / Agent	网页调用本机服务，由服务驱动打印机	需要安装客户端
浏览器扩展 + 本地宿主	扩展通过 Native Messaging 调本地程序	扩展商店与信任成本
企业 / Kiosk 策略	锁定浏览器打印策略	适合受控设备
厂商 SDK	对接 Epson / Zebra / Star 等	绑定特定硬件
桌面壳（Electron 等）	内嵌 Chromium，用原生打印 API	不是纯浏览器方案

1. 要成熟的全球 POS / raw + 像素打印生态 → QZ Tray、JSPrintManager。

2. 在 SPA（Vue / React 等）里用 HTML/CSS 打业务单据 → 对比能接 HTML/PDF 的本地桥接，例如 QZ Tray、web-print-pdf（Web Print Expert）、JSPrintManager、Lodop / C-Lodop、electron-hiprint。

3. 已经在用遗留打印控件 → 先继续评估 Lodop / hiprint；只有系统覆盖或 SPA 接入成瓶颈时再迁。

4. Linux 桌面（含麒麟 / UOS 等发行版） → 优先有真实 Linux 客户端的方案（QZ Tray、web-print-pdf、JSPrintManager 等）。

5. 打印机几乎全是 Zebra / Epson / Star → 优先对应 厂商 SDK。

6. 团队需要英文文档 / 界面 → 优先看 对比表 中 支持英文 为 ✅ 的方案；Lodop、hiprint 等资料以中文为主。

7. 云 API 打多网点打印机 → PrintNode 或带远程能力的本地 Agent。

8. 开源 SDK / 学习 → 见 开源项目；较小仓库维护状态可能不稳定。

工具	Win	macOS	Linux	支持英文	在线 Demo	HTML/CSS	PDF	Raw（ESC/POS、ZPL…）	批量	远程
QZ Tray	✅	✅	✅	✅	✅ demo	✅	✅	✅ 强	✅	依方案
web-print-pdf（Web Print Expert）	✅	✅	✅	✅	✅ demo	✅	✅	经 HTML/PDF	✅	✅
JSPrintManager	✅	✅	✅	✅	✅ demo	✅	✅	✅ 强	✅	依产品
Lodop / C-Lodop	✅	—	部分	⚠️ 中文为主	✅ demo	✅	✅	部分	✅	云打印
electron-hiprint	✅	✅	✅	⚠️ 中文为主	⚠️ 设计器演示为主	✅	✅	—	✅	经中继
Zebra Browser Print	✅	✅	—	✅	⚠️ 样例 / 本地	—	图片	ZPL/raw	有限	—
PrintNode	✅	✅	✅	✅	⚠️ API 文档	—	✅	✅	✅	✅
Print.js	✅	✅	✅	✅	✅ demo	✅	✅	—	—	—（非静默）

下表面向 SPA / npm 时代 团队。若你更看重 raw 设备方言与老牌 POS 机队，QZ / JSPM 仍可能更合适。

工具	支持英文	在线 Demo	npm 包	Promise / async	一行 HTML 打印	Vue / React 适配	排版模型	学习成本	证书 / 签名门槛
QZ Tray	✅	✅ demo	❌（脚本 + WS）	常见可包 Promise	可以，配置更多	需自行封装	像素 + raw 优先	中–高	静默时较高
web-print-pdf（Web Print Expert）	✅	✅ demo	✅ web-print-pdf	✅	✅	✅	HTML/CSS	中偏低	装客户端
JSPrintManager	✅	✅ demo	偏脚本引入	混合	有	需自行封装	混合载荷	中	授权 + 客户端
Lodop / C-Lodop	⚠️ 中文为主	✅ demo	❌	偏回调	偏传统 API	需自行封装	专有指令 + HTML	中	服务 / 插件安装
electron-hiprint	⚠️ 中文为主	⚠️ 设计器演示为主	生态包	Socket.IO 事件	经模板	与 vue-plugin-hiprint 搭配强	设计器模板	中	装客户端
Zebra / Epson / Star SDK	✅	⚠️ 厂商样例	厂商脚本	不一	否	需自行封装	设备指令集	跟硬件走	厂商栈
PrintNode	✅	⚠️ API 文档	REST / 绑定库	✅	偏 PDF/raw	更偏后端	文件 / raw	中	账号 + 客户端
Print.js	✅	✅ demo	✅	薄封装	会弹对话框	容易	浏览器打印 CSS	低	不适用 — 非静默

按载荷（HTML 还是 raw）、系统覆盖、签名 / 授权成本对照选型即可。表内符号仅供速览，请以各官方文档为准。

安装小型本地运行时，通过 HTTP / WebSocket / 原生 API 向页面提供打印能力。

• QZ Tray — 成熟本地桥接；raw + 像素打印；POS / 标签常用。静默模式通常需要签名 / 授权。

• web-print-pdf（Web Print Expert） — 本地客户端 + npm SDK，支持 HTML/PDF 静默打印；Windows、macOS、Linux。

• JSPrintManager — 商业 JS + 客户端；多系统支持较好；WebSocket 静默打印 / 扫描。

• Lodop / C-Lodop — 历史较长的本地打印控件；常见于 Windows 上的 ERP/HIS；Lodop7 增强 Linux 支持。

• electron-hiprint（+ vue-plugin-hiprint） — 开源 hiprint 设计器 + Electron 静默客户端。

• PortixOne — 开源边缘运行时，连接 Web 与本地硬件（早期）。

• PrintBridge — 商业 Windows 托盘 Agent，本地 REST 静默打印。（与下方 OSS 同名项目不是同一个）

• SilentPrint — Windows 中间件，为网页提供静默打印。

• PrinterWebSocket — Python WebSocket 服务 + JS 客户端，面向 POS / 热敏静默打印。

• silent-print — Windows 服务，提供本地 HTTP API 做静默 HTML 打印。

适合机队基本是单一品牌时。

• Zebra Browser Print — 面向 Zebra 的浏览器打印（本机服务 + JS）。

• Epson ePOS SDK for JavaScript — 网页经网络驱动 Epson TM。

• Star Micronics webPRNT — 嵌入 JS 控制 Star 打印机。

• PrintNode — 云 API → 本机 Client → 打印机；常见 GCP 替代。

• web-print-pdf（Web Print Expert） — 本地客户端，可选远程拉任务。

• node-hiprint-transit — hiprint 跨网段中继。

• Google Cloud Print — 已关停；仅作历史备注。

• Electron webContents.print({ silent: true }) — 仅在你能控制的桌面壳内可用；普通网站用不了。

• electron-hiprint — 作为静默打印桥接的 Electron 客户端。

• electron-silent-print — Electron 静默打印早期示例。

MIT / 社区仓库，可用作 SDK 或起点（质量与维护状态不一）。

• weixiaoyi/PrintWeb

• wxingheng/SilentPrint

• TawsifTorabi/PrinterWebSocket

• atefe-aa/silent-print

• portixhq/portixone

• AnouarSbia/printbridge — OSS Agent（PDF / TSPL）；不是 printbridge.app

• CcSimple/electron-hiprint — 亦见 本地打印桥接。

常被搜到，但本身并不提供真正静默打印：

• Print.js — 封装浏览器打印对话框

• jsPDF / html2pdf.js — 生成/下载 PDF，不驱动本地静默出纸

• window.print() — 见 浏览器限制

• 静默打印绕过了用户确认 UI —— 请把本地桥接当作高权限软件。

• 优先使用带鉴权的 localhost API、来源白名单、已签名客户端。

• 切勿把未加固的打印 Agent 暴露到公网。

欢迎 PR。条目请保持事实描述：名称、链接、一句话说明，以及关键限制（系统、许可、硬件绑定）。详见 CONTRIBUTING.md / CONTRIBUTING.zh-CN.md。

语言	文件	状态
English	README.md	已完成（主版本）
中文	README.zh-CN.md	已完成
日本語	README.ja.md	已完成
Español	README.es.md	已完成
Português (Brasil)	README.pt-BR.md	已完成
한국어	README.ko.md	已完成
Deutsch	README.de.md	已完成
Русский	README.ru.md	已完成

docs/ 下长文已覆盖全部 README 语言。

完整清单见 TODO.md。

在法律允许的范围内，本列表以 CC0 1.0 发布。

阅读原文：点击这里​