银河麒麟桌面静默打印指南

在 银河麒麟 政务/金融终端部署 Web打印专家 deb 客户端,前端 npm install web-print-pdf 后调用 printHtml,与 Windows 办公机共用同一套代码。通用步骤见 Linux 部署。

更新于 2026-10 · web-print-pdf v2.1.7 · 本地处理 · 数据不上云

与通用 Linux 部署的关系

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

麒麟基于 Linux,安装流程与 deb 包一致;注意 CPU 架构(x64/arm64)与内网软件源策略。

安装步骤(deb)

  1. 从 下载页 获取对应架构 deb
  2. 双击或 sudo dpkg -i 安装并启动客户端
  3. 确认 WebSocket 服务已监听
  4. 前端集成 printHtml,与 Vue 专题相同

联调与排障

内网环境常见问题:

  • 客户端是否开机自启
  • 浏览器能否访问 127.0.0.1 WebSocket
  • 安全策略是否拦截本地端口
  • 使用 getConnectStatus() 预检

前端接入

与 Windows/macOS 相同:

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' }
);

信创 OA/ERP 与 Windows 分支使用相同 npm API,仅安装包不同。

部署要点

  • 麒麟 + Windows 混合环境可共用前端打印代码。
  • 财政/票据类场景建议 PoC 边距与打印机枚举。
  • 从 Lodop 迁移见 Lodop 迁移指南。

信创采购与立项评估

  • 适配范围:确认麒麟 V10 版本与 CPU(x64/arm64)在下载页有对应 deb
  • 授权:按安装客户端的桌面数;政务分支与总部 Windows 分别清点
  • 混合环境:与 Windows/UOS 共用 npm 版本;HTML 模板跨平台一致
  • 合规:业务 HTML 本地渲染不上云,满足政务/金融内网审计
  • 验收:getConnectStatus + 指定打印机静默 + 与 Windows PoC 样张边距对照
  • 并行:Lodop 存量可保留,见 迁移指南;UOS 工位见 UOS 专题

上线前检查表

  • deb 架构(x64/arm64)与麒麟版本匹配
  • 客户端开机自启与 WebSocket 端口可达
  • 浏览器/Electron 可访问 127.0.0.1
  • PoC 样张边距、打印机枚举与 Windows 对照
  • 运维文档注明与 Lodop 并行策略(如有)

与本站专题分工

常见问题

麒麟 V10 支持吗?

支持。请使用官网当前提供的 deb 包与架构说明。

统信 UOS 是否相同?

API 相同,安装包可能不同。见 UOS 专题。

麒麟工位与 Windows 总部共用前端吗?

可以。同一套 printHtml 代码;仅客户端安装包按 OS 区分。见 Vue 专题。

各平台客户端部署

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

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