5分钟搞定 Ghost-Downloader-3 多协议下载部署新手完整指南【免费下载链接】Ghost-Downloader-3The only downloader you need. 下载器的集大成者。项目地址: https://gitcode.com/GitHub_Trending/gh/Ghost-Downloader-3磁力、M3U8、YouTube 各装一个工具链接还要来回复制——这是多平台下载管理的真实痛点。Ghost-Downloader-3 是一款跨平台多协议下载器把 HTTP、BT、M3U8、eD2k、FTP 以及 YouTube、Bilibili 等下载场景统一到一个原生 GUI 客户端里。本文带你走完从克隆源码到跑通第一次下载的全过程并说明如何启用 aria2 兼容 RPC 接口。 它解决了什么问题Ghost-Downloader-3 在一个应用内覆盖常见下载协议新协议则通过 features/ 目录下的功能包提供Bilibili、GitHub 镜像、HuggingFace 加速等启动时自动加载无需额外安装。下载场景支持情况HTTP/HTTPS 直链、FTP开箱即用磁力 / BTlibtorrent开箱即用M3U8/HLS、MPEG-DASH开箱即用eD2k 电驴开箱即用YouTube / Bilibili片段、画质、字幕开箱即用一个客户端替代多个工具不用在软件之间复制粘贴链接。 环境准备开始前逐项确认Python 3.13pyproject.toml 中requires-python明确要求 3.13低版本无法运行。uv 包管理器用于一键创建环境缺失需先自行安装。操作系统Windows 10、macOS 13、Linux glibc 2.35支持 x86_64 与 arm64。支持 AVX 指令集的 CPUQt 6.6 已放弃旧 CPU老硬件跑不起来。用下面命令验证 Python 版本python --version确认输出为 3.13 及以上再进入下一步。 落地操作步骤第1步克隆仓库目标获取完整源码到本地。git clone https://gitcode.com/GitHub_Trending/gh/Ghost-Downloader-3 cd Ghost-Downloader-3预期结果目录中出现入口文件Ghost-Downloader-3.py及app/、features/等目录。第2步创建环境并安装依赖目标一次性装好 PySide6、libtorrent 等全部依赖。uv sync预期结果生成.venv/虚拟环境依赖按 uv.lock 锁定安装。第3步首次启动目标启动 GUI 并完成初始设置。uv run python Ghost-Downloader-3.py预期结果首次启动出现 OOBE 欢迎窗口完成后进入主界面日志写入数据目录下的GhostDownloader.log。第4步验证一次下载目标确认下载引擎可用。在主窗口粘贴一条直链或拖入一个.torrent文件后开始任务。预期结果任务列表出现进度默认保存到系统用户下载目录见 app/config/paths.py 中的user_downloads_path()。第5步可选跑测试套件目标确认环境在你修改后没有破坏。uv run pytest预期结果tests/ 下的测试全部通过。⚙️ 关键配置项便携数据目录是什么入口脚本所在目录若存在GhostDownloader子目录配置、日志、功能包全部存放于此便携模式否则写入系统用户数据目录。为什么重要便携模式下UserConfig.json与日志集中一处整个目录拷走即可迁移到另一台机器。常见错误在~/.config里找配置文件找不到——先看程序目录旁有没有GhostDownloader文件夹。aria2 兼容 RPC是什么aria2 兼容的 JSON-RPC 服务默认端口16800默认关闭仅绑定127.0.0.1实现见 app/services/aria2_rpc.py。为什么重要第三方工具可用aria2.addUri推送任务已有的 aria2 脚本无需改写。curl -s http://127.0.0.1:16800/jsonrpc -d \ {jsonrpc:2.0,id:1,method:aria2.getVersion,params:[]}返回包含版本号的 JSON说明服务已就绪。常见错误期望从其他机器访问——它只监听本地设置了 token 却没在params首元素传token:xxx会直接返回 Unauthorized。浏览器扩展通道是什么浏览器扩展配对用的 WebSocket 端口默认14370默认开启。为什么重要扩展把页面媒体直接推给桌面端不用复制链接登录状态原样保留。常见错误修改端口后扩展连不上——改端口后必须重启应用才会生效。下载目录与日志是什么默认下载目录为系统用户下载目录日志按 512KB 轮转、保留最近 5 个文件。为什么重要想换保存位置请在设置中修改下载目录排查问题先翻GhostDownloader.log。常见错误到程序目录里找下载文件——默认位置并不是程序目录。️ 避坑清单现象Linux 启动报缺少 Qt 平台库。——原因系统图形库未装全。——解决安装libgl1、libxcb-cursor0等桌面依赖。现象老硬件上应用无法启动。——原因Qt 6.6 不再支持无 AVX 的 CPU。——解决更换更新的 CPU应用端无绕过方案。现象aria2 RPC 返回 Unauthorized。——原因服务端配置了 token请求未携带。——解决params首元素加token:xxx。现象RPC 启动失败日志有端口错误。——原因16800 端口被占用如真 aria2 守护进程。——解决把Aria2Rpc/Port改为 1024–65535 间的空闲端口。现象RPC 推来的任务不在任务列表。——原因开启了保存为草稿任务只进了草稿箱。——解决在草稿卡片中确认或调整对应设置。现象更新功能包后行为没变化。——原因功能包在下次启动才生效。——解决重启应用。 部署方式选型方式适用场景关键点源码uv run运行联调、开发、脚本集成需要 Python 3.13最灵活官方发布包日常使用免构建装完即用AUR 社区包ArchArch 用户ghost-downloader-bin/-git需要接脚本就选源码方式并同时启用 aria2 兼容 RPC纯日常使用发布包更省事。 总结Ghost-Downloader-3 把 HTTP、BT、M3U8、eD2k 等多协议下载收进一个原生客户端源码方式 5 分钟即可跑起来。建议下一步先启用 aria2 兼容 RPC把它接入你现有的脚本工作流。【免费下载链接】Ghost-Downloader-3The only downloader you need. 下载器的集大成者。项目地址: https://gitcode.com/GitHub_Trending/gh/Ghost-Downloader-3创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考