kathara/frr

FRRouting扩展镜像文档

镜像概述与主要用途

本镜像是基于基础镜像构建的网络功能增强容器镜像，通过集成FRRouting（FRR）开源路由套件，提供动态路由协议支持。FRR是一个功能完善的开源路由软件套件，支持多种动态路由协议（如BGP、OSPFv2/v3、RIP、IS-IS等），本镜像旨在为需要动态路由功能的网络环境提供轻量级、可移植的容器化解决方案，适用于网络功能虚拟化（NFV）、软件定义网络（SDN）及网络实验场景中的路由节点部署。

核心功能与特性

• 基础镜像扩展：基于标准基础镜像构建，保留原镜像核心功能的同时新增路由能力
• 完整FRRouting集成：包含FRR全套组件（zebra、bgpd、ospfd、ripd等守护进程）
• 多协议支持：兼容主流动态路由协议，包括BGPv4/v6、OSPFv2/v3、RIP v1/v2、IS-IS等
• 容器化优势：轻量级部署、环境隔离、跨平台移植性强，降低传统路由设备硬件依赖
• 灵活配置：支持通过配置文件挂载、环境变量或CLI动态调整路由参数
• 网络兼容性：支持桥接、host、macvlan等多种Docker网络模式，适配复杂网络拓扑

使用场景与适用范围

典型使用场景

• 网络功能虚拟化（NFV）：作为虚拟路由转发（VRF）实例，提供运营商或企业网络中的动态路由服务
• 软件定义网络（SDN）：作为SDN环境中的控制平面路由节点，实现网络流量动态调度
• 网络实验室：在教学或研究环境中快速部署路由协议测试环境，模拟复杂网络拓扑
• 边缘计算网络：为边缘节点提供动态路由能力，适应边缘网络拓扑变化
• 微服务网络：在大型微服务架构中实现跨子网服务的动态路由发现

适用范围

• 网络功能开发者测试环境
• 企业私有云/混合云网络架构
• 教育机构网络协议教学实验
• 中小型网络的动态路由解决方案
• 网络设备厂商的功能验证环境

使用方法与配置说明

前置要求

• Docker Engine 19.03+ 或兼容的容器运行时
• 宿主机需支持必要的网络模式（如host模式需root权限，macvlan需网络接口配置）
• 如需跨主机网络通信，需配置Docker网络或外部网络策略

获取镜像

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/frr-extension-image:latest

基本运行示例

1. 基础路由节点（host网络模式）

bash
docker run -d \
  --name frr-router \
  --net=host \
  --cap-add=NET_ADMIN \  # 需添加网络管理权限
  -v /path/to/local/frr:/etc/frr \  # 挂载本地配置目录
  [镜像仓库地址]/frr-extension-image:latest

2. 自定义网络模式（macvlan示例）

bash
# 创建macvlan网络
docker network create -d macvlan \
  --subnet=192.168.100.0/24 \
  --gateway=192.168.100.1 \
  -o parent=eth0 macvlan-net

# 运行FRR容器
docker run -d \
  --name frr-macvlan \
  --network macvlan-net \
  --ip=192.168.100.10 \
  --cap-add=NET_ADMIN \
  -v /path/to/frr.conf:/etc/frr/frr.conf \
  docker.xuanyuan.run/[镜像仓库地址]/frr-extension-image:latest

3. Docker Compose配置示例

yaml
version: '3.8'
services:
  frr-router:
    image: docker.xuanyuan.run/[镜像仓库地址]/frr-extension-image:latest
    container_name: frr-router
    network_mode: host
    cap_add:
      - NET_ADMIN
    volumes:
      - ./frr-config:/etc/frr  # 本地配置目录挂载
      - /lib/modules:/lib/modules  # 如需内核模块支持（如MPLS）
    environment:
      - FRR_DISABLE_ZEBRA=no  # 启用zebra守护进程
      - FRR_LOG_LEVEL=info  # 日志级别配置
    restart: unless-stopped

配置说明

核心配置文件

FRR主要配置文件位于容器内/etc/frr/frr.conf，典型配置结构示例：

!
hostname frr-router
!
password frr
enable password frr
!
interface eth0
 ip address 192.168.1.10/24
!
router ospf
 ospf router-id 10.0.0.1
 network 192.168.1.0/24 area 0
!
line vty
!

环境变量配置

支持通过环境变量调整基础运行参数：

• FRR_LOG_LEVEL：日志级别（debug/info/warn/error），默认info
• FRR_DISABLE_ZEBRA：是否禁用zebra守护进程（yes/no），默认no
• FRR_VTYSH_ENABLE：是否启用vtysh管理接口（yes/no），默认yes
• FRR_CONFIG_AUTOLOAD：是否自动加载配置文件（yes/no），默认yes

服务验证

容器启动后可通过以下方式验证FRR服务状态：

bash
# 进入容器
docker exec -it frr-router bash

# 查看FRR进程状态
systemctl status frr  # 或直接检查进程：ps aux | grep frr

# 通过vtysh管理接口查看路由表
vtysh -c "show ip route"

注意事项

• 容器需添加NET_ADMIN权限以实现网络配置修改
• host模式下需注意端口冲突（FRR默认使用2600-2609端口范围）
• 复杂网络拓扑建议使用macvlan或ipvlan网络模式以获取独立MAC地址
• 生产环境中建议挂载持久化卷保存配置文件，避免容器重启后配置丢失