oaisoftwarealliance/trf-gen-cn5g

OAI 5G核心网流量生成工具镜像文档

镜像概述

本镜像为Open Air Interface (OAI) 5G核心网提供专用流量生成功能，是一款轻量级工具镜像，旨在模拟真实5G用户设备（UE）的网络流量，帮助开发者与测试人员验证OAI 5G核心网的性能、稳定性及功能完整性。

核心功能与特性

• 5G流量模拟：支持模拟多种5G用户设备的网络行为，包括数据业务（如HTTP/HTTPS）、视频流、语音通话等典型业务流量。
• 可配置参数：允许自定义用户设备数量（UE count）、流量速率、数据包大小、持续时间等关键参数，灵活适配不同测试场景。
• OAI兼容性：深度适配OAI 5G核心网架构，支持与OAI AMF、SMF、UPF等网元的协议交互，确保流量接入与转发的真实性。
• 轻量化设计：镜像体积小巧，启动快速，可直接部署于测试环境或CI/CD流程中，降低测试链路复杂度。

使用场景与适用范围

• 性能测试：模拟高并发用户流量，测试OAI 5G核心网在不同负载下的吞吐量、时延、丢包率等关键指标。
• 负载测试：验证5G核心网在极限用户数或流量负载下的稳定性，定位系统瓶颈。
• 功能验证：在OAI 5G核心网功能开发过程中，通过模拟特定流量场景（如切换、会话建立/释放）验证网元交互逻辑。
• 自动化测试：集成至5G核心网自动化测试框架，实现持续集成环境中的流量生成与结果分析。

使用方法与配置说明

前置条件

• 已部署OAI 5G核心网环境（含AMF、SMF、UPF等必要网元）。
• Docker环境已安装，且容器网络需与OAI 5G核心网网络互通（建议使用自定义桥接网络或host网络模式）。

基础使用命令

通过docker run命令启动流量生成容器，基本格式如下：

bash
docker run --network=<oai-core-network> [环境变量] oai-traffic-generator:<tag> [命令行参数]

参数说明

示例：模拟10个UE的视频流量

bash
docker run \
  --network=oai-core-net \
  -e AMF_IP=10.0.0.100 \
  -e SMF_IP=10.0.0.101 \
  oai-traffic-generator:latest \
  --ue-count=10 \
  --traffic-type=video \
  --duration=300 \
  --rate=5

与Docker Compose集成

在OAI 5G核心网的docker-compose.yml中添加流量生成服务：

yaml
services:
  traffic-generator:
    image: oai-traffic-generator:latest
    network_mode: "service:amf"  # 共享AMF网络命名空间（根据实际网络配置调整）
    depends_on:
      - amf
      - smf
      - upf
    command: ["--ue-count=5", "--traffic-type=data", "--duration=600"]
    environment:
      - AMF_IP=amf  # 通过容器名解析AMF IP
      - SMF_IP=smf  # 通过容器名解析SMF IP

输出与日志

容器运行过程中，流量生成状态（如UE注册结果、流量统计）将实时输出至标准输出（stdout），可通过docker logs <container-id>查看历史日志。