从零构建5G SA实验环境OAI核心网与UERANSIM实战指南引言为什么选择OAIUERANSIM组合5G独立组网SA的实验室搭建一直是通信学习者的痛点——传统方案要么依赖昂贵商用设备要么配置复杂度令人望而生畏。而OpenAirInterfaceOAI作为最成熟的开源5G实现配合轻量级模拟器UERANSIM终于让个人电脑搭建端到端5G网络成为可能。这套组合的优势在于硬件门槛低无需专用射频设备普通x86服务器即可运行协议栈完整支持5G SA全协议流程包括AMF/SMF/UPF等核心网元件调试友好UERANSIM提供清晰的日志输出和配置界面社区活跃GitLab上每月都有功能更新和问题修复本文将带您完成从系统准备到业务测试的全流程特别针对网络配置、容器互通等易错点提供解决方案。实验环境基于Ubuntu 18.04 LTS所需硬件仅为支持AVX2指令集的CPUIntel四代酷睿或AMD Ryzen以上16GB以上内存双网卡建议使用USB 3.0千兆网卡作为第二接口1. 基础环境准备1.1 系统优化配置低延时内核是保证实时性的关键执行以下命令安装并启用sudo apt-get install linux-image-uname -r | cut -d- -f1-2-lowlatency \ linux-headers-uname -r | cut -d- -f1-2-lowlatency sudo rebootCPU性能调优需禁用节能模式编辑/etc/default/grubGRUB_CMDLINE_LINUX_DEFAULTquiet intel_pstatedisable processor.max_cstate1 intel_idle.max_cstate0更新配置后重启sudo update-grub sudo reboot验证设置是否生效cat /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor # 应全部显示performance1.2 依赖组件安装基础开发工具链sudo apt-get install git cmake ninja-build \ python3-pip libssl-dev libsctp-dev lksctp-tools网络工具集sudo apt-get install net-tools tshark iproute2 \ iptables iptables-persistent提示建议使用Python虚拟环境管理Python依赖避免与系统包冲突2. OAI核心网部署2.1 Docker环境配置OAI官方推荐使用Docker容器部署核心网组件首先安装Docker CEcurl -fsSL https://get.docker.com | sudo sh sudo usermod -aG docker $USER newgrp docker验证安装docker run hello-world配置Docker网络参数sudo tee /etc/docker/daemon.json EOF { default-address-pools: [ {base:192.168.250.0/24,size:28} ] } EOF sudo systemctl restart docker2.2 核心网容器部署克隆OAI CN5G仓库git clone https://gitlab.eurecom.fr/oai/cn5g/oai-cn5g-fed.git cd oai-cn5g-fed启动最小化核心网docker-compose -f docker-compose-mini-nrf.yaml up -d验证容器状态docker ps --format table {{.Names}}\t{{.Status}}正常应显示5个运行中的容器mysql、oai-nrf、oai-amf、oai-smf、oai-spgwu核心网组件端口对照表组件端口协议用途AMF38412SCTPgNB接入NRF8080HTTP服务发现SMF80HTTP会话管理UPF2152GTP-U用户面数据3. UERANSIM配置与对接3.1 编译安装UERANSIM获取最新源码git clone https://github.com/aligungr/UERANSIM cd UERANSIM编译安装make生成测试用SIM卡数据./build/nr-cli --gen-ue-data -o config/ue3.2 gNB配置编辑config/gnb.yaml关键参数amfConfigs: address: 192.168.70.132 # AMF容器IP port: 38412 gtpConfigs: interface: enp3s0 # 物理网卡名称 plmnList: - mcc: 208 # 需与核心网一致 mnc: 99启动gNB./build/nr-gnb -c config/gnb.yaml3.3 UE配置修改config/ue.yamlsupi: imsi-2089900000001 plmn: 20899 key: 465B5CE8B199B49FAA5F0A2EE238A6BC op: E8ED289DEBA952E4283B54E88E6183CA gnbSearchList: - 192.168.70.131 # gNB服务地址启动UE模拟器./build/nr-ue -c config/ue.yaml4. 网络互通配置4.1 路由设置在主机添加静态路由sudo ip route add 192.168.250.0/24 via 172.18.0.1 dev docker0启用IP转发sudo sysctl -w net.ipv4.ip_forward1 sudo iptables -t nat -A POSTROUTING -o enp3s0 -j MASQUERADE4.2 连通性测试从UE ping核心网UPFping -I uesimtun0 8.8.8.8抓包验证N1接口sudo tshark -i any -f port 38412 -Y sctp常见问题排查表现象可能原因解决方案AMF无法连接防火墙阻断sudo ufw allow 38412/sctpUE注册失败PLMN不匹配检查核心网与gNB的MCC/MNC无PDU会话SMF配置错误验证UPF的N4接口地址5. 进阶调试与优化5.1 性能调优调整gNB线程亲和性taskset -c 2,3 ./build/nr-gnb -c config/gnb.yaml监控CPU利用率watch -n 1 ps -eo pid,comm,%cpu | grep nr-5.2 业务测试发起HTTP请求curl --interface uesimtun0 http://example.comiperf3带宽测试# 服务端 iperf3 -s -B 192.168.250.2 # 客户端 iperf3 -c 192.168.250.2 -B uesimtun0 -t 30在实际测试中Ryzen 5 3600处理器配合双通道内存可达到控制面时延12-18ms用户面吞吐85-120Mbps最大并发会话32个UE