欢迎使用 FLARE-VM - Windows 系统的软件安装脚本集合，可让您轻松在虚拟机 (VM) 上设置和维护逆向工程环境。 FLARE-VM 旨在解决逆向工程工具管理问题，依赖于两项主要技术：Chocolatey 和 Boxstarter。 Chocolatey 是一个基于 Windows 的 Nuget 包管理系统，其中“包”本质上是一个 ZIP 文件，其中包含用于下载和配置特定工具的 PowerShell 安装脚本。 Boxstarter 利用 Chocolatey 软件包自动安装软件并创建可重复的脚本化 Windows 环境。
FLARE-VM 只能安装在虚拟机上。虚拟机应满足以下要求：
本节介绍安装 FLARE-VM 的步骤。您可能还会发现构建用于逆向工程和恶意软件分析的虚拟机很有用！安装 FLARE-VM视频。
PowerShell提示符installer.ps1下载到您的桌面：(New-Object net.webclient).DownloadFile('https://raw.githubusercontent.com/mandiant/flare-vm/main/install.ps1',"$([Environment]::GetFolderPath("Desktop"))install.ps1")Unblock-File .install.ps1Set-ExecutionPolicy Unrestricted -ForceSet-ExecutionPolicy Unrestricted -Scope CurrentUser -Force传递范围。要查看所有范围的执行策略，请执行Get-ExecutionPolicy -List.install.ps1.install.ps1 -password <password>.install.ps1 -password <password> -noWait -noGui.install.ps1 -customConfig <config.xml> -password <password> -noWait -noGuihost-only网络模式并拍摄虚拟机快照以下是 CLI 参数说明。
PARAMETERS
-password <String>
Current user password to allow reboot resiliency via Boxstarter. The script prompts for the password if not provided.
-noPassword [<SwitchParameter>]
Switch parameter indicating a password is not needed for reboots.
-customConfig <String>
Path to a configuration XML file. May be a file path or URL.
-customLayout <String>
Path to a taskbar layout XML file. May be a file path or URL.
-noWait [<SwitchParameter>]
Switch parameter to skip installation message before installation begins.
-noGui [<SwitchParameter>]
Switch parameter to skip customization GUI.
-noReboots [<SwitchParameter>]
Switch parameter to prevent reboots (not recommended).
-noChecks [<SwitchParameter>]
Switch parameter to skip validation checks (not recommended).
通过运行Get-Help .install.ps1 -Detailed获取完整的使用信息。
执行验证检查并安装 Boxstarter 和 Chocolatey（如果尚未安装）后，将显示安装程序 GUI。使用安装程序 GUI，您可以自定义：
安装程序将从 FLARE-VM 存储库下载 config.xml。该文件包含默认配置，包括要安装的软件包列表和环境变量路径。您可以通过指定 CLI 参数-customConfig并提供config.xml文件的本地文件路径或 URL 来使用自己的配置。例如：
.install.ps1 -customConfig "https://raw.githubusercontent.com/mandiant/flare-vm/main/config.xml"
安装程序将使用 FLARE-VM 存储库中的 CustomStartLayout.xml。该文件包含默认的任务栏布局。您可以通过指定 CLI 参数-customLayout并提供CustomStartLayout.xml文件的本地文件路径或 URL 来使用自己的配置。例如：
.install.ps1 -customLayout "https://raw.githubusercontent.com/mandiant/flare-vm/main/CustomStartLayout.xml"
cmd.exe或powershell的快捷方式，并提供参数来执行您想要的操作。-runAsAdmin标志的VM-Install-Shortcut创建快捷方式并固定快捷方式。 您可以在标签apps 、 services 、 path-items 、 registry-items和custom-items内的配置中包含任何您喜欢的安装后步骤。
例如：
< registry-items >
< registry-item name = " Show known file extensions " path = " HKCU:SoftwareMicrosoftWindowsCurrentVersionExplorerAdvanced " value = " HideFileExt " type = " DWord " data = " 0 " />
</ registry-items >有关更多示例，请检查默认配置文件：config.xml。
想开始贡献吗？请参阅下面的链接以了解具体操作方法。我们期待与您一起改进 FLARE-VM！ ？
如果您的安装失败，请尝试通过阅读系统上下面列出的日志文件来确定安装错误的原因：
%VM_COMMON_DIR%log.txt%PROGRAMDATA%chocolateylogschocolatey.log%LOCALAPPDATA%Boxstarterboxstarter.log确保您正在运行最新版本的 FLARE-VM 安装程序并且您的 VM 满足要求。
如果由于安装脚本（例如install.ps1 ）中的问题导致安装失败，请报告 FLARE-VM 中的错误。提供所需的所有信息，以确保我们能够为您提供帮助。
注意：
install.ps1很少会成为安装失败的原因。最有可能的是一个特定的包或一组包失败了（见下文）。
软件包有时无法安装——这是正常的。最常见的原因概述如下：
.nupkg文件失败或超时HTTP STATUS 404 ）原因1-4对我们来说很难解决，因为我们无法控制它们。如果提出与原因1-4相关的问题，我们不太可能提供帮助。
我们可以为原因5-7提供帮助，并欢迎社区贡献修复！请报告 VM-Packages 中的错误，并提供所需的所有信息。
请注意，软件包更新已尽最大努力，并且更新尚未经过测试。如果遇到错误，请执行全新的 FLARE-VM 安装。
提供此下载配置脚本是为了帮助网络安全分析师为恶意软件分析环境创建方便且多功能的工具箱。它为他们提供了一个方便的界面，可以直接从原始来源获取一组有用的分析工具。该脚本的安装和使用须遵守 Apache 2.0 许可证。作为此脚本的用户，您必须查看、接受并遵守每个下载/安装的软件包的许可条款。继续安装即表示您接受每个软件包的许可条款，并确认您对每个软件包的使用将受到其各自许可条款的约束。
