适用系统: 银河麒麟 / 中标麒麟等 RPM 系 Linux 系统
Apache 版本: 2.2 / 2.4(以实际安装版本为准)
安装方式: yum / rpm
模块名称: mod_version
模块标识: version_module
模块文件: mod_version.so

一、模块作用

mod_version 是 Apache 提供的版本判断模块,可以根据 Apache 版本自动加载不同的配置。

例如,在 Apache 2.2 和 2.4 中使用不同的 WebDAV 授权配置:

主要用于兼容不同 Apache 版本,减少维护多套配置文件的工作量。

注意:mod_version 只负责版本判断,不提供 WebDAV 或用户认证功能。

二、检查 Apache 版本与模块状态

如果输出:

说明模块已经加载,无需安装。

三、模块存在但未加载

假设模块文件为:

先确认没有其他配置重复加载,再创建模块配置文件:

添加:

检查配置:

正常返回:

然后重载 Apache:

检查模块:

预期:

注意: LoadModule 必须在使用 <IfVersion> 的配置文件之前执行。

四、模块文件不存在时的处理

先查看 httpd 安装包:

如果没有结果,查询哪个软件包提供模块:

若确认模块属于已安装的 httpd 软件包,但文件丢失,可进一步检查:

如果确实缺失,可以在备份配置、确认软件仓库版本一致后考虑:

注意:重新安装 Apache 可能影响现有服务,生产服务器应谨慎操作。

如果仓库根本没有提供 mod_version.so,需要使用与当前 Apache 版本和 CPU 架构匹配的模块,不能直接复制其他服务器的 .so 文件。特殊发行版可能需要使用匹配的源码和 apxs 编译。

五、安装后测试

5.1 检查模块加载状态

5.2 测试版本条件语法

在已经确认 mod_version 正常加载后,可以使用:

需要注意:<IfVersion < 2.4> 中的 < 如果写在配置文件里,应按照 Apache 支持的语法使用,不要直接复制到 HTML/XML 文档中而未转义

5.3 测试现有 Apache 配置

如果 Apache 同时运行 WebDAV、LIMS 等业务,还应检查网站能否访问,以及 WebDAV 认证是否正常。

六、常见问题

问题 原因及处理
httpd -M 没有 version_module 模块未加载,检查 .so 和 LoadModule
Cannot load modules/mod_version.so 模块不存在、路径错误或二进制不兼容
Invalid command ‘IfVersion’ 未加载 mod_version,或加载顺序不正确
module version_module is already loaded 已加载模块,不要重复配置
Syntax OK 但功能不正常 继续检查版本条件及实际授权规则
yum provides 没有结果 仓库未提供对应模块,需要检查系统软件源

七、卸载或回退

如果是手动新增的模块加载配置:

可以删除该文件或注释其中的 LoadModule 指令。

回退前必须确认其他配置中已不再使用 <IfVersion>。 否则 Apache 可能无法通过语法检查。

之后执行: