PGU4-Sync

基于 PyQt5 的 Ubuntu 远程文件管理与高速下载工具。界面以远程文件列表为主，支持连接记忆、远程路径记忆、局域网扫描、拖拽到 Windows 资源管理器、多线程下载、暂停/继续、取消、实时速度条和极速 HTTP Range 通道。

连接配置保存在程序同目录的 PGU-NetFileSyncWin.ini 中，便于和 exe 一起复制使用。

安装

建议使用本机 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

主要功能

• 通过 SSH/SFTP 连接 Ubuntu 设备，浏览远程目录。
• 支持局域网扫描开放 5901 或 5923 的设备，并自动映射主界面 SSH 端口。
• 远程文件列表支持空白区域框选、多选、单击空白取消选择。
• 可将已选远程文件或文件夹拖到已打开的 Windows 资源管理器窗口中下载。
• 下载过程显示当前通道、实时速度、已下载量、完成用时和平均速度。
• 下载支持暂停、继续、取消和失败重试。
• 连接后自动检测远端极速服务，优先使用极速 HTTP Range 通道。
• 可一键安装、升级或停止远端极速服务；安装后会写入远端用户级开机自启配置，关闭 GUI 不会停止远端常驻极速服务。

传输策略

• 普通 SFTP 通道使用本机逻辑线程数作为并发上限。
• 极速通道针对大量小文件优化，默认使用 12 路 HTTP 文件并发。
• 超过 64MB 的大文件使用 Range 分片，单个大文件最多 4 路分片并发。
• 目录扫描和下载同时进行，发现文件后立即投入下载队列，不等待完整目录树预扫描。
• 单个分片失败会自动重试，重试耗尽后才记录为失败文件，并在任务结束后汇总提示。

发布

单文件 Windows GUI 版本位于：

dist/PGU-NetFileSyncWin.exe

该版本使用 PyInstaller --onefile --windowed 打包，不显示命令行窗口，并嵌入应用图标。