名稱

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

雖然上面這些都是合於規定的語系設定參數，但 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

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

回報問題

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

版權

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

參考

amule(1), amulecmd(1)

作者

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