作者：vivo 互联网服务器团队- Liu Yanjiang

月光宝盒是一个基于流量录制回放的自动化测试平台，通过录制回放取代编写脚本进行自动化回归，提升测试效率和覆盖率。因为其解决方案具有很强的通用性，所以我们把这它开源出来，希望能帮助到有需要的用户。

一、月光宝盒 是什么？

Moonbox（月光宝盒）是 JVM-Sandbox 生态下的一款流量录制回放产品。所谓流量录制回放是服务端通过挂载 agent 探针自动注册到服务端，拦截服务端调用，将所有外部调用依赖的内容（如数据库、分布式缓存、外部服务响应等）进行完整记录形成录制流量。其核心价值是通过录制流量数据，将流量数据转化成可复用、可执行的自动化用例，快速在测试环境中进行回放比对接口返回值和外部调用依参数（见下图）。Moonbox（月光宝盒）提供了大量的常用插件，能够对常见的中间调用进行录制回放，同时也提供了非常可靠、高性能的数据存储、计算能力。

二、月光宝盒 有哪些优势？

正如开头所说月光宝盒是一款面向测试、研发工程师使用的低门槛、高性能、更易于使用的自动化测试工具。这款产品已经在 vivo 运行了 2 年多了，经过我们持续优化、打磨拥有很多实用、易用功能。它的优点主要体现在下面几方面：

2.1 全面可视化视操作（部分功能）

(1）基于任务、接口维度的流量管理能力

(2）详细的流量展示细节（请求、响应、子调用）

(3）基于任务、接口维度的回放数据管理，叠加各种维度统计、查询能力

(4）易于人工分析的回放比对结果和差异展示

2.2 丰富的插件支持

月光宝盒支持非常多组件录制和回放能力，基本上能满足绝大多数人诉求。

2.3 多种部署方式

• Docker：这种方式简单、可靠，让您可以摒弃复杂的环境配置和安装，快速在本地体验我们项目。

• 常规方式：这种方式复杂、步骤繁琐，需要按照步骤创建 ES 和 MySQL 数据库，初始化数据表，更新好应用配置，安装好前端 node 服务。

此外月光宝盒是前后端分离项目，当您使用该项目需要分别部署前端、后端，非常有助于您后续将项目部署到生产环境。

2.4 性能安全可靠

平台对性能进行了长期优化，在 vivo 内部历经多个高并发系统验证。我们对 agent 端录制流量进行了一系列安全防护，例如对相同接口同时只能有一个进入采样中，限制并行录制接口数量。服务端使用了 ES 储存流量，有效提升了数据储存规模。

三、月光宝盒 实现原理

3.1 整体架构

月光宝盒平台分为 2 个部分，分别为 moonbox-agent 和 moonbox-server（整体架构如下图所示）

moonbox-agent

使用 Java-attach 技术(实际的动态字节码增强由 JVM-Sandbox 实现)动态代理到目标进程上，提供流量录制和回放的增强。

moonbox-server

• Agent 端使用接口，提供配置查询、录制流量保存、流量查询、回放结果保存等服务

• 录制任务/回放任务的配置，agent 任务远程管理能力和管理后台操作界面(前后端分离部署)

3.2 流量录制 &回放

流量录制

核心逻辑是将 agent 分发到用户填写的机器上(本地、远程机器），然后将 agent attach 到用户填写应用所对应的正确进程上去。然后通过 JVM-Sandbox 的 BEFORE、RETRUN、THROW 事件机制拦截关键调用位置获取流量入参、出参。整体流程见下图整体流程见下图：

流量回放

核心逻辑是将 agent 分发到用户填写的机器上(本地、远程机器），然后将 agent attach 到用户填写应用所对应的正确进程上去，agent 启动后从服务端不断拉取流量去分发到对应接口做回放，整体流程见下图：

心跳管理

Agent 启动后会单独开启线程固定间隔时间通过 http 请求给服务端上报心跳

3.3 Agent 启动过程

执行脚本将 sandbox agent attach 到目标 java 进程上，sandbox 启动 jetty 服务，加载 moonbox module，然后从服务端拉取 moonbox 配置，加载流量录制和回放插件。

四、 和 jvm-sandbox-repeater 关系？

Moonbox 是基于 jvm-sandbox-repeater 重新开发的一款流量回放平台产品。在 jvm-sandbox-repeater 基础上重写了很多模块，并提供了更加丰富功能，同时便于线上部署和使用，和 jvm-sandbox-repeater 差异如下：

五、为什么要开源？

流量录制回放技术复杂，挑战较高，开源社区虽然有很多类似产品但是在易用性方面都有一些欠缺，我们希望通过开源月光宝盒帮助对该方向有兴趣的开发者快速构建自己的自动化工具，同时可以基于我们这款产品制定个性化诉求。此外，月光宝盒本身也借鉴了 jvm-sandbox-repeater 设计和方案，是开源的受益方，现在我们将自己思考和探索回馈给开源社区，丰富流量回放开源技术生态。除此之外通过社区中开发者的使用，也可以帮助我们更好的改进我们的工具，获得更多的需求场景输入，也能让该工具获得更加长远的发展。

六、Roadmap

月光宝盒已经完成 V1.0.0 版本开源，初步完成了各项重要功能开源，后续我们会持续性的完成平台性能、体验优化工作，同时积极收集社区使用反馈的功能需求，将一些好的需求纳入我们版本计划里面。2023 年我们规划了一些迭代版本，如下图所示：

七、写在最后

今天月光宝盒的开源只是我们迈出的一小步，后续我们会持续按照计划向社区贡献版本和特性。如果您对月光宝盒有兴趣，欢迎体验我们开源产品。如果您有问题或者更好的方案，欢迎向我们开源项目贡献反馈 ISSUE 和贡献 PR，这将是我们莫大的荣幸。

GItHub 项目地址：https://github.com/vivo/MoonBox