更新至新版本
更新只會取代程式本身,其他一概不動。您的設定、額度、分享檔案記錄、未完成的下載與已完成的檔案,都存放在新版本不會覆寫的位置,因此在大多數系統上,更新就是把新版本直接安裝在舊版本上。Windows ZIP 是唯一的例外:您的資料位於程式資料夾內,解壓縮之前請先閱讀該章節。
您的資料存放位置
| 您使用的版本 | 程式 | 您的資料 |
|---|---|---|
| Windows 安裝程式 | C:\Program Files\eMule Qt |
%LOCALAPPDATA%\eMuleQt,其中包含 Incoming 與 Temp |
| Windows ZIP(免安裝版) | 您解壓縮出來的 eMule 資料夾 |
同一個資料夾:config、Incoming 與 Temp 位於 emuleqt.exe 旁邊 |
| macOS | Applications 中的 emuleqt.app |
~/eMuleQt/Config、~/eMuleQt/Incoming、~/eMuleQt/Temp |
| Linux | tarball 中的 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 拖曳到 Applications,並選擇取代。
- 啟動 eMule Qt。
您位於 ~/eMuleQt 的資料在應用程式之外,會維持原樣。
Linux
- 結束 eMule Qt 及其核心(見上文)。
- 將新的 tarball 解壓縮到與舊版相同的位置,使其覆寫舊的
eMuleQt資料夾:tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz - 啟動 eMule Qt。由於路徑沒有改變,您的選單項目與檔案類型關聯仍可正常運作。
~/eMuleQt,您的資料則是 ~/eMuleQt/Config、Incoming 與 Temp。在更新前刪除舊的程式資料夾,也會一併刪除這些資料。直接解壓縮覆蓋一律是安全的,因為 tarball 中沒有 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 啟動即可。它會下載每個新版本、進行檢查,並依照本頁所述的方式安裝(免安裝版中同樣會保留您自己的 config 檔案),再以相同的選項重新啟動。Docker 容器不會自行更新,請改為拉取新的映像檔。