PGU-NetFileSyncWin/USER.md

PGU-NetFileSyncWin 用户说明书

PGU-NetFileSyncWin 用于在 Windows 上连接 PGU 设备，查看设备中的文件，并把文件或文件夹下载到本机。

1. 准备文件

请把下面两个文件放在同一个文件夹中：

PGU-NetFileSyncWin.exe
PGU-NetFileSyncWin.ini

双击运行：

PGU-NetFileSyncWin.exe

程序不会打开命令行窗口。

2. 配置连接信息

连接信息保存在 PGU-NetFileSyncWin.ini 中。默认内容如下：

[General]
host=192.168.1.248
port=22
username=clear
remote_path=/home/clear/Data

IP、端口、用户名和远程路径可以直接用记事本修改。密码请在软件界面中输入。

常用字段说明：

• host：PGU 设备 IP。
• port：连接端口。
• username：用户名。
• remote_path：打开软件后默认进入的远程路径。

密码保存后会写入 password_protected，内容由 Windows DPAPI 加密，仅当前 Windows 用户可以解密。旧版 INI 中的明文 password 会在启动时自动迁移并删除。

3. 连接 PGU 设备

1. 打开软件。
2. 点击左侧的 设备与连接设置。
3. 检查 IP、端口、用户名和密码，点击 保存并连接。
4. 也可以直接点击左侧 连接设备，使用已经保存的连接信息。
5. 连接成功后，按钮会变成 断开连接。
6. 文件列表会显示 PGU 设备中的远程目录。

如果不知道 PGU 设备 IP，请进入 设备与连接设置 后点击 扫描局域网设备。

4. 扫描 PGU 设备

点击 设备与连接设置，再点击 扫描局域网设备。

操作步骤：

1. 选择本机网卡。
2. 开始扫描。
3. 在结果列表中选择 PGU 设备。
4. 点击使用选中的 IP。
5. 返回连接设置后点击 保存并连接。

扫描会检查 5901、5923 和 8080 端口，并在结果中标明设备类型：

• 开放 5901 或 5923：显示为 PGU4。
• 开放 8080：显示为 PGU5。

选择设备后，软件会自动填写：

• PGU4：用户 clear，密码自动填写，默认路径 /home/clear/Data。
• PGU5：用户 root，密码自动填写，默认路径 /nvme-data/pgu_data。

密码始终使用掩码显示，保存后由 Windows DPAPI 加密。

5. 浏览远程文件

文件列表中会显示：

• 名称
• 大小
• 修改时间
• 类型

常用操作：

• 双击文件夹：进入该文件夹。
• 点击向上箭头：返回上一层。
• 点击刷新图标：重新读取当前目录。
• 点击前进、后退图标：切换访问过的目录。
• 在远程路径输入框中输入路径后按回车：进入指定目录。
• 使用右上角搜索框：筛选当前目录。

常用快捷键：

• Ctrl+F：搜索。
• F5：刷新。
• Alt+Left / Alt+Right：后退、前进。
• Alt+Up：上级目录。
• Enter：打开选中的文件夹。
• Delete：永久删除选中项。
• Esc：清除搜索或选择。

访问 /root 或其子目录时，软件会要求再次输入当前 SSH 连接密码。密码错误或取消验证时不会进入该目录。离开 /root 后，再次进入需要重新验证。

6. 选择文件

支持以下选择方式：

• 单击一行：选择一个文件或文件夹。
• 按住 Ctrl 单击：选择多个项目。
• 按住 Shift 单击：连续选择。
• 从左侧空白列、右侧空白区或底部空白区拖动：框选多个项目。
• 单击空白区域：取消当前选择。

7. 下载文件

方法一：下载到指定目录

1. 在文件列表中选择文件或文件夹。
2. 点击 下载。
3. 选择本机目录。
4. 软件开始下载。

方法二：拖拽到 Windows 资源管理器

1. 先打开 Windows 资源管理器，并进入目标文件夹。
2. 在软件中选择要下载的远程文件或文件夹。
3. 从选中的文件行拖出软件窗口。
4. 拖到资源管理器窗口中松开鼠标。
5. 软件会自动开始下载到该目录。

注意：框选空白区是用来选择文件的，不是拖出下载。请从已选中的文件行拖出。

8. 删除远程内容

选中一个或多个文件、目录后点击鼠标右键，选择 永久删除选中项。

软件会先弹窗要求二次确认。确认后，PGU 设备会在本机文件系统中批量永久删除选中内容，非空目录会连同内部文件一起删除，不会进入远程回收站。弹窗会显示选中项删除进度，完成后远程目录会自动刷新。

如果目录正在被其他程序写入，软件会自动进行多次重试。持续写入仍可能导致删除失败，此时应先停止占用该目录的程序，再重新删除。

删除操作无法撤销，请在确认前仔细检查选中的内容。

9. 极速下载

左侧高速通道区域会显示当前极速服务状态：

• 极速 v3：当前已安装并运行 V3 极速服务。
• 安装极速：PGU 设备上还没有极速服务，点击后安装。
• 极速 v2 · 可升级：检测到旧版本，点击 升级极速 后更新。
• 升级极速：检测到旧服务，点击后升级。
• 修复极速：当前版本已安装但自动启动失败，点击后修复。
• 停止极速：极速服务正在运行，点击后停止。

一般情况下，连接 PGU 设备后，如果极速服务可用，软件会自动使用极速通道下载。

安装极速服务后，PGU 设备重启时会通过 systemd 和单条 crontab 备用项自动启动。软件会清理重复旧自启命令；当前版本没有运行时会先自动恢复，不会误报为旧版本。

极速 V3 支持中文远程目录、中文文件名、空格以及中文 Windows 下载目录；同时按远端 CPU 数量限制服务并发，使用 HTTP 长连接减少大量小文件下载时的波动。

10. 下载过程

下载时可以使用：

• 暂停：暂停当前下载。
• 继续：恢复下载。
• 取消：取消当前下载。

下载过程中如果某个文件短暂超时，软件会自动重试，不会立即弹窗打断下载。

如果最终仍有文件失败，软件会在下载结束后统一提示。

下载结束后会弹出结果窗口，显示：

• 是否全部成功或被取消。
• 已传输大小和计划大小。
• 总用时和平均速度。
• 失败项目数量及失败原因。

结果窗口关闭后，底部速度条会自动恢复为 0，等待下一次下载。

11. 速度条

底部进度条是速度条，不是总进度条。

• 100MB/s 对应满格。
• 下载过程中为蓝色。
• 下载结果弹窗关闭后自动清零，恢复为等待下一次下载的状态。

下载完成后会显示：

下载完成  1.7 GB  用时 34s  平均 51.2 MB/s

12. 自动更新

软件启动后会在后台静默检查 Gitea 是否有新版本：

• 没有新版本或网络不可用：不弹窗，正常使用。
• 发现新版本：弹窗询问是否立即升级。
• 确认升级：自动下载新版并重启软件。
• 也可以点击左侧底部的 检查更新 手动检查。

升级时会保留现有 IP、端口、账号、密码和远程路径。新版配置文件中新增的配置项可以自动补入，但已有配置值不会被覆盖。

13. 常见问题

打开后连接信息不对

请检查 exe 同目录的 PGU-NetFileSyncWin.ini。

想清空连接信息

删除 PGU-NetFileSyncWin.ini，再重新打开软件。软件会生成默认配置。

图标没有变化

Windows 可能缓存旧图标。请确认运行的是新版 exe。如果任务栏固定了旧版本，请取消固定后重新固定。

拖拽没有开始下载

请确认已经打开 Windows 资源管理器目标文件夹，并且是从已选中的文件行拖出软件窗口。

想停止 PGU 设备上的极速服务

连接 PGU 设备后，点击左侧高速通道区域的 停止极速。

软件关闭后 PGU 设备上的极速服务还在

这是正常行为。关闭 Windows 软件不会停止 PGU 设备上的极速服务。需要停止时请点击 停止极速。