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.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>
2016 九月 | aMule webserver v2.3.2 |