如何配置 Apache 虚拟主机子域名泛解析-Apache-PHP中文网

apache子域名泛解析需dns与apache双端协同：dns层添加 a记录指向服务器ip，apache层启用rewrite等模块并配置含serveralias .example.com的完整virtualhost块，缺一不可。

如何配置 apache 虚拟主机子域名泛解析

Apache 虚拟主机子域名泛解析，核心是两件事：DNS 层把所有 *.example.com 请求指向服务器 IP，Apache 层识别并正确响应这些请求。只配一边，访问会失败——比如 DNS 没设通，浏览器根本连不到你的 Apache；Apache 模块没开或配置不全，即使请求到了也会 404 或 403。

必须提前完成的 DNS 泛解析

DNS 是第一道关卡，本地 hosts 文件无法模拟泛解析：

登录你购买域名的控制台（如阿里云、腾讯云、Cloudflare）
添加一条 A 记录：
记录类型：A
主机名：*（必须是单独一个英文星号）
记录值：填你服务器的公网 IP（如 123.45.67.89）
生效时间通常为几分钟到一小时，可用 dig test.example.com +short 或在线 DNS 查询工具验证是否返回了你的 IP

Apache 端关键配置步骤

以主流 Linux 发行版（Ubuntu/CentOS）和 Windows 下 phpEnv 为例，共性操作如下：

Apache Superset Dashboard and SQL Exploration Skill

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

下载

启用必要模块：mod_vhost_alias 不是必需，但 mod_rewrite 和虚拟主机基础模块（mpm_prefork / event）必须启用。运行：
a2enmod rewrite（Ubuntu/Debian）
或确认 /etc/httpd/conf/httpd.conf 中有未注释的：
LoadModule rewrite_module modules/mod_rewrite.so
确保虚拟主机功能开启：
Ubuntu 默认已启用；CentOS 需确认 httpd.conf 含 NameVirtualHost *:80（Apache 2.4+ 可省略）；phpEnv 用户需取消 httpd.conf 中这两行的注释：
LoadModule vhost_alias_module modules/mod_vhost_alias.so
Include conf/extra/httpd-vhosts.conf

在虚拟主机配置文件中写完整 <virtualhost></virtualhost> 块（不能只写 ServerAlias）：

<virtualhost><br>  ServerName example.com<br>  ServerAlias *.example.com<br>  DocumentRoot "/var/www/example"<br><directory><br>    Options Indexes FollowSymLinks<br>    AllowOverride All<br>    Require all granted<br></directory><br></virtualhost>

进阶：按子域名自动匹配子目录（如 a.example.com → /var/www/a）

若需每个子域名加载独立站点（而非全部指向同一目录），用 VirtualDocumentRoot：

确认已启用 mod_vhost_alias（a2enmod vhost_alias 或取消 httpd.conf 注释）
替换上面配置中的 DocumentRoot 和 <directory></directory>：
VirtualDocumentRoot /var/www/%1
其中 %1 表示第一个点号前的部分（a.example.com → a）
确保对应目录存在且权限正确：
mkdir -p /var/www/a /var/www/b
chown -R $USER:www-data /var/www

验证与排错要点

配置完成后务必执行以下检查：

语法检查：apache2ctl configtest（Ubuntu）或 httpd -t（CentOS/phpEnv）——无报错才可重启
重启服务：sudo systemctl restart apache2（Linux）或在 phpEnv 控制面板中「停止→启动」Apache
访问测试：curl -H "Host: demo.example.com" http://127.0.0.1（本机测试，绕过 DNS）
常见错误：
• 403 Forbidden：<directory></directory> 权限未设 Require all granted
• 404 Not Found：DocumentRoot 路径不存在或拼写错误
• 500 Internal Server Error：.htaccess 里重写规则冲突，先临时重命名测试