跳至内容
Laravel

Laravel Homestead

简介

Laravel 致力于使整个 PHP 开发体验变得愉快，包括您的本地开发环境。 Laravel Homestead 是一个官方的预打包 Vagrant 虚拟机，它为您提供了一个很棒的开发环境，无需在本地机器上安装 PHP、Web 服务器或任何其他服务器软件。

Vagrant 提供了一种简单、优雅的方式来管理和配置虚拟机。Vagrant 虚拟机是完全可丢弃的。如果出现问题，您可以在几分钟内销毁并重新创建虚拟机！

Homestead 可以在任何 Windows、macOS 或 Linux 系统上运行，并且包含 Nginx、PHP、MySQL、PostgreSQL、Redis、Memcached、Node 以及开发出色的 Laravel 应用程序所需的所有其他软件。

exclamation

如果您使用的是 Windows，您可能需要启用硬件虚拟化 (VT-x)。它通常可以通过 BIOS 启用。如果您在 UEFI 系统上使用 Hyper-V，您可能还需要禁用 Hyper-V 才能访问 VT-x。

包含的软件

  • Ubuntu 22.04
  • Git
  • PHP 8.3
  • PHP 8.2
  • PHP 8.1
  • PHP 8.0
  • PHP 7.4
  • PHP 7.3
  • PHP 7.2
  • PHP 7.1
  • PHP 7.0
  • PHP 5.6
  • Nginx
  • MySQL 8.0
  • lmm
  • Sqlite3
  • PostgreSQL 15
  • Composer
  • Docker
  • Node（包含 Yarn、Bower、Grunt 和 Gulp）
  • Redis
  • Memcached
  • Beanstalkd
  • Mailpit
  • avahi
  • ngrok
  • Xdebug
  • XHProf / Tideways / XHGui
  • wp-cli

可选软件

  • Apache
  • Blackfire
  • Cassandra
  • Chronograf
  • CouchDB
  • Crystal & Lucky Framework
  • Elasticsearch
  • EventStoreDB
  • Flyway
  • Gearman
  • Go
  • Grafana
  • InfluxDB
  • Logstash
  • MariaDB
  • Meilisearch
  • MinIO
  • MongoDB
  • Neo4j
  • Oh My Zsh
  • Open Resty
  • PM2
  • Python
  • R
  • RabbitMQ
  • Rust
  • RVM（Ruby 版本管理器）
  • Solr
  • TimescaleDB
  • Trader (PHP 扩展)
  • Webdriver & Laravel Dusk 工具

安装和设置

第一步

在启动 Homestead 环境之前，您必须安装 Vagrant 以及以下支持的提供商之一

所有这些软件包都为所有流行的操作系统提供了易于使用的可视化安装程序。

要使用 Parallels 提供商，您需要安装 Parallels Vagrant 插件。它是免费的。

安装 Homestead

您可以通过将 Homestead 存储库克隆到您的主机机器上安装 Homestead。考虑将存储库克隆到您的“home”目录中的 Homestead 文件夹中，因为 Homestead 虚拟机将充当所有 Laravel 应用程序的主机。在本文档中，我们将此目录称为您的“Homestead 目录”。

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

克隆 Laravel Homestead 存储库后，您应该检出 release 分支。此分支始终包含 Homestead 的最新稳定版本。

cd ~/Homestead
 
git checkout release

接下来，从 Homestead 目录执行 bash init.sh 命令以创建 Homestead.yaml 配置文件。Homestead.yaml 文件是您配置 Homestead 安装所有设置的地方。此文件将放置在 Homestead 目录中。

# macOS / Linux...
bash init.sh
 
# Windows...
init.bat

配置 Homestead

设置您的提供商

Homestead.yaml 文件中的 provider 键指示应使用哪个 Vagrant 提供商：virtualbox 或 parallels。

provider: virtualbox
exclamation

如果您使用的是 Apple Silicon，则需要 Parallels 提供商。

配置共享文件夹

Homestead.yaml 文件的 folders 属性列出了您希望与 Homestead 环境共享的所有文件夹。随着这些文件夹中文件的更改，它们将在您的本地机器和 Homestead 虚拟环境之间保持同步。您可以根据需要配置任意数量的共享文件夹。

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
exclamation

Windows 用户不应使用 ~/ 路径语法，而应使用项目的完整路径，例如 C:\Users\user\Code\project1。

您应该始终将各个应用程序映射到其自己的文件夹映射，而不是映射包含所有应用程序的单个大型目录。当您映射文件夹时，虚拟机必须跟踪文件夹中每个文件的全部磁盘 IO。如果您在文件夹中包含大量文件，则可能会降低性能。

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
    - map: ~/code/project2
      to: /home/vagrant/project2
exclamation

使用 Homestead 时，您永远不应挂载 .（当前目录）。这会导致 Vagrant 不将当前文件夹映射到 /vagrant，并且会破坏可选功能并在配置过程中导致意外结果。

要启用 NFS，您可以在文件夹映射中添加 type 选项。

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
      type: "nfs"
exclamation

在 Windows 上使用 NFS 时，您应该考虑安装 vagrant-winnfsd 插件。此插件将为 Homestead 虚拟机中文件和目录维护正确的用户/组权限。

您还可以通过在 options 键下列出它们来传递 Vagrant 的 同步文件夹 支持的任何选项。

folders:
    - map: ~/code/project1
      to: /home/vagrant/project1
      type: "rsync"
      options:
          rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
          rsync__exclude: ["node_modules"]

配置 Nginx 站点

不熟悉 Nginx？没问题。Homestead.yaml 文件的 sites 属性允许您轻松地将“域名”映射到 Homestead 环境上的文件夹。Homestead.yaml 文件中包含一个示例站点配置。同样，您可以根据需要向 Homestead 环境添加任意数量的站点。Homestead 可以作为您正在处理的每个 Laravel 应用程序的便捷虚拟化环境。

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public

如果您在配置 Homestead 虚拟机后更改了 sites 属性，则应在您的终端中执行 vagrant reload --provision 命令以更新虚拟机上的 Nginx 配置。

exclamation

Homestead 脚本尽可能地构建为幂等的。但是，如果您在配置过程中遇到问题，则应通过执行 vagrant destroy && vagrant up 命令销毁并重建虚拟机。

主机名解析

Homestead 使用 mDNS 发布主机名以实现自动主机解析。如果您在 Homestead.yaml 文件中设置 hostname: homestead，则主机将在 homestead.local 上可用。macOS、iOS 和 Linux 桌面发行版默认包含 mDNS 支持。如果您使用的是 Windows，则必须安装 Bonjour 打印服务 for Windows。

使用自动主机名最适合用于 每个项目的 Homestead 安装。如果您在一个 Homestead 实例上托管多个站点，您可以将您网站的“域名”添加到机器上的 hosts 文件中。hosts 文件会将对您 Homestead 站点的请求重定向到您的 Homestead 虚拟机。在 macOS 和 Linux 上，此文件位于 /etc/hosts。在 Windows 上，它位于 C:\Windows\System32\drivers\etc\hosts。您添加到此文件中的行将如下所示

192.168.56.56  homestead.test

确保列出的 IP 地址与您 Homestead.yaml 文件中设置的 IP 地址一致。将域名添加到 hosts 文件并启动 Vagrant 虚拟机后，您将能够通过 Web 浏览器访问该站点

http://homestead.test

配置服务

Homestead 默认启动多个服务；但是，您可以在预配期间自定义哪些服务已启用或禁用。例如，您可以通过修改 Homestead.yaml 文件中的 services 选项来启用 PostgreSQL 并禁用 MySQL

services:
    - enabled:
        - "postgresql"
    - disabled:
        - "mysql"

指定的服务将根据其在 enabled 和 disabled 指令中的顺序启动或停止。

启动 Vagrant 虚拟机

在您根据自己的喜好编辑完 Homestead.yaml 后，从您的 Homestead 目录运行 vagrant up 命令。Vagrant 将启动虚拟机并自动配置您的共享文件夹和 Nginx 站点。

要销毁虚拟机，您可以使用 vagrant destroy 命令。

每个项目的安装

您可以为管理的每个项目配置一个 Homestead 实例，而不是全局安装 Homestead 并跨所有项目共享同一个 Homestead 虚拟机。如果您希望将 Vagrantfile 与您的项目一起交付，则每个项目安装 Homestead 可能会有益，从而允许在克隆项目存储库后立即 vagrant up 的其他项目参与者。

您可以使用 Composer 包管理器将 Homestead 安装到您的项目中

composer require laravel/homestead --dev

安装 Homestead 后，调用 Homestead 的 make 命令为您的项目生成 Vagrantfile 和 Homestead.yaml 文件。这些文件将放置在项目的根目录中。make 命令将自动配置 Homestead.yaml 文件中的 sites 和 folders 指令

# macOS / Linux...
php vendor/bin/homestead make
 
# Windows...
vendor\\bin\\homestead make

接下来，在您的终端中运行 vagrant up 命令，并在浏览器中访问 http://homestead.test 上的项目。请记住，如果您不使用自动 主机名解析，您仍然需要为 homestead.test 或您选择的域名添加 /etc/hosts 文件条目。

安装可选功能

可选软件是使用 Homestead.yaml 文件中的 features 选项安装的。大多数功能可以使用布尔值启用或禁用，而某些功能允许多个配置选项

features:
    - blackfire:
        server_id: "server_id"
        server_token: "server_value"
        client_id: "client_id"
        client_token: "client_value"
    - cassandra: true
    - chronograf: true
    - couchdb: true
    - crystal: true
    - dragonflydb: true
    - elasticsearch:
        version: 7.9.0
    - eventstore: true
        version: 21.2.0
    - flyway: true
    - gearman: true
    - golang: true
    - grafana: true
    - influxdb: true
    - logstash: true
    - mariadb: true
    - meilisearch: true
    - minio: true
    - mongodb: true
    - neo4j: true
    - ohmyzsh: true
    - openresty: true
    - pm2: true
    - python: true
    - r-base: true
    - rabbitmq: true
    - rustc: true
    - rvm: true
    - solr: true
    - timescaledb: true
    - trader: true
    - webdriver: true

Elasticsearch

您可以指定 Elasticsearch 的受支持版本，该版本必须是精确的版本号（主版本.次版本.修订版本）。默认安装将创建一个名为“homestead”的集群。您永远不应该为 Elasticsearch 提供超过操作系统内存一半的内存，因此请确保您的 Homestead 虚拟机至少具有 Elasticsearch 分配的两倍内存。

lightbulb

查看 Elasticsearch 文档，了解如何自定义您的配置。

MariaDB

启用 MariaDB 将删除 MySQL 并安装 MariaDB。MariaDB 通常用作 MySQL 的直接替换，因此您仍然应该在应用程序的数据库配置中使用 mysql 数据库驱动程序。

MongoDB

默认的 MongoDB 安装将把数据库用户名设置为 homestead，并将相应的密码设置为 secret。

Neo4j

默认的 Neo4j 安装将把数据库用户名设置为 homestead，并将相应的密码设置为 secret。要访问 Neo4j 浏览器，请通过 Web 浏览器访问 http://homestead.test:7474。端口 7687（Bolt）、7474（HTTP）和 7473（HTTPS）已准备好为来自 Neo4j 客户端的请求提供服务。

别名

您可以通过修改 Homestead 目录中的 aliases 文件，将 Bash 别名添加到您的 Homestead 虚拟机

alias c='clear'
alias ..='cd ..'

更新 aliases 文件后，应使用 vagrant reload --provision 命令重新预配 Homestead 虚拟机。这将确保您的新别名在机器上可用。

更新 Homestead

在开始更新 Homestead 之前，您应该确保已通过在 Homestead 目录中运行以下命令删除了当前虚拟机

vagrant destroy

接下来，您需要更新 Homestead 源代码。如果您克隆了存储库，则可以在最初克隆存储库的位置执行以下命令

git fetch
 
git pull origin release

这些命令从 GitHub 存储库中拉取最新的 Homestead 代码，获取最新的标签，然后检出最新的标记版本。您可以在 Homestead 的 GitHub 发行版页面 上找到最新的稳定版本。

如果您通过项目的 composer.json 文件安装了 Homestead，则应确保您的 composer.json 文件包含 "laravel/homestead": "^12" 并更新您的依赖项

composer update

接下来，您应该使用 vagrant box update 命令更新 Vagrant 虚拟机。

vagrant box update

更新 Vagrant 虚拟机后，您应该从 Homestead 目录运行 bash init.sh 命令以更新 Homestead 的其他配置文件。系统会询问您是否希望覆盖现有的 Homestead.yaml、after.sh 和 aliases 文件

# macOS / Linux...
bash init.sh
 
# Windows...
init.bat

最后，您需要重新生成 Homestead 虚拟机以利用最新的 Vagrant 安装

vagrant up

日常使用

通过 SSH 连接

您可以通过从 Homestead 目录执行 vagrant ssh 终端命令来 SSH 进入您的虚拟机。

添加其他站点

在您的 Homestead 环境预配并运行后，您可能希望为其他 Laravel 项目添加其他 Nginx 站点。您可以在单个 Homestead 环境中运行任意数量的 Laravel 项目。要添加其他站点，请将站点添加到您的 Homestead.yaml 文件中。

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
    - map: another.test
      to: /home/vagrant/project2/public
exclamation

在添加站点之前，您应该确保已为项目的目录配置了 文件夹映射。

如果 Vagrant 没有自动管理您的“hosts”文件，您可能需要将新站点也添加到该文件中。在 macOS 和 Linux 上，此文件位于 /etc/hosts。在 Windows 上，它位于 C:\Windows\System32\drivers\etc\hosts

192.168.56.56  homestead.test
192.168.56.56  another.test

添加站点后，从 Homestead 目录执行 vagrant reload --provision 终端命令。

站点类型

Homestead 支持多种“类型”的站点，使您能够轻松运行不基于 Laravel 的项目。例如，我们可以使用 statamic 站点类型轻松地将 Statamic 应用程序添加到 Homestead

sites:
    - map: statamic.test
      to: /home/vagrant/my-symfony-project/web
      type: "statamic"

可用的站点类型包括：apache、apache-proxy、apigility、expressive、laravel（默认）、proxy（用于 nginx）、silverstripe、statamic、symfony2、symfony4 和 zf。

站点参数

您可以通过 params 站点指令将其他 Nginx fastcgi_param 值添加到您的站点

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      params:
          - key: FOO
            value: BAR

环境变量

您可以通过将它们添加到 Homestead.yaml 文件中来定义全局环境变量

variables:
    - key: APP_ENV
      value: local
    - key: FOO
      value: bar

更新 Homestead.yaml 文件后，请务必通过执行 vagrant reload --provision 命令重新预配虚拟机。这将更新所有已安装 PHP 版本的 PHP-FPM 配置，并更新 vagrant 用户的环境。

端口

默认情况下，以下端口将转发到您的 Homestead 环境

  • HTTP: 8000 → 转发到 80
  • HTTPS: 44300 → 转发到 443

转发其他端口

如果需要，您可以通过在 Homestead.yaml 文件中定义 ports 配置条目将其他端口转发到 Vagrant 虚拟机。更新 Homestead.yaml 文件后，请务必通过执行 vagrant reload --provision 命令重新预配虚拟机

ports:
    - send: 50000
      to: 5000
    - send: 7777
      to: 777
      protocol: udp

以下是您可能希望从主机映射到 Vagrant 虚拟机的其他 Homestead 服务端口列表

  • SSH: 2222 → 到 22
  • ngrok UI: 4040 → 到 4040
  • MySQL: 33060 → 到 3306
  • PostgreSQL: 54320 → 到 5432
  • MongoDB: 27017 → 到 27017
  • Mailpit: 8025 → 到 8025
  • Minio: 9600 → 到 9600

PHP 版本

Homestead 支持在同一虚拟机上运行多个版本的 PHP。您可以在 Homestead.yaml 文件中为给定站点指定要使用的 PHP 版本。可用的 PHP 版本包括：“5.6”、“7.0”、“7.1”、“7.2”、“7.3”、“7.4”、“8.0”、“8.1”、“8.2”和“8.3”（默认）。

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      php: "7.1"

在您的 Homestead 虚拟机中，您可以通过 CLI 使用任何受支持的 PHP 版本

php5.6 artisan list
php7.0 artisan list
php7.1 artisan list
php7.2 artisan list
php7.3 artisan list
php7.4 artisan list
php8.0 artisan list
php8.1 artisan list
php8.2 artisan list
php8.3 artisan list

您可以通过在 Homestead 虚拟机中发出以下命令来更改 CLI 使用的 PHP 默认版本

php56
php70
php71
php72
php73
php74
php80
php81
php82
php83

连接到数据库

开箱即用，homestead 数据库已配置用于 MySQL 和 PostgreSQL。要从主机数据库客户端连接到 MySQL 或 PostgreSQL 数据库，您应该连接到端口 33060（MySQL）或 54320（PostgreSQL）上的 127.0.0.1。两个数据库的用户名和密码都是 homestead / secret。

exclamation

仅在从主机连接到数据库时才应使用这些非标准端口。您将在 Laravel 应用程序的 database 配置文件中使用默认的 3306 和 5432 端口，因为 Laravel 运行在虚拟机内部。

数据库备份

Homestead 可以在 Homestead 虚拟机被销毁时自动备份您的数据库。要使用此功能，您必须使用 Vagrant 2.1.0 或更高版本。或者，如果您使用的是较旧版本的 Vagrant，则必须安装 vagrant-triggers 插件。要启用自动数据库备份，请将以下行添加到您的 Homestead.yaml 文件中

backup: true

配置完成后，当执行 vagrant destroy 命令时，Homestead 将将您的数据库导出到 .backup/mysql_backup 和 .backup/postgres_backup 目录。这些目录可以在您安装 Homestead 的文件夹中找到，或者如果您使用的是 每个项目安装 方法，则可以在项目的根目录中找到。

配置 Cron 计划任务

Laravel 提供了一种便捷的方式来 计划 cron 作业，方法是安排每分钟运行一次的 schedule:run Artisan 命令。schedule:run 命令将检查 routes/console.php 文件中定义的作业计划，以确定要运行哪些计划任务。

如果您希望 schedule:run 命令为 Homestead 站点运行，则可以在定义站点时将 schedule 选项设置为 true

sites:
    - map: homestead.test
      to: /home/vagrant/project1/public
      schedule: true

站点的 cron 作业将在 Homestead 虚拟机的 /etc/cron.d 目录中定义。

配置 Mailpit

Mailpit 允许您拦截传出的电子邮件并检查它，而无需实际将其发送给收件人。要开始使用，请更新应用程序的 .env 文件以使用以下邮件设置

MAIL_MAILER=smtp
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

配置 Mailpit 后，您可以访问 https://127.0.0.1:8025 上的 Mailpit 仪表板。

配置 Minio

Minio 是一款开源对象存储服务器，具有与 Amazon S3 兼容的 API。要安装 Minio，请使用以下配置选项在 功能 部分更新您的 Homestead.yaml 文件

minio: true

默认情况下，Minio 在端口 9600 上可用。您可以通过访问 https://127.0.0.1:9600 来访问 Minio 控制面板。默认访问密钥为 homestead，默认密钥为 secretkey。访问 Minio 时，应始终使用区域 us-east-1。

要使用 Minio，请确保您的 .env 文件具有以下选项

AWS_USE_PATH_STYLE_ENDPOINT=true
AWS_ENDPOINT=https://127.0.0.1:9600
AWS_ACCESS_KEY_ID=homestead
AWS_SECRET_ACCESS_KEY=secretkey
AWS_DEFAULT_REGION=us-east-1

要预配 Minio 支持的“S3”存储桶，请将 buckets 指令添加到您的 Homestead.yaml 文件中。定义存储桶后，您应该在终端中执行 vagrant reload --provision 命令

buckets:
    - name: your-bucket
      policy: public
    - name: your-private-bucket
      policy: none

支持的 policy 值包括：none、download、upload 和 public。

Laravel Dusk

为了在 Homestead 中运行 Laravel Dusk 测试，您应该在 Homestead 配置中启用 webdriver 功能

features:
    - webdriver: true

启用 webdriver 功能后，您应该在终端中执行 vagrant reload --provision 命令。

共享您的环境

有时您可能希望与同事或客户共享您当前正在处理的内容。Vagrant 通过 `vagrant share` 命令内置支持此功能；但是，如果您在 `Homestead.yaml` 文件中配置了多个站点，则此功能将不起作用。

为了解决此问题，Homestead 包含了自己的 `share` 命令。要开始使用，请通过 `vagrant ssh` SSH 连接到您的 Homestead 虚拟机 并执行 `share homestead.test` 命令。此命令将共享 `Homestead.yaml` 配置文件中的 `homestead.test` 站点。您可以将任何其他配置的站点替换为 `homestead.test`

share homestead.test

运行命令后，您将看到一个 Ngrok 屏幕出现，其中包含活动日志和共享站点的公共可访问 URL。如果您想指定自定义区域、子域或其他 Ngrok 运行时选项，您可以将它们添加到 `share` 命令中

share homestead.test -region=eu -subdomain=laravel

如果您需要通过 HTTPS 而不是 HTTP 共享内容，则使用 `sshare` 命令而不是 `share` 命令可以实现此目的。

exclamation

请记住，Vagrant 本身不安全，在运行 `share` 命令时，您会将虚拟机暴露到 Internet。

调试和性能分析

使用 Xdebug 调试 Web 请求

Homestead 支持使用 Xdebug 进行逐步调试。例如，您可以访问浏览器中的一个页面，PHP 将连接到您的 IDE 以允许检查和修改正在运行的代码。

默认情况下，Xdebug 已经运行并准备接受连接。如果您需要在 CLI 上启用 Xdebug，请在 Homestead 虚拟机中执行 `sudo phpenmod xdebug` 命令。接下来，按照 IDE 的说明启用调试。最后，配置您的浏览器以使用扩展程序或 书签 触发 Xdebug。

exclamation

Xdebug 会导致 PHP 运行速度显着降低。要禁用 Xdebug，请在 Homestead 虚拟机中运行 `sudo phpdismod xdebug` 并重新启动 FPM 服务。

自动启动 Xdebug

在调试对 Web 服务器发出请求的功能测试时，自动启动调试比修改测试以传递自定义标头或 Cookie 来触发调试更容易。要强制 Xdebug 自动启动，请修改 Homestead 虚拟机内的 `/etc/php/7.x/fpm/conf.d/20-xdebug.ini` 文件并添加以下配置

; If Homestead.yaml contains a different subnet for the IP address, this address may be different...
xdebug.client_host = 192.168.10.1
xdebug.mode = debug
xdebug.start_with_request = yes

调试 CLI 应用程序

要调试 PHP CLI 应用程序，请在 Homestead 虚拟机中使用 `xphp` shell 别名

xphp /path/to/script

使用 Blackfire 分析应用程序性能

Blackfire 是一种用于分析 Web 请求和 CLI 应用程序的服务。它提供了一个交互式用户界面，该界面以调用图和时间线形式显示配置文件数据。它构建用于开发、登台和生产环境，对最终用户没有开销。此外，Blackfire 对代码和 `php.ini` 配置设置提供性能、质量和安全检查。

Blackfire Player 是一款开源的 Web 爬虫、Web 测试和 Web 抓取应用程序，可以与 Blackfire 协同工作以编写分析场景。

要启用 Blackfire，请在 Homestead 配置文件中使用“features”设置

features:
    - blackfire:
        server_id: "server_id"
        server_token: "server_value"
        client_id: "client_id"
        client_token: "client_value"

Blackfire 服务器凭据和客户端凭据 需要 Blackfire 帐户。Blackfire 提供了各种分析应用程序的选项，包括 CLI 工具和浏览器扩展。请 查看 Blackfire 文档以了解更多详细信息。

网络接口

`Homestead.yaml` 文件的 `networks` 属性配置 Homestead 虚拟机的网络接口。您可以根据需要配置任意数量的接口

networks:
    - type: "private_network"
      ip: "192.168.10.20"

要启用 桥接 接口，请为网络配置 `bridge` 设置并将网络类型更改为 `public_network`

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"

要启用 DHCP，只需从配置中删除 `ip` 选项即可

networks:
    - type: "public_network"
      bridge: "en1: Wi-Fi (AirPort)"

要更新网络正在使用的设备，您可以向网络的配置中添加 `dev` 选项。默认的 `dev` 值为 `eth0`

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"
      dev: "enp2s0"

扩展 Homestead

您可以使用 Homestead 目录根目录中的 `after.sh` 脚本扩展 Homestead。在此文件中，您可以添加任何必要的 shell 命令来正确配置和自定义您的虚拟机。

在自定义 Homestead 时，Ubuntu 可能会询问您是否要保留软件包的原始配置或将其覆盖为新的配置文件。为避免这种情况，您应该在安装软件包时使用以下命令，以避免覆盖 Homestead 之前编写的任何配置

sudo apt-get -y \
    -o Dpkg::Options::="--force-confdef" \
    -o Dpkg::Options::="--force-confold" \
    install package-name

用户自定义

当与您的团队一起使用 Homestead 时，您可能希望调整 Homestead 以更好地适应您的个人开发风格。为此，您可以在 Homestead 目录的根目录（包含 `Homestead.yaml` 文件的同一目录）中创建一个 `user-customizations.sh` 文件。在此文件中，您可以进行任何您想要的自定义；但是，`user-customizations.sh` 不应进行版本控制。

提供商特定设置

VirtualBox

natdnshostresolver

默认情况下，Homestead 将 `natdnshostresolver` 设置配置为 `on`。这允许 Homestead 使用您的主机操作系统的 DNS 设置。如果您想覆盖此行为，请将以下配置选项添加到 `Homestead.yaml` 文件中

provider: virtualbox
natdnshostresolver: 'off'