XAMPP多端口配置：httpd-vhosts.conf详解

本文深入解析了XAMPP中实现多端口本地开发环境的关键原理与实操要点，直击“配置了VirtualHost却无法访问”的普遍痛点——根本原因在于httpd-vhosts.conf本身不负责端口监听，真正起效的是httpd.conf中的Listen指令和未被注释的Include行；文章不仅厘清了配置逻辑层级（从全局监听→虚拟主机绑定→目录权限控制），还系统梳理了ERR_CONNECTION_REFUSED、403 Forbidden等典型错误的根源，涵盖防火墙拦截、hosts映射缺失、Apache版本权限语法差异、管理员权限重启等易忽略细节，并给出可直接复用的安全配置示例，助开发者一步到位搭建稳定、灵活的多项目并行调试环境。

直接说结论：XAMPP 的 httpd-vhosts.conf 本身不“支持多端口”——它只负责把某个端口（比如 *:8080）绑定到某个目录；真正让多端口生效的，是 httpd.conf 里的 Listen 指令。漏掉这一步，VirtualHost 配置再对也访问不了。

为什么加了 VirtualHost *:8080 还打不开？

常见错误现象是浏览器卡住、连接被拒绝，或直接报 ERR_CONNECTION_REFUSED。

• httpd.conf 中没加 Listen 8080（或对应端口），Apache 根本不监听该端口
• Include conf/extra/httpd-vhosts.conf 这行仍被注释（前面有 #），整个 httpd-vhosts.conf 文件没被加载
• Windows 防火墙或杀毒软件拦截了新端口（尤其 8080 以外的非常用端口）

httpd-vhosts.conf 里怎么写多端口配置？

每个 VirtualHost 块必须明确指定端口号，且 DocumentRoot 必须是绝对路径（不能以 ./ 或 htdocs/xxx 开头），末尾不加斜杠。

示例（添加到 httpd-vhosts.conf 文件末尾）：

<VirtualHost *:8080>
    DocumentRoot "C:/xampp/htdocs/project-a"
    ServerName localhost:8080
    <Directory "C:/xampp/htdocs/project-a">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:8081>
    DocumentRoot "C:/xampp/htdocs/project-b"
    ServerName localhost:8081
    <Directory "C:/xampp/htdocs/project-b">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

• 不要用 ServerAlias 替代 ServerName，否则部分 Apache 版本会忽略该虚拟主机
• 如果项目依赖 .htaccess（如 Laravel、WordPress），AllowOverride All 不可省略
• Require all granted 是 Apache 2.4+ 的权限语法；若用旧版 XAMPP（Apache 2.2），需改用 Order allow,deny + Allow from all

为什么访问时总报 403 Forbidden？

绝大多数情况不是 httpd-vhosts.conf 写错了，而是全局目录权限没放开。

在 httpd.conf 中找到类似这段（通常在 210–230 行附近）：

<Directory />
    AllowOverride none
    Require all denied
</Directory>

必须改成：

<Directory />
    AllowOverride none
    Require all granted
</Directory>

• 这个配置控制 Apache 对所有路径的默认访问策略，VirtualHost 里的 只能在此基础上收紧，不能突破它
• 改完后务必运行 httpd -t（在 XAMPP 控制面板里点 “Shell” 输入）验证语法，避免重启失败
• Windows 下修改 httpd.conf 后需以管理员身份重启 Apache，否则可能因权限不足无法加载新配置

实际访问时要注意什么？

配置生效 ≠ 能直接用 http://localhost:8080 访问——你得确认三件事：

• 浏览器地址栏输的是 http://localhost:8080，不是 https://（除非你配了 SSL）
• 对应目录下有可识别的首页文件（如 index.php、index.html），否则会报 403（目录列表被禁）或 404
• 如果要用自定义域名（如 dev.project-a.com），必须同时在系统 hosts 文件中加映射：127.0.0.1 dev.project-a.com，否则 DNS 解析失败

最常被忽略的一点：改完所有配置后，必须彻底停止再启动 Apache（不是“重启”，XAMPP 的“重启”有时只重载模块，不重读 httpd.conf）。直接点“Stop”，等状态变灰，再点“Start”。

今天关于《XAMPP多端口配置：httpd-vhosts.conf详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于XAMPP的内容请关注golang学习网公众号！