AMULEWEB(1)

名稱
amuleweb - aMule 網頁伺服器

簡介
[-h <主機>] [-p <通訊埠>] [-P <密碼>] [-f <路徑>] [-l <語言>] [-t <名稱>] [-s <通訊埠t>] [-U <通訊埠>] [-A <密碼>] [-G <密碼>] [--create-config-from=<路徑>] [--amule-config-file=<路徑>]

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

[ -h <主機>, --host=<主機> ]
    正在執行 aMule 核心的主機 (預設：本機)， <主機> 可以是 IP 位址或網域名稱

[ -p <通訊埠>, --port=<通訊埠> ]
    aMule 外部連線用的通訊埠，在 偏好設定 > 遠端控制 設定 (預設：4712)

[ -P <密碼>, --password=<密碼> ]
    外部連線密碼。

[ -f <路徑>, --config-file=<路徑> ]
    使用指定的設定檔，預設是 ~/.aMule/remote.conf

不將任何資訊顯示在標準輸出。

詳細模式 - 也顯示除錯訊息。

[ -l <語言>, --locale=<語言> ]
    設定程式的語系 (語言)。請看 附註 章節裏關於 <語言> 參數的說明。

將命令列選項寫入設定檔後離開

[ -t <名稱>, --template=<名稱> ]
    載入 <名稱> 這個模板。詳細請參考 外觀面板支援 章節。

[ -s <通訊埠>, --server-port=<通訊埠> ]
    網頁伺服器的 HTTP 連接埠：要用瀏覽器連線時必須加以指定 (預設：4711)。

啟用 UPnP。

[ -U <通訊埠>, --upnp-port <通訊埠> ]
    UPnP 通訊埠。

在 HTTP 傳輸時啟用 gzip 壓縮以節省頻寬。

停用 gzip 壓縮 (這是預設值)。

[ -A <密碼>, --admin-pass=<密碼> ]
    網站伺服器的完整存取密碼。

[ -G <密碼>, --guest-pass=<密碼> ]
    網站伺服器的訪客密碼。

允許訪客連線。

禁止訪客連線 (預設)。

從遠端的 aMule 載入網頁伺服器設定/將設定儲存到遠端。這個會使 amuleweb
    忽略命令列與設定檔內的設定、並從遠端載入新設定；儲存時則只會寫入遠端 aMule 的設定。(當然，只限於 aMule 的 偏好設定 > 遠端控制 裏的幾個設定項目)

停用 PHP 解譯器 (不建議)

爲每個要求重編譯 PHP 頁面。

[ --create-config-from=<路徑> ]
    參考 <path> 裏的資料來建立設定檔後離開。(<path> 裏必須有有效的 aMule 設定檔)

顯示簡短的使用說明。

顯示目前的版本號碼。

[ --amule-config-file=<路徑> ]
    aMule 設定擋路徑。請不要直接使用！這個選項會導致原有命令列和設定檔的設定都被忽略都被忽略。 啟動 aMule 後在開啟 amuleweb 時會用這個選項，從指定的設定檔讀取偏好設定，並自行加上 -q -L 選項。

附註

  路徑
對於有 <路徑> 的選項，如果 路徑 裏面沒有含目錄 (即只有單純檔名)，則會被認為是在 aMule 的設定檔所在目錄 ~/.aMule 下。

  語言
-l 選項的 <語系> 參數有以下幾種樣式：lang[_LANG][.encoding][@modifier]。其中：lang 是主要的語系代碼，LANG 是語系次分類、使用地區代碼，encoding 是使用的編碼，modifier 則讓使用者用一個代號就指定一組語系設定。例如：「zh_TW.UTF-8@Taiwan」 例如，以下的字串都有效：
雖然上面這些都是合於規定的語系設定參數，但 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，然後你只需要再輸入：

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

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

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

參考

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