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=<路徑>]

說明

amuleweb 可以經由網頁瀏覽器來管理 amule。你可以和 amule(1) 一起執行 amuleweb,也可以稍候再另外執行。可以在命令列或是用用設定檔指定參數,命令列參數會優先於設定檔的參數。

[ -h <主機>, --host=<主機> ]
正在執行 aMule 核心的主機 (預設:本機), <主機> 可以是 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 <通訊埠>, --upnp-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 設定檔)
[ --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_DE.iso88591
de_DE@euro
de_DE.iso88591@euro

雖然上面這些都是合於規定的語系設定參數,但 encodingmodifier 目前已經沒在使用了。

你也可以使用完整的英文名稱來設定語系,例如:-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

當然,你可以指定比第一行範例裏更多或更少的選項,甚至您也可以完全不使用。

回報問題

請到我們的論壇 (http://forum.amule.org/) 或錯誤追蹤網站 (http://bugs.amule.org/) 回報發現的問題。請不要用 e-mail 或在我們的群組信件中回報,也不要直接通知某個團隊成員。

版權

aMule 與附加的工具程式都遵守 GNU 的 GPL 協定。

參考

amule(1), amulecmd(1)

作者

說明文件撰寫者: Vollstrecker <amule@vollstreckernet.de>

2016 九月 aMule webserver v2.3.2