一、下载安装包
四个包各自独立,目标机器不需要安装 Python 或任何运行库。解压后双击根目录的 PrintRelay_Console.exe 即可——它会自动提权装好系统服务,并常驻托盘显示状态灯(绿=正常 / 黄=断线重连 / 红=服务异常)。
二、部署顺序
按这个顺序装,前一步没通之前不要做下一步。
放服务器包 → 双击 PrintRelay_Console.exe(弹 UAC 点“是”)→ 防火墙放行 TCP 8443。
先装打印机原厂驱动并打出测试页 → 装节点包 → 托盘变绿且打印机出现在列表。
装客户端包 → 自动添加 PrintRelay 打印机 → 打印测试页验证。
装手机打印包 → 浏览器打开 http://节点内网IP:6310/。
三、安装与配置
点选对应角色查看详细步骤。统一入口是双击 PrintRelay_Console.exe,会自动提权,无需手动找“以管理员身份运行”。
- 状态灯:绿色 = 服务正常且中继已连接;黄色 = 服务在跑但中继断线重连中;红色 = 服务未运行/异常。鼠标悬停看详情(在线设备、打印机数、待处理任务)。
- 右键菜单:状态详情、重启服务、查看日志、退出(退出只关托盘,服务继续跑)。
- 开机自启 + 守护:安装时自动配置当前用户开机自启;服务被停会自动拉起,托盘异常退出由守护进程重启。你主动点退出则不会重启。
- 防误杀:服务以
LocalSystem运行,普通用户在任务管理器里无法结束它。 - 自动更新:每天定时(默认凌晨 3 点)自动从服务端检查更新,只替换应用代码,不动你的配置和打印数据;下载有 SHA256 校验,更新失败自动回滚。右键「检查更新」可立即手动触发。以后我们发布新版本,你不用再下载重装。
- 32/64 位通用:节点包和客户端包内置两套运行时,托盘会自动识别系统架构并选用,32 位机与 64 位机下载同一个包即可,无需区分。(服务器包、手机包为 64 位)
- 排障:命令行执行
PrintRelay_Console.exe --status,或看data\tray_stderr.log。
公网服务器(server)
- 把包解压到
C:\PrintRelay\Server(路径不要有中文和空格)。 - 双击包根目录的
PrintRelay_Console.exe(弹 UAC 点“是”,自动装服务并显示托盘状态灯)。 - 确认服务:
sc query PrintRelayServer,状态应为 RUNNING。 - 服务器防火墙放行入站 TCP
8443。 - 管理接口只绑本机:
http://127.0.0.1:8444/api/status,不要公网放行。
关键配置(config/config.yaml)
| 项 | 值 | 说明 |
|---|---|---|
| listen_port | 8443 | 中继端口,改了要同步改所有客户端包 |
| tls.enabled | true | 已启用,证书与私钥在 certs/ |
| token_secret / enroll_key | 随机强密钥 | 已预置;若泄露,全部端要同步更换 |
| admin.port | 8444 | 只读状态接口,仅 127.0.0.1 |
certs/server.key 只在服务器包里。任何客户端拿到它就可以伪造服务器。打印节点(node,接打印机的电脑)
- 先把打印机接到这台电脑,装好原厂驱动,在系统里打出测试页。这一步不通,后面都不用看。
- 解压节点包,双击
PrintRelay_Console.exe(自动提权装服务)。 - 确认服务
PrintRelayNode正在运行。 - 在服务器上打开
http://127.0.0.1:8444/api/printers,应能看到这台电脑的打印机。 - 电源设置里关闭休眠,这台机器相当于打印服务器,必须常开。
关键配置
| 项 | 说明 |
|---|---|
| server_host / server_port | 已预填 101.34.207.236:8443 |
| printer_names | 留空 = 发布本机所有打印机;填名称列表 = 只发布指定打印机 |
| sumatra_path | 打 PDF 需要装 SumatraPDF 并填它的绝对路径;只打 RAW/PCL/PS 可不填 |
| spool_dir | 任务临时目录,默认 data/node_spool |
客户端电脑(client)
- 解压客户端包,双击
PrintRelay_Console.exe(自动提权装服务并添加打印机)。 - 脚本会注册服务
PrintRelayClient,并自动添加名为PrintRelay的本地打印机,指向127.0.0.1:9100。 - 打开「设备和打印机」,确认
PrintRelay存在;在任意软件里打印到它。 - 任务经中继送到节点,由节点上装了驱动的打印机输出。
如果自动添加打印机失败,手工添加
- 控制面板 → 设备和打印机 → 添加打印机 → 「我想要的打印机不在列表中」。
- 选「按 TCP/IP 地址添加」→ 设备类型选 TCP/IP 设备。
- 主机名/IP 填
127.0.0.1,端口9100,协议 RAW / JetDirect。 - 驱动选
Generic / Text Only或 Microsoft 通用驱动,不要装打印机原厂驱动。 - 打印测试页。
关键配置
| 项 | 说明 |
|---|---|
| local_raw_port | 本机截获端口,默认 9100;改了要同步改本地打印机端口 |
| printer_id | 留空 = 使用节点上报的默认打印机;填具体 ID = 固定打到某台打印机 |
| device_id | 多台电脑主机名相同时,手工改成唯一值,否则会互相踢下线 |
手机打印网关(mobile)
- 建议与打印节点装在同一台电脑。解压后双击
PrintRelay_Console.exe。 - 确认服务
PrintRelayMobile正在运行。 - 内网放行 TCP
6310,不要公网放行。 - 手机连同一 WiFi,浏览器打开
http://节点内网IP:6310/,上传文件即可打印。
原生打印
- iPhone / iPad:任何 App 里点分享 → 打印 → 选择打印机。
- 安卓:安装 Mopria Print Service,或系统设置 → 打印 → 开启默认打印服务。
- mDNS 广播不跨网段;跨网段时手动添加 IPP 地址
http://节点内网IP:6310/ipp/。
四、打印机型号怎么处理
系统不绑定任何具体型号。节点通过 Windows 打印子系统枚举本机所有已装驱动的打印机,只要能在 Windows 里打出测试页,就能被发布出去。
· 节点端:装联想原厂完整驱动(这是渲染发生的地方)。
· 客户端:不要装原厂驱动,用通用
Generic / Text Only 即可。· 打印流:客户端发 RAW 数据,节点收到后调用原厂驱动输出,绕开 SMB 共享的各类报错。
· 从手机发 PDF 时,节点端需要 SumatraPDF 把 PDF 转成可打印内容;GDI 机型偶尔会有兼容问题,客户端 RAW 路径最稳。
常见型号对照
| 类型 | 典型型号 | 节点端 | 客户端 |
|---|---|---|---|
| GDI / 主机渲染 | 联想 M7400、M7600D、HP 1020、佳能 LBP2900 | 必须装原厂完整驱动 | 通用驱动,走 RAW |
| PCL / PostScript | HP LaserJet 系列、兄弟 MFC 系列、理光/施乐多数机型 | 装原厂或通用 PCL6 / PS 驱动 | 通用驱动,RAW 或 IPP 都可 |
| 标签 / 小票机 | 斑马、得力、各类 ESC/POS | 装原厂驱动并设置正确纸张 | 通用驱动,走 RAW |
多种型号同时存在时
| 场景 | 处理方式 |
|---|---|
| 一台节点接多台打印机 | 自动全部发现并上报,客户端在列表里选目标;也可用 printer_names 白名单只发布需要的 |
| 多个节点各接不同打印机 | 都连同一个中继,列表在服务器自动合并,按 printer_id 路由到对应节点 |
| 不同型号混用 | 驱动只装在对应节点上,客户端统一走 RAW,型号差异被节点端吸收 |
| 同名打印机 | printer_id 由打印机名称生成,不同节点上请改成不同名称,否则后上报的会覆盖先上报的 |
| 新增 / 更换打印机 | 装好驱动后重启节点服务,列表每 60 秒自动刷新;也可用管理接口确认 |
0x0000011b / 0x00000709;不要试图在客户端装所有型号的原厂驱动;不要把 9100 或 6310 直接暴露到公网。五、客户端日常使用
装好之后,用户的使用方式完全不变。
- 打开任意软件(Word、Excel、浏览器、ERP 等),点打印。
- 打印机选择
PrintRelay。 - 点打印,任务会经公网服务器送到节点,由真实打印机输出。
printer_id 填目标打印机的 ID。ID 可从服务器管理接口 /api/printers 查看。留空则使用节点上报的默认打印机。六、手机打印使用
- 手机与节点电脑连同一个 WiFi(不能是访客隔离网络)。
- 浏览器打开
http://节点内网IP:6310/。 - 选择打印机、份数,上传 PDF / 图片 / 文本文件,点发送打印。
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 新端口,用新生成的四个包覆盖下载目录里的旧包,所有机器重装一次。
八、安全须知
- 中继已启用 TLS 1.2+,打印数据不在公网裸奔。
- 公网防火墙只放行 TCP 8443。管理口 8444、手机口 6310、本机打印口 9100 都不能公网放行。
- 服务器私钥
server.key和部署密钥文件deployment_secrets.json不要发给无关人员。 - 如果要把手机网关暴露到公网,必须开启 Basic Auth 并放在 HTTPS 反向代理后面。
- 节点电脑相当于打印服务器,要设固定内网 IP 并关闭休眠。
- 安装包来自内部服务器,请勿从不明来源获取。