
free5gc/upf本仓库是free5GC stage 3的Docker Compose版本,灵感来源于free5gc-docker-compose,并参考了docker-free5GC。可在config文件夹和docker-compose.yaml中自定义配置。
由于UPF的限制,主机必须使用5.0.0-23-generic内核,并包含gtp5g内核模块。
在主机操作系统上执行以下命令:
git clone [***] cd gtp5g make sudo make install
由于需要创建隧道接口,需使用具有root权限的特权容器。
bash$ git clone [***] $ cd free5gc-compose $ make base $ docker-compose build $ sudo docker-compose up # 建议使用tmux在前台运行 $ sudo docker-compose up -d # 如需后台运行
有时需要清除数据库数据:
bash$ docker exec -it mongodb mongo > use free5gc > db.subscribers.drop() > exit # (或按Ctrl-D)
可使用docker logs命令查看各服务日志。例如,查看SMF日志:
consoledocker logs smf
更多故障排除信息请参考free5GC Wiki。
与UERANSIM eNB/UE模拟器的集成方法详见官方文档。
也可参考此Issue了解如何配置UPF以在Docker环境中转发UERANSIM与DN(如互联网)之间的流量。
若不想更新内核版本,可使用Vagrant Box快速搭建工作环境,具体步骤见Vagrant-free5gc仓库。
| NF | 暴露端口 | 依赖项 | 依赖URI |
|---|---|---|---|
| amf | 8000 | nrf | nrfUri: [***] |
| ausf | 8000 | nrf | nrfUri: [***] |
| nrf | 8000 | db | MongoDBUrl: mongodb://db:27017 |
| nssf | 8000 | nrf | nrfUri: [] nrfId: [] |
| pcf | 8000 | nrf | nrfUri: [***] |
| smf | 8000 | nrf, upf | nrfUri: [***] node_id: upf1, node_id: upf2, node_id: upf3 |
| udm | 8000 | nrf | nrfUri: [***] |
| udr | 8000 | nrf, db | nrfUri: [***] url: mongodb://db:27017 |
| n3iwf | N/A | amf, smf, upf | |
| upf1 | N/A | pfcp, gtpu, apn | pfcp: upf1, gtpu: upf1, apn: internet |
| upf2 | N/A | pfcp, gtpu, apn | pfcp: upf2, gtpu: upf2, apn: internet |
| upfb (ulcl) | N/A | pfcp, gtpu, apn | pfcp: upfb, gtpu: upfb, apn: intranet |
| webui | 5000 | db | MongoDBUrl: mongodb://db:27017 |






manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务