<-
Apache > HTTP 服务器 > 文档 > 版本 2.4 > 模块

Apache 模块 mod_info

可用语言:  en  |  fr  |  ja  |  ko 

描述提供服务器配置的全面概述
状态扩展
模块标识符info_module
源文件mod_info.c

摘要

要配置 mod_info,请将以下内容添加到您的 httpd.conf 文件中。

<Location "/server-info">
    SetHandler server-info
</Location>

您可能希望在 <Location> 指令中使用 mod_authz_host 来限制对服务器配置信息的访问

<Location "/server-info">
    SetHandler server-info
    Require host example.com
</Location>

配置完成后,可以通过访问 http://your.host.example.com/server-info 获取服务器信息

Support Apache!

主题

指令

错误修复清单

另请参阅

top

安全问题

一旦 mod_info 加载到服务器中,它的处理程序功能就会在所有配置文件中可用,包括每个目录文件(例如.htaccess)。这可能会对您的网站造成安全相关的影响。

特别是,此模块可能会泄露来自其他 Apache 模块配置指令的敏感信息,例如系统路径、用户名/密码、数据库名称等。因此,此模块应在受控环境中使用,并且始终谨慎使用。

您可能希望使用 mod_authz_host 来限制对服务器配置信息的访问。

访问控制

<Location "/server-info">
    SetHandler server-info
    # Allow access from server itself
    Require ip 127.0.0.1

    # Additionally, allow access from local workstation
    Require ip 192.168.1.17
</Location>
top

选择显示的信息

默认情况下,服务器信息包括所有已启用模块的列表,以及每个模块的描述,该模块理解的指令,该模块实现的钩子以及当前配置中的相关指令。

通过将查询附加到 server-info 请求,可以获得配置信息的其他视图。例如,http://your.host.example.com/server-info?config 将显示所有配置指令。

?<module-name>
仅与命名模块相关的信息
?config
仅配置指令,不按模块排序
?hooks
仅每个模块附加到的钩子列表
?list
仅已启用模块的简单列表
?server
仅基本服务器信息
?providers
列出服务器上可用的提供程序
top

启动时转储配置

如果配置定义 -DDUMP_CONFIG 已设置,则 mod_info 将在服务器启动期间将预解析的配置转储到 stdout

httpd -DDUMP_CONFIG -k start

预解析意味着 <IfDefine><IfModule> 等指令将被评估,并且环境变量将被替换。但是,它不代表配置的最终状态。特别是,它不代表对重复指令可能发生的合并或覆盖。

这大致等同于 ?config 查询。

top

已知限制

mod_info 通过读取解析的配置而不是读取原始配置文件来提供其信息。由于解析的配置树的创建方式,存在一些限制

top

AddModuleInfo 指令

描述向服务器信息处理程序显示的模块信息添加其他信息
语法AddModuleInfo module-name string
上下文服务器配置,虚拟主机
状态扩展
模块mod_info

这允许将 string 的内容显示为 HTML 解释的,其他信息,用于模块 module-name。示例

AddModuleInfo mod_deflate.c 'See <a \
    href="https://httpd.apache.org/docs/2.4/mod/mod_deflate.html">\
    https://httpd.apache.org/docs/2.4/mod/mod_deflate.html</a>'

可用语言:  en  |  fr  |  ja  |  ko 

top

评论

注意
这不是问答部分。此处放置的评论应指向有关改进文档或服务器的建议,如果它们被实施或被认为无效/离题,可能会被我们的版主删除。有关如何管理 Apache HTTP Server 的问题应直接发送到我们的 IRC 频道 #httpd(在 Libera.chat 上)或发送到我们的 邮件列表