free5GC项目中N3IWUE与N3IWF网络连接问题的分析与解决

问题背景

在free5GC v3.4.0版本中，用户报告了一个关于N3IWUE（非3GPP互通用户设备）与N3IWF（非3GPP互通功能）之间网络连接建立失败的问题。具体表现为N3IWF无法正常启动，日志中显示"SCTP连接被拒绝"的错误信息。

问题现象

当用户尝试运行包含N3IWF的free5GC时，系统日志显示以下关键错误信息：

[ERRO][N3IWF][NGAP] [SCTP] DialSCTP(): connection refused
[ERRO][N3IWF][Init] Start NGAP service failed: NGAP service run failed

尽管TestNon3GPP测试用例能够通过，但在实际部署中N3IWF无法与AMF建立连接，导致整个非3GPP接入功能失效。

根本原因分析

经过深入排查，发现问题主要由以下配置错误导致：

1. AMF与N3IWF配置不一致：在amfcfg.yaml中ngapIPList被设置为10.0.0.100，但在n3iwfcfg.yaml中AMFSCTPAddresses仍保持默认的127.0.0.18，导致连接失败。

2. IPSec隧道地址冲突：IPSecTunnelAddress参数配置的IP地址(10.0.0.x)与5GC主机地址(10.0.0.110)存在冲突。

3. 版本兼容性问题：v3.4.0版本中存在某些影响N3IWUE功能的代码变更。

解决方案

配置修正

1. 统一AMF和N3IWF的IP配置：

   • 确保n3iwfcfg.yaml中的AMFSCTPAddresses与amfcfg.yaml中的ngapIPList保持一致
   • 示例配置：

     # amfcfg.yaml
     ngapIPList:
       - 10.0.0.100
     
     # n3iwfcfg.yaml
     AMFSCTPAddresses:
       - 10.0.0.100
     

2. 调整IPSec隧道地址：

   • 将IPSecTunnelAddress改为不与主机冲突的IP段（如172.16.0.1）
   • 相应修改n3ue.yaml中的IPsecInnerAddr
   • 更新UEIPAddressRange为对应网段（如172.16.0.0/24）

3. 网络配置命令：

   sudo sysctl -w net.ipv4.ip_forward=1
   sudo iptables -t nat -A POSTROUTING -o <dn_interface> -j MASQUERADE
   sudo systemctl stop ufw
   sudo systemctl disable ufw
   

版本升级

free5GC团队在v3.4.1版本中修复了相关问题。升级后验证显示：

• N3IWUE能够成功建立连接
• Ping测试和接口通信功能恢复正常
• 虚拟接口能够正确路由数据包

经验总结

1. 配置一致性检查：在部署多组件系统时，必须确保相关组件间的配置参数一致。

2. IP规划：提前做好IP地址规划，避免地址冲突，特别是当使用虚拟接口和隧道时。

3. 版本验证：新版本发布后应进行全面功能测试，特别是边缘功能如非3GPP接入。

4. 网络准备：确保主机已正确配置IP转发和NAT规则，防火墙不会阻挡必要通信。

后续建议

对于使用free5GC非3GPP功能的用户，建议：

1. 直接采用v3.4.1或更高版本
2. 仔细核对各组件配置文件中的网络参数
3. 在独立环境中测试验证后再进行生产部署
4. 关注官方文档更新，获取最新配置指导

通过以上措施，可以确保N3IWUE与N3IWF之间的网络连接正常建立，实现非3GPP设备的5G核心网接入功能。