marshallasch/rhpman

rhpman-sim镜像说明

镜像概述

本镜像基于NS-3模拟器（版本3.32）实现了RHPMAN（移动自组织网络高分区复制方案），旨在复现Shi和Chen 2014年论文中的性能评估。镜像预构建了完整的运行环境，无需手动安装依赖或编译，支持两种使用模式：直接执行模拟命令或进入交互式终端操作。

核心功能

1. 实现RHPMAN数据复制算法，适配移动自组织网络的分布式数据管理场景
2. 支持自定义模拟参数（如节点数量、移动模型、复制策略等）
3. 生成NetAnim动画XML文件，可视化模拟过程中的网络动态
4. 提供debug、release、optimized三种构建版本，满足不同性能需求

使用场景

1. 学术研究：验证移动自组织网络中数据复制方案的性能指标
2. 教学演示：展示NS-3模拟器的使用及MANETs相关算法原理
3. 快速原型：无需本地配置环境即可测试RHPMAN方案的参数调整效果

配置说明

直接运行模拟命令

传递参数给镜像执行模拟，例如查看所有可配置参数：

bash
docker run --rm marshallasch/rhpman:optimized --printHelp

生成NetAnim动画文件

将动画文件输出到本地目录（需挂载卷）：

bash
docker run --rm -v $(pwd)/output:/output marshallasch/rhpman:optimized --animation-xml=/output/rhpman.xml

交互式终端模式

进入镜像的ns-3根目录，手动执行waf命令：

bash
docker run --rm -it marshallasch/rhpman:optimized bash

自定义构建镜像

若需自定义构建版本，可使用以下命令：

bash
docker build \
  --build-arg VCS_REF=$(git rev-parse -q --verify HEAD) \
  --build-arg BUILD_DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ") \
  --build-arg BUILD_PROFILE=optimized \
  -t marshallasch/rhpman:optimized .

BUILD_PROFILE可选值：debug（默认）、release、optimized

重要说明

本镜像仅支持IPv4网络，节点ID基于IPv4地址生成，若需适配IPv6需修改源码中的ID生成逻辑。 镜像代码采用ISC许可证，NS-3模拟器本身采用GPLv2许可证。