| AMULECMD(1) | aMule 的工具程式 | AMULECMD(1) |
名稱¶
amulecmd - 終端機模式下控制 aMule 的程式
簡介¶
amulecmd [-h <主機>] [-p <通訊埠>] [-P <密碼>] [-f <路徑>] [-q] [-v] [-l <語言>] { [-w] | [-c <指令>] } [--space-separated]
amulecmd [--create-config-from=<路徑>]
amulecmd [--version]
amulecmd [--help]
說明¶
amulecmd 是終端機模式下控制 aMule 的的客戶端程式。
- [ -h <主機>, --host=<主機> ]
- 正在執行 aMule 核心的主機 (預設:127.0.0.1), <主機> 可以是 IP 位址或網域名稱
- [ -p <通訊埠>, --port=<通訊埠> ]
- aMule 外部連線用的通訊埠,在 偏好設定 > 遠端控制 設定 (預設:4712)
- [ -P <密碼>, --password=<密碼> ]
- 外部連線密碼。
- [ -f <路徑>, --config-file=<路徑> ]
- 使用指定的設定檔,預設是 ~/.aMule/remote.conf
- [ -q, --quiet ]
- 不將任何資訊顯示在標準輸出。
- [ -v, --verbose ]
- 詳細模式 - 也顯示除錯訊息。
- [ -l <語言>, --locale=<語言> ]
- 設定程式的語系 (語言)。請看 附註 章節裏關於 <語言> 參數的說明。
- [ -w, --write-config ]
- 將命令列選項寫入設定檔後離開
- [ -c <指令>, --command=<指令> ]
- 像在 amulecmd 的命令列模式下一樣,執行 <指令> 後離開。
- [ --create-config-from=<路徑> ]
- 參考 <path> 裏的資料來建立設定檔後離開。(<path> 裏必須有有效的 aMule 設定檔)
- [ --disable-ec-encryption ]
- Do not encrypt the External Connection link. Encryption is negotiated automatically whenever the remote aMule supports it, and is on by default for every destination, local or remote. Turning it off leaves everything after the login readable, and modifiable, by anyone able to observe the connection.
- [ --force-zlib ]
- Force ZLIB compression on the External Connection link regardless of the dialed-IP locality. Useful when the server side is reachable over a VPN tunnel that resolves to a LAN IP and the heuristic would otherwise skip compression.
- [ --space-separated ]
- Separate the fields of the list commands with spaces, as earlier versions did, instead of tabs. Client names and file names may contain spaces, so the default tab separator is what lets a script split a row back into its fields; use this only for scripts written against the older output.
- [ --version ]
- 顯示目前的版本號碼。
- [ --help ]
- 顯示簡短的使用說明。
指令¶
所有指令都不分大小寫。
Add <eD2k-link> | <magnet-link>¶
將 eD2k 連結或 magnet 加到核心。
可以使用以下幾種 eD2k 連結:
magnet 連結裏必須包含 eD2k 的 hash 值和檔案大小。
Cancel <hash> | <number>¶
取消下載指定的檔案,指定方式:<hash 值> 或 <編號>;要查詢數值請用 show。
Connect [ kad | ed2k | <ip|name> ]¶
連線到網路。
這樣將會連線到在偏好設定中啟用的所有網路。
用這個選項參數,你可以指定要連線到哪個網路:用「IP:port」格式指定伺服器的位址 (IP 可以用有小數點的十進位 IPv4 網址,或是可從 DNS 轉換的網域名稱),aMule 就會只連線到那個伺服器。
Disconnect [ ed2k | kad ]¶
中斷所有已連線的網路,或只中斷指定的網路連線。
Download <number>¶
開始下載檔案。
<編號> 指上次搜尋檔案時的結果。例如:「download 12」會下載上次搜尋時編號 12 的檔案。
Exit¶
始 amule/amuled 斷線,並離開 amulecmd。
Get <what>¶
取得並顯示某個偏好設定的值。
<目標> 參數可用的值:
Help [ <command> ]¶
顯示使用說明。如果沒有加參數,會顯示可用的指令一覽;如果加了 <指令> 參數,會顯示該指令的簡單說明。
Pause <hash> | <number>¶
暫停下載指定的檔案,指定方式:<hash 值> 或 <編號>;要查詢數值請用 show。
Priority <priority> <hash> | <number>¶
用 <hash 值> 或 <編號> 設定下載檔案的優先程度。
可用在 <優先度> 的參數:
Progress [<id>]¶
Shows the progress of an on-going search. Optionally takes a search <id> (as printed by search); with no id, shows the most recently started search.
Quit¶
A synonym of the exit command.
Reload <what>¶
重新載入指定的物件。
<目標> 參數可用的值:
- 重新載入分享檔案清單。
- IPFilter
- 重新載入 IP 過濾器資料。
Reset¶
清除記錄。
Results [<id>]¶
Shows you the results of a search. Optionally takes a search <id> (as printed by search); with no id, shows the most recently started search. Several searches can be kept on the daemon at once and addressed by id.
Resume <hash> | <number>¶
繼續下載指定的檔案,指定方式:<hash 值> 或 <編號>;要查詢數值請用 show。
Search <type> [<filters>] <keyword>¶
Makes a search for the given <keyword>. A search type and a keyword to search is mandatory to do this. Example: 'search kad amule' performs a kad search for 'amule'. Prints a search id; pass it to results or progress to address this search. Several searches can run at once, each with its own id.
可用的搜尋類型:
Optional filters can be placed before, after, or interleaved with the search keyword(s):
- --type <Audio|Video|Image|Doc|Pro|Arc|Iso>
- Restrict results to the given file type.
- --extension <ext> (alias: --ext)
- Restrict results to a specific file extension (e.g. iso, mp3).
- --avail <N> (alias: --availability)
- Minimum number of sources a result must report.
- --min-size <N[KMG]>
- Smallest file size to return. Suffixes use binary multipliers (K = 1024, M = K×1024, G = M×1024); no suffix means bytes.
- --max-size <N[KMG]>
- Largest file size to return. Same suffixes as --min-size.
Example: 'search global linux iso --type Iso --min-size 100M' returns results for 'linux iso' of file-type Iso at least 100 MiB.
Set <what>¶
設定指定的偏好設定值。
<目標> 參數可用的值:
Show <what>¶
顯示 上傳/下載 等候區、伺服器清單 或 分享檔案清單。
<目標> 參數可用的值:
Shutdown¶
關閉在遠端執行的核心 (amule/amuled)。這樣也會關閉文字模式客戶端程式,因為不能在沒有核心下執行。
Statistics [ <number> ]¶
顯示統計資訊。
<編號> 是這個指令的參數之一,用來指定要顯示多少個客戶端程式的版本附加版本;須為 0-255 的數字,輸入 0 或略過不輸入則表示「不限」。
範例:「statistics 5」只會顯示每個客戶端種類的前 5 個版本。
Status¶
顯示 連線狀態、目前的上傳/下載速度 等等。
附註¶
路徑¶
對於有 <路徑> 的選項,如果 路徑 裏面沒有含目錄 (即只有單純檔名),則會被認為是在 aMule 的設定檔所在目錄 ~/.aMule 下。
語言¶
-l 選項的 <語系> 參數有以下幾種樣式:lang[_LANG][.encoding][@modifier]。其中:lang 是主要的語系代碼,LANG 是語系次分類、使用地區代碼,encoding 是使用的編碼,modifier 則讓使用者用一個代號就指定一組語系設定。例如:「zh_TW.UTF-8@Taiwan」
例如,以下的字串都有效:
de_DE
de_DE.iso88591
de_DE@euro
de_DE.iso88591@euro
雖然上面這些都是合於規定的語系設定參數,但 encoding 和 modifier 目前已經沒在使用了。
你也可以使用完整的英文名稱來設定語系,例如:-l german 也等於 -l de_DE。
沒有在命令列或設定檔中設定語系時,會使用系統預設語言。
檔案¶
~/.aMule/remote.conf
範例¶
通常 amulecmd 會優先以這樣執行:
amulecmd -h 主機名稱 -p 外部連線通訊埠 -P 外部連線密碼 -w
或
amulecmd --create-config-from=/home/username/.aMule/amule.conf
這樣就會將設定儲存到 $HOME/.aMule/remote.conf,然後你只需要再輸入:
amulecmd
當然,你可以不必都遵照這個範例。
回報問題¶
請到我們的論壇 (https://github.com/amule-org/amule/discussions) 或錯誤追蹤網站 (https://github.com/amule-org/amule/issues) 回報發現的問題。請不要用 e-mail 或在我們的群組信件中回報,也不要直接通知某個團隊成員。
版權¶
aMule 與附加的工具程式都遵守 GNU 的 GPL 協定。
參考¶
作者¶
說明文件撰寫者: Vollstrecker <amule@vollstreckernet.de>
| October 2026 | aMuleCmd v3.1.0 |