Web 静默打印 · 本地 Agent
npm 包 web-print-pdf

Web打印专家 Web 静默打印 SDK 与本地打印 Agent

无需浏览器弹窗,直接将 HTML / PDF 打到本地打印机

面向 Web 应用的静默打印 SDK 与本地打印 Agent:JavaScript 一行调用即可出纸。配套 npm 包 web-print-pdf,支持 Vue / React;Windows、macOS、Linux 通用,并适配银河麒麟、统信 UOS。数据本地处理不上云。

静默打印方案入门 →

10000+ 开发者使用
99.9% 服务稳定性
×ばつ24 技术支持
  • 静默打印,无需浏览器弹窗
  • HTML / PDF / 图片一键出纸,样式由 CSS 控制
  • 本地处理,数据不上云
  • 适配 Win / Mac / Linux 与麒麟、UOS
quick-start.js
import webPrintPdf from 'web-print-pdf';
await webPrintPdf.printHtml(
 '<h1>Order details</h1>',
 { paperFormat: 'A4' },
 { printerName: 'Default printer' }
);
await webPrintPdf.printHtmlByUrl(
 'https://example.com/page.html',
 { paperFormat: 'A4' }
);
await webPrintPdf.printPdfByUrl(
 'https://example.com/doc.pdf'
);
信创适配

支持大部分 Linux 与国产操作系统

专为信创与国产化替代场景打造,已在银河麒麟、统信UOS 等国产 Linux 系统上稳定运行,助力政务、金融、能源等行业完成 Web 打印国产化改造

银河麒麟 统信 UOS Ubuntu Debian 更多 Linux
  • 原生 deb 包安装,无需额外兼容层
  • 本地 HTML 转 PDF,数据不出内网
  • 同一套 API,Windows 与国产 Linux 无缝切换
下载 Linux 客户端

产品优势

内置 Chrome 引擎,所见即所打

客户端内置 Chromium 内核渲染前端页面,CSS3、Flex/Grid、主流组件库样式与浏览器预览高度一致,打印效果与屏幕所见相同,复杂报表、票据、动态页面不再走样。

为前端而生,接入调试极简

printHtml 一行调用即可打印,适配 Vue、React,无需浏览器插件。打印参数灵活可配,支持水印、纸张与打印机选择。客户端内置编辑器,联调 API 更便捷。

跨平台客户端,一套 API 通用

提供 Windows、Linux、macOS 安装包,深度适配银河麒麟、统信 UOS 等信创环境;业务系统迁移或换平台时无需改打印代码,同一套 web-print-pdf API 即可部署。

核心打印 API

安装客户端后,执行 npm install web-print-pdf 即可调用 · 查看完整文档

printHtml

打印 HTML 字符串,支持 HTML 片段和完整页面

printHtmlByUrl

打印在线 HTML 地址,支持任意网站链接,可配置 Cookies、Headers、超时等参数

printHtmlByBase64

打印 Base64 编码的 HTML 内容

printPdfByUrl

打印在线 PDF 地址,快速下载并输出到指定打印机

printPdfByBase64

打印 Base64 格式的 PDF 文件

printImageByUrl

打印在线图片 URL

printImageByBase64

打印 Base64 格式的图片

batchPrint

批量提交多个打印任务,适合面单、发票等场景

打印预览

打印前浏览器级预览,确认样式后再输出

核心特性

极简 API,一行调用

printHtml 一行代码即可完成 HTML 转 PDF 并打印,学习成本低,快速接入现有前端项目。

降低开发成本

客户端主题定制

通过 API 自定义客户端标题、主题色与布局,打造符合企业品牌的打印工具界面。

个性化定制

HTML/CSS 决定 PDF 样式

沿用前端熟悉的 HTML 和 CSS 编写打印模板,所见即所得,无需学习额外排版语法。

样式完全可控

高性能批量队列

内置任务队列管理,高效处理大量打印任务,适合 ERP、WMS 等系统的批量输出需求。

高效处理

稳定可靠

完善的错误处理与日志记录,打印任务状态可追踪,保障生产环境长期稳定运行。

稳定可靠

技术支持

提供详细文档、示例代码与邮件支持,帮助开发者快速完成 web-print-pdf 集成与调试。

快速响应

典型适用场景

一行 API,搞定信创内网、管理后台、面单报表与静默打印——前端最头疼的打印问题,这里有现成答案

信创 & Linux

国产系统与 Linux 桌面

银河麒麟、统信 UOS、Ubuntu 等环境与 Windows 共用同一套 API,打印能力无缝迁移。

  • 原生 deb 部署,无需虚拟机或兼容层
  • 政务、金融、能源等行业打印改造
管理后台

Vue / React 静默打印

SPA 里订单、报表、票据直接打出,不再弹出浏览器打印对话框。

  • npm install web-print-pdf 一行接入
  • 适合 ERP、CRM、OMS 等业务系统
动态模板

HTML 报表与面单

动态拼接 HTML 模板,printHtml 直打,样式完全由 CSS 掌控。

  • 快递面单、小票、发货单高频场景
  • Chrome 内核渲染,所见即所打
替代 window.print

可控静默打印

突破 window.print 的限制,用 JS 全权驱动本地打印机。

  • 静默输出,支持批量队列
  • 纸张、水印、边距参数灵活配置

功能预览

Web打印专家客户端 - 设备与授权信息

基本信息

设备特征码、授权状态、试用信息一目了然

Web打印专家 - 打印机设置与管理

打印机设置

多打印机管理,轻松设置默认打印机

Web打印专家 - 远程打印配置,支持 WebSocket 与 HTTP 轮询

远程打印

实时监听远程服务端接口,获取新打印消息后自动输出,支持 WebSocket 与 HTTP 轮询,消息格式与 web-print-pdf npm 包一致

Web打印专家 - 打印任务日志

日志管理

HTML、PDF、打印日志分类管理,实时监控任务状态

Web打印专家 - 在线代码调试

实时运行示例

内置代码编辑器,实时测试 web-print-pdf API

Web打印专家 - 打印预览

打印预览

打印前预览 PDF 效果,确保输出符合预期

Web打印专家 - 主题定制

定制主题

自定义主题色和页面布局,打造专属打印客户端

客户部署案例

以下为匿名化场景摘要,供选型参考;具体配置因环境而异。

政务信创

Vue 管理后台 + 银河麒麟桌面

某省级单位内网 OA 需在国产终端上静默输出财政票据,替代浏览器打印对话框。

查看政务信创案例
物流 WMS

仓储系统远程面单打印

某物流企业 WMS 由服务端推送面单任务,仓库 PC 自动打印,无需人工点选。

查看物流 WMS 案例
制造 ERP

统信 UOS 产线报表打印

某制造企业产线工位使用统信 UOS,需将 ERP 动态 HTML 报表直接打到本地打印机。

查看制造 ERP 案例

常见问题

Web打印专家和 window.print 有什么区别?

window.print 依赖浏览器打印对话框,样式可控性有限且无法静默打印。Web打印专家通过本地客户端配合 web-print-pdf,支持 HTML/CSS 精确控制 PDF 输出、静默打印和批量任务。

web-print-pdf 怎么安装和使用?

下载并安装客户端,再在项目中执行 npm install web-print-pdf,引入后调用 printHtml、batchPrint 等 API,即可用 JavaScript 驱动本地打印机,无需浏览器弹窗。

是否支持 HTML 字符串转 PDF 打印?

支持。printHtml 接口可直接传入 HTML 字符串,PDF 样式由 HTML 和 CSS 决定,适合动态生成的报表和票据。

支持 Vue 和 React 项目吗?

支持。web-print-pdf 是标准 npm 包,可在 Vue、React、Angular 及 Node.js 项目中集成。

数据是否上传到云端?

不会。所有 HTML 转 PDF 和打印处理均在本地完成,适合对数据安全有要求的企业内网环境。

Web打印专家是否支持批量打印?

支持。通过 batchPrint API 可一次提交多个打印任务,适合快递面单、发票、报表等大批量输出场景。

银河麒麟和统信UOS上如何实现前端静默打印?

在银河麒麟或统信UOS桌面安装 Web打印专家 deb 客户端,前端项目 npm install web-print-pdf 后调用 printHtml 即可实现无浏览器弹窗的 JavaScript 静默打印,适合信创内网管理后台与 ERP 系统。

Web打印专家可以免费试用吗?

可以。下载客户端并安装 web-print-pdf npm 包即可免费试用,体验完整 HTML 转 PDF、静默打印和打印机管理功能。

下载试用

先装客户端跑通打印,再按需购买授权

安装 npm 包 web-print-pdf

客户端安装后,在前端项目中集成 JavaScript 打印 API

npm install web-print-pdf
查看 npm 包

下载 Windows 客户端

下载 Windows 桌面客户端,启用完整 HTML 转 PDF、打印机管理与批量打印功能

Windows 10/11

下载 Linux 客户端

支持大部分 Linux 发行版,含银河麒麟、统信UOS、Ubuntu、Debian 等

x64 / amd64

下载 macOS 客户端

支持 Apple Silicon 与 Intel 芯片 Mac,dmg 安装包一键部署

x64 / amd64

更多平台与功能

更多系统架构与客户端能力正在开发中,后续版本将在此发布

Linux arm64 · 更多特性
即将推出

试用满意后如何购买

下载客户端试用 → 打开价格页选方案付款 → 微信发送机器码开通授权