| AMULEWEB(1) | aMule 的工具程式 | AMULEWEB(1) |
名稱¶
amuleweb - aMule 網頁伺服器
簡介¶
amuleweb [-h <主機>] [-p <通訊埠>] [-P <密碼>] [-f <路徑>] [-q] [-v] [-l <語言>] [-w] [-t <名稱>] [-s <通訊埠t>] [-u] [-U <通訊埠>] [-z] [-Z] [-A <密碼>] [-G <密碼>] [-a | -d] [-L] [--no-php] [-N]
amuleweb [--create-config-from=<路徑>]
amuleweb [--help]
amuleweb [--version]
amuleweb [--amule-config-file=<路徑>]
說明¶
DEPRECATED: amuleweb is deprecated and may be removed in aMule 3.2 or later. It is not being removed yet; consider migrating to amuleapi, the REST/SSE API.
amuleweb 可以經由網頁瀏覽器來管理 amule。你可以和 amule(1) 一起執行 amuleweb,也可以稍候再另外執行。可以在命令列或是用用設定檔指定參數,命令列參數會優先於設定檔的參數。
- [ -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 ]
- 將命令列選項寫入設定檔後離開
- [ -t <名稱>, --template=<名稱> ]
- 載入 <名稱> 這個模板。詳細請參考 外觀面板支援 章節。
- [ -s <通訊埠>, --server-port=<通訊埠> ]
- 網頁伺服器的 HTTP 連接埠:要用瀏覽器連線時必須加以指定 (預設:4711)。
- [ -u ]
-
啟用 UPnP。 - [ -U <port>, --upnp-port=<port> ]
- UPnP 通訊埠。
- [ -z, --enable-gzip ]
- 在 HTTP 傳輸時啟用 gzip 壓縮以節省頻寬。
- [ -Z, --disable-gzip ]
- 停用 gzip 壓縮 (這是預設值)。
- [ -A <密碼>, --admin-pass=<密碼> ]
- 網站伺服器的完整存取密碼。
- [ -G <密碼>, --guest-pass=<密碼> ]
- 網站伺服器的訪客密碼。
- [ -a, --allow-guest ]
- 允許訪客連線。
- [ -d, --deny-guest ]
- 禁止訪客連線 (預設)。
- [ -L, --load-settings ]
- 從遠端的 aMule 載入網頁伺服器設定/將設定儲存到遠端。這個會使 amuleweb 忽略命令列與設定檔內的設定、並從遠端載入新設定;儲存時則只會寫入遠端 aMule 的設定。(當然,只限於 aMule 的 偏好設定 > 遠端控制 裏的幾個設定項目)
- [ --no-php ]
- 停用 PHP 解譯器 (不建議)
- [ -N, --no-script-cache ]
- 爲每個要求重編譯 PHP 頁面。
- [ --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.
- [ --help ]
- 顯示簡短的使用說明。
- [ --version ]
- 顯示目前的版本號碼。
- [ --amule-config-file=<路徑> ]
- aMule 設定擋路徑。請不要直接使用!這個選項會導致原有命令列和設定檔的設定都被忽略都被忽略。 啟動 aMule 後在開啟 amuleweb 時會用這個選項,從指定的設定檔讀取偏好設定,並自行加上 -q -L 選項。
附註¶
路徑¶
對於有 <路徑> 的選項,如果 路徑 裏面沒有含目錄 (即只有單純檔名),則會被認為是在 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。
沒有在命令列或設定檔中設定語系時,會使用系統預設語言。
外觀面板支援¶
amuleweb 可以用不同的外觀面板顯示資訊;這些面板稱為「模板」,你可以用在命令列用 -t 選項讓 amuleweb 載入指定的模板。程式會在兩個地方搜尋模板:先從 ~/.aMule/webserver/,然後如果是用 --prefix=/usr 安裝程式,就會再到 /usr/share/amule/webserver/ 搜尋。
每個模板都必須被放在以該模板名稱命名的子目錄下,這個目錄裏也必須包含所有模板需要的檔案。
檔案¶
~/.aMule/remote.conf
~/.aMule/webserver/
$(pkgdatadir)/webserver/
範例¶
通常 amuleweb 會優先以這樣執行:
amuleweb -h 主機名稱 -p 外部連線通訊埠 -P 外部連線密碼 -s HTTP 通訊埠 -A 管理者密碼 -w
或
amuleweb --create-config-from=/home/username/.aMule/amule.conf
這樣就會將設定儲存到 $HOME/.aMule/remote.conf,然後你只需要再輸入:
amuleweb
當然,你可以指定比第一行範例裏更多或更少的選項,甚至您也可以完全不使用。
回報問題¶
請到我們的論壇 (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 | aMule webserver v3.1.0 |