手把手教你Homestead安装，并填坑（2017.3.27重大更新）

一时失言乱红尘 2022-06-14 07:39 214阅读 0赞

话说作为laravel的开发者，你听说Homestead应该很久了，可是官方推荐的开发环境在国内为什么鲜有人用？我这几天试着安装了一下，发现官方的安装教程实在存在着太多的大坑，尤其让刚刚入道的开发者望而却步，在本文我试着手把手教大家填上这个坑，我在腾讯课堂上传了[视频教程][Link 1]，欢迎报名学习。如果你觉得视频过于罗嗦，直接参看本教程即可。

原文链接：http://www.jianshu.com/p/ae9d1261bbd8

## 第一步 安装必须的软件 ##

1.安装vagrant，[点此进入][Link 2]下载页，vagrant属于跨平台应用，我的系统是win10。关于[vagrant教程][vagrant]，可以自己看一下，百度一下遍地是。不看也没关系，本文大概只用到其中的几个命令。

2.安装Virtualbox，当然你安装Vmware或parallels（OX系统）也可以，但后面下载的box要注意对应，虚拟机对应的版本不同。

## 第二步 导入box    ##

> vagrant box add laravel/homestead  
>

第一个坑：原本只要如上的命令即可，但由于国内众所周知的网络原因，我们不得不考虑先下载好你需要的box再来添加。

首先在[hashicorp][]中找到合适的版本,再在链接后加上”版本号/providers/虚拟机类型.box”即可获得下载链接.

如我们要下载最新的版本号为1.0.1的virtualbox版的box文件,链接即为:[https://atlas.hashicorp.com/laravel/boxes/homestead/versions/1.0.1/providers/virtualbox.box][https_atlas.hashicorp.com_laravel_boxes_homestead_versions_1.0.1_providers_virtualbox.box]

为此我还是提供了国内的链接（已更新到2.0.0），方便大家。

链接：[http://pan.baidu.com/s/1dEJdHj7 ][http_pan.baidu.com_s_1dEJdHj7]

密码：kzlc

不建议采用迅雷离线下载，据说会导致下载的文件损坏！

接下来我新建了一个文件夹名为homestead，然后我将下好的box重命名为homestead.box放入，然后在此文件夹内运行如下命令（这里是按照一些普通的教程来添加，这时候挖了一个坑，后面填上）。

> vagrant box add laravel/homestead homestead.box  
>

接着运行

> vagrant box list

![1240][]

vagrant box list

发现这个box已经添加进来就ok了。

## 第三步 下载官方homestead配置    ##

可以进入laravel5.3的[官方文档][Link 3]

按照文档的说明首先运行（必须本地已经安装了git）

git clone https://github.com/laravel/homestead.git Homestead

接着在已经克隆下来的文件夹内，会发现bash init.sh，init.bat两个文件，这两个分别是将该目录内的Homestead.yaml文件拷贝到你的系统“家”目录下。如果是在win下，又安装了git bash，则运行bash init.sh，init.bat均可。如果是在linux下，则运行bash init.sh。

接着我们就在家目录.homestead文件夹下找到了我们的这个配置文件

![1240 1][]

## 第四步 配置Homestead.yaml ##

设置 IP及Provider

Homestead.yaml文件中的provider键表示使用哪个 Vagrant 提供者：virtualbox、vmware\_fushion或者vmware\_workstation，你可以将其设置为自己喜欢的提供者：

ip: "192.168.10.10"

provider: virtualbox

配置共享文件夹

Homestead.yaml文件中的folders属性列出了所有主机和 Homestead 虚拟机共享的文件夹，一旦这些目录中的文件有了修改，将会在本地和 Homestead 虚拟机之间保持同步，如果有需要的话，你可以配置多个共享文件夹（一般一个就够了）：

> folders:
> 
> \- map: D:/homestead/code  \#（这是我本地的文件夹）
> 
> to: /home/vagrant/Code

配置 Nginx 站点

对 Nginx 不熟？没问题，通过sites属性你可以方便地将“域名”映射到 Homestead 虚拟机的指定目录，Homestead.yaml中默认已经配置了一个示例站点。和共享文件夹一样，你可以配置多个站点：

> sites:
> 
> \- map: liang.app
> 
> to: /home/vagrant/Code/Laravel/public

Hosts文件

不要忘记把 Nginx 站点配置中的域名添加到本地机器上的hosts文件中，该文件会将对本地域名的请求重定向到 Homestead 虚拟机，在 Mac 或 Linux上，该文件位于/etc/hosts，在 Windows 上，位于C:\\Windows\\System32\\drivers\\etc\\hosts，添加方式如下：

192.168.10.10 liang.app

确保 IP 地址和你的Homestead.yaml文件中列出的一致，一旦你将域名放置到hosts文件，就可以在浏览器中通过该域名访问站点了：

http://liang.app

## 第五步 启动vagrant ##

在 Homestead 目录下运行vagrant up命令，Vagrant 将会启动虚拟机并自动配置共享文件夹以及 Nginx 站点。官方文档对此描述的如此这般简单，其实这里遇到了第二个大坑

我们输入vagrant up看会发生什么？一堆的错误提示！！！！

![1240 2][]

我们根据提示，貌似是ssh的key没有生成，于是我们要运行如下命令，这个命令可以在git bash下生成，也可以在cmder等命令行工具完成，但在win下的cmd却无法执行。win 下可考虑powershell。

> ssh-keygen  
>

好了，我们欢喜的以为，我们可以顺利运行了。vagrant up。我擦居然提示这个box没有，需要安装。出现了第三个坑

![1240 3][]

再次出现该box不存在

导致该坑的原因，我们看之前的vagrant box list，里面显示laravel/homestead (virtualbox, 0)，而homestead要求Box Version: >= 1.0.0，这就不奇怪了。但我们明明下的是这个1.0.1版本啊。

![1240][]

vagrant box list

#### 我们有两种方式修复这个大坑    ####

#### 方式一    ####

修改homestead/scripts/homestead.rb的这个文件，将其中的>= 1.0.0改为< 1.0.0即可满足要求。但我并不推荐这种方式，因为实质对满足要求进行了篡改。

![1240 4][]

homestead.rb

#### 方式二 ####

我们在homestead下新建一个名为homestead.json的一个json配置文件

> \{  
> 
> 
> "name": "laravel/homestead",
> 
> "versions": \[\{
> 
> "version": "1.0.1",
> 
> "providers": \[\{
> 
> "name": "virtualbox",
> 
> "url": "file://homestead.box"
> 
> \}\]
> 
> \}\]
> 
> \}

看懂了吗？接着我们运行这个命令

> vagrant box add homestead.json  
>

![1240 5][]

已经添box成功

真的不容易啊，添加成功了

我们接着运行vagrant up试试

![1240 6][]

成功运行

经过这样一番折腾终于成功运行了。

## 第六步 登录vagrant并安装laravel ##

这一步应该是我们的最后一步了，我们期待目标通过本地能够访问到你用vagrant搭建起来的laravel。我们通过vagrant ssh命令即可顺利登录我们的系统了。

由于设置上我们的vagrant虚拟机Code目录和我们的本地主机D:/homestead/Code是同一个目录，因此，我们先移步到该目录。

第四个坑出现了，我们一般是通过composer来进行安装，但出于GFW原因，我们不得不用[中国镜像][Link 4]来安装。vagrant虚拟机中运行如下命令

> composer config -g repo.packagist composer https://packagist.phpcomposer.com  
>

接着我们通过composer来安装一个5.2版本

composer create-project laravel/laravel=5.2.\* --prefer-dist

OK，访问liang.app，出现了Laravel 5的欢迎界面，大功告成。

补坑：对于部分用户，可能出现autoload或boostrap不存在，说明依赖安装不完整，可以在laravel目录下运行如下命令来解决。

> composer update--no-scripts  
>

#  #

由于直接git clone 官方在github上的东西可能造成与本box版本不一致，建议解决方案参考评论中beyond\_\_devil所用的方法，将版本回滚。或者直接下最新的box或等我的box更新。

#  #

受各位启发，准备出一个Docker教程，于是乎发现了有意思的评论

# ![1240 7][]         #

#  #

欢迎打赏、打赏、打赏

#  #

2017.03.27重大更新

1.homestead的box已升级到2.0

2.vagrant版本要求必须是1.9+

3.最最重要的是，homestead在github上的版本已更新到5.1，有一些文件发生了变动。

最主要的变动是当运行init.bat或init.sh时候，几个文件将不再复制到家目录的.homestead文件，而是直接被复制到homestead项目的根目录中（源在homestead项目文件的resources文件夹下）。原先家目录下的.homestead可以直接删掉了！

![1240 8][]

几个文件变动

4.先删除原来box，可以用vagrant box remove laravel/homestead命令，destroy之前的虚拟机，接着重复之前的步骤，安装新的2.0box即可（记得修改添加时的版本号）。

##  ##

腾讯课堂已经更新，已报名的同学可以观看补充的课程

[Link 1]: https://ke.qq.com/course/183018
[Link 2]: https://www.vagrantup.com/downloads.html
[vagrant]: http://ninghao.net/blog/1566
[hashicorp]: https://atlas.hashicorp.com/laravel/boxes/homestead/
[https_atlas.hashicorp.com_laravel_boxes_homestead_versions_1.0.1_providers_virtualbox.box]: https://atlas.hashicorp.com/laravel/boxes/homestead/versions/0.4.1/providers/virtualbox.box
[http_pan.baidu.com_s_1dEJdHj7]: http://pan.baidu.com/s/1dEJdHj7%20
[1240]: /images/20220614/ae107061dde34e9aac9128e0440ee4a3.png
[Link 3]: https://laravel.com/docs/5.3/homestead
[1240 1]: /images/20220614/ac9b4dd858f84b5d81a7d243353b237e.png
[1240 2]: /images/20220614/15fe53b76576432287dda8f4a21a03bd.png
[1240 3]: /images/20220614/6de463b9603f497ba10205df7735e279.png
[1240 4]: /images/20220614/56c73be752dc4d9dafcb440cd7a41ad4.png
[1240 5]: /images/20220614/9e211d7286e14b748856c96cd1fe3bf8.png
[1240 6]: /images/20220614/4947ba09ed974cbd90ed867d00d07d61.png
[Link 4]: http://pkg.phpcomposer.com/
[1240 7]: /images/20220614/2c8c7e5cb0434e82a1742b2abbff7353.png
[1240 8]: /images/20220614/8a5197dbdfd143ae897636510e406bc2.png