OpenONU Adapter (GO) 镜像文档

镜像概述

OpenONU Adapter镜像为VOLTHA（Virtual OLT Hardware Abstraction）平台提供ONU（光网络单元）设备的适配能力，采用GO语言开发。该镜像实现了ONU与VOLTHA控制平面之间的协议转换、设备管理及状态监控功能，是构建软件定义光接入网络（SDN-based Optical Access Network）的关键组件。

核心功能特性

1. VOLTHA平台深度集成

• 遵循VOLTHA平台标准接口规范，支持与VOLTHA核心控制平面（如voltha-core）无缝通信
• 实现ONU设备在VOLTHA生态中的生命周期管理（注册、配置、激活、去激活）

2. GO语言技术优势

• 基于GO语言高性能运行时，具备低内存占用、高并发处理能力，适合网络设备实时数据处理场景
• 跨平台编译支持，可部署于x86_64、ARM等多种硬件架构

3. ONU设备管理能力

• 支持ONU设备发现与识别，兼容主流厂商ONU设备（需配合厂商配置文件）
• 实现ONU业务配置下发（如VLAN、QoS参数）及状态监控（连接状态、流量统计）
• 提供ONU故障检测与自动恢复机制

4. 协议支持

• 支持G.988 (OMCI) 协议处理，实现ONU与OLT之间的管理层通信
• 兼容VOLTHA内部gRPC接口，确保与控制平面的高效数据交互

使用场景

• 电信运营商光接入网部署：作为VOLTHA架构的一部分，用于FTTH（光纤到户）网络中ONU设备的集中管理
• SDN光网络实验环境：在VOLTHA开源项目测试与开发中，提供ONU设备模拟与真实设备接入能力
• 多厂商ONU设备统一管理：通过标准化适配层，简化不同厂商ONU设备的集成复杂度

使用方法

前提条件

• 已部署VOLTHA核心组件（voltha-core、etcd等）
• 容器网络需与VOLTHA核心组件互通
• （可选）ONU厂商配置文件（如支持特定厂商设备）

镜像拉取

bash
docker pull voltha/openonu-adapter-go:latest

基本运行示例

bash
docker run -d \
  --name openonu-adapter \
  --network voltha-network \  # 需与VOLTHA核心组件在同一网络
  -e VOLTHA_GRPC_ADDRESS=voltha-core:50057 \  # VOLTHA核心gRPC服务地址
  -e LOG_LEVEL=info \  # 日志级别：debug/info/warn/error
  -e ADAPTER_PORT=50060 \  # 适配器服务端口
  -v /path/to/vendor/config:/etc/openonu/vendor \  # 挂载厂商配置文件（可选）
  voltha/openonu-adapter-go:latest

Docker Compose配置示例

yaml
version: '3'
services:
  openonu-adapter:
    image: voltha/openonu-adapter-go:latest
    container_name: openonu-adapter
    network_mode: "voltha-network"
    environment:
      - VOLTHA_GRPC_ADDRESS=voltha-core:50057
      - LOG_LEVEL=info
      - ADAPTER_PORT=50060
      - ONU_DISCOVERY_INTERVAL=30s  # ONU发现间隔
    volumes:
      - ./vendor-config:/etc/openonu/vendor
    restart: unless-stopped

环境变量配置说明

注意事项

• 确保容器网络与VOLTHA核心组件互通，否则无法建立gRPC连接
• 对于特定厂商ONU设备，需提前准备厂商配置文件并通过卷挂载至容器内
• 生产环境建议设置LOG_LEVEL=warn或error以减少日志开销，调试时使用debug级别
• 需根据实际ONU设备数量调整MAX_ONU_CONCURRENT参数，避免资源竞争

版本信息

• 镜像基于GO 1.18+构建，支持CGO交叉编译
• 兼容VOLTHA 2.8及以上版本
• 遵循VOLTHA社区适配器开发规范（ONU Adapter Specification）