Windows 防火墙与打印客户端排障

Windows 10/11 上防火墙或安全软件可能拦截本地 WebSocket,导致 printHtml 报连接失败。本文针对 Windows 工位排查,Linux/信创见 linux-deploy。

常见现象

现象方向
新装客户端后无法连接放行 exe 专用规则
域策略环境失败联系 IT 放行 127.0.0.1 回环
仅 Wi-Fi 失败检查「公用网络」配置文件

排查步骤

  1. Windows 安全中心 → 防火墙 → 允许应用 → 勾选 Web打印专家
  2. 或添加入站/出站规则允许本地 exe
  3. 确认客户端监听 127.0.0.1(非 0.0.0.0 外网)
  4. 与 WebSocket 排障 对照
  5. 部署清单见 Windows 部署

预防建议

  • 安装脚本提示用户放行防火墙
  • 企业 GPO 预置允许规则
  • 收银/仓库 PC 用「专用网络」配置文件

延伸阅读

常见问题

需要关防火墙吗?

不需要长期关闭;添加允许规则即可。

127.0.0.1 也要放行?

部分安全软件仍拦截回环;需单独允许 exe。

Server 2019 远程桌面?

每个 RDP 会话独立客户端实例;在用户会话内安装启动。

Mac 防火墙?

见 mac-deploy;本文仅 Windows。

如何验证已恢复?

getConnectStatus 返回 true 后再试 printHtml preview。

各平台客户端部署

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

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