free5gc/amf

基于Docker Compose的free5GC stage 3部署方案，用于搭建5G核心网络，支持自定义配置，需依赖GTP5G内核模块和Docker环境，提供容器化部署和管理各网络功能（NF）的能力。

1 收藏0 次下载activefree5gc镜像

free5GC Compose

本仓库是free5GC stage 3的Docker Compose版本，灵感来源于free5gc-docker-compose，并参考了docker-free5GC。可通过config文件夹和docker-compose.yaml自定义配置。

镜像概述和主要用途

free5GC Compose提供了基于Docker容器化部署free5GC stage 3的方案，用于快速搭建5G核心网络环境。通过Docker Compose编排各网络功能（NF），支持灵活配置，适用于5G核心网的开发、测试和研究场景。

核心功能和特性

容器化部署：将free5GC各网络功能（如AMF、SMF、UPF等）封装为Docker容器，简化部署流程
自定义配置：支持通过config文件夹和docker-compose.yaml文件定制网络参数
依赖管理：集成MongoDB数据库，管理用户订阅数据
外部集成：支持与UERANSIM等eNB/UE模拟器对接
多部署模式：提供前台运行（推荐结合tmux）和后台运行两种方式
Vagrant支持：提供Vagrant Box选项，规避内核版本限制

使用场景和适用范围

5G核心网络功能的开发与测试环境搭建
5G网络协议栈研究与验证
教学或培训中的5G核心网演示环境
需要快速部署和重置的5G核心网实验场景

使用方法和配置说明

前提条件

GTP5G内核模块

由于UPF的限制，主机必须使用5.0.0-23-generic内核，并包含gtp5g内核模块。在主机OS上执行以下命令安装：

bash
git clone [***]
cd gtp5g
make
sudo make install

Docker环境

Engine：参考Docker Engine安装文档在对应操作系统安装
Compose：参考Docker Compose安装文档安装

启动free5GC

由于需要创建隧道接口，需使用具有root权限的特权容器：

bash
# 克隆仓库
git clone [***]
cd free5gc-compose

# 构建基础镜像和服务镜像
make base
docker-compose build

# 启动服务（推荐使用tmux在前台运行）
sudo docker-compose up

# 如需后台运行
sudo docker-compose up -d

故障排除

数据库数据清理

有时需要清除数据库中的订阅数据：

bash
# 进入MongoDB容器
docker exec -it mongodb mongo
# 删除订阅者数据
> use free5gc
> db.subscribers.drop()
> exit  # 或按Ctrl-D退出

查看服务日志

使用docker logs命令查看各服务日志，例如查看SMF日志：

bash
docker logs smf

更多故障排除信息请参考free5GC***Wiki。

与外部eNB/UE模拟器集成

与UERANSIM eNB/UE模拟器的集成方法详见***文档。

关于在Docker环境中配置UPF以实现UERANSIM与DN（如互联网）之间的流量转发，可参考相关Issue。

Vagrant Box选项

若不想升级主机内核，可使用Vagrant Box快速搭建环境，参考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

参考

[***]
[***]===SHORT_DESC=== 基于Docker Compose的free5GC stage 3部署方案，用于搭建5G核心网络，支持自定义配置，需依赖GTP5G内核模块和Docker环境，提供容器化部署和管理各网络功能（NF）的能力。 ===FULL_DESC===# free5GC Compose