drumsergio/genieacs-sim

genieacs-sim-docker

镜像概述

genieacs-sim-docker是GenieACS Simulator的Docker化实现，将TR-069设备模拟器封装为容器镜像，提供快速部署、隔离运行的测试环境。该镜像旨在简化GenieACS（TR-069自动配置服务器）的功能测试流程，无需依赖物理宽带设备，即可模拟各类TR-069兼容设备与ACS服务器的交互行为。

核心功能与特性

容器化部署

• 基于Docker容器封装，支持跨平台运行，简化环境配置，减少依赖冲突
• 轻量级设计，快速启动，资源占用低

TR-069设备模拟

• 支持模拟多种TR-069协议兼容设备（如调制解调器、路由器、IP电话等）
• 可模拟设备注册、参数获取/设置、固件升级、事件通知等标准TR-069交互流程

灵活集成

• 支持与GenieACS服务器（或其他TR-069 ACS）对接，模拟真实设备与服务器的通信
• 可配置设备参数、事件触发规则，满足多样化测试需求

使用场景

开发与测试

• TR-069设备管理功能开发阶段的本地测试环境
• GenieACS服务器功能验证，无需实际物理设备
• 自动化测试流程中的设备模拟节点

培训与演示

• 搭建TR-069协议及GenieACS系统的教学环境
• 演示设备与ACS服务器的交互过程

功能验证

• 验证ACS服务器对设备参数配置、固件升级、故障上报等功能的支持
• 模拟异常场景（如网络中断、设备离线）的恢复机制测试

使用方法与配置说明

基本部署

通过以下命令快速启动GenieACS模拟器容器：

bash
docker run -d -p 7547:7547 --name genieacs-sim genieacs-sim

• -p 7547:7547：映射容器内TR-069默认端口（7547）到主机，用于与ACS服务器通信
• --name genieacs-sim：指定容器名称，便于管理

配置参数

环境变量

可通过环境变量调整模拟器行为（具体支持的变量需参考镜像实际文档，以下为常见配置示例）：

• GENIEACS_SERVER_URL：指定目标GenieACS服务器地址（如 http://genieacs-server:7557），用于模拟器设备注册
• DEVICE_COUNT：设置模拟设备数量（默认1）
• DEVICE_PREFIX：模拟设备名称前缀（默认sim-device-）

示例（指定ACS服务器地址）：

bash
docker run -d -p 7547:7547 \
  -e GENIEACS_SERVER_URL=http://192.168.1.100:7557 \
  -e DEVICE_COUNT=5 \
  --name genieacs-sim genieacs-sim

自定义设备配置

如需自定义模拟设备的参数（如厂商、型号、支持的TR-069数据模型），可通过挂载配置文件实现：

bash
docker run -d -p 7547:7547 \
  -v /path/to/custom-devices:/app/devices \
  --name genieacs-sim genieacs-sim

• /path/to/custom-devices：主机上存放自定义设备配置文件的目录，容器将加载该目录下的设备定义

验证运行

容器启动后，可通过查看日志确认运行状态：

bash
docker logs genieacs-sim

正常情况下，日志将显示设备模拟进程启动信息及注册状态（如连接到指定的GenieACS服务器）。

注意事项

• 确保目标GenieACS服务器与模拟器容器网络互通，以便设备成功注册
• 不同版本的GenieACS模拟器可能需要匹配对应版本的GenieACS服务器，建议查看镜像标签说明
• 生产环境中不建议使用该模拟器，仅用于测试和开发场景

参考链接

• GenieACS官方文档：[***]
• TR-069协议规范：Broadband Forum TR-069