openverso/open5gs

Open5gs 容器镜像

重要说明

已弃用：请改用 https://hub.docker.com/r/gradiant/open5gs%E3%80%82

新版本将发布在 https://hub.docker.com/r/gradiant/open5gs%E3%80%82

镜像概述和主要用途

本仓库提供用于部署 Open5gs 服务的容器镜像。Open5gs 是一个开源的 5GC 和 EPC（Release-16）项目，可用于配置自有 NR/LTE 网络。若具备 gNB/eNB 和 USIM，可使用 Open5gs 构建私有网络。Open5gs 采用 C 语言实现 5GC 和 EPC，同时提供基于 Node.js 和 React 的 WebUI 用于测试。

核心功能和特性

• 支持部署 Open5gs 各核心网络服务（如 hss、sgwc、amf 等）
• 提供最小化工作配置文件，位于 /opt/open5gs/etc/open5gs/ 和 /opt/open5gs/etc/freeDiameter
• 包含原始配置文件（带参数注释），位于 /opt/open5gs/etc/orig
• 数据平面服务 upf 需访问 /dev/ogstun tun 设备（支持主机挂载或特权模式运行）
• 支持通过环境变量 DB_URI 配置 MongoDB 访问（默认值：mongodb://mongo/open5gs）

使用场景和适用范围

适用于需要部署私有 NR/LTE 网络的场景，如研究、测试或小型私有通信网络构建。

使用方法和配置说明

基本使用

每个核心网络服务（hss、sgwc、amf 等）需部署独立容器。镜像默认 CMD 为 /bin/bash，建议将命令修改为对应服务的守护进程，例如：

• hss 服务：open5gs-hssd
• sgwc 服务：open5gs-sgwcd
• amf 服务：open5gs-amfd

配置文件

配置文件路径：

• 工作配置：/opt/open5gs/etc/open5gs/ 和 /opt/open5gs/etc/freeDiameter
• 原始配置（含参数注释）：/opt/open5gs/etc/orig

UPF 服务特殊配置

UPF 服务需要访问 /dev/ogstun tun 设备，可通过以下方式实现：

1. 在主机创建 tun 接口并挂载到容器：-v /dev/ogstun:/dev/ogstun
2. 以特权模式运行容器：--privileged

MongoDB 配置

部分服务依赖 MongoDB，可通过环境变量 DB_URI 配置访问地址：

bash
-e DB_URI=mongodb://<mongodb-host>:<port>/open5gs

Docker Compose 部署

GitHub 仓库 https://github.com/Gradiant/openverso-images/tree/main/open5gs 提供 docker-compose.yaml 文件，用于部署 Open5gs。

部署步骤

1. 克隆仓库或下载 docker-compose.yaml
2. 启动服务：

   bash
   docker-compose up -d
   

3. 检查服务状态：

   bash
   docker-compose ps
   

4. 停止并移除容器：

   bash
   docker-compose down