在Win10添加虚拟主机的方法

在进行 Web 应用开发或网站测试时，我们常常需要在本地搭建一个 Web 服务器环境，在这样的开发环境中，配置虚拟主机（Virtual Host）是一项非常实用的功能，通过虚拟主机，我们可以为不同的项目分配不同的域名，project1.local 和 project2.local，从而更加真实地模拟线上生产环境，本文将详细介绍如何在 Windows 10 系统中配置 Apache 服务器的虚拟主机。

准备工作

在开始配置虚拟主机之前,我们需要确保本地已经安装并正确配置了以下环境组件：

1. Apache 服务器
   可通过集成环境如 XAMPP、WAMP、AppServ 等安装 Apache，也可以选择单独安装 Apache。

2. 文本编辑器或代码编辑器
   推荐使用 Notepad++、Visual Studio Code 或 Sublime Text 等编辑器来修改配置文件。

3. 管理员权限
   修改系统文件（如 hosts 文件）时，需要以管理员身份运行编辑器,否则可能无法保存更改。

配置 Apache 虚拟主机

Apache 默认已经启用了虚拟主机功能，但需要我们手动进行配置,以下是具体操作步骤：

启用虚拟主机配置模块

Apache 的主配置文件为 httpd.conf，通常位于 Apache 安装目录下的 conf 文件夹中。

C:\xampp\apache\conf\httpd.conf

使用文本编辑器打开该文件,并查找以下语句：

#Include conf/extra/httpd-vhosts.conf

将前面的 号删除,启用该模块：

Include conf/extra/httpd-vhosts.conf

保存并关闭文件。

编辑虚拟主机配置文件

接下来打开虚拟主机配置文件：

C:\xampp\apache\conf\extra\httpd-vhosts.conf

该文件中可能包含一些示例配置，我们可以将其清空或直接覆盖,假设我们有两个项目目录：

• C:/projects/project1
• C:/projects/project2

在该文件中添加如下配置内容：

<VirtualHost *:80>
    ServerAdmin admin@example.com
    DocumentRoot "C:/projects/project1"
    ServerName project1.local
    ErrorLog "logs/project1.local-error.log"
    CustomLog "logs/project1.local-access.log" common
</VirtualHost>
<VirtualHost *:80>
    ServerAdmin admin@example.com
    DocumentRoot "C:/projects/project2"
    ServerName project2.local
    ErrorLog "logs/project2.local-error.log"
    CustomLog "logs/project2.local-access.log" common
</VirtualHost>

注意： Apache 配置中路径建议使用正斜杠 ，或者使用双反斜杠 \\,以避免路径解析错误。

修改 Windows 的 hosts 文件

为了让系统识别我们自定义的域名（如 project1.local），需要修改 Windows 的 hosts 文件。

打开路径：

C:\Windows\System32\drivers\etc\

2. 找到名为 hosts 的文件，以管理员身份运行文本编辑器打开它。

3. 在文件末尾添加以下内容：

0.0.1       project1.local
127.0.0.1       project2.local

保存文件（如果提示权限不足，可以先复制文件到桌面修改后再替换回去）。

重启 Apache 服务

完成上述配置后，需要重启 Apache 服务使更改生效。

如果你使用的是 XAMPP,可以按照以下步骤操作：

1. 打开 XAMPP 控制面板。
2. 点击 “Stop” 停止 Apache 服务。
3. 再次点击 “Start” 重新启动 Apache。

Apache 成功启动且没有报错,说明配置已经生效。

测试虚拟主机是否成功

打开浏览器,访问：

http://project1.local

如果显示你 project1 项目的内容,则说明虚拟主机配置成功。

同样访问：

http://project2.local

如果也能正常显示内容,说明两个虚拟主机均已配置完成。

常见问题及解决方法

无法访问虚拟主机，出现 403 或 404 错误

• 检查 Apache 的 httpd-vhosts.conf 文件中 DocumentRoot 设置的路径是否正确。
• 确保项目目录下存在 index.html、index.php 等默认首页文件。
• 查看 Apache 的错误日志文件（如 logs/project1.local-error.log）,获取具体错误信息。

hosts 文件无法保存

• 必须使用管理员权限运行编辑器才能修改 hosts 文件。
• 如果仍然无法保存，可以将 hosts 文件复制到桌面修改后,再放回原目录。

Apache 启动失败

• 检查 httpd.conf 和 httpd-vhosts.conf 文件是否存在语法错误。
• 在 XAMPP 控制面板中，点击 “Config” → “Apache (httpd)” → “Check Syntax” 来验证配置文件语法。

进阶配置建议

为虚拟主机配置 HTTPS

如果你希望为虚拟主机启用 HTTPS，可以在配置文件中添加 SSL 支持：

<VirtualHost *:443>
    ServerName project1.local
    DocumentRoot "C:/projects/project1"
    SSLEngine on
    SSLCertificateFile "C:/xampp/apache/conf/ssl.crt/server.crt"
    SSLCertificateKeyFile "C:/xampp/apache/conf/ssl.key/server.key"
</VirtualHost>

配置多个端口

如果你想使用非标准端口（如 8080），可以在 <VirtualHost> 标签中指定端口号：

<VirtualHost *:8080>
    ServerName project1.local
    DocumentRoot "C:/projects/project1"
</VirtualHost>

在 httpd.conf 中添加监听端口设置：

Listen 8080

通过本文的详细说明，相信你已经掌握了在 Windows 10 上配置 Apache 虚拟主机的方法，虚拟主机的配置不仅能帮助我们更高效地进行本地 Web 开发与测试，还能让我们更好地模拟生产环境,提升开发效率。

如果你是刚入门的开发者，建议从 Apache + XAMPP 的组合开始练习，逐步熟悉服务器配置流程，待熟练掌握后，可以进一步学习更复杂的服务器环境配置，例如使用 Nginx 或 Docker 等工具进行虚拟主机管理。

参考资料

• Apache 官方文档
• XAMPP 官方网站

关键词：如何在 Windows 10 添加虚拟主机、Apache 虚拟主机配置教程、本地 Web 开发环境搭建