1. 核心网

1.1 Open5GS 核心网

核心网配置确认

1. 点击页面导航栏的「Open5GS 核心网」→「版本管理」，然后点击进入目录的按钮，进入到核心网的配置目录。

1. 找到 .env 文件查看相关配置，比如 AMF 的 IP 地址、MCC、MNC。

1. 在 AMF 的配置文件中查看 TAC、Slice 的相关配置。

1. 在 SMF 和 UPF 配置中查看 DNN/APN 以及支持的 IP 类型。如果需要修改，两处需要同时修改。

核心网开户

1. 点击页面导航栏的「Open5GS 核心网」→「订阅管理」，进入开户界面。

1. 点击「订阅模版」中的「添加」按钮，添加一个模版，将公共参数提前配置好。

• 配置文件名称：名称随意
• K 值：00112233445566778899AABBCCDDEEFF
• AMF：9001
• OP/OPC：OPC 000102030405060708090A0B0C0D0E0F
• Slice 切片：SST-1，SD 为空。要和核心网的配置文件保持一致。
• DNN/APN：open5g。要和核心网的配置文件保持一致。
• Type：IPv4v6 或者 IPv4 均可。尽量和核心网的配置支持情况保持一致。

1. 点击「订阅用户」的「添加」按钮，添加具体用户。选择刚刚添加的模版，输入一个 15 位长度的 IMSI 号码，然后点击右下角的「创建」。开户后需要重启核心网。

核心网的启动和停止

1. 点击页面导航栏的「Open5GS 核心网」→「指标监控」，进入启动页面。点击「启动」按钮，选择要启动的配置，点击「启动」即可。可以通过「日志」按钮监控相关日志。

1. 点击页面的「停止」按钮即可停止核心网。

1.2 OAI 核心网

核心网的配置确认

1. 点击导航栏的「OAI 核心网」→「版本配置」，在版本信息中点击下图中的图标进入配置目录。

1. 在 open5g_studio.yaml 文件中查看 AMF 的 IP 地址。

1. 在 conf.yaml 文件中确认相关配置。

开户数据库的相关信息：

Slice、MCC、MNC、TAC 的相关配置：

APN/DNN 配置查看。后续修改 APN/DNN 需要修改下面的所有地方：

核心网的开户

1. 点击导航栏的「OAI 核心网」→「订阅管理」，进入开户界面。点击「添加」按钮即可添加。

• UE ID 和 SUPI：IMSI 的 15 位号码。
• encPerManentKey：00112233445566778899AABBCCDDEEFF
• encOpcKey：000102030405060708090A0B0C0D0E0F
• servingPlmnId：00101，一定要和核心网的 MCC、MNC 保持一致。
• protectionParameterId：00112233445566778899AABBCCDDEEFF
• DNN：open5g，一定要和核心网的配置保持一致。
• defaultSessionType：IPv4v6，一定要和核心网保持一致。

核心网的启动和停止

1. 点击导航栏的「OAI 核心网」→「指标监控」，进入 OAI 核心网的启动界面。点击「启动」按钮，在弹窗中选择启动的配置，点击「启动」即可启动 OAI 核心网。可以通过「日志」按钮监控核心网的日志。

1. 点击右上角的「停止」按钮即可停止核心网。

2. 基站

2.1 OAI 基站

基站的配置修改

点击左侧导航栏的「OAI 基站」→「版本管理」，然后点击要修改的配置右侧的编辑按钮，即可对基站的配置文件进行编辑。

1. TAC、MCC、MNC、Slice 的修改。

1. IP 地址配置。其中 AMF 的地址就是从核心网配置查看到的 AMF 地址，gNB 的地址需要和核心网网络互通。

1. 频点和带宽配置。

1. PCIE/USB 配置。

1. 天线。

单天线配置：

双天线配置：

4 天线配置：

基站的启停

1. 点击左侧导航栏的「OAI 基站」→「指标监控」，点击右上角的「启动」按钮。在弹窗中选择要运行的基站版本和配置文件，点击「启动」按钮即可启动。

1. 可以通过日志按钮查看基站的日志。

1. 点击「停止」按钮即可停止基站。

NTN 基站的启停

启动方法和普通基站的启动方法一致，只是启动的配置文件不同。NTN 启动的配置文件是 gnb.sa.band256.u0.106prb.yunsdr.ntn-leo.conf。

1. 当前协议栈只支持 LEO 低轨卫星轨道模拟。
2. 基站和终端的位置坐标暂时无法修改。

2.2 SrsRAN 基站

基站的配置修改

点击左侧导航栏的「SrsRAN」→「版本管理」，然后点击要编辑的配置文件右侧的编辑按钮，即可对配置文件进行编辑。

1. IP 地址、PLMN、TAC、Slice 配置。其中 addr 是核心网的 AMF 地址，bind_addr 是基站地址，保证和核心网的 AMF 地址互通。PLMN 和 TAC 的配置有两处需要修改。

1. 频点和带宽配置。带宽修改要设置带宽对应的 SDR 采样率，100M 带宽是 122.88。

1. PCIE/USB 配置。

1. 天线数量配置。天线数量根据实际需要进行配置。

基站的启停

1. 点击左侧导航栏的「SrsRAN 基站」→「指标监控」，点击右上角的「启动」按钮，选择要启动的配置，点击「启动」按钮即可启动基站。

1. 通过「日志」按钮可以监控基站的运行日志。

1. 点击「停止」按钮即可将基站停止。

3. OAI UE 模拟器

1. OAI 的 UE 模拟器只支持接入 OAI 的基站。
2. OAI 的 UE 模拟器和基站的天线距离越近越好。

3.1 UE 模拟器（后台启动）

UE 模拟器（地面基站）

1. 进入到 OAI 的启动目录。

cd ~/sdr/Open5G/oai/openairinterface5g-2026-w34/cmake_targets/

1. 执行启动命令。其中部分参数需要参考基站启动日志的信息。

sudo ./ran_build/build/nr-uesoftmodem --usrp-args "dev=pciex:0,auxdac1=1650" --ue-rxgain 60 --ue-txgain 0 --ue-nb-ant-rx 1 --ue-nb-ant-tx 1 -C 3649380000 -r 273 --numerology 1 --ssb 1472 --band 78 --ue-fo-compensation --uicc0.imsi 001010000000004 --uicc0.key 00112233445566778899AABBCCDDEEFF --uicc0.opc 000102030405060708090A0B0C0D0E0F --uicc0.pdu_sessions.[0].dnn open5g

1. Ctrl+C 即可停止运行。

UE 模拟器（NTN 基站）

当前 UE 模拟器 NTN 模式只支持命令行启动。

1. 先进入到 UE 配置目录，检查 UE 的相关配置。

cd ~/sdr/Open5G/oai/openairinterface5g-2026-w34/targets/PROJECTS/GENERIC-NR-5GC/CONF/
cat ue-ntn.conf

内容如下：

# SPDX-License-Identifier: LicenseRef-CSSL-1.0
# The subscriber data must match the 5GC database used by the test lab.
uicc0 = {
 imsi = "001010000000001";
 key = "00112233445566778899AABBCCDDEEFF";
 opc = "000102030405060708090A0B0C0D0E0F";
 pdu_sessions = ({ dnn = "open5g"; nssai_sst = 1; });
}
# UE ECEF position used for NTN UE-specific timing advance.
position0 = {
 x = 0.0;
 y = 0.0;
 z = 6377900.0;
}

1. 进入到启动目录，然后启动 UE 模拟器。

cd ~/sdr/Open5G/oai/openairinterface5g-2026-w34/cmake_targets/
sudo ./ran_build/build/nr-uesoftmodem \
  --usrp-args 'dev=pcies:0,auxdac1=1660' \
  -O ../targets/PROJECTS/GENERIC-NR-5GC/CONF/ue-ntn.conf \
  --band 256 -C 2185000000 --CO -190000000 -r 106 \
  --numerology 0 --ssb 146 --time-sync-I 0.1 \
  --ntn-initial-time-drift -46 --initial-fo 50340 \
  --cont-fo-comp 2 --autonomous-ta --ue-txgain 20 --ue-rxgain 0

基站日志如下。根据下面的日志可以配置上述需要查看基站日志的参数值，其中多普勒的值允许有一定误差。

3.2 UE 模拟器（Web）

当前 Web 启动存在一些问题，后续解决之后可远程进行更新（DNN 参数采用的老版本，导致无法建立 PDU）。

UE 模拟器（地面基站）

1. 点击左侧导航栏的「OAI 基站」→「UE 模拟器」，进入 OAI 的 UE 模拟器配置启动界面。

1. 配置 args、PCIe、收发增益、天线数量、小区的频段带宽和频率，以及开户信息等。

1. UE 模拟器的启动和停止。选择要启动的版本，点击「启动」按钮即可启动，按钮则变成「停止」，再次点击这个「停止」按钮即可停止。

UE 模拟器（NTN 基站）

1. 场景选择 NTN，其他配置如下。其中 -O 指定的是 UE 的配置文件，下面的配置文件一定要写相对路径，不要写绝对路径。路径是相对于 OAI 根目录的，例如 ~/sdr/Open5G/oai/openairinterface5g-2026-w34/。

配置文件的内容如下，包括用户信息和位置坐标：

1. NTN UE 模拟器的启动。配置好后，点击右上角的启动按钮即可启动。UE 模拟器启动后「启动」按钮会变成红色的「停止」按钮，点击停止按钮即可停止。

4. 终端

4.1 APN/DNN 配置

1. 点击桌面的「设置」→「移动网络」→「SIM1」。

1. 进入到「APN」中修改或者添加新的 APN。

1. 配置其中的：

• 名称：任意
• APN 为 open5g（和核心网保持一致，开源协议栈是 open5g，商用协议栈和 4G 协议栈是 internet）
• MCC、MNC：PLMN 的值，例如 PLMN 为 00101，那么 MCC=001，MNC=01
• APN 类型：default
• APN 协议：ipv4ipv6，需要和核心网保持一致
• APN 漫游协议：ipv4ipv6，需要和核心网保持一致

4.2 启用 5G

1. 点击桌面的「设置」→「移动网络」→「SIM1」。

1. 将「启用 5G」的开关打开。

4.3 VONR/VOLTE 关闭

1. 点击桌面的「设置」→「移动网络」→「SIM1」。

1. 找到「VoLTE 高清通话」，进行关闭。

1. 在拨号键盘输入 *#*#4636#*#*，然后点击「手机信息」，将「设置首选网络类型」配置成 NR only，然后飞行手机即可。

4.4 SA/NSA 配置

1. 进入到「设置」→「关于手机」→「版本信息」，连续点击「软件版本」直到提示开发者模式打开，使「开发者选项」出现。

1. 进入到「设置」→「系统管理与升级」→「开发者选项」，找到「5G 网络模式」，配置为 SA 优先（包含 SA 或者 AUTO）。

5. 业务

5.1 终端 IP 地址查看

手机侧查看

进入到手机的设置界面，点击「我的设备」→「全部参数与信息」→「状态信息」，找到「IP 地址」即可查看到手机的 IP 地址。

其他手机的查看路径则是：「设置」→「关于手机」→「状态信息」，IP 地址的信息就在这里面展示。

核心网侧查看

Open5GS 核心网

1. 点击左侧导航栏的「Open5GS 核心网」→「指标监控」，点击「日志」按钮打开核心网的日志，切换到 open5gs-smf 的标签页面查看对应 UE 的 IP 地址。

1. 后台命令行查看命令如下。

sudo docker logs -f open5gs-smf

OAI 核心网

1. 点击左侧导航栏的「OAI 核心网」→「指标监控」，点击「日志」按钮打开核心网的日志，切换到 oai-smf 的标签页面查看对应 UE 的 IP 地址。

1. 后台查看命令如下。

sudo docker logs -f oai-smf

5.2 Iperf 业务

使用 Open5GS 核心网

1. 首先打开一个命令行终端，输入下面的命令进入到 UPF 的容器当中。

sudo docker exec -it open5gs-upf bash

1. 输入下面的命令开始进行 iperf 灌包。其中 10.46.0.2 是 UE 获取的 IP 地址，根据实际情况进行修改。

iperf -u -c 10.46.0.2 -t 1000 -b 1G -i 1 -l 1350

1. 退出 UPF 的 docker 容器。先 Ctrl+C 停止灌包，然后输入 exit 即可。

使用 OAI 核心网

1. 首先打开一个命令行终端，输入下面的命令即可给 UE 灌包。其中 192.168.70.135 是核心网的 UPF 地址，10.0.0.2 是 UE 获取的 IP 地址，根据实际获取的地址进行修改。

docker exec -it oai-ext-dn iperf -u -t 86400 -i 1 -fk -B 192.168.70.135 -b 200M -c 10.0.0.2

5.3 VLC 高清视频业务（OAI）

基站核心网所在的主机

IP 地址配置和路由

1. 给主机电脑配置一个 IP 地址，和其他网络分开，比如 192.168.3.10/24。

1. 主机电脑添加一条路由。其中 10.46.0.0/24 是核心网给 UE 分配 IP 的地址段，根据实际情况修改；172.22.0.8 是 UPF 的 docker 容器地址，是和 UPF 的地址桥接的。

sudo route add -net 10.46.0.0/24 gw 172.22.0.8

VLC 的安装和启动

1. 通过下面的命令给主机安装 VLC。

sudo apt-get install vlc

1. 在基站核心网所在的主机，打开命令行终端，输入 vlc，然后回车打开 VLC。

1. 点击「Media」→「Stream...」进入到流控的弹窗配置界面。

1. 点击「+Add...」按钮，然后选择要播放的高清视频文件。

1. 在下面图中的小三角下拉框选择 Stream，然后点击这个按钮进入下一步。

1. 该界面无需任何操作，直接点击「Next」进入到下一步。

1. 勾选「display locally」可以打开本地显示，视频就会在本地的 VLC 播放，不勾选则无画面。New destination 选择 HTTP，并点击后边的「Add」按钮进入到 HTTP 的配置标签界面，配置端口为一个未被占用的端口，例如 8990，然后点击「Next」进入到下一步。

1. 将 Activate Transcoding 前面的复选框去掉勾选，关闭转码。Profile 选择 Video-H.264+MP3(TS)，然后点击「Next」进入到下一步。

1. 此界面无需任何配置，直接点击「Stream」按钮即可开始视频的播放和推送。

UE 模拟器所在的主机

IP 地址和路由配置

1. 先启动 OAI 的 UE 模拟器，让 UE 模拟器接入到基站获取 IP 地址（一定要先接入）。获取的 IP 地址可以通过 ip a 查看 oaitun_ue1。
2. 配置一条静态的 IP 路由。其中 192.168.3.0/24 是基站所在主机配置的 IP 地址所在的网段，10.46.0.1 是核心网的 UPF 地址，根据实际的地址配置。

sudo route add -net 192.168.3.0/24 gw 10.46.0.1

1. 待路由配置好后，通过 ping 命令查看网络的连通性。

VLC 的安装和启动

1. 通过下面的命令给主机安装 VLC。

sudo apt-get install vlc

1. 打开一个终端命令行窗口，输入 vlc 命令，打开 VLC。

1. 点击「Media」→「Open Network Stream...」，打开网络流的配置界面。

1. 在 Network 的标签界面，配置要监听的网络流地址。其中 192.168.3.10 就是基站核心网配置的地址（VLC 运行所在的主机），协议和端口号就是在 VLC Server 端启动的时候配置的协议和端口。添加好地址后，点击「Play」按钮即可开始接收。

Android 手机

1. 手机接入后打开手机上的 VLC。

1. 进入到首页之后，点击下方导航栏的「...更多」。然后点击「新建串流」，在输入框输入 URL 地址，点击运行图标即可。这里的 URL 地址要和推流侧配置的一致。

6. 常见问题

暂无。