apache不支持单个内用变量动态切换documentroot，但可通过启用mod_vhost_alias模块、设置usecanonicalname off，并使用virtualdocumentroot指令实现基于域名的自动路径映射，配合通配权限与php类型声明，达成多站点免手动配置的自动化部署。

Apache 本身不支持在一个 <virtualhost></virtualhost> 内用变量“动态切换” DocumentRoot，但可以通过 mod_vhost_alias 模块配合 VirtualDocumentRoot 指令，在虚拟主机层级实现基于请求域名的自动路径映射——本质是“一个域名 → 一个物理目录”，无需为每个新站点手动添加配置块，也无需重启服务。

启用 mod_vhost_alias 并关闭 CanonicalName

这是整套机制生效的前提：

• Debian/Ubuntu 系统执行：sudo a2enmod vhost_alias && sudo systemctl reload apache2
• RHEL/CentOS 系统确认主配置中已加载：LoadModule vhost_alias_module modules/mod_vhost_alias.so
• 在 <virtualhost></virtualhost> 或全局配置中添加：UseCanonicalName Off，确保 Apache 信任客户端发来的 Host 头

用 VirtualDocumentRoot 替代 DocumentRoot

该指令只允许出现在服务器级或 <virtualhost></virtualhost> 上下文中，支持以下常用变量：

Apache Superset Dashboard and SQL Exploration Skill

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

• %0：完整 Host 名（如 shop.example.com）→ 路径示例：/var/www/vhosts/%0
• %1：第一级子域（shop），%2：二级域（example），%3：顶级域（com）
• 组合写法更实用：VirtualDocumentRoot "/var/www/vhosts/%2+/%1" 访问 blog.example.com → 映射到 /var/www/vhosts/example.com/blog api.myapp.dev → /var/www/vhosts/myapp.dev/api

配套权限与运行环境必须显式声明

路径自动映射只是第一步，访问控制、PHP 解析、重写规则等仍需手动配置：

• 用通配 <directory></directory> 统一授权：<directory> Require all granted; AllowOverride All </directory>
• 确保 PHP 模块已启用，并添加：AddType application/x-httpd-php .php，否则 .php 文件会被当文本下载
• 若站点依赖重写（如 WordPress、Laravel），需在同级开启：AllowOverride All，并确认 mod_rewrite 已加载

验证与排错关键点

常见问题往往不出在语法，而在系统级细节：

• 检查 Apache 用户（如 www-data 或 apache）对目标目录有 执行（x）权限，否则报 403；父目录如 /var/www/vhosts 也需可执行
• SELinux 启用时（RHEL/CentOS），需校准上下文：sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/vhosts(/.*)?"，再执行 sudo restorecon -Rv /var/www/vhosts
• 确认 DNS 或 hosts 文件已将测试域名指向服务器 IP，且对应目录已创建、含 index.html 等测试文件