更新到新版本
更新只会替换程序本身,其他内容都不会动。你的设置、积分、共享文件历史、未完成的下载和已完成的文件都保存在新版本不会覆盖的位置,所以在大多数系统上,更新就是把新版本直接安装到旧版本上。Windows ZIP 是唯一的例外:它的数据位于程序文件夹内,因此解压前请先阅读相应章节。
你的数据存放在哪里
| 你使用的版本 | 程序 | 你的数据 |
|---|---|---|
| Windows 安装程序 | C:\Program Files\eMule Qt |
%LOCALAPPDATA%\eMuleQt,其中包含 Incoming 和 Temp |
| Windows ZIP(便携版) | 你解压出的 eMule 文件夹 |
同一个文件夹:config、Incoming 和 Temp 位于 emuleqt.exe 旁边 |
| macOS | “应用程序”中的 emuleqt.app |
~/eMuleQt/Config、~/eMuleQt/Incoming、~/eMuleQt/Temp |
| Linux | 压缩包中的 eMuleQt 文件夹 |
~/eMuleQt/Config、~/eMuleQt/Incoming、~/eMuleQt/Temp |
| Docker | 镜像 | /config 和 /data 卷 |
如果你在“选项”中把 Incoming、Temp 或共享文件夹移到了别处,它们会留在你指定的位置,任何更新都不会触碰它们。
每次更新之前
- 退出 eMule Qt 及其核心。窗口和核心(
emulecored)是两个程序。如果状态栏中的链条图标已断开,说明核心处于分离状态,关闭窗口后仍会继续运行。请在任务管理器、活动监视器或通过pgrep emulecored确认没有残留的emulecored。 - 备份你的 config 文件夹。它很小,备份不费事。正常更新时,Temp 中未完成的下载无需备份。
Windows 安装程序
- 下载新的安装程序(
eMuleQt-vX.Y.Z-win64-setup.exe),可在下载页面获取。 - 运行它。它会找到旧的安装,并把新版本放进同一个文件夹。正在运行的 eMule Qt 及其核心会自动关闭。
- 不要勾选“从 eMule 导入设置”。更新时该选项默认不勾选,因为你的 eMule Qt 配置已在使用中。
- 启动 eMule Qt。
无需先卸载。即使你卸载了,卸载程序也不会动 %LOCALAPPDATA%\eMuleQt。
Windows ZIP(便携版)
在便携版中,你的 config 文件夹位于程序文件夹内,而 ZIP 自带一个 config 文件夹。ZIP 中的 config 文件夹包含以下内容:
- 应当被替换的程序文件:
eMule.tmpl、webserver文件夹、nodes.ed3knod和GeoLite2-Country.mmdb。 - 应保留你自己副本的初始文件:
server.met、nodes.dat、webservices.dat和FakeFileFilter.dat。如果被 ZIP 覆盖,你的服务器列表和 Kad 联系人会恢复为随包附带的版本。不会出任何故障,但你积累的列表会丢失。
ZIP 中不含任何你的个人文件:preferences.yml、preferences.dat、cryptkey.dat、clients.met、known.met、Temp 中的 .part 文件以及你已完成的下载。解压不会影响它们。
如何更新
- 退出 eMule Qt 及其核心(见上文)。
- 把新版本解压到一个临时文件夹,不要直接解压覆盖到现有安装上。
- 在临时的
eMule\config文件夹中,删除server.met、nodes.dat、webservices.dat和FakeFileFilter.dat。 - 把临时
eMule文件夹中的所有内容复制到现有的eMule文件夹上,并确认替换文件。 - 启动 eMule Qt,然后删除临时文件夹。
config 复制过去。请不要这样做。你未完成的下载在 Temp 中,已完成的文件在 Incoming 中,二者都在旧文件夹里,而 preferences.yml 保存的是它们的完整路径。新文件夹会从空的下载列表开始,或者在你没有察觉的情况下继续使用旧文件夹。如果你确实想移动安装位置,请移动整个文件夹,之后在“选项”中检查各目录。如果你修改过 config\webserver 中的网页界面文件,请先备份:更新会替换它们。
macOS
- 退出 eMule Qt 及其核心(见上文)。
- 打开新的磁盘映像:Apple 芯片使用
eMuleQt-vX.Y.Z-macOS-arm64.dmg,Intel 使用eMuleQt-vX.Y.Z-macOS-x86_64.dmg。 - 把 eMule Qt 拖到“应用程序”中,并选择替换。
- 启动 eMule Qt。
你在 ~/eMuleQt 中的数据位于应用之外,保持不变。
Linux
- 退出 eMule Qt 及其核心(见上文)。
- 把新的压缩包解压到与旧版本相同的位置,覆盖旧的
eMuleQt文件夹:tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz - 启动 eMule Qt。由于路径没有变化,你的菜单项和文件类型关联仍然有效。
~/eMuleQt,数据是 ~/eMuleQt/Config、Incoming 和 Temp。在更新前删除旧的程序文件夹,会把这些数据一并删掉。直接解压覆盖始终是安全的,因为压缩包中没有 Config、Incoming 或 Temp 文件夹。其中小写的 config 文件夹存放随包附带的默认文件,eMule Qt 绝不会用它们覆盖你修改过的文件。如果你把新版本解压到了别处,请从那里启动一次,eMule Qt 会把菜单项更新为新的路径。
Docker
拉取新镜像并重新创建容器。你的数据保存在卷中:
- Docker Compose:
docker compose pull && docker compose up -d - 普通 Docker:
docker pull ghcr.io/moddermule/emuleqt:latest,然后删除旧容器,并使用相同的-v选项启动新容器。
如何得知有新版本
eMule Qt 会自行检查新版本,并弹出一个对话框,显示更新内容以及指向下载页面的链接。若要立即检查,请使用工具 → 链接 → 版本检查。如果对话框提示必须更新,说明你的版本存在已知的严重错误,在更新之前 eMule Qt 会关闭。
在服务器或 NAS 上无窗口运行的核心可以自行安装更新:以 emulecored --autoupdate 启动即可。它会下载每个新版本并进行校验,按本页所述的方式安装(便携版安装中同样会保留你自己的配置文件),然后使用相同的选项重新启动。Docker 容器不会自行更新,请改为拉取新镜像。