跳到主要内容

OmniAMF

OmniAMF是Omnitouch 5G核心的接入与移动管理功能（AMF）。它终止来自5G无线接入网络（gNBs）的N1（NAS）和N2（NGAP）接口，并协调用户设备（UE）的注册、认证、移动性、连接管理、寻呼和PDU会话信令中继。

它参与基于服务的5G架构（SBA）通过SBI，既生成也消费Namf和其他网络功能（NF）服务，并提供N26 EPS↔5GS互通与4G MME。OmniAMF是每个UE在5G核心中的移动性和连接锚：它接受来自gNB的SCTP/NGAP关联，终止在NGAP中中继的NAS信令，并与对等NF协调以认证UE、检索订阅数据、选择切片和管理PDU会话。

文档​

  • 操作指南 - 核心概念、3GPP参考、接口/SBI端点和关键程序及其序列图。
  • 配置参考 - 完整的参数文档、管理/OAM API���点和日志说明。
  • 管理API - 操作员OAM REST API：状态/库存、运行时配置和UE/gNB/NRF/维护控制操作。
  • 指标与监控 - Prometheus指标和示例PromQL查询。
  • 故障排除 - 常见问题及解决方案。

架构概述​

每个UE由一个专用的UeWorker进程处理，该进程在UE监督器下进行监督。NGAP消息通过NGAP UE标识符进行解复用到拥有的工作进程，因此UE状态机在隔离中运行。一个独立的基于ETS的GUTI上下文存储持久化每个UE的本地5G NAS安全上下文（SUPI、K_AMF、NAS计数、安全能力），以5G-TMSI为键，与工作进程的生命周期无关。这可以在工作进程更替时存活，并允许从空闲模式返回的UE在不重新认证的情况下恢复。

功能概述​

  • NGAP / N2终止 - 接受来自gNB的SCTP关联；处理NG设置、初始UE消息、UE上下文设置/释放、NAS传输、寻呼和切换准备（TS 38.413）。
  • UE注册和5G-AKA - 协调与AUSF的认证和与UDM的订阅检索/UECM注册。
  • NAS安全：派生K_AMF和NAS密钥，运行安全模式控制，并根据UE能力协商NAS完整性（NIA）和加密（NEA），优先选择NIA2/NEA2并回退到NIA0/NEA0。设置force_null_ciphering以强制使用NEA0（空加密），无论UE能力如何。
  • 基于GUAMI的GUTI分配 - 从配置的GUAMI分配5G-GUTI，并通过基于ETS的上下文存储支持空闲模式GUTI恢复。
  • 寻呼和服务请求 - 在其TAI列表中寻呼CM-IDLE UE，并在服务请求时重新激活用户平面。
  • PDU会话中继（N11） - 将5GSM NAS中继到/从SMF，并推动N2 PDU会话资源设置/修改到gNB。
  • PCF AM策略（N15） - 在注册和注销期间创建和删除接入与移动策略关联。
  • NF发现 - 通过NRF发现解析对等NF URI，并提供每个NF的静态回退（60秒缓存）。
  • N26 EPS↔5GS互通 - 可选的GTPv2-C端点，用于与4G MME的系统间切换，包括S-NAPTR MME发现。
  • Namf服务 - 生成Namf_Communication（N1N2转移、上下文转移、EBI分配、状态订阅）和Namf_EventExposure。
  • 操作员管理 - 管理REST API和Web控制面板，用于状态检查和OAM操作。

快速开始​

OmniAMF从Elixir应用程序环境中的:omniamf键读取操作员配置，该键在启动时从config/runtime.exs填充。每个运行时键由一个环境变量驱动，并具有内置默认值，因此可以完全通过环境变量调整部署。

config :omniamf,
  # SBI HTTP服务器（生成的Namf服务）
  sbi_scheme: "http",
  sbi_addr: "127.0.0.5",
  sbi_port: 7777,

  # NRF（注册、心跳、发现）
  nrf_uri: "http://127.0.0.1:7777",

  # 消费的对等NF基本URI（静态回退；优先NRF发现）
  ausf_uri: "http://127.0.0.12:7777",
  udm_uri: "http://127.0.0.12:7777",
  smf_uri: "http://127.0.0.4:7777",
  nssf_uri: "http://127.0.0.14:7777",

  # 服务PLMN
  mcc: "999",
  mnc: "70",

  # AMF身份（GUAMI）
  amf_name: "OmniAMF",
  amf_id: %{region_id: 2, set_id: 1, pointer: 0},

  # 可观察性
  prometheus_metrics_port: 9569,

  # N2 / NGAP（gNB的SCTP监听器）
  ngap_addr: "0.0.0.0",
  ngap_port: 38412,

  # NRF心跳频率
  heartbeat_interval: 10_000,

  # N26 EPS↔5GS与4G MME的互通
  n26_enabled: true,
  n26_addr: "0.0.0.0",
  n26_mme_peer: %{ip: "127.0.0.11", port: 2123}

每个参数的完整文档，包括高级应用配置键和管理/OAM API，详见配置参考。

最后于 更新