泛域名虚拟主机需通过ServerAlias *.example.com、mod_vhost_alias模块和VirtualDocumentRoot动态映射协同实现，禁用ServerName写泛域名；须配置DNS泛解析A记录及通配符SSL证书，并按子域层级规范组织目录结构。
生产环境中 Apache 配置泛域名虚拟主机，核心不是靠 ServerName 写 *.example.com（这会直接启动失败），而是靠 ServerAlias *.example.com + mod_vhost_alias 模块 + 动态路径映射三者协同实现。配置必须稳定、可维护、符合 DNS 和安全规范，不能依赖本地 hosts 或测试式写法。
启用并验证 mod_vhost_alias 模块
该模块是泛域名动态路由的基础，缺省常未启用：
- Linux（如 CentOS/RHEL）：运行
a2enmod vhost_alias（Debian/Ubuntu）或确认/etc/httpd/conf.modules.d/00-base.conf中有LoadModule vhost_alias_module modules/mod_vhost_alias.so - 检查是否加载成功：
httpd -M | grep vhost_alias或apachectl -M | grep vhost_alias - 若未加载，需手动添加模块行并重启服务；宝塔等面板通常自动处理此步
标准虚拟主机配置（支持一级子域）
适用于 a.example.com、blog.example.com 等二级域名统一接入场景：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<VirtualHost *:80>
ServerName example.com
ServerAlias *.example.com
UseCanonicalName Off
VirtualDocumentRoot /var/www/example_sub/%1
<Directory "/var/www/example_sub">
Require all granted
AllowOverride All
</Directory>
</VirtualHost>说明：
-
%1表示 Host 头中第一个点号前的部分（即a、blog），目录结构为/var/www/example_sub/a/、/var/www/example_sub/blog/ -
ServerName必须设为真实主域名（如example.com），否则 Apache 启动警告且 CanonicalName 逻辑异常 - HTTPS 环境需另配对应
*:443块，并绑定泛域名证书（如通配符 SSL 证书*.example.com）
DNS 与证书前提不可跳过
泛域名在服务端生效，前提是请求能抵达你的 Apache 服务器：
- DNS 层必须配置
A记录：* IN A 192.0.2.100（指向你的服务器公网 IP），确保所有*.example.com解析到该 IP - SSL/TLS 证书必须覆盖泛域名：使用合法通配符证书（如 Let’s Encrypt 的
*.example.com），单域名证书无法匹配子域 HTTPS 请求 - 避免将泛解析用于敏感子域（如
admin.example.com），建议用显式ServerAlias或独立虚拟主机隔离高权限站点
进阶：多级子域或统一入口处理
若需支持 api.v2.example.com 或全部子域走同一入口（如 API 网关），可用以下方式：
- 用
%-2+提取倒数第二段起：例如VirtualDocumentRoot /var/www/example_root/%-2+，则api.v2.example.com→/var/www/example_root/v2.example.com - 更灵活的路由推荐用
RewriteRule+ENV或后端应用识别HTTP_HOST，尤其适合微服务或 SaaS 多租户架构 - 不建议仅靠
ServerAlias *.example.com却无VirtualDocumentRoot或重写——此时所有子域默认访问同一 DocumentRoot，缺乏隔离性，存在安全隐患
