eMule Qt：跨平台 P2P 下载客户端

项目简介

eMule Qt（eMuleQt）是把经典 eMule 客户端用 Qt 6 与 C++23 从头重写的跨平台版本，完全兼容现有的 eMule 网络。除 ED2K 与 Kademlia 外，它还把 BitTorrent、Usenet 和文件网盘（file hoster）下载整合进同一个客户端。

官网：emule-qt.org

主要功能

• ED2K 与 Kademlia：服务器与去中心化 DHT 双网络；默认启用 TCP/UDP 协议混淆；AICH 分块校验与损坏自动恢复；继承 eMule 的排队与积分系统。
• BitTorrent：由 libtorrent 驱动，支持种子与磁力链，DHT、PEX、本地节点发现、加密、按文件选择、按分享率或时长限制做种。
• Usenet：守护进程内置完整 NNTP 引擎，最多 16 个 provider 按优先级与故障转移排列，支持 TLS、配额追踪、PAR2 修复与下载完成即解压。
• 文件网盘下载：粘贴上千个网盘与链接站的链接，由 JDownloader 插件解析（Java 会自动获取），支持图形验证码、付费账号、镜像回退、断点续传与打包分组。
• 搜索与订阅：newznab / Torznab 索引器并行查询并去重；保存的索引器查询或 RSS 地址可定时轮询，按正则、大小、时间过滤后自动入队。
• 远程与控制：内置 Web 服务器可用浏览器远程控制；提供 JSON 格式的 /api/v1/* REST API；命令行可执行 --add-link、--add-torrent、--add-nzb、--connect 等操作。
• AI 助手接口：Web 服务器端口上的 /mcp 提供 MCP 端点，通过 51 个工具搜索、排队和管理下载，支持只读开关与 API-key 认证。
• 网络能力：客户端、服务器、Kademlia 与 eD2K 链接全链路 IPv6 双栈；PCP、NAT-PMP、UPnP 三种端口映射后端竞速；LowID 客户端之间可借助服务器或 Kad 好友牵线完成 NAT 穿透。
• 架构：守护进程 emulecored 与 GUI emuleqt 分离，通过 CBOR IPC 通信，可把核心跑在服务器或 NAS 上远程连接。
• 界面与体验：IRC 聊天与点对点消息、动态 IP 过滤、下载完成前预览视频与浏览压缩包、实时带宽图表与 Kademlia 可视化、13 种界面语言、搜索结果中的假文件置信度提示、国家旗帜、上传队列持久化。

安装与使用

发布页提供各平台安装包：Linux x86_64（tar.gz）、macOS 13+（Apple silicon / Intel 的 dmg）、Windows x64（安装程序与便携 zip）。

从源码构建需要 Qt 6.8+、CMake 3.25+ 和 C++23 编译器（Clang 16+、GCC 13+、MSVC 2022+）。

macOS / Linux：

scripts/build.sh

Windows 用 Visual Studio 2022 打开 src/eMuleQt.sln 构建。

运行 GUI（会自动启动守护进程）：

build/emuleqt

无界面或服务器场景可单独运行守护进程（默认端口 4712，GUI 可远程接入）：

build/emulecored

Docker 镜像 ghcr.io/moddermule/emuleqt 运行核心，也可选择在浏览器中使用 GUI。

注意事项

• 项目以 GPL-2.0 许可发布，基于 Merkur 的原始 eMule 开发。
• 首次配置时 Usenet 模块会拉取 rapidyenc 与 par2cmdline-turbo 两个可选库；可用 -DEMULE_USENET_RAPIDYENC=OFF 改用内置标量解码器，用 -DEMULE_USENET_PAR2=OFF 去掉校验与修复，队列仍可正常下载、组装与分享。
• 远程连接 GUI 时，CBOR IPC 链路使用固定证书的 TLS。
• 网盘下载依赖 JDownloader 的插件扩展。

---

本作品整理自 GitHub 开源项目 ModderMule/emule-qt，原作者 @ModderMule，许可证 GPL-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。