XAMPP多端口配置及hosts映射教程

本文详细讲解了如何在XAMPP中通过配置Apache多端口监听（如8080、8081）与虚拟主机绑定，结合系统hosts文件域名映射，实现多个本地开发站点（如dev1.test、dev2.test）的独立运行与便捷访问；内容涵盖httpd.conf修改、VirtualHost精准配置、路径书写规范、hosts生效要点及常见跳转失败原因解析，手把手解决“为什么dev1.test总跳回localhost”等高频痛点，让前端和后端开发者无需复杂工具即可高效管理本地多项目环境。

Apache怎么监听多个端口

XAMPP默认只监听 80 端口，要跑多个本地站点（比如 dev1.test 和 dev2.test），最直接的方式是让 Apache 同时监听多个端口，例如 8080、8081。这比改 DNS 或用子域名泛解析更可控。

操作路径：C:\xampp\apache\conf\httpd.conf（Windows）或 /Applications/XAMPP/etc/httpd.conf（macOS）。

找到 Listen 80 这一行，在它下面新增：

Listen 8080
Listen 8081

注意：不能只写端口号，必须是完整 Listen 指令；如果已有其他 Listen 行（如 Listen 443），保持格式一致即可。

重启 Apache 后，http://localhost:8080 和 http://localhost:8081 就能分别访问不同服务了。

如何为每个端口配独立虚拟主机

光开多个端口没用——所有请求默认都进同一个 DocumentRoot。得靠 把端口和目录/域名绑定起来。

在 httpd.conf 文件末尾或 httpd-vhosts.conf（推荐）里添加：

<VirtualHost *:8080>
    DocumentRoot "C:/xampp/htdocs/dev1"
    ServerName dev1.test
</VirtualHost>

<VirtualHost *:8081>
    DocumentRoot "C:/xampp/htdocs/dev2"
    ServerName dev2.test
</VirtualHost>

关键点：

• ServerName 必须和 hosts 里写的域名完全一致（大小写不敏感，但建议全小写）
• DocumentRoot 路径里的反斜杠在 Windows 上要用正斜杠或双反斜杠，否则 Apache 启动失败
• 确保 httpd-vhosts.conf 已被主配置文件包含（检查 httpd.conf 中是否有 Include conf/extra/httpd-vhosts.conf 且未被注释）

hosts 文件怎么写才生效

Windows 路径：C:\Windows\System32\drivers\etc\hosts；macOS/Linux：/etc/hosts。必须用管理员权限（Windows）或 sudo（macOS）编辑。

每行一个映射，格式固定：IP地址 域名，中间用空格或制表符分隔。本地开发只用 127.0.0.1：

127.0.0.1 dev1.test
127.0.0.1 dev2.test

常见失效原因：

• 文件保存时被记事本加了 .txt 后缀（如 hosts.txt），必须确认扩展名是纯 hosts
• 浏览器缓存了旧 DNS 结果，可尝试 chrome://net-internals/#dns 清除 DNS 缓存，或换 Firefox 测试
• 系统防火墙或安全软件拦截了非标端口（如 8081），临时关闭测试一次

为什么访问 dev1.test 总跳回 localhost

这是最常卡住人的地方：浏览器发请求时，默认走 80 端口，而你把 dev1.test 绑到了 8080。所以必须显式带端口访问：http://dev1.test:8080。

想省略端口，只有两个办法：

• 把虚拟主机绑定到 80 端口，再用不同 ServerName 区分（这时 hosts 映射仍有效，但需确保每个 ServerName 唯一）
• 用反向代理（如 Nginx）监听 80，按 Host 头转发到后端不同端口——对 XAMPP 来说属于过度设计

别试图用 Redirect 或 mod_rewrite 隐藏端口，HTTP 协议本身不允许浏览器自动补端口，前端永远得知道目标端口。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~