PGU-NetFileSyncWin

PGU-NetFileSyncWin 是一个 Windows 桌面文件同步工具，用于连接 PGU 设备、浏览远程目录，并把远程文件或文件夹高速下载到本机。

主要功能

• 连接 PGU 设备并浏览远程文件。
• 支持在连接设置中扫描局域网，并区分 PGU4 与 PGU5 设备。
• 扫描选择设备后自动填写对应账号、密码、SSH 端口和默认远程路径。
• 支持多选、框选、空白区域取消选择。
• 支持目录前进、后退、搜索和常用键盘快捷键。
• 支持拖拽已选文件到 Windows 资源管理器下载。
• 支持“下载”选择本地目录。
• 支持远端批量永久删除文件及非空目录，不经过回收站，并显示删除进度。
• 支持暂停、继续、取消和失败自动重试。
• 支持极速通道，提高大量小文件下载速度。
• 支持中文远程目录、中文文件名和中文 Windows 目标目录。
• 支持远端极速服务安装、升级、修复、停止和开机自启。
• 重启 PGU 设备后会自动恢复当前版本极速服务，清理重复旧自启项。
• 启动后静默检查 Gitea 新版本，并支持自动升级和重启。
• 使用速度条显示实时速度，下载完成后显示用时和平均速度。
• 使用同目录 PGU-NetFileSyncWin.ini 保存连接配置，便于和 exe 一起复制使用。

当前版本

当前应用版本：v1.0.6

本版本重点修复极速下载稳定性：客户端会同时考虑 Windows 本机和 PGU 设备的 CPU 线程数；极速服务按远端 CPU 建立并发槽位，支持 HTTP 长连接、连接队列扩容、服务版本显示和旧版一键升级。

• 高速通道区域显示已安装的极速服务版本，例如 极速 v3。
• 检测到旧版时显示实际版本，并提供 升级极速。
• 大量小文件下载复用连接，减少速度波动和重复重试。
• 下载结束后弹窗显示成功/失败状态、已传输大小、用时、平均速度和失败项目；底部速度条自动清零。

发布版

推荐使用发布页中的文件：

• PGU-NetFileSyncWin.exe
• PGU-NetFileSyncWin.ini

两个文件建议放在同一目录。PGU-NetFileSyncWin.ini 保存默认连接信息。

源码运行

建议使用本机 clear_conda_main 环境：

C:\Users\clear\.conda\envs\clear_conda_main\python.exe -m pip install -r requirements.txt

启动：

run_pgu4_sync.bat

或者：

C:\Users\clear\.conda\envs\clear_conda_main\python.exe pgu4_sync.py

配置文件

配置文件名：

PGU-NetFileSyncWin.ini

默认示例：

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

说明：

• 配置文件位于 exe 同目录。
• 密码使用 Windows DPAPI 加密后保存为 password_protected，仅当前 Windows 用户可解密。
• 旧版 password= 明文配置会在启动时自动迁移并删除。
• 删除 ini 后，程序会自动重新生成默认配置。
• PGU-NetFileSyncWin.ini 已加入 .gitignore，不会提交到仓库。

打包

使用 PyInstaller 打包为单文件 Windows GUI 程序：

C:\Users\clear\.conda\envs\clear_conda_main\python.exe -m PyInstaller --clean --noconfirm --onefile --windowed --name PGU-NetFileSyncWin --icon assets\pgu_netfilesync_icon.ico --add-data "assets\pgu_netfilesync_icon.ico;assets" --add-data "assets\pgu_netfilesync_icon.png;assets" --add-binary "C:\Users\clear\.conda\envs\clear_conda_main\Library\bin\libssl-3-x64.dll;." --add-binary "C:\Users\clear\.conda\envs\clear_conda_main\Library\bin\libbz2.dll;." --add-binary "C:\Users\clear\.conda\envs\clear_conda_main\Library\bin\ffi-8.dll;." --exclude-module PyQt5.QtWebEngine --exclude-module PyQt5.QtWebEngineWidgets --exclude-module PyQt5.QtWebKit --exclude-module PyQt5.QtWebKitWidgets --exclude-module matplotlib --exclude-module numpy --exclude-module pandas --exclude-module scipy --exclude-module IPython --exclude-module jupyter --exclude-module notebook --exclude-module pytest --exclude-module tkinter pgu4_sync.py

输出文件：

dist/PGU-NetFileSyncWin.exe

发布版 INI 不应包含 password 或 password_protected。用户首次连接后，密码会在其本机生成 DPAPI 密文。