首先安装VirtualBox和Vagrant，然后添加Homestead Box并克隆配置项目，接着配置Homestead.yaml文件定义IP、共享目录和站点映射，之后启动虚拟机并通过SSH连接验证服务运行，最后修改本地hosts文件实现域名解析访问。
如果您在使用Laravel开发项目时希望搭建一个统一、隔离的本地开发环境，Homestead是一个基于Vagrant的官方推荐方案。以下是完成Homestead环境配置的具体步骤：
一、安装VirtualBox与Vagrant
Homestead依赖于虚拟化技术运行Ubuntu环境，因此需要先安装底层虚拟机平台和自动化部署工具。
1、访问VirtualBox官网下载并安装适合您操作系统的版本，安装完成后验证是否可正常启动。
2、前往Vagrant官方网站下载最新版安装包，安装后在终端执行 vagrant --version 确认安装成功。
二、添加Homestead Box
Homestead box是预配置的Ubuntu虚拟机镜像，通过Vagrant管理，添加该box可加快后续环境初始化速度。
1、打开命令行工具，运行指令 vagrant box add laravel/homestead 自动从仓库下载最新版本的Homestead镜像。
2、等待下载完成后，可通过 vagrant box list 查看已安装的box列表以确认添加成功。
三、克隆Homestead配置项目
Homestead提供了一个包含Vagrantfile和配置脚本的Git仓库，需将其克隆到本地用于定义虚拟机行为。
1、选择一个合适目录，执行 git clone https://github.com/laravel/homestead.git Homestead 克隆官方仓库。
2、进入克隆后的目录，运行 bash init.sh（Linux/macOS）或 init.bat（Windows）生成本地配置文件Homestead.yaml。
四、配置Homestead.yaml文件
该YAML文件用于定义虚拟机的IP地址、共享文件夹、域名映射及数据库设置等核心参数。
1、使用文本编辑器打开Homestead.yaml，修改 ip 字段为所需的私有网络地址，例如192.168.10.10。
GitHub 项目更新追踪工具 - 自动检查多个 GitHub 项目的 Releases 和 CHANGELOG，生成更新摘要与影响分析报告。支持自动化定时任务。 如何使用 最简单的方式：直接用自然语言告诉我 你可以说 我会做 「检查 GitHub 更新」 检查最新版本 「添加 vscode」 追踪新项目 「停止追踪 xxx」 移除项目 「暂停更新检查」 暂停自动化 「给我看 openclaw 报告」 展示报告 触发词：「追踪项目更新」「检查 GitHub 更新」「项目更新报告」「设置更新提醒」
2、在 folders 列表中添加本地项目路径与虚拟机内的挂载点，格式为：map: 本地路径，to: 虚拟机路径。
3、在 sites 部分配置Nginx站点，指定域名与项目public目录的映射关系，如将test.app指向/code/test/public。
4、保存文件前确保缩进正确，YAML对空格敏感，错误格式会导致Vagrant报错。
五、启动并连接Homestead虚拟机
完成配置后即可启动虚拟机，并通过SSH连接进行进一步操作。
1、在Homestead项目根目录下运行 vagrant up 启动虚拟机，首次启动会自动进行系统初始化。
2、启动成功后，执行 vagrant ssh 进入虚拟机终端环境。
3、进入后可检查PHP、MySQL、Nginx等服务是否正常运行，例如输入 php -v 查看PHP版本信息。
六、配置本地主机域名解析
为了让浏览器能通过自定义域名访问虚拟机中的站点，需修改本地hosts文件实现DNS映射。
1、在本地计算机上找到hosts文件：Windows位于 C:\Windows\System32\drivers\etc\hosts，macOS/Linux位于 /etc/hosts。
2、以管理员权限打开该文件，在末尾添加一行：192.168.10.10 test.app（IP与域名需与Homestead.yaml中一致）。
3、保存文件后，在浏览器中访问 http://test.app 即可加载对应项目内容。
