轻连智搜盒 部署与运维手册

适用版本：V1.0　最后更新：2026-10

本手册面向轻连智搜盒（以下简称「盒子」）的实施人员与企业 IT 运维人员，覆盖上架激活、批量克隆、许可导入、远程接入开通、日常运维、备份与升级、故障排查、搬迁等工作。面板日常管理操作请参阅《管理员手册》。

三档（基础版 / 高级版 / AI 增强版）均为硬件买断、无年费，员工电脑支持 Windows 与 macOS。涉及档位差异处均已标注。

1. 实施前准备

1.1 客户现场条件确认

注意：盒子所有内部服务（数据库、插件接口等）均仅监听本机回环地址，不对局域网暴露；局域网内只需访问盒子面板。无需在客户路由器或防火墙上为盒子做端口映射、DMZ 或开孔。

1.2 实施所需物料与信息

• 盒子整机（机身底部标签含序列号与查询码）；
• 网线、电源线，显示器与键盘（仅现场排障时需要，日常可由 HDMI 信息屏查看地址）；
• 批量克隆场景：容量 ≥ 16GB 的 U 盘（建议 32GB），以及一台用于制作启动 U 盘的 Windows 电脑；
• 许可文件或激活码（由供应方按盒子序列号与身份指纹签发）；
• 客户网络信息：IP 分配方式、网段、是否有访客网络隔离；
• 交付信息表：记录每台盒子的序列号、部署位置、档位、到期时间、管理员联系方式。

1.3 上架前核对

1. 盒子外观与封签完好，序列号与出货单一致；
2. 清点许可文件数量与采购档位一致；
3. 与客户管理员约定首启向导的管理员账号归属与密码交接方式；
4. 确认客户员工电脑系统版本（Windows / macOS）。

2. 单台激活

适用于出厂整机直接上架的场景。

2.1 开机与获取盒子地址

1. 插好网线与电源后开机；
2. 通过以下任一方式获取盒子访问地址：
   • 接显示器查看 HDMI 信息屏，屏幕显示盒子主机名与访问地址；
   • 登录路由器后台，查看新出现的 DHCP 客户端（主机名形如 linkio-xxxx）；
   • 在同一局域网内用 ping linkio-xxxx.local（mDNS）解析；
   • 浏览器打开盒子地址查询页 https://box.jaojue.com/lookup.html，输入机身标签上的序列号与查询码进行查询。

2.2 完成首启向导

1. 在浏览器打开 https://<盒子IP>:9090（盒子使用内置证书，浏览器提示不受信任时选择继续访问）；
2. 按向导创建管理员账号：用户名 3–32 位（字母、数字及 _、.、-），密码至少 8 位；
3. 提交后自动登录，进入管理面板。

2.3 激活许可并交付

1. 在「许可」页面导入许可（在线激活或离线激活，见第 4 章）；
2. 按《管理员手册》创建员工账号、生成注册令牌并在员工电脑上安装客户端；
3. 交付验收建议逐项确认：
   • 面板可正常登录，许可档位显示正确；
   • 至少一台员工电脑客户端在线；
   • 员工可正常进行文件名检索；
   • 高级版及以上：登记一个测试目录，确认汇聚完成后可按内容搜索；
   • 需要远程接入时，按第 5 章完成开通并实测。

3. 批量克隆部署

批量出货时，使用「母盘整盘克隆」方式生产：在一台母盘上装齐全部软件并封盘，通过 Clonezilla U 盘将整块系统盘打成镜像，再到目标机上逐台恢复，每台机器首次开机时自动完成身份随机化。以下步骤依据《Clonezilla U 盘一次全装操作手册》整理，实际操作以该手册与配套脚本为准。

3.1 制作母盘

1. 在母盘硬件上安装 Ubuntu Server（22.04 或 24.04），安装时手动分区、根分区不要占满整盘（预留 60–80GB 即可，便于镜像恢复到不同容量硬盘）；
2. 执行基线固化脚本 box-baseline.sh：卸载 snapd、关闭 cloud-init 与系统自动更新、锁定当前内核、配置管理用户免密提权、SSH 禁止 root 直接登录；
3. 准备盒端资产包（含盒端程序与全套插件缓存），执行 box-clone-master-setup.sh 完成装配，内容包括：
   • PostgreSQL 16 数据库及配套检索扩展（仅监听本机）；
   • 独立服务运行账号与目录骨架（/data 数据区等）；
   • 盒端系统服务（自动重启策略）、首启身份随机化服务；
   • HDMI 信息屏服务、控制台锁定；
4. 脚本结束会自动验证服务、面板与数据库状态；随后按第 2.2 节在 https://<母盘IP>:9090 走一次首启向导，确认母盘是一台功能正常的盒子。

3.2 制作 Clonezilla 启动 U 盘

1. 在 Windows 电脑上下载 Tuxboot 与 Clonezilla Live（stable、amd64、iso）；
2. U 盘数据提前转移，使用 Tuxboot 将 Clonezilla Live 写入 U 盘；
3. U 盘剩余空间用于存放整盘镜像，无需再分区。

注意：不要使用 Rufus 的 DD 写入模式，否则 U 盘剩余空间无法存放镜像。

3.3 封盘

确认母盘功能无误后执行 box-clone-seal.sh：

1. 脚本停止服务、清理缓存、日志、临时文件与 DHCP 租约，缩小镜像体积；
2. 按屏幕提示逐项核对封盘清单（管理账号密码、SSH 密钥、U 盘、HDMI 面板显示、控制台密钥占位值）；
3. 输入 yes 后脚本放置首启标记并自动关机。

封盘是单向操作：此后任何机器从该硬盘开机都会触发身份随机化。请仅「马上打镜像」前执行。

3.4 打镜像（savedisk）

1. 母盘插入 Clonezilla U 盘，开机选择 U 盘启动（UEFI 优先；如启动异常可在 BIOS 关闭 Secure Boot）；
2. 依次选择 Start Clonezilla → device-image → local_dev，挂载 U 盘分区（认准 U 盘容量，默认挂载到 /home/partimag）；
3. 选择 Beginner → savedisk（保存整块磁盘，含分区表）；
4. 镜像名建议使用 linkio-box-v1-YYYYMMDD，源盘只勾选母盘系统盘；
5. 确认后开始，结束选择关机。镜像为 U 盘根目录下的同名文件夹，整个文件夹即为镜像，不要改动内部文件。

3.5 现场恢复（restoredisk，可重复执行）

1. 目标机插网线（DHCP）与同一块 U 盘，开机选择 U 盘启动；
2. 依次选择 Start Clonezilla → device-image → local_dev → 挂载 U 盘分区 → 选择镜像 → Beginner → restoredisk；
3. 选择目标磁盘时务必确认：目标盘原有数据将被全部清除，且目标盘容量不小于母盘系统盘；
4. 确认后开始恢复，结束选择关机，拔出 U 盘后再开机。

3.6 首次开机（自动进行，切勿干预）

1. 第一次开机时首启随机化服务自动执行，依次重置：盒内置证书与身份、本机节点凭据、业务数据区、审批密钥、控制台密钥、数据库、machine-id、SSH 主机密钥与主机名；
2. 完成后机器会自动重启一次，属正常设计，请勿按电源键；
3. 第二次开机进入全新出厂状态，主机名变为 linkio-<4位十六进制>。

3.7 新盒入列

按第 2.1 节找到新盒地址，打开 https://<新盒IP>:9090 走首启向导，随后导入许可（第 4 章）。需要将机器重置回出厂状态时，重新执行一次 restoredisk 即可。

3.8 克隆常见问题

• 目标硬盘比母盘小：常规模式不支持；建议从分区规划上控制镜像大小，不推荐使用缩分区的专家模式。
• FAT32 单文件 4GB 限制：镜像会自动按 4GB 分卷，无需处理。
• 启动模式：UEFI/Legacy 需与母盘安装时保持一致，克隆不跨分区表模式转换。

4. 许可批量导入

4.1 许可绑定规则

• 许可与盒子硬件一一绑定：绑定序列号（sn）与盒内置证书身份指纹（fp，8 位十六进制），复制到其他盒子无效；
• 克隆机首次开机时业务数据区会被清空，许可不会随镜像复制，每台机器必须在首启向导完成后逐台重新导入。

4.2 批量导入流程

1. 完成每台新盒的首启向导；
2. 收集每台盒子的序列号（机身标签）与身份指纹（面板展示，与盒内置证书同源）；
3. 由供应方使用签发工具按每台机器的 sn、fp 逐张签发许可，可指定档位（基础版 / 高级版 / AI 增强版）、增值功能、有效期（按天数或永久）；
4. 现场通过任一方式导入：
   • 面板在线激活：盒子联网时粘贴许可串自动换取本机许可；
   • 面板离线激活：粘贴离线激活码，无需盒子联网；
   • 由实施人员将许可文件放置到 /etc/linkio/license.lic（属主 root、权限 0644）。
5. 导入后下一校验周期自动生效（通常在一分钟内），在面板「许可」页核对档位与授权功能。

4.3 管理要求

• 签发私钥由供应方统一保管，私钥文件严禁入库或随项目分发；现场人员只持有已签发的许可文件或激活码；
• 建立许可台账：序列号、客户、部署位置、档位、有效期、签发日期；
• 许可文件与序列号信息离线留档，便于故障换机时快速核对。

5. 安全远程接入开通

三档均支持员工出差或在外时安全访问公司内网，开通工作不需要在客户路由器上开孔。

5.1 原理与边界

• 盒子由内网主动向外部建立加密连接，外出员工通过该加密通道访问盒子；
• 客户路由器与防火墙保持默认即可，无需端口映射、DMZ、UPnP 放行；
• 若客户网络需要出站白名单，保持盒子对互联网的正常出站访问即可，具体接入信息以实际交付版本为准。

5.2 开通步骤

1. 管理员在面板为需要外出的员工开通远程接入权限，并将其使用的电脑登记为授权设备（具体页面以面板为准）；
2. 员工在外网环境（如家庭宽带、手机热点）打开客户端，由客户端主动连回公司网络，无需员工自行改设置；
3. 远程访问的检索、读取、审批规则与内网完全一致，不会因为走远程通道而获得额外权限。

5.3 验收与注意事项

• 务必在客户现场以外的网络实测一次：登录面板、搜索文件、打开一份文件；
• 远程权限不是默认开放的，按人按设备开通，离职或设备遗失时及时收回；
• 严禁为图省事在客户路由器上为盒子开孔，该做法会把企业内网直接暴露在公网上。

6. 日常运维

6.1 例行检查项

6.2 服务与日志

• 盒端主服务为系统服务，异常退出后自动重启；查看实时日志：journalctl -u linkio-agent -f，最近 50 行：journalctl -u linkio-agent -n 50；
• 系统日志总量已限定为 200MB，不会无限增长；
• 数据库为 PostgreSQL 16，仅对本机提供服务，不要对外开放数据库端口。

6.3 系统基线保持

• 系统自动更新、snap、cloud-init 在基线中已全部关闭，补丁与内核更新统一走盒子升级通道，不要手工执行系统级版本升级；
• 当前内核已锁定，不要自行解锁；
• 时区为 Asia/Shanghai，确保盒子时间准确——时间异常会影响许可校验与审计可信度，建议网络内提供可靠的时间来源。

6.4 控制台与信息屏

• HDMI 信息屏循环显示盒子地址等信息；控制台维护解锁密钥存放于 /etc/linkio/console.key，由实施人员保管，每台机器各不相同；
• 控制台默认处于锁定状态，维护结束后退出即可。

6.5 盒子地址公开查询

• 客户可通过查询页凭序列号与查询码查询盒子在线状态与地址；
• 查询服务有防滥用限制：同一来源短时间内请求次数过多会被暂时限制，序列号或查询码连续输错会锁定约 15 分钟；属正常防护，等待后再试。

7. 数据备份策略

7.1 盒子提供的两层保护（面向已登记的工作目录）

1. 历史版本自动存档（高级版及以上）：文件每次保存形成可追溯版本，连续保存自动防抖合并；可随时查看并取回历史版本。
2. 目录快照：支持每目录每日自动快照与手动立即快照，采用 4MB 分块、按内容校验去重，多台电脑、多次快照间相同内容只存一份；每日凌晨 02:00–06:00 自动进行垃圾回收与空间整理。

7.2 实施侧备份建议

• 重要目录同时开启历史版本与每日快照；
• 大规模调整目录结构、升级前手动触发一次快照；
• 建议将盒子视为第一份集中副本而非唯一备份：重要数据保留盒子之外的第二份（如由管理员将快照物化副本通过只读共享复制到企业外部存储），具体操作以面板功能为准；
• 许可文件、序列号台账、管理员交接信息离线留档；
• 每季度至少进行一次恢复抽查，确认快照可正常取回。

7.3 容量规划

• 业务数据集中存放在 /data（含历史版本库、快照数据、共享文件）；
• 分块去重可显著节省空间，但仍需按员工数量、目录规模与留存周期预留容量；
• 长期不在线电脑的快照请求会保留失败记录，电脑恢复在线后关注补跑情况。

8. 升级与回退

8.1 升级机制

• 盒子能访问供应方平台时，启动约 90 秒后开始检查、之后约每小时检查一次更新，失败时自动延长间隔；
• 升级包分为功能套件、盒端程序、整机固件三类，每个包均带摘要校验与数字签名，并标注最低可升级版本；平台可下发强制安全更新标记；
• 离线环境同样强制验签，断网不等于可以安装未签名包；
• 隔离环境可由管理员在升级页上传离线升级包（支持大文件分片上传）。

8.2 升级操作建议

1. 确认近期快照成功，必要时先手动快照；
2. 通知员工保存并关闭文件，避开集中使用时段；
3. 优先在升级页面执行，升级过程中不要断电；
4. 升级完成后抽测面板登录、检索与客户端连通。

8.3 回退与最终恢复手段

• 升级后若出现异常，先查看服务日志并联系供应方获取回退方案；回退包同样通过升级通道验签安装；
• 不要自行降级数据库或手工替换数据库文件；
• 最终手段：使用克隆 U 盘重新执行整盘恢复，机器一步回到出厂镜像状态（该操作会清空盒子内全部数据），随后重新走向导、导入许可并恢复外部备份。

9. 故障排查

排查时请记录：盒子序列号、现象出现时间、相关日志截图，便于供应方定位。

10. 搬家与更换路由器

10.1 办公地点搬迁

1. 正常关机后再断电搬运，避免震动中读写硬盘；
2. 到达新址后插好网线、电源开机；
3. 盒子通过 DHCP 自动获取新地址，数据与许可不受影响（许可绑定的是硬件身份，不绑定 IP 与网络环境）；
4. 按第 2.1 节方式确认新地址，抽查面板、客户端与远程接入。

10.2 更换路由器或调整网段

• 路由器更换后保持 DHCP 开启，盒子上电后自动恢复，无需重新配置；
• 若新路由器网段改变，员工电脑只需按新地址访问盒子；客户端会自动重新发现；
• 若客户环境必须使用静态地址，由实施人员在系统层为盒子配置固定网络参数，并同步核对时间与外部连通；
• 远程接入在盒子恢复互联网访问后自动重建；仍应在外网实测一次。

10.3 搬迁交付核对

• 盒子地址已在新路由器中确认；
• 员工电脑节点全部恢复在线；
• 快照与汇聚按计划恢复执行；
• 远程接入实测通过；
• 更新交付信息表中的部署位置与网络信息。

如遇本手册未覆盖的异常，请先区分网络、许可、服务三类问题并保留现场信息，再联系供应方实施人员处理。