局域网打印工作站

一台机器接打印机、同网段的电脑共享出纸：配置步骤、浏览器限制与故障回滚。

在仓库、门店或产线里，常见做法是一台机器接打印机并运行 PrintLink，同一网段的其他电脑通过网络地址把任务交给它。

这是高级部署

局域网监听会让同网段的任何设备在网络层触达打印服务。来源白名单、站点授权与接口权限是三道彼此独立的闸门，缺任何一道都不要上线。本页每一步都请在真实网络环境里实测后再上线。

适用与不适用

先按安装在工作站上跑起来，并在操作系统里装好全部目标打印机。此时仍是默认的只接受本机连接，先在工作站本机浏览器里用快速上手确认能出纸，再考虑放开局域网。

建议配置静态 IP 或 DHCP 地址保留：地址一变，所有终端的连接地址都得跟着改。

地址真的变了也不会让工作站停摆——本机打印依赖的回环地址始终绑定，失效的局域网地址只影响它自己：

现场	处理
清单里还有活着的地址	保留你勾选的清单，跳过失效的那条
全部失效，本机还有同类地址	自动改选一条（优先物理网卡、优先 IPv4）并保存，弹系统通知告诉你换成了哪条
全部失效且无同类可选	保留原清单不清空，本次只以本机运行

服务上线后两分钟内还会按 3 / 7 / 15 / 30 / 60 秒补绑几次（开机自启常跑在网卡拿到租约之前），全部就位即停。

在控制台「安全与站点 → 网络访问」里：

范围还是「仅本机」时这些规则会保存但暂不生效（界面有提示），正好可以先填好。

在「设置 → 服务监听范围」选择局域网，勾选工作站的私网地址（回环地址始终绑定）。确认框会列出范围、端口、绑定地址、生效的规则数与受信站点数，并提示不提供 TLS。

切换是一个事务：端口被占、地址不存在或保存失败都会整体回滚，旧服务持续可用。

const client = new PrintLink.PrintLinkClient({
  appName: '仓库出库单',
  endpoint: 'ws://192.168.10.20:17888/ws',
});

SDK 脚本也可以直接从工作站加载（http://192.168.10.20:17888/sdk/printlink.js），或随你的网页一起发布——两种方式协议相同。

首次连接时，授权确认出现在工作站的 PrintLink 上，而不是终端电脑上。可以：

浏览器把回环地址视为可信来源，所以 HTTPS 页面可以连接 ws://127.0.0.1:17888/ws；但对非回环地址的明文连接会作为混合内容直接拦截。所以：

PrintLink 不内置 TLS，这条限制来自浏览器，不是配置项。

工作站上的 PrintLink 界面、同机自动化程序不带 Origin，来自回环对端时被视为可信本机客户端。但来自其他电脑的无 Origin 连接会在握手前被拒绝（REMOTE_NATIVE_CLIENT_DENIED），即使白名单放行了它的 IP。

在独立的服务 / 设备令牌体系发布前，局域网终端请统一使用浏览器页面接入。

现象	排查	回滚
终端连接失败	工作站防火墙是否放行端口；终端 IP 是否在允许范围内；浏览器是否报混合内容	范围切回「仅本机」，立即断开所有远程会话
提示需要授权 / 等待授权	到工作站控制台「安全与站点」处理待确认请求	移除站点会撤销其令牌
提示权限不足	令牌缺少打印权限	在「安全与站点」调整该站点的权限
提示「监听地址已自动调整」	保存的地址在本机网卡上已不存在，已自动改选或本次跳过；服务仍在运行	把终端地址改到提示里的新地址；想固定就配 DHCP 保留
保存监听配置时报绑定失败	保存是全事务的：勾选的地址此刻绑不上（网卡下线、端口被占），旧监听保持不变	刷新网卡列表后重新勾选真实存在的地址
需要紧急收紧	「安全与站点 → 恢复安全默认值」	收紧即时生效

终端不在同一网段时怎么办。

白名单、配对与权限的完整规则。

锁定范围与站点策略。