在Laragon中为Laravel项目改域名需三步闭环:先以管理员权限修改hosts添加“127.0.0.1 myapp.test”,再在Settings→Apache中勾选“Enable Virtual Hosts”,最后通过Quick App创建虚拟主机并重启Apache。

在 Laragon 中为 Laravel 项目改域名,本质是让 本地请求能通过自定义域名(如 myapp.test)访问到你的 Laravel 项目。这需要系统级、Web 服务器级和项目级三者协同,不能只改 Laravel 的 APP_URL 或路由。核心是“自定义 Host + 虚拟主机启用”闭环,下面分步说明。
修改系统 hosts 文件绑定域名
这是第一步,也是最常出错的环节。必须用管理员权限操作:
- 右键“记事本”,选择“以管理员身份运行”
- 菜单栏点“文件 → 打开”,路径输入:C:\Windows\System32\drivers\etc\hosts
- 在文件末尾另起一行,写入:127.0.0.1 myapp.test(把 myapp.test 换成你想要的域名)
- 务必用 127.0.0.1,不能写 localhost;否则 Apache 无法识别该域名请求
- 保存时若提示权限不足,说明没用管理员模式打开,需重来
在 Laragon 中启用并生成虚拟主机
仅改 hosts 不够,Laragon 必须告诉 Apache:“这个域名归哪个项目管”:
- 点击系统托盘中的 Laragon 图标 → Settings → Apache → 勾选 “Enable Virtual Hosts”
- 确保你的 Laravel 项目已放在 C:\laragon\www\myapp(文件夹名建议与域名前缀一致)
- 右键 Laragon 图标 → Quick App → Create Virtual Host,输入域名 myapp.test
- Laragon 会自动创建 laragon/etc/apache2/sites-enabled/myapp.test.conf,并设置 DocumentRoot 指向你的 Laravel public 目录
- 最后点主界面的 Restart Apache(或右键重启),让配置生效
验证 Laravel 是否响应正确域名
此时浏览器访问 http://myapp.test 应显示 Laravel 首页。若报 404 或连接失败,检查以下三点:
- hosts 是否保存成功(可 cmd 输入 ping myapp.test,应返回 127.0.0.1)
- Laragon 的 Apache 是否已启用虚拟主机且服务正在运行(托盘图标应为绿色)
- Laravel 的 APP_URL 在 .env 中设为 https://myapp.test(非必须,但影响生成 URL 和重定向)
进阶:支持 HTTPS 或子域名
如果需要 https://myapp.test 或 admin.myapp.test 这类子域名,Laragon 提供一键支持:
- 右键 Laragon 图标 → SSL → Install Self-signed Certificate,之后所有 .test 域名自动支持 HTTPS
- 子域名(如 admin.myapp.test)同样需加到 hosts:127.0.0.1 admin.myapp.test
- 再用 Quick App 创建同名虚拟主机,或手动复制一份 myapp.test.conf 改名为 admin.myapp.test.conf,并调整 DocumentRoot 或 ServerAlias
- Laravel 内部可用 Route::domain('admin.myapp.test') 分离后台路由逻辑


















