不能直接“开箱即用”实现海量子域名自动化托管。mod_vhost_alias仅按模板（如%1）动态映射子域名到目录，依赖DNS泛解析生效、目录权限正确及UseCanonicalName Off三前提，不处理DNS解析、证书或Host头校验。
不能直接“开箱即用”实现海量子域名自动化托管。mod_vhost_alias 本身不解析 DNS、不校验 Host 头合法性、也不自动创建目录或处理证书——它只在请求到达后，按预设模板把子域名映射成文件路径。真正起作用的前提是：DNS 已完成泛解析，服务器权限和路径结构已就位，且 Apache 正确读取 Host 头。
必须提前做好的三件事
这是整个方案能跑通的底层基础，缺一不可：
-
DNS 泛解析生效：在域名控制台为
*.example.com添加 A 记录，指向你的服务器 IP；用dig test.example.com或nslookup demo.example.com验证返回的是正确 IP -
目录结构与权限对齐：比如
alice.example.com映射到/var/www/alice/，那这个目录必须存在，且 Apache 运行用户（如www-data）对该目录有执行（x）权限（进入目录）、读（r）权限（读取文件） -
关闭 CanonicalName 强制行为：必须设置
UseCanonicalName Off，否则 Apache 会忽略客户端发来的 Host 头，导致%1取不到子域名值
核心配置写法与变量含义
在 <VirtualHost> 块中使用 VirtualDocumentRoot 是关键，它决定静态资源从哪读：
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
-
%1→ Host 头中第一个点号前的部分（bob.example.com→bob） -
%2→ 第二段（bob.example.com→example） -
%-1→ 最后一段（bob.example.com→com） -
%0→ 完整 Host 名（bob.example.com） -
%1+或%-2+等可组合截取，适合多级子域（如api.v2.demo.example.com）
典型配置示例：
<VirtualHost *:80>ServerName example.com
ServerAlias *.example.com
UseCanonicalName Off
VirtualDocumentRoot /var/www/%1
VirtualScriptAlias /var/www/%1/cgi-bin
<Directory "/var/www">
Require all granted
Options FollowSymLinks
</Directory>
</VirtualHost>
常见报错原因与快速定位方法
403 Forbidden 和 404 Not Found 占实际问题的九成以上，根源几乎都不在 mod_vhost_alias 本身：
-
403：先检查目标目录父路径是否都有
x权限（例如/var/www和/var/www/alice都要能被 Apache 用户进入） -
404：开启
LogLevel info，查 error log 里类似VirtualDocumentRoot is now /var/www/test的日志行，确认拼出的路径是否真实存在 -
始终进默认站点：说明 DNS 没泛解析，或客户端请求没带 Host 头（如直接输 IP 访问），或
ServerAlias *.example.com没写、或顺序被其他<VirtualHost>块抢了匹配权
HTTPS 和安全增强注意事项
mod_vhost_alias 不参与 TLS 层处理：
- 若启用 HTTPS，所有子域名必须共用一张通配符证书（
*.example.com），SNI 机制由客户端和 OpenSSL 支持，模块本身不切换证书 - Host 头未校验可能引发虚拟主机混淆，建议加一层简单校验，例如用
RewriteCond %{HTTP_HOST} !^([a-z0-9\-]+)\.example\.com$ [NC]拒绝非法 Host - 子域名含下划线或大写字母时，对应目录名必须完全一致（Linux 文件系统区分大小写，且部分旧版 Apache 对下划线支持不稳定）
