Apache虚拟主机匹配取决于配置顺序和Host头精确匹配:先比ServerName,再查ServerAlias(支持通配符),首个完全匹配的VirtualHost生效;全不匹配则交由第一个定义的VirtualHost处理。

Apache 的 <VirtualHost> 配置中,ServerName 本身没有“优先级”之分,真正起决定作用的是 匹配顺序 + 请求 Host 头的精确匹配逻辑。
简单说:Apache 不按 ServerName 字母顺序、配置先后或权重排序;它靠的是 “谁先完全匹配 Host 请求头”,而这个过程有明确规则。
✅ ServerName 和 ServerAlias 的匹配逻辑
- 每个
<VirtualHost>块里:-
ServerName是唯一主域名,必须且只能写一个(如ServerName example.com)。 -
ServerAlias是它的补充别名列表,支持空格分隔多个域名(如ServerAlias www.example.com blog.example.com),也支持通配符(如ServerAlias *.example.com)。
-
- Apache 匹配时:
- 先比对请求中的
Host:头是否完全等于ServerName; - 如果不匹配,再逐个检查
ServerAlias列表里的每个值(包括通配符); - 一旦命中任意一个,就交由该
<VirtualHost>处理,不再继续往下查其他块。
- 先比对请求中的
⚠️ 注意:不是“所有匹配的虚拟主机都参与”,而是第一个匹配成功的块胜出——所以顺序很重要。
✅ 多个 <VirtualHost> 块之间的“实际优先级”
Apache 按照配置文件中 <VirtualHost> 出现的从上到下的顺序依次尝试匹配:
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
- 请求进来后,Apache 扫描所有同端口(如
*:80)的<VirtualHost>块; - 对每个块,执行上面说的
ServerName → ServerAlias匹配; - 第一个完全匹配成功的块被选中,后续块即使也匹配,也不会生效。
例如:
<VirtualHost *:80>
ServerName site-a.com
DocumentRoot /var/www/a
</VirtualHost>
<VirtualHost *:80>
ServerName site-b.com
ServerAlias www.site-b.com
DocumentRoot /var/www/b
</VirtualHost>
<VirtualHost *:80>
ServerName site-c.com
ServerAlias *.site-c.com
DocumentRoot /var/www/c
</VirtualHost>当请求 Host: www.site-b.com 时:
- 第一块
site-a.com不匹配; - 第二块
ServerAlias包含www.site-b.com→ ✅ 匹配成功 → 用/var/www/b; - 第三块不会被检查。
✅ 特殊情况:没匹配上的请求去哪了?
- 如果所有
<VirtualHost>都没匹配上(比如输了个错域名xxx.invalid),Apache 会交给第一个定义的<VirtualHost>块处理(无论它有没有ServerName); - 这就是常说的“默认虚拟主机”或“兜底主机”;
- 所以建议把最通用或最基础的站点(比如维护页或 404 页)放在最前面,避免意外暴露其他站点根目录。
✅ 实操提醒
- 不要在一个
<VirtualHost>里写多个ServerName—— 语法错误; - 不要用
ServerName写通配符(如ServerName *.example.com)—— 无效,通配符只在ServerAlias中合法; - 测试时可用
curl -H "Host: test.example.com" http://127.0.0.1绕过 DNS,验证匹配是否准确; - 修改后务必运行
sudo apache2ctl -t检查语法,并sudo systemctl reload apache2生效。
配置本身不复杂,但顺序和匹配规则容易忽略。

















