基本信息

源代码仓库

文档

参与

子项目

相关项目

其他

安装说明

mod_mbox 安装和设置非常简单。首先，我们需要构建模块并让 Apache HTTPd Web 服务器加载它。然后，我们将设置我们的存档库并完成 Apache 的配置。

mod_mbox 当然有一些要求

下载和构建

您可以下载源代码包或通过 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>

有关这些指令的更多信息，请参阅配置指令 参考。