Landrush完全指南：让Vagrant虚拟机域名解析变得如此简单

【免费下载链接】landrushA Vagrant plugin that provides a simple DNS server for Vagrant guests项目地址: https://gitcode.com/gh_mirrors/la/landrush

Landrush是一款为Vagrant虚拟机提供简单DNS服务的插件，它能在主机和客户机上都实现域名解析功能。通过自动注册和注销虚拟机的IP地址，Landrush让Vagrant环境中的网络配置变得前所未有的轻松。本文将详细介绍如何安装、配置和使用Landrush，帮助你快速掌握这一强大工具。

快速安装Landrush插件

安装Landrush非常简单，只需在终端中执行以下命令：

vagrant plugin install landrush

这条命令会将Landrush插件安装到你的Vagrant环境中，适用于Vagrant 1.1及更高版本。安装完成后，你就可以在Vagrantfile中启用并配置Landrush了。

启用Landrush的基本配置

要在你的Vagrant项目中使用Landrush，只需在Vagrantfile中添加几行配置即可：

Vagrant.configure("2") do |config| config.vm.box = "ubuntu/xenial64" # 启用Landrush DNS服务 config.landrush.enabled = true # 设置虚拟机主机名 config.vm.hostname = "myhost.vagrant.test" # 添加静态DNS条目（可选） config.landrush.host 'static1.example.com', '1.2.3.4' config.landrush.host 'static2.example.com', '2.3.4.5' end

配置完成后，启动你的虚拟机：

vagrant up

Landrush会自动启动DNS服务器，并处理虚拟机的域名解析。你可以通过以下命令测试解析是否正常：

dig -p 10053 @localhost myhost.vagrant.test

动态与静态DNS条目管理

动态DNS条目

Landrush会自动检测虚拟机的IP地址并创建DNS记录。默认情况下，它会忽略某些接口，如本地回环、Docker和隧道接口。你可以通过以下配置自定义接口排除规则：

config.landrush.host_interface_excludes = [/lo[0-9]*/, /docker[0-9]+/, /tun[0-9]+/]

如果Landrush未能正确检测IP地址，你可以指定接口类型：

config.landrush.host_interface_class = :ipv4 # 可选值: :ipv4, :ipv6, :any

或者直接指定接口名称：

config.landrush.host_interface = 'eth0'

最极端情况下，你可以直接覆盖IP地址：

config.landrush.host_ip_address = '1.2.3.4'

静态DNS条目

除了自动管理的动态条目，你还可以添加静态DNS条目：

config.landrush.host 'myapp.example.com', '192.168.33.10'

这对于将生产环境服务重定向到本地测试环境非常有用。

通配符子域名

Landrush支持通配符子域名解析。例如，如果myhost.vagrant.test解析到192.168.33.10，那么app.myhost.vagrant.test和api.myhost.vagrant.test也会解析到相同的IP地址。

你还可以自定义顶级域名：

config.landrush.tld = 'vm' # 将默认的vagrant.test改为vm

网络连接配置指南

正确配置网络连接是确保Landrush正常工作的关键。在Windows系统中，你需要确保VirtualBox的主机专用网络适配器正确配置。

VirtualBox网络连接配置

以下是配置Windows主机网络的步骤：

1. 打开"控制面板\网络和Internet\网络连接"
2. 找到VirtualBox Host-Only网络适配器
3. 确保其IP地址配置在私有网络范围内
4. 以管理员身份运行命令行，执行以下命令：

netsh interface ipv4 add dnsserver "VirtualBox Host-Only Network" address=127.0.0.1 index=1

对于其他操作系统，Landrush会尝试自动配置网络：

• macOS：通过/etc/resolver目录自动配置特定域名的DNS解析
• Linux：使用dnsmasq服务实现DNS转发，可能需要手动安装dnsmasq

高级配置选项

上游DNS服务器

默认情况下，Landrush使用Google的DNS服务器(8.8.8.8)处理未匹配的查询。你可以配置自定义上游服务器：

# 基本配置 config.landrush.upstream '10.1.1.10' # 指定端口 config.landrush.upstream '10.1.2.10', 1001 # TCP模式 config.landrush.upstream '10.1.3.10', 1001, :tcp

多顶级域名支持

Landrush支持同时使用多个顶级域名：

config.landrush.tld = ['acme.com', 'example.com'] config.landrush.host 'www.acme.com', '1.2.3.4' config.landrush.host 'api.example.com', '2.3.4.5'

禁用DNS重定向

如果你需要禁用Landrush的DNS重定向功能，可以使用以下配置：

# 禁用客户机DNS重定向 config.landrush.guest_redirect_dns = false # 禁主机DNS重定向 config.landrush.host_redirect_dns = false

Landrush命令行工具使用

Landrush提供了一系列命令行工具，方便你管理DNS服务和条目：

vagrant landrush <command> commands: {start|stop|restart|status} # 控制landrush服务器 list, ls # 列出所有DNS条目 dependentvms, vms # 列出依赖landrush的虚拟机 set { <host> <ip> | <alias> <host> } # 添加DNS映射 rm, del { <host> | <alias> | --all } # 删除DNS映射 help # 显示帮助信息

例如，要查看当前所有DNS条目：

vagrant landrush list

要手动添加一个DNS条目：

vagrant landrush set myapp.example.com 192.168.33.20

常见问题解决

如果你在使用Landrush过程中遇到问题，可以参考doc/Troubleshooting.adoc文档。以下是一些常见问题的解决方法：

• 解析失败：检查虚拟机网络配置，确保私有网络正确设置
• 主机无法解析：确认宿主机器的DNS配置是否正确应用
• 多虚拟机冲突：为每个虚拟机设置唯一的主机名
• 性能问题：尝试增加Landrush服务器的内存分配

总结

Landrush为Vagrant用户提供了简单而强大的DNS解决方案，通过自动化域名解析管理，大大简化了多虚拟机环境的网络配置。无论是开发、测试还是演示环境，Landrush都能帮助你轻松实现虚拟机之间以及主机与虚拟机之间的域名解析。

现在就尝试使用Landrush来提升你的Vagrant体验吧！只需通过以下命令克隆项目并开始探索：

git clone https://gitcode.com/gh_mirrors/la/landrush

如需了解更多详细信息，请查阅官方文档doc/Usage.adoc。

【免费下载链接】landrushA Vagrant plugin that provides a simple DNS server for Vagrant guests项目地址: https://gitcode.com/gh_mirrors/la/landrush