apachectl -S 怎么确认请求实际匹配了哪个虚拟主机

Apache 多站点出现“配置明明写了，请求却打开默认站点”时，先不要猜 DocumentRoot。运行 apachectl -S，看清请求使用的 IP/端口属于哪组虚拟主机，再把请求里的 Host 与这组条目的 ServerName、ServerAlias 对上。没有名称命中时，同一地址和端口下最先列出的虚拟主机就是默认项。

apachectl -S 展示的是 Apache 从配置解析出的虚拟主机静态映射：它能告诉你候选集合、名称和默认项，但不会替你记录某一次真实请求的完整运行时链路。

先把 -S 的输出读成地址、端口和名称三列

apachectl 是 httpd 的控制前端，会把可识别的参数传给服务程序。因此，排查虚拟主机时可以直接使用：

# 只读取当前配置解析出的虚拟主机关系，不启动或重载服务
sudo apachectl -S

下面是便于阅读的示意输出，具体路径和措辞会随发行版、编译参数及配置文件位置变化：

*:80 is a NameVirtualHost
         default server site-a.example (/etc/apache2/sites-enabled/000-site-a.conf:1)
         port 80 namevhost site-a.example (/etc/apache2/sites-enabled/000-site-a.conf:1)
                 alias www.site-a.example
         port 80 namevhost site-b.example (/etc/apache2/sites-enabled/010-site-b.conf:1)

阅读时先抓三件事：*:80 或具体 IP 表示监听地址和端口；namevhost 后面是该候选集合中的名称；default server 表示未匹配到名称时的首个条目。文件路径和行号用于回到配置定位，不等于一次请求的访问日志。

用请求端口和 Host 对应候选集合

Apache 的名称虚拟主机匹配不是先看域名。第一层是请求使用的 IP 与端口，先缩小到最具体的 地址和端口组合；同组内再比较请求名称与 ServerName、ServerAlias。下面这个配置只用于说明字段之间的关系：

# 两个站点共享 80 端口，首个条目承担未命中时的默认站点角色

    ServerName site-a.example
    ServerAlias www.site-a.example
    DocumentRoot /srv/site-a


# Host 为 site-b.example 时，名称匹配到第二个条目

    ServerName site-b.example
    DocumentRoot /srv/site-b

因此，排查一条请求时可把它拆成“目标端口 + Host”两项。访问 http://site-b.example/ 重点看 *:80 这一组和 site-b.example；若请求实际走的是 HTTPS，则要在 -S 中寻找对应的 *:443 或具体地址，而不能拿 80 端口的结果解释 443 请求。

请求落到默认站点时，按这四项排查

1. 先对端口。请求 URL 的 http 与 https 分别通常对应 80 和 443；代理或负载均衡转发后，还要确认到达 Apache 的实际监听端口。
2. 再对 Host。域名是否带 www、端口是否被客户端保留，都会影响名称匹配。缺少对应的 ServerName 或 ServerAlias 时，不会命中目标条目。
3. 检查默认项。同一地址端口下没有名称命中时，最先列出的虚拟主机会接住请求。看到 default server 后，回到它显示的文件和行号查看加载顺序。
4. 确认名称写全。每个名称虚拟主机显式写出 ServerName，不要依赖全局主机名继承。需要先确认语法时可运行：

# 只做配置语法检查；失败时先处理语法错误再解释虚拟主机映射
sudo apachectl configtest

这一步只回答“配置能否被解析”，不能证明某个客户端请求已经走到了目标站点；它与 -S 的静态映射信息要分开看。

一张速查表：-S 能确认什么

简化成一句话：先用 apachectl -S 找到“地址/端口候选组”，再用请求 Host 对照名称，最后检查未命中时的首个条目。这样可以把“默认站点问题”从猜测 DocumentRoot，收敛为可定位的配置映射问题。

常见问题

apachectl -S 会显示某一次请求实际命中了哪个站点吗？

不会。它显示的是配置解析后的虚拟主机设置。要判断一次真实请求，还需要结合请求进入的端口、Host、代理转发信息和访问日志；这些不属于 -S 自身的输出。

为什么 Host 没写错，仍然显示默认站点？

优先检查请求实际使用的端口是否与目标 一致，再检查该名称是否写在正确的 ServerName 或 ServerAlias 中。若名称没有落在同一地址端口候选组，Apache 会使用该组的首个条目。