PrintRelay 跨网打印系统

内网互不相通的电脑,经公网服务器串联打印。全 Windows、无需 SMB、无需装 Python,解压即用。

公网中继:101.34.207.236 中继端口:8443(TLS 加密) 支持 Win7 / 10 / 11,32 / 64 位 支持手机打印

一、下载安装包

四个包各自独立,目标机器不需要安装 Python 或任何运行库。解压后双击根目录的 PrintRelay_Console.exe 即可——它会自动提权装好系统服务,并常驻托盘显示状态灯(绿=正常 / 黄=断线重连 / 红=服务异常)。

公网服务器

部署在 101.34.207.236
  • 中继 + 鉴权 + 路由
  • 监听 8443
  • 管理口 8444(仅本机)
下载服务器包
PrintRelay_server · 约 31 MB · 检测中

打印节点

部署在接打印机的电脑
  • 自动发现本机打印机
  • 执行 RAW / PCL / PS 打印
  • 32 / 64 位通用 · 无入站端口
下载节点包
PrintRelay_node · 约 56 MB · 检测中

客户端电脑

部署在所有其他内网电脑
  • 本机 9100 截获打印任务
  • 自动添加 PrintRelay 打印机
  • 32 / 64 位通用
下载客户端包
PrintRelay_client · 约 44 MB · 检测中

手机打印网关

可与打印节点装在同一台
  • 网页上传打印
  • AirPrint / Mopria(IPP)
  • 监听 6310(仅内网)
下载手机打印包
PrintRelay_mobile · 约 31 MB · 检测中

二、部署顺序

按这个顺序装,前一步没通之前不要做下一步。

第 1 步公网服务器

放服务器包 → 双击 PrintRelay_Console.exe(弹 UAC 点“是”)→ 防火墙放行 TCP 8443。

第 2 步打印节点

先装打印机原厂驱动并打出测试页 → 装节点包 → 托盘变绿且打印机出现在列表。

第 3 步客户端电脑

装客户端包 → 自动添加 PrintRelay 打印机 → 打印测试页验证。

第 4 步手机(可选)

装手机打印包 → 浏览器打开 http://节点内网IP:6310/。

三、安装与配置

点选对应角色查看详细步骤。统一入口是双击 PrintRelay_Console.exe,会自动提权,无需手动找“以管理员身份运行”。

托盘控制台(每个包根目录都有)
  • 状态灯:绿色 = 服务正常且中继已连接;黄色 = 服务在跑但中继断线重连中;红色 = 服务未运行/异常。鼠标悬停看详情(在线设备、打印机数、待处理任务)。
  • 右键菜单:状态详情、重启服务、查看日志、退出(退出只关托盘,服务继续跑)。
  • 开机自启 + 守护:安装时自动配置当前用户开机自启;服务被停会自动拉起,托盘异常退出由守护进程重启。你主动点退出则不会重启。
  • 防误杀:服务以 LocalSystem 运行,普通用户在任务管理器里无法结束它。
  • 自动更新:每天定时(默认凌晨 3 点)自动从服务端检查更新,只替换应用代码,不动你的配置和打印数据;下载有 SHA256 校验,更新失败自动回滚。右键「检查更新」可立即手动触发。以后我们发布新版本,你不用再下载重装。
  • 32/64 位通用:节点包和客户端包内置两套运行时,托盘会自动识别系统架构并选用,32 位机与 64 位机下载同一个包即可,无需区分。(服务器包、手机包为 64 位)
  • 排障:命令行执行 PrintRelay_Console.exe --status,或看 data\tray_stderr.log。

公网服务器(server)

  1. 把包解压到 C:\PrintRelay\Server(路径不要有中文和空格)。
  2. 双击包根目录的 PrintRelay_Console.exe(弹 UAC 点“是”,自动装服务并显示托盘状态灯)。
  3. 确认服务:sc query PrintRelayServer,状态应为 RUNNING。
  4. 服务器防火墙放行入站 TCP 8443。
  5. 管理接口只绑本机:http://127.0.0.1:8444/api/status,不要公网放行。

关键配置(config/config.yaml)

项值说明
listen_port8443中继端口,改了要同步改所有客户端包
tls.enabledtrue已启用,证书与私钥在 certs/
token_secret / enroll_key随机强密钥已预置;若泄露,全部端要同步更换
admin.port8444只读状态接口,仅 127.0.0.1
私钥不能外发certs/server.key 只在服务器包里。任何客户端拿到它就可以伪造服务器。

打印节点(node,接打印机的电脑)

  1. 先把打印机接到这台电脑,装好原厂驱动,在系统里打出测试页。这一步不通,后面都不用看。
  2. 解压节点包,双击 PrintRelay_Console.exe(自动提权装服务)。
  3. 确认服务 PrintRelayNode 正在运行。
  4. 在服务器上打开 http://127.0.0.1:8444/api/printers,应能看到这台电脑的打印机。
  5. 电源设置里关闭休眠,这台机器相当于打印服务器,必须常开。

关键配置

项说明
server_host / server_port已预填 101.34.207.236:8443
printer_names留空 = 发布本机所有打印机;填名称列表 = 只发布指定打印机
sumatra_path打 PDF 需要装 SumatraPDF 并填它的绝对路径;只打 RAW/PCL/PS 可不填
spool_dir任务临时目录,默认 data/node_spool
多台打印机 / 多个节点节点会自动枚举本机所有打印机并上报,多个节点上报的列表在服务器上合并。客户端看到的是一张完整列表,按目标选择即可。详见下方「打印机型号」章节。

客户端电脑(client)

  1. 解压客户端包,双击 PrintRelay_Console.exe(自动提权装服务并添加打印机)。
  2. 脚本会注册服务 PrintRelayClient,并自动添加名为 PrintRelay 的本地打印机,指向 127.0.0.1:9100。
  3. 打开「设备和打印机」,确认 PrintRelay 存在;在任意软件里打印到它。
  4. 任务经中继送到节点,由节点上装了驱动的打印机输出。

如果自动添加打印机失败,手工添加

  1. 控制面板 → 设备和打印机 → 添加打印机 → 「我想要的打印机不在列表中」。
  2. 选「按 TCP/IP 地址添加」→ 设备类型选 TCP/IP 设备。
  3. 主机名/IP 填 127.0.0.1,端口 9100,协议 RAW / JetDirect。
  4. 驱动选 Generic / Text Only 或 Microsoft 通用驱动,不要装打印机原厂驱动。
  5. 打印测试页。
为什么客户端不装原厂驱动?打印内容在节点端已渲染成打印机语言,客户端只是把原始数据流转发过去。装原厂驱动反而可能二次渲染导致乱码。

关键配置

项说明
local_raw_port本机截获端口,默认 9100;改了要同步改本地打印机端口
printer_id留空 = 使用节点上报的默认打印机;填具体 ID = 固定打到某台打印机
device_id多台电脑主机名相同时,手工改成唯一值,否则会互相踢下线

手机打印网关(mobile)

  1. 建议与打印节点装在同一台电脑。解压后双击 PrintRelay_Console.exe。
  2. 确认服务 PrintRelayMobile 正在运行。
  3. 内网放行 TCP 6310,不要公网放行。
  4. 手机连同一 WiFi,浏览器打开 http://节点内网IP:6310/,上传文件即可打印。

原生打印

  • iPhone / iPad:任何 App 里点分享 → 打印 → 选择打印机。
  • 安卓:安装 Mopria Print Service,或系统设置 → 打印 → 开启默认打印服务。
  • mDNS 广播不跨网段;跨网段时手动添加 IPP 地址 http://节点内网IP:6310/ipp/。
自签证书提示手机原生 IPP 可能提示证书不受信任,这是正常的。网页上传打印不受影响。需要原生打印稳定工作的话,换成正式 CA 证书并填到配置里。

四、打印机型号怎么处理

系统不绑定任何具体型号。节点通过 Windows 打印子系统枚举本机所有已装驱动的打印机,只要能在 Windows 里打出测试页,就能被发布出去。

联想 M7400 这类 GDI / 主机渲染型打印机 M7400 是主机渲染机器,打印机本身不做 PCL/PostScript 解释。正确做法:
· 节点端:装联想原厂完整驱动(这是渲染发生的地方)。
· 客户端:不要装原厂驱动,用通用 Generic / Text Only 即可。
· 打印流:客户端发 RAW 数据,节点收到后调用原厂驱动输出,绕开 SMB 共享的各类报错。
· 从手机发 PDF 时,节点端需要 SumatraPDF 把 PDF 转成可打印内容;GDI 机型偶尔会有兼容问题,客户端 RAW 路径最稳。

常见型号对照

类型典型型号节点端客户端
GDI / 主机渲染联想 M7400、M7600D、HP 1020、佳能 LBP2900必须装原厂完整驱动通用驱动,走 RAW
PCL / PostScriptHP LaserJet 系列、兄弟 MFC 系列、理光/施乐多数机型装原厂或通用 PCL6 / PS 驱动通用驱动,RAW 或 IPP 都可
标签 / 小票机斑马、得力、各类 ESC/POS装原厂驱动并设置正确纸张通用驱动,走 RAW

多种型号同时存在时

场景处理方式
一台节点接多台打印机自动全部发现并上报,客户端在列表里选目标;也可用 printer_names 白名单只发布需要的
多个节点各接不同打印机都连同一个中继,列表在服务器自动合并,按 printer_id 路由到对应节点
不同型号混用驱动只装在对应节点上,客户端统一走 RAW,型号差异被节点端吸收
同名打印机printer_id 由打印机名称生成,不同节点上请改成不同名称,否则后上报的会覆盖先上报的
新增 / 更换打印机装好驱动后重启节点服务,列表每 60 秒自动刷新;也可用管理接口确认
别这么做不要用 Windows 打印机共享(SMB)再映射公网,会踩 0x0000011b / 0x00000709;不要试图在客户端装所有型号的原厂驱动;不要把 9100 或 6310 直接暴露到公网。

五、客户端日常使用

装好之后,用户的使用方式完全不变。

  1. 打开任意软件(Word、Excel、浏览器、ERP 等),点打印。
  2. 打印机选择 PrintRelay。
  3. 点打印,任务会经公网服务器送到节点,由真实打印机输出。
想让不同人打到不同打印机?在客户端配置 printer_id 填目标打印机的 ID。ID 可从服务器管理接口 /api/printers 查看。留空则使用节点上报的默认打印机。

六、手机打印使用

  1. 手机与节点电脑连同一个 WiFi(不能是访客隔离网络)。
  2. 浏览器打开 http://节点内网IP:6310/。
  3. 选择打印机、份数,上传 PDF / 图片 / 文本文件,点发送打印。
搜不到打印机?先确认节点服务在运行、手机和节点在同一内网、防火墙放行 6310。跨网段请手动填 IPP 地址 http://节点内网IP:6310/ipp/。

七、常见问题

程序更新后,客户端需要重新安装吗?

不需要。装好带自动更新的版本后,以后我们发布新版,各客户端会在每天固定时段自动检查并下载更新(只替换应用代码),更新失败会自动回滚。也可右键托盘「检查更新」立即触发。整个过程不重装、不丢配置、不丢打印任务。详细机制见服务端部署文档 docs/UPDATE.md。

注意:更新服务依赖网站上 /update/api.php 可访问,请确保上传网站时把整个 web/ 目录(含 update/ 子目录)一起上传。

托盘一直红灯 / 服务没启动?

看托盘状态灯的悬停提示。日志在 data\tray_stderr.log(托盘)、data\service_boot.log(服务启动阶段)、data\*.log(运行)。命令行跑 PrintRelay_Console.exe --status 看服务和连接状态。要前台排障双击 scripts\debug.bat。

在 Server 2012 R2 上如果装服务报 1053,说明用的是旧版安装脚本——请重新下载带 PrintRelay_Console.exe 的新包(托盘 EXE 通过标准 SCM 调度启动服务,已修复该问题)。

客户端连不上服务器?
  • 确认服务器 TCP 8443 已在防火墙放行,且服务 PrintRelayServer 在运行。
  • 确认各端 config\config.yaml 里的 server_host 是 101.34.207.236。
  • 确认各端 enroll_key 与服务器一致。
节点上看不到打印机?

先在 Windows 里给这台打印机打测试页。驱动装好后重启 PrintRelayNode 服务。如果仍看不到,检查 printer_names 是否误设了白名单。

任务状态是 failed,提示 SumatraPDF?

那是发了 PDF 任务。装 SumatraPDF 并在节点配置 sumatra_path 填绝对路径;或者把文件转成 PCL/PS 再发。RAW 打印不需要它。

多台客户端互相踢下线?

device_id 是按主机名生成的。主机名重复就会冲突。在冲突机器的 config\config.yaml 里给 device_id 填一个唯一值,重启服务。

想改公网 IP 或端口怎么办?

改 dist/deployment_secrets.json 里的 host,然后运行 python scripts/build_packages.py --host 新IP --port 新端口,用新生成的四个包覆盖下载目录里的旧包,所有机器重装一次。

八、安全须知