Laragon中配置自定义域名需三步闭环:先以管理员权限修改hosts文件添加“127.0.0.1 myapp.test”,再在Settings→Apache中勾选“Enable Virtual Hosts”,最后通过Quick App自动创建或手动新建myapp.test.conf配置DocumentRoot并重启Apache。

在Laragon中为本地项目配置自定义域名(如myapp.test),是开发多项目时避免端口冲突、模拟真实线上环境的刚需操作,必须完成系统 hosts 绑定 + Laragon 虚拟主机启用 + 服务重启三步闭环,缺一不可。
修改系统 hosts 文件添加域名映射
用管理员权限打开记事本(右键→以管理员身份运行),然后通过“文件→打开”导航至 C:\Windows\System32\drivers\etc\hosts;若提示无权限保存,说明未以管理员身份运行,需重开。
在文件末尾另起一行,输入:127.0.0.1 myapp.test(将 myapp.test 替换为你想要的域名);【必须使用 127.0.0.1,不能写 localhost】,否则 Apache 无法正确路由。
保存文件。若提示“需要提供管理员权限才能保存”,请确认记事本是管理员模式启动;保存失败会导致后续所有配置无效。
在 Laragon 中启用虚拟主机支持
点击 Laragon 系统托盘图标 → Settings → Apache → 勾选 “Enable Virtual Hosts”。
这一步会自动在 laragon/etc/apache2/sites-enabled/ 下生成通配符配置,并启用 vhost.conf 加载逻辑;不勾选则所有自定义域名请求都会被 Apache 拒绝或返回 404。
为项目创建专属虚拟主机配置
方法一:使用 Laragon 自动创建(推荐新手)
Laragon 8.6.1 是一款轻量、快速的本地服务器环境管理工具,专为 Windows 开发者设计。它集成了 Apache、Nginx、PHP、MySQL、Redis 等核心组件,支持一键启动与切换。相比传统集成环境,Laragon 启动速度极快,占用内存极少,并自带自动虚拟主机功能,能通过文件夹名自动生成访问域名(如 projectname.test)。它特别适合 Laravel、Symfo
右键 Laragon 托盘图标 → Quick App → Choose a folder → 选择你的项目根目录(如 D:\laragon\www\myapp)→ 输入域名 myapp.test → 点击 OK。
方法二:手动编辑配置文件(适合批量或高级控制)
进入 laragon/etc/apache2/sites-enabled/,新建一个以域名命名的文件,例如 myapp.test.conf;内容如下:
<VirtualHost *:80>
ServerName myapp.test
DocumentRoot "D:/laragon/www/myapp"
<Directory "D:/laragon/www/myapp">
Options Indexes FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
【DocumentRoot 路径中的斜杠必须是正斜杠 /,不能用反斜杠 \】,否则 Apache 启动失败且无明确报错提示。
重启 Apache 使配置生效
第一步:点击 Laragon 托盘图标 → Apache → Restart。
第二步:观察右下角通知——出现 “Apache started successfully” 表示服务已加载新配置;若显示 “Failed to start”,请立即检查上一步配置文件语法和路径是否正确。
第三步:在浏览器地址栏输入 http://myapp.test,能正常打开项目首页即表示全部配置成功。


















