XAMPP多端口配置及子域名设置方法

XAMPP 无法自动实现多级子域名与多端口的组合映射，必须通过手动协同配置 Windows hosts 文件、Apache 主配置 httpd.conf（添加监听端口并启用虚拟主机模块）以及虚拟主机配置 httpd-vhosts.conf（为每个子域名+端口组合单独定义 ServerName、DocumentRoot 和关键权限指令 Require all granted），三者缺一不可；尤其要注意 Apache 2.4+ 的权限模型已彻底变更，沿用旧版 Order/Allow 指令必然导致 403 错误，同时 hosts 不支持通配符、端口避开系统保留范围、DNS 缓存刷新等细节稍有疏忽就会让整个配置“静默失效”，本文直击这些极易踩坑却鲜有文档明确提醒的核心要点。

直接说结论：XAMPP 本身不支持“多级子域名 + 多端口”自动映射，必须手动组合 hosts + httpd.conf + httpd-vhosts.conf 三处配置，且 Apache 2.4+ 必须用 Require all granted 替代旧版权限指令，否则 403 错误必现。

为什么不能只靠改 httpd-vhosts.conf 就生效

Apache 不会自动把 www.dev.project.local 这种多级子域名解析到对应目录——它只认 ServerName 字符串是否完全匹配。你写 ServerName dev.project.local，浏览器输 www.dev.project.local 就 404；反过来也一样。所以每个多级子域名都得单独配一条 ，不能靠通配符偷懒（*.dev.project.local 在 Apache 2.4 默认不启用，需额外加 ServerAlias 或启用 mod_vhost_alias，但 XAMPP 默认没开）。

• ServerName 必须和浏览器地址栏输入的**完整主机名**一字不差（包括 www. 前缀）
• 若想同时支持 dev.project.local 和 www.dev.project.local，得在同一个 块里加 ServerAlias dev.project.local www.dev.project.local
• httpd-vhosts.conf 文件本身默认是被注释掉的，必须确认 httpd.conf 里这行没被注释：Include conf/extra/httpd-vhosts.conf

hosts 文件怎么填才不翻车

Windows 的 hosts 是纯文本映射，不支持通配符或正则。每个你要访问的多级子域名，都得单独写一行指向 127.0.0.1：

• 错误写法：127.0.0.1 *.dev.project.local（会被当字面量，无效）
• 正确写法（三行）：127.0.0.1 dev.project.local、127.0.0.1 www.dev.project.local、127.0.0.1 api.dev.project.local
• 修改后必须以管理员身份运行记事本保存，否则 Windows 会静默失败（尤其 Win10/Win11）
• 改完别忘了清 DNS 缓存：ipconfig /flushdns，否则旧缓存可能让你白等几分钟

端口 + 子域名混搭的实际配置示例

假设你要让 admin.dev.project.local:8080 指向 D:\xampp\htdocs\project-admin，而 api.dev.project.local:8081 指向 D:\xampp\htdocs\project-api，操作顺序不能错：

• 第一步：在 httpd.conf 里添加监听端口（位置在已有 Listen 80 下方）：Listen 8080、Listen 8081
• 第二步：在 httpd-vhosts.conf 里分别写两个块（注意路径斜杠用正斜杠或双反斜杠）：

  <VirtualHost *:8080>
      ServerName admin.dev.project.local
      DocumentRoot "D:/xampp/htdocs/project-admin"
      <Directory "D:/xampp/htdocs/project-admin">
          Require all granted
          AllowOverride All
      </Directory>
  </VirtualHost>

  <VirtualHost *:8081>
      ServerName api.dev.project.local
      DocumentRoot "D:/xampp/htdocs/project-api"
      <Directory "D:/xampp/htdocs/project-api">
          Require all granted
          AllowOverride All
      </Directory>
  </VirtualHost>

• 第三步：确保 hosts 已含这两行：127.0.0.1 admin.dev.project.local 和 127.0.0.1 api.dev.project.local

最容易被忽略的是权限模型切换——XAMPP 从 5.6 开始默认用 Apache 2.4，Order Deny,Allow 和 Allow from all 全部失效，不换成 Require all granted 就算路径全对，也只会返回 403 Forbidden。另外，端口号尽量避开 1024 以下（比如别用 80、443、21），否则可能被系统服务占用或需要管理员权限启动。

理论要掌握，实操不能落！以上关于《XAMPP多端口配置及子域名设置方法》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！