free5gc/nssf
free5gc
free5GC Compose是基于Docker Compose的free5GC stage 3部署方案，用于快速搭建5G核心网络，包含各网络功能(NF)的容器化部署、配置管理及依赖协调，支持通过Docker容器编排简化5G核心网环境搭建与运维。
下载次数: 0状态：社区镜像维护者：free5gc仓库类型：镜像最近更新：5 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
free5GC Compose
镜像概述和主要用途
free5GC Compose是free5GC stage 3的Docker Compose版本，用于简化5G核心网络（5GC）的部署流程。该方案基于Docker容器技术，通过Compose编排实现各网络功能（NF）的容器化部署，支持自定义配置，适用于5G核心网的开发、测试与教学场景。其设计参考了多个开源项目，旨在提供便捷、可复现的5G核心网部署环境。
核心功能和特性
- 完整NF支持：包含AMF、AUSF、NRF、NSSF、PCF、SMF、UDM、UDR、UPF等5G核心网关键网络功能
- Docker Compose编排：通过Docker Compose实现多NF容器的协同部署与依赖管理
- 灵活配置：支持通过
config目录和docker-compose.yaml自定义网络功能参数 - 集成数据库：内置MongoDB存储用户订阅数据，支持数据清理与管理
- 日志与故障排查：提供容器日志查看工具，支持数据库数据重置等故障处理操作
使用场景和适用范围
- 5G核心网功能开发与测试环境搭建
- 5G网络教学与培训实践
- 5G核心网与eNB/UE模拟器（如UERANSIM）的集成测试
- 快速验证5G核心网功能与性能的实验场景
详细使用方法和配置说明
前提条件
GTP5G内核模块
由于UPF（用户面功能）限制，主机需使用5.0.0-23-generic内核，并安装gtp5g内核模块。主机端安装步骤：
bashgit clone https://github.com/PrinzOwO/gtp5g.git cd gtp5g make sudo make install
Docker环境
- Engine：参考Docker Engine安装文档安装Docker引擎
- Compose：参考Docker Compose安装文档安装Docker Compose
部署步骤
由于需要创建隧道接口，需使用具有root权限的特权容器。部署命令如下：
bash# 克隆仓库 git clone https://github.com/free5gc/free5gc-compose.git cd free5gc-compose # 构建基础镜像和服务镜像 make base docker-compose build # 启动服务（推荐使用tmux前台运行） sudo docker-compose up # 如需后台运行 sudo docker-compose up -d
故障排除
数据库数据清理
当需要重置用户订阅数据时，可执行以下命令清理MongoDB数据：
bash# 进入MongoDB容器 docker exec -it mongodb mongo # 切换到free5gc数据库 > use free5gc # 删除订阅者集合 > db.subscribers.drop() # 退出（或按Ctrl-D） > exit
日志查看
使用docker logs命令查看各服务日志，例如查看SMF（会话管理功能）日志：
consoledocker logs smf
更多故障排查信息请参考https://github.com/free5gc/free5gc/wiki%E3%80%82
与外部eNB/UE模拟器集成
- 与https://github.com/aligungr/UERANSIM%EF%BC%88eNB/UE%E6%A8%A1%E6%8B%9F%E5%99%A8%EF%BC%89%E7%9A%84%E9%9B%86%E6%88%90%E6%96%B9%E6%B3%95%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3
- 配置UPF实现UERANSIM与数据网络（如互联网）之间流量转发的方法可参考https://github.com/free5gc/free5gc-compose/issues/26
Vagrant环境选项
若需避免主机内核版本限制，可使用Vagrant Box快速搭建环境，详情参见：https://github.com/abousselmi/vagrant-free5gc
网络功能(NF)依赖和端口
| 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 |
参考
- https://github.com/open5gs/nextepc/tree/master/docker
- https://github.com/abousselmi/docker-free5gc
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull free5gc/nssf:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"