Mythic项目中的Agent安装问题分析与解决方案

问题背景

在使用Mythic框架进行红队工具开发时，开发者经常会遇到需要自定义或修改现有Agent的情况。本文针对一个典型场景进行分析：开发者克隆了Apollo Agent项目，进行修改后尝试重新安装到Mythic框架时遇到的错误。

问题现象

开发者按照以下步骤操作：

1. 克隆Apollo Agent仓库
2. 进行自定义修改（如实现真正的sRDI功能替代Donut）
3. 创建自己的仓库并将修改后的代码推送到新仓库
4. 尝试通过Mythic CLI安装修改后的Agent

安装过程中出现错误提示，表明系统仍在尝试从原始仓库地址获取镜像，而非使用本地修改后的版本。

根本原因分析

经过排查，发现问题的根源在于Mythic框架的.env配置文件中残留了原始Agent的配置信息。即使开发者在Agent的config.json中移除了相关配置，.env文件中仍保留着以下关键配置项：

ARTEMIS_INSTALL_LOCATION="https://github.com/mythicagents/apollo;master"
ARTEMIS_REMOTE_IMAGE="ghcr.io/mythicagents/apollo:v0.0.0.14"
ARTEMIS_USE_BUILD_CONTEXT="true"

这些配置导致Mythic CLI在安装过程中仍然尝试从原始仓库获取资源，而非使用本地修改后的版本。

解决方案

要解决这个问题，开发者需要执行以下步骤：

1. 打开Mythic项目根目录下的.env文件
2. 查找与新Agent名称相关的配置项（如示例中的ARTEMIS_*）
3. 删除这些残留的配置项
4. 重新尝试通过Mythic CLI安装修改后的Agent

最佳实践建议

为了避免类似问题，建议开发者在fork和修改Agent时遵循以下流程：

1. 首先在自己的账户下创建新仓库
2. 克隆原始Agent仓库时直接使用git clone --origin myorigin指定自定义远程名称
3. 修改Agent名称和相关配置时，确保同时更新：
   • config.json文件
   • 所有Docker相关配置
   • 任何可能包含原始仓库引用的文件
4. 在安装前检查.env文件，确保没有残留的旧配置

技术要点总结

1. Mythic框架会通过.env文件持久化Agent的安装配置
2. 修改Agent时需要注意配置文件的全面性，不能只修改config.json
3. 安装失败时应检查环境变量和配置文件中的残留项
4. 合理的版本控制和仓库管理流程可以避免这类问题

通过理解Mythic框架的配置机制和遵循规范的开发流程，开发者可以更高效地进行Agent定制和开发工作。