PrintLink安装
下载并运行 PrintLink（Windows / macOS / Linux），确认服务状态、修改端口与开机自启。网页端 SDK 无需安装。
最后更新
PrintLink 只有一个组件需要安装：桌面端 Agent。网页用的 SDK 由 PrintLink 自己分发，不必安装任何浏览器插件。
1. 下载并安装
前往首页下载区，页面会按当前设备推荐安装包，并列出全部平台 （每个包都附 SHA-256）。
| 平台 | 安装包 | 说明 |
|---|---|---|
| Windows 10 / 11（x64） | PrintLink_<版本>_x64-setup.exe | 双击安装即可 |
| Windows（便携版） | PrintLink_<版本>_x64-portable.exe | 免安装直接运行 |
| macOS 11+（Apple 芯片） | PrintLink_<版本>_aarch64.dmg | 拖入「应用程序」 |
| Linux（Debian / Ubuntu） | PrintLink_<版本>_amd64.deb | sudo dpkg -i <包名> |
| Linux（其他） | PrintLink_<版本>_amd64.AppImage | chmod +x 后直接运行，需 CUPS |
Windows 便携版
便携版不会做安装器的环境准备，目标电脑需已安装 Microsoft Edge WebView2 Runtime。 替换已安装程序前，先从托盘完全退出 PrintLink，再替换原文件并保持文件名不变。
2. 确认服务在运行
启动后，托盘（macOS 为菜单栏）会出现 PrintLink 图标，点击可启动 / 暂停服务。 确认服务正常的办法：
curl http://127.0.0.1:17888/healthz返回 200 即表示正在运行。也可以在控制台「总览」页看到当前的 WebSocket 地址
与 SDK 地址，并可一键复制。
3. 改端口或监听范围（可选）
默认监听 127.0.0.1:17888，只接受本机连接。
- 换端口：控制台「设置」→「服务端口」，带占用检测。若改过端口，页面里
的
17888也要同步替换。 - 开放局域网 / 远程访问：默认关闭，且需要显式配置。先读 部署拓扑，不要为了图省事把范围整体放开。
4. 关于开机自启
默认开启：登录系统后 PrintLink 会自动启动，可在「设置 → 界面」关掉。 关掉时会清除系统里的自启条目，不会残留。
它和「启动服务」是两回事：前者决定 PrintLink 要不要被系统拉起来，后者决定 PrintLink 起来后要不要把打印服务也跑起来。两个开关可以独立设置。
5. 自动更新
PrintLink 内置更新器，安装包经 HTTPS 下载并做签名校验，来源不可信时拒绝更新。 可在「设置」或版本号旁点检查更新获取新版本；企业环境可用 机器策略统一指定更新通道。
6. 网页端 SDK：无需安装
页面里加一行即可：
<script src="http://127.0.0.1:17888/sdk/printlink.js"></script>工程化项目也可以用 npm 安装 ESM 版本（含 TypeScript 类型）：
npm install @printlink/sdk内网离线环境可在「设置 → 本地 SDK 包」导出版本化的 .tgz（附 SHA-256）。
常见安装问题
| 现象 | 处理 |
|---|---|
| 网页提示连不上 | 确认托盘图标是「运行中」；curl http://127.0.0.1:17888/healthz；确认端口没被改过 |
| 提示端口被占用 | 「设置」里换一个端口，或结束占用 17888 的进程（错误码 PORT_UNAVAILABLE） |
| macOS 提示「无法打开」 | 「系统设置 → 隐私与安全性」里选「仍要打开」 |
| Linux 列不出打印机 | 确认 CUPS 在运行（systemctl status cups），且当前用户能访问打印队列 |
| Windows 缺少 WebView2 | 用安装版（会自动准备运行时），或先单独安装 WebView2 Runtime |