如何在Apache中包含httpd vhosts conf配置文件
海外云服务器 40个地区可选 亚太云服务器 香港 日本 韩国
云虚拟主机 个人和企业网站的理想选择 俄罗斯电商外贸虚拟主机 赠送SSL证书
该指令用于在Apache HTTP服务器配置中包含虚拟主机的额外配置文件,通过加载conf/extra/httpd-vhosts.conf,用户可集中管理多个网站或域名的虚拟主机设置,实现基于名称或IP的虚拟托管,此方式提升配置模块化与可维护性,便于为不同站点独立设定文档根目录、访问权限及日志路径等参数,是部署多站点环境的标准实践。XWAMP 虚拟主机配置指南:手把手搭建本地多站点开发环境
在现代 Web 开发实践中,开发者往往需要同时维护多个项目,或模拟线上服务器架构进行本地调试,配置本地虚拟主机(Virtual Host)就显得尤为关键——它不仅能让你在同一台机器上运行多个独立网站,还能为每个项目分配专属域名和根目录,极大提升开发效率与环境真实性。
XWAMP 是一款专为 Windows 平台打造的集成式本地服务器环境套件,内含 Apache、MySQL、PHP 与 phpMyAdmin 等核心组件,开箱即用,是新手入门和资深开发者本地调试的理想选择,本文将从零开始,带你一步步完成 XWAMP 的虚拟主机配置,轻松实现多站点并行开发、域名隔离访问、环境高度仿真的高效工作流。
什么是“虚拟主机”?为什么你需要它?
所谓“虚拟主机”,是指在一台物理服务器(或你的本地电脑)上,通过软件配置模拟出多个独立的网站服务,每个“虚拟站点”拥有:
- 专属域名(如:
http://mysite.local、http://blog.test) - 独立的项目根目录(如:
C:/xwamp/www/mysite、C:/xwamp/www/blog) - 自定义的访问权限、日志路径、错误页面等配置
相比传统的“localhost/项目名”访问方式,虚拟主机能避免路径冲突、提升调试真实感,并支持团队协作中统一域名规范,是迈向专业开发的重要一步。
配置前的准备工作
请确保你已完成以下步骤:
- ✅ XWAMP 已正确安装并成功启动(Apache 和 MySQL 服务均正常运行)
- ✅ 项目文件夹已创建(如:
C:/xwamp/www/mysite、C:/xwamp/www/blog) - ✅ 使用文本编辑器(推荐 VS Code、Notepad++ 或 Sublime Text)以管理员身份打开配置文件
启用 Apache 虚拟主机功能
打开 XWAMP 安装目录下的 apache/conf/httpd.conf 文件。
搜索以下行(通常位于文件中后段):
#Include conf/extra/httpd-vhosts.conf
删除行首的 号,取消注释,使其变为:
Include conf/extra/httpd-vhosts.conf
✅ 此操作启用了 Apache 对虚拟主机配置文件的支持。
编写虚拟主机配置
打开 apache/conf/extra/httpd-vhosts.conf 文件。
建议先备份原文件,然后清空或注释掉默认示例内容(避免干扰)。
添加如下自定义虚拟主机配置(可根据实际项目数量增减):
<VirtualHost *:80>
ServerName mysite.local
DocumentRoot "C:/xwamp/www/mysite"
<Directory "C:/xwamp/www/mysite">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
<VirtualHost *:80>
ServerName blog.test
DocumentRoot "C:/xwamp/www/blog"
<Directory "C:/xwamp/www/blog">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
📌 配置说明:
ServerName:自定义访问域名,建议使用.local或.test后缀,避免与公网域名冲突。DocumentRoot:项目根目录路径,请确保路径存在且包含入口文件(如 index.php / index.html)。<Directory>块:设置目录访问权限,AllowOverride All允许 .htaccess 生效,Require all granted授予所有访问权限(开发环境适用)。
修改系统 Hosts 文件,绑定本地域名
为了让浏览器识别你自定义的域名,需将其指向本地回环地址 0.0.1。
打开路径:C:\Windows\System32\drivers\etc\hosts
⚠️ 注意:必须以管理员身份运行编辑器才能保存修改。
在文件末尾添加以下行:
0.0.1 mysite.local
127.0.0.1 blog.test
❗ 你原文中的 0.1 是错误 IP,已修正为 0.0.1。
重启服务 & 测试访问
返回 XWAMP 控制面板,点击 “Restart Apache” 重启服务,使新配置生效。
打开浏览器,分别访问:
🎉 如果看到对应项目的首页,恭喜你——虚拟主机配置成功!
进阶技巧 & 常见问题排查
▶ 支持 HTTPS(SSL 虚拟主机)
只需复制上述配置,将端口改为 *:443,并添加 SSL 相关指令(如 SSLEngine on、证书路径等),即可开启本地 HTTPS 环境。
▶ 自定义端口绑定
若 80 端口被占用,可修改为 <VirtualHost *:8080>,并在 hosts 中保持域名不变,访问时加上端口号即可(如:http://mysite.local:8080)。
▶ 日志分离
在每个 <VirtualHost> 块中加入:
ErrorLog "logs/mysite_error.log"
CustomLog "logs/mysite_access.log" combined
便于独立监控各站点运行状态。
▶ 故障排查 Tips:
- Apache 启动失败?检查路径是否含中文或空格,建议使用英文路径。
- 访问显示 403 Forbidden?确认
<Directory>权限配置无误。 - 域名无法解析?确认 hosts 文件保存成功,且无拼写错误。
- 仍访问到默认页?清除浏览器缓存,或尝试无痕模式访问。
让本地开发更专业、更高效
掌握 XWAMP 虚拟主机配置,不仅意味着你能轻松管理多个项目,更代表着你已具备构建接近生产环境的本地开发能力,无论是个人学习、团队协作,还是上线前的兼容性测试,虚拟主机都能为你提供稳定、隔离、可控的调试空间。
别再用 localhost/project1、localhost/project2 这种原始方式了——现在就开始配置属于


