所见即所得
预览窗口显示的就是最终打印效果,确认打印不再重新排版。
网页直连本地打印机 · 安全可控
在连接打印机的电脑上装好 PrintLink,网页授权后即可直接打印——所见即所得,数据默认不出本机;局域网与公网接入可按需开启。
文档
从装好 PrintLink 到网页出纸的每一步;每页都能一键复制给 AI,让它基于官方文档帮你写接入代码。
核心能力
从网页里点「打印」到纸张出来,每一步都确定、可控,不再依赖浏览器打印对话框。
预览窗口显示的就是最终打印效果,确认打印不再重新排版。
PrintLink 默认只接受本机连接,新网页要打印必须经用户授权;局域网或公网连接需管理员显式开启。
份数、双面、纸张、纸盒按打印机实际支持的选项执行,不支持的自动降级并明确提示,不会打出错乱格式。
PDF、图片、Hiprint 模板、代码构建的打印文档都能打,同一条任务里还能混排,统一一套参数。
毫米级精度画布,支持数据绑定与实时预览;导出 JSON 即可交给 PrintLink 打印,模板中心提供起点。
任何网页、脚本、程序都能直连本机服务,不限浏览器;浏览器接入只需一个 script 标签或 npm 包。
连接方式
默认本机直连;打印机不在本机时,再由管理员显式开启更宽的连接。
业务系统在公网也没关系:网页经 127.0.0.1 连接本机 PrintLink,纸从本机出,不开放任何端口。
为什么这是默认打印机接在一台工作站上,同网段电脑经确认的地址连接;来源白名单、站点授权、接口权限三层独立。
工作站部署指南经 VPN 或反向代理访问,内置 TLS 尚未提供;网络、证书与域名由部署方负责,远程非浏览器接入待独立身份体系。
责任边界与前置条件三者互相独立:同一份 PDF,公网网页可以在本机提交,局域网里的终端也可以。
三步上手
一段短代码即可接入,默认路径全程不出本机。
下载安装包,装在连接打印机的电脑上;默认只接受本机连接。
一个 script 标签或 npm 包;网页首次打印时,用户在桌面端确认授权。
构建打印文档或上传 PDF,预览确认后静默出纸。
// 1. 引入:<script src="http://127.0.0.1:17888/sdk/printlink.js">
const client = new PrintLink.PrintLinkClient({
appName: '我的业务系统' });
await client.connect();
await client.ensureAuthorized(); // 首次在 Agent 端确认授权
const asset = await client.uploadAsset(pdfBytes, 'application/pdf');
await client.printAndWait({ queueId,
source: { type: 'pdf', asset } });
// 静默出纸;preview() 用同样参数打开预览窗口
// 组合式:用代码构建 PrintLink Document
const doc = PrintLink.createDocument({ size: 'A4' });
doc.text({ x: 15, y: 18, text: '出库单', fontSize: 16 });
doc.text({ x: 15, y: 32, bind: 'customer.name' });
doc.table({ bind: 'order.items' });
await client.printAndWait({
queueId, source: { type: 'document', document: doc },
data: order });
// bind 字段由 data 注入;preview() 用同样参数
完整可复制示例与三种状态处理见快速上手。 快速开始 →
工具
设计器、模板中心与 Playground 覆盖从模板制作到接入联调的全过程。
Windows 10 / 11
仅 Apple 芯片 · macOS 11+
21765d211ed35a4d866c2e1c6346dd2fccd0e7bb06c28d9b4d37b019de5bc8dfDebian / Ubuntu · AppImage 免安装
b2c9b9c6afa0c077393f162398d255926a02b566eac97b130b0952238596a16fdfe4af0ac49c7531a868ec0eddd475ddb43f60b3bccc5153ff23ddd5c59d3bf9