要點

來源儲存庫

文件

參與

子計畫

相關計畫

其他

安裝說明

安裝和設定 mod_mbox 十分容易。首先，我們需要建立模組並且讓 Apache HTTPd 網路伺服器載入它。接著，我們會設定檔案儲存庫並完成 Apache 的設定。

當然地，mod_mbox 有些需求

下載並建立

可以下載來源 tarball 或透過 Subversion 簽出來源

svn checkout https://svn.apache.org/repos/asf/httpd/mod_mbox/trunk
mod_mbox

接著，建立 mod_mbox

./autogen.sh
./configure --enable-experimental-libtool --with-apxs=`which apxs`
 make clean all
 su -c 'make install'

如果您需要指定一個安裝前綴符號 ( --prefix=... ) 或任何其他特定設定，請參閱設定說明 ( ./configure --help )。

Apache 初步設定

下一步是讓 Apache HTTPd 在運行時載入 mod_mbox 模組。編輯您的 Apache 設定檔，並將下列內容新增到其他的 LoadModule 欄位

LoadModule mbox_module /usr/lib/apache2/modules/mod_mbox.so

儲存庫設定

mod_mbox 是一個郵件檔案瀏覽器。要是有一些郵件檔案可以瀏覽會是一個很好的主意。對於下列步驟，我們會假設您有一個包含您的 .mbox 檔案的目錄 ( 我們稱之為 foo )。您必須每月放置一個 .mbox 檔案，且每個檔案的名稱都必須以 YYYYMM.mbox 的方式命名。

在能運行之前，mod_mbox 需要對檔案進行靜態預處理。為此，我們會使用工具 mod-mbox-util，這個工具會在建立時與模組本身一起編譯

mod-mbox-util -v -c foo/

每次更新您的 .mbox 檔案時，請記得執行 mod-mbox-util ！

如果您尚未執行此操作，您必須將您的檔案移至 Apache 的 DocumentRoot 中的目錄（或在其建立一個指向您的目錄的符號連結）

mkdir -p ~www-data/archives
mv foo/ $_
cp mod_mbox/docroot/* $_
chown -R www-data:www-data $_

您可以使用 mod_mbox 主持多個郵件串列檔案，每個都儲存在一個不同的目錄中。如果您要這樣做，您應該考慮加入一個索引檔案，顯示所有已主導檔案的清單。

mod_mbox 組態

讓您的 mod_mbox 啟動並執行所需的最後一件事就是組態 Apache，以便它在嘗試讀取 .mbox 檔案時會呼叫 mod_mbox。以下組態片段是一個良好的開始

AddHandler mbox-handler.mbox
<LocationMatch /archives/([^/]+)>
MboxIndex On
MboxRootPath "/archives/"
MboxStyle "/archives/style.css"
MboxScript "/archives/archives.js"
MboxHideEmpty On
MboxAntispam On
</LocationMatch>

請參閱組態指令 參考，以取得有關這些指令的更多資訊。