客户端离线工具（终端进不去系统时取回数据）

终端蓝屏、系统起不来、更新到一半停在开机画面——这种时候最急的往往不是修系统，而是**"我桌面上那份东西还在不在"**。

在桌面云终端上，用户数据其实还完整地躺在这台机器的本地缓存里。本产品的缓存盘本来就带完整的合成读能力，只要把它挂成一块普通磁盘，数据就能直接拷走：不必等系统修好，也不必联网连回服务器。

「客户端离线工具」做的就是这一件事：把本机缓存里的每个系统列出来，点一下挂成本机磁盘，并直接告诉你数据落在哪个盘符 / 挂载点。

它是一个独立的维护工具

随维护介质（U 盘、PE、救援盘）发放，不进客户端安装包、不常驻、不开机自启，只在人工运行时打开一次控制设备。用完卸载或重启，挂出来的磁盘就消失。

一、两种形态，能力完全一样

形态	什么时候用	怎么起
网页界面	机器还进得了某个有桌面的环境（另一个系统、Linux 救援桌面、PE 带桌面）	直接双击运行，自动打开浏览器
命令行	只有一个控制台（不带桌面的 PE、Linux 救援环境）	带子命令运行，见第四节

网页界面只监听本机

它只绑在本机回环地址（默认 127.0.0.1:7898），不对外提供服务，同网段的其他机器打不开这一页。这是有意为之——离线工具能读到缓存里的全部数据，不该在网上露面。

Windows 与国产 Linux 是同一套代码、同一套界面，两端看到的列表、按钮与结果一致；界面按现有工具家族的视觉规范做，与平台检测工具、迁移工具同一套样式。

二、界面上有什么

顶部先告诉你"这台是哪台"——客户机名称、服务器地址、本机地址 / MAC，以及本地缓存池的容量占用。救援现场机器长得都一样，先确认身份再动手。

中间是本机缓存里的系统清单：

列	说明
序号	命令行里可以直接用这个序号指代
系统名称	就是开机选单里看到的那个桌面名
容量	该系统的磁盘容量
版本	本机缓存里这份系统的版本
访问模式	还原 / 读写，见如何修改访问模式
状态	是否已经挂出来
数据位置	挂载之后这一列才有内容：Windows 上是盘符（含卷标、文件系统、可用 / 总容量），Linux 上是挂载点

「数据位置」是这个工具真正的落点。 老工具挂完之后不告诉你数据在哪，还得自己去磁盘管理里翻；这里挂完直接给出位置，界面上还能一键在文件管理器里打开它。

三、怎么用（网页界面）

1，以管理员 / root 身份运行——要打开控制设备才能读缓存表、挂盘。身份不足时界面会明确提示，不会静默失败。

2，在列表里找到要取数据的那个系统，点「挂载」；要一次全挂出来就用「挂载全部」。

3，看「数据位置」列：Windows 记下盘符，Linux 记下挂载点（统一挂在 /mnt/vdrescue 下，按分区分开）。

4，点「打开」直接在文件管理器里进到那个位置，把要的文件拷到 U 盘或网络位置。

5，拷完点「卸载」。忘了卸载也不要紧，重启即消失。

四、命令行用法

只有一个控制台的救援环境用这一套，能做的事和网页界面完全一样：

vdrescue list

vdrescue mount 1

vdrescue unmount all

子命令	作用
不带参数运行	启动网页界面并尝试打开浏览器（最常用的形态）
serve	只启动网页界面，可用 -addr 指定监听地址、-no-open 不自动开浏览器
list	列出本机缓存里的所有系统
mount <序号|UUID|all>	把指定系统的本地缓存挂成本机磁盘，默认只读
unmount <序号|UUID|all>	卸载已挂出的缓存磁盘
info	本机驱动状态、缓存池占用与主机信息
version	版本

五、只读是默认值

默认挂出来就是只读的，而且是真的只读：

• Windows：由磁盘驱动层拒写，并对外报写保护。
• Linux：由内核把块设备置为只读，再以只读方式挂载文件系统——连直接写设备节点都会被挡。

数据恢复场景下不要开读写

挂载时可以显式切换成读写（命令行是 -rw），但那意味着待恢复的缓存可能被工具本身改脏。取数据时一律用默认的只读；只有在明确知道自己要往里写、且已经接受风险时才切换。

脏文件系统留了兜底路径。 上次没正常关机的 NTFS / ext4 恰恰是最需要恢复的那一种，工具会依次尝试多种挂载方式，而不是一次失败就报错收场。

六、边界与坑

必须有本地缓存。 这个工具读的是本机缓存里的系统。纯网络启动（没有本地缓存盘）的终端上没有可挂的东西，列表会是空的——那种情况下数据本来也不在这台机器上。

没装本产品驱动的机器上跑不了。 在普通电脑上运行，命令行与界面都会给出可读的原因说明（而不是崩溃或空白），这本身也可以用来确认"这台机器到底装没装我们的驱动"。

取回的是这台机器上的数据，包含写入区。 还原模式的系统每次重启回到基准版本，本次开机之后写的东西在缓存的写入区里；一旦这个系统被清空写入数据或重下，那份东西就没有了。因此"进不去系统"之后的第一件事是先把数据取出来，不要先去开机菜单里清缓存，清区口径见如何清空数据。

挂出来的磁盘是临时的。 卸载或重启后消失，不会留在机器上，也不会改任何配置。

它不修系统。 这个工具只负责把数据取出来。修不修得好、要不要重下，见启动故障排查与异常终端（启动失败与长期离线）。

有前身工具的现场请换新版。 老的那个只有 Windows、界面是十多年前的对话框样式、挂完不告诉你盘符。本工具是它的跨平台重做版，功能是超集。

七、配套阅读

• 启动故障排查 —— 终端起不来时的排查主线
• 异常终端（启动失败与长期离线） —— 管理台侧怎么发现这类机器
• 如何清空数据 —— 清哪块区、清了以后还剩什么
• 如何修改访问模式 —— 还原 / 读写按盘设
• 平台检测工具（体检 · 修复 · 报告） —— 服务器侧的同族工具
• 更新日志