透過腳本、儀表板或 shell 來操控
eMule Qt 保留了經典的網頁介面,並在旁新增完整的 JSON REST API、供 AI 助理使用的 MCP 端點,以及命令列控制,讓其他軟體也能與用戶端溝通。
REST API
內建的網頁伺服器提供 /api/v1/*:連線狀態與連線/中斷連線、搜尋與搜尋結果、下載清單(可對每個傳輸暫停、繼續、取消與預覽)、上傳、分享檔案、伺服器、好友、統計資料,以及透過 GET 和 PATCH 存取偏好設定。請求以 API 金鑰驗證,伺服器也可透過 HTTPS 執行。
網頁介面與 API 是各自獨立的開關:你可以只提供 JSON API 而完全不開放 HTML 介面,反之亦然。預設連接埠為 4711,只要你需要,連接埠對應層就會替你轉送。
MCP:讓 AI 助理操控你的用戶端
eMule Qt 支援 Model Context Protocol(MCP),這是 AI 助理與其他程式協作所用的開放標準。開啟後,Claude 這類助理就能查看並操作你的用戶端:「還有什麼在下載?」、「在 Kad 搜尋這個,並把來源最多的結果加入佇列」、「暫停「影片」分類中的所有項目」。
助理能做什麼
常駐程式提供 51 個工具,依助理的實際需求挑選:
- 狀態 — 連線、Kademlia、防火牆與連接埠狀態、統計資料與記錄檔。
- 搜尋 — 開始搜尋、讀取結果,並直接從結果下載。結果附有假檔案判定,助理因此會知道哪些結果值得懷疑及原因。
- 下載 — 列出、新增、暫停、繼續、停止與取消,查看下載的來源,清除已完成項目。
- 伺服器與 Kad — 列出、新增、移除並連線至伺服器,啟動與停止 Kad,匯入節點。
- 分享 — 分享的檔案與目錄、上傳及上傳佇列。
- Usenet — Usenet 佇列、透過 URL 新增 NZB,以及對發佈項目執行操作。
- 分類與偏好設定 — 可讀取,並在結構描述允許寫入之處進行修改。
與 REST API 相同的程式碼
MCP 並非第二套實作。每個工具都是同一份操作表中的項目,而上方的 REST API 正是由這份表產生,因此工具呼叫的驗證與執行方式與對應的 HTTP 請求完全相同:未知欄位或超出範圍的值會被拒絕,而非被忽略。具破壞性的呼叫(例如取消下載、移除發佈項目)必須帶上 "confirm": true。關閉常駐程式則完全不是工具。
由你決定開啟,未開啟前一律關閉
- 預設關閉 — 在你啟用之前,不會有任何東西等候助理連線。
- 每次呼叫都需 API 金鑰 — 與 REST API 使用同一把金鑰,伺服器也可透過 HTTPS 執行。
- 唯讀模式 — 一個開關,助理就只會獲得不更動任何內容的工具。它能查看一切,卻無法更動任何東西。
- 阻擋順手攻擊的網頁 — 來自你未允許的瀏覽器來源的請求會被拒絕。
- 不外洩機密 — 憑證、API 金鑰,以及任何指向程式或憑證的項目,都無法透過偏好設定工具讀取或設定。
連接助理
端點位於網頁伺服器連接埠(預設 4711)的 /mcp,採用 streamable HTTP。支援 HTTP 的用戶端可直接連線,以 Claude Code 為例:
claude mcp add --transport http emuleqt http://localhost:4711/mcp --header "Authorization: Bearer <api key>"
只能啟動本機程式的用戶端,則使用小型橋接程式 emuleqt-mcp,每個下載套件都會將它與常駐程式放在一起。它會從你的本機設定讀取連接埠與金鑰,因此無需輸入任何內容:
{ "mcpServers": { "emuleqt": { "command": "/path/to/emuleqt-mcp" } } }
橋接程式也能連到另一台機器上的常駐程式:
emuleqt-mcp --url https://nas.example:4711/mcp --api-key <key>
eMule Qt 實作的 MCP 版本為 2026-07-28。只支援較舊版本的用戶端會收到明確的說明,而不是無聲失敗。
命令列
eMule Qt 隨附三個程式,全部都支援命令列選項:圖形介面 emuleqt、核心 emulecored,以及 MCP 橋接程式 emuleqt-mcp。每個程式都可用 --help 列出完整選項,並用 --version 顯示版本。
執行中的核心可直接從 shell 操控,讓你輕鬆把 eMule Qt 接入腳本、檔案管理員與瀏覽器處理程式:
emulecored --add-link "ed2k://|file|...|/" emulecored --add-nzb ~/Downloads/linux-iso.nzb emulecored --connect emulecored --disconnect emulecored --connect-kad
自訂設定資料夾:–config
預設情況下,設定在 Linux 與 macOS 位於 ~/eMuleQt/Config,在 Windows 位於 %LOCALAPPDATA%\eMuleQt(可攜模式則為程式旁的 config 資料夾)。--config <dir> 可讓 eMule Qt 改用其他位置:
emuleqt --config /media/eMuleQt/Config
- 設定資料夾中的一切都會隨之移動:
preferences.yml、伺服器清單、Kad 聯絡人、已知檔案、積分、你的使用者雜湊與金鑰、Usenet 提供者以及記錄檔。資料夾若尚不存在,會自動建立。 - 圖形介面會把它的
--config傳給它啟動的核心,因此兩者永遠讀取相同的設定。 - Incoming 與 Temp 資料夾是各自獨立的設定。全新的設定資料夾預設使用
~/eMuleQt/Incoming與~/eMuleQt/Temp;若也要搬移下載內容,請在選項 → 目錄中更改。 - 每個設定資料夾就是一個獨立的設定檔。只要使用不同的連接埠(TCP、UDP、核心連接埠 4712 與網頁連接埠 4711),兩個設定檔就能各自開啟視窗並行執行。
- 傳給執行中核心的命令也可使用
--config,因此emulecored --config /media/eMuleQt/Config --connect會找到該設定檔的核心。
圖形介面:emuleqt
| 選項 | 作用 |
|---|---|
ed2k://… file.nzb |
新增 ED2K 連結,或將一個或多個 .nzb 檔案加入佇列。若 eMule Qt 已使用相同設定資料夾執行,就會交給該視窗處理,而不會另開一個。 |
--config <dir> |
使用其他設定資料夾(見上文)。 |
--new-instance |
即使此安裝與設定資料夾已有視窗在執行,仍開啟另一個視窗。 |
--tab <name> |
從指定分頁啟動:kad、servers、transfers、search、shared、messages、irc、statistics、usenet。 |
--subtab <n> |
Kad 或傳輸分頁的子分頁,從 0 起算。 |
--subtab-top <n> |
傳輸上方窗格中的清單:0 下載、1 上傳中、2 下載中、3 佇列中、4 已知用戶端。 |
--options <page> |
開啟選項對話框並跳至指定頁面:general、display、connection、proxy、server、directories、files、notifications、statistics、irc、messages、security、scheduler、webinterface、usenet、indexers、feeds、extended。 |
--register-file-types |
將此程式設為 .nzb 檔案的處理程式,然後結束。適合用於打包者的安裝後腳本。 |
--unregister-file-types |
移除 .nzb 關聯,然後結束。 |
--screenshot <path> |
儲存視窗(或 --options 頁面)的螢幕截圖並結束。--delay <ms> 可設定截圖前的等待時間,預設為 3000。 |
核心:emulecored
不帶命令啟動時,emulecored 以核心身分執行。帶命令啟動時,它會把命令傳給已在執行的核心,然後結束。
| 選項 | 作用 |
|---|---|
--add-link <link> |
從 ed2k://|file| 連結新增下載,或套用 ed2k://|httpcache| 設定連結。 |
--add-nzb <file|url> |
從 .nzb 檔案或 http(s) URL 將 Usenet 下載加入佇列。URL 由核心自行擷取,因此只要核心所在的機器連得到即可。 |
-c、--connect |
連線至 ED2K 伺服器。 |
-d、--disconnect |
中斷與 ED2K 伺服器的連線。 |
--connect-kad |
啟動 Kademlia。 |
--disconnect-kad |
停止 Kademlia。 |
--config <dir> |
使用其他設定資料夾(見上文)。 |
--port <port> |
圖形介面與核心之間的連接埠,預設為 4712。啟動時是核心監聽的連接埠;帶命令時則是要傳送命令的目標核心。 |
--hold-connect |
啟動後暫不連線,直到圖形介面的首次啟動精靈選定連接埠。圖形介面會自行設定此項。 |
MCP 橋接程式:emuleqt-mcp
橋接程式將 AI 助理連接到核心(見上文 MCP)。不帶選項時,它會從本機設定讀取連接埠與 API 金鑰。
| 選項 | 作用 |
|---|---|
--config <dir> |
從其他設定資料夾讀取連接埠與 API 金鑰。 |
--url <url> |
與其他位置的核心通訊,例如 http://192.168.1.10:4711/mcp。 |
--api-key <key> |
要使用的 API 金鑰。預設:先取 $EMULEQT_API_KEY,再取本機設定。 |
--insecure |
接受自行簽署的 HTTPS 憑證。 |
為何重要
打造你自己的儀表板、讓助理替你管理下載、繪製傳輸歷史圖表、從系統任何地方把 ED2K 連結交給核心、把整個設定檔放在外接硬碟,或將用戶端整合進智慧家庭自動化,全都不必去擷取專為人類設計的網頁畫面。