Apache的ServerName不支持通配符，必须设为具体域名（如example.com）；泛解析需靠ServerAlias *.example.com配合mod_vhost_alias模块及VirtualDocumentRoot或重写规则实现。

Apache 的 ServerName 本身**不支持通配符写法**，比如不能写成 ServerName *.example.com——这种写法非法，Apache 启动会报错或忽略。真正实现泛解析的，是 ServerAlias 配合其他机制，而 ServerName 只能设一个真实、具体的主域名（如 example.com）。

ServerName 必须写具体域名

ServerName 是 Apache 识别虚拟主机的“锚点”，必须是完整、合法、可解析的域名。它不参与匹配逻辑，只用于内部标识和生成 Canonical URL（除非关掉）。常见正确写法：

• ServerName example.com（推荐，主站域名）
• ServerName localhost（仅开发测试环境）
• ServerName your-server-ip（不推荐，无域名语义）

写 ServerName *.example.com 或 ServerName .example.com 都会触发警告甚至启动失败。

泛解析靠 ServerAlias + 模块协同

要让 Apache 接收所有 xxx.example.com 请求，关键在三步配合：

• 启用 mod_vhost_alias（Apache 环境下必需；Nginx 不需要此模块）
• 用 ServerAlias *.example.com 声明接受哪些 Host 头
• 用 VirtualDocumentRoot 或 RewriteRule 动态分发请求路径

示例配置片段：

Apache Superset Dashboard and SQL Exploration Skill

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

下载

<VirtualHost *:80>
  ServerName example.com
  ServerAlias *.example.com
  UseCanonicalName Off
  VirtualDocumentRoot /var/www/%1
</VirtualHost>

其中 %1 表示 Host 头中第一个点前的部分（api.example.com → api），所以需提前建好 /var/www/api 目录。

DNS 和权限是前置硬条件

光配 Apache 不够，以下三点缺一不可：

• DNS 泛解析已生效：域名后台添加 * IN A 你的服务器IP，用 dig test.example.com 或 ping 验证是否返回该 IP
• 目录存在且可访问：比如 /var/www/test 必须存在，且 Apache 运行用户（如 www-data）有读+执行权限（chmod 755）
• Host 头被信任：必须加 UseCanonicalName Off，否则 Apache 会忽略请求中的 Host 字段，导致 %1 取不到值

宝塔用户注意实际行为

宝塔面板添加 *.example.com 站点时，它会自动：

• 启用 mod_vhost_alias（Apache 环境）
• 写入 ServerAlias *.example.com
• 配置 VirtualDocumentRoot 或用重写规则统一转发

但它绝不会修改 ServerName 为带星号的形式——那是无效操作。你看到的配置里 ServerName 仍是 example.com 或类似真实域名。