chpradeep23/exabgp-rt

Exa-BGP Docker镜像文档

1. 镜像概述和主要用途

Exa-BGP Docker镜像用于构建网络路由实验环境，主要功能是学习和测试基于互联网路由表的策略。该环境包含多个cEOS网络设备、运行Ubuntu 24.04的Linux Docker容器（ExaBGP节点，命名为iexcng），以及二层交换机组件。通过eBGP和iBGP邻居关系配置，ExaBGP节点可向cEOS设备宣告完整互联网路由表，适用于模拟真实网络路由场景。

2. 核心功能和特性

• BGP邻居关系管理：支持eBGP（ExaBGP节点与cEOS设备间）和iBGP（cEOS设备间）邻居关系配置，可灵活定义AS号、路由策略。
• 路由宣告能力：通过Python脚本（fullbgptable-lum.py、fullbgptable-vzb.py）向不同邻居宣告路由表，支持IPv4单播地址族。
• 多运行模式：提供两种运行方式，既可作为系统服务（systemd）后台运行，也可手动启动以实时查看日志输出。
• 网络拓扑灵活性：通过二层交换机连接ExaBGP节点与cEOS设备，形成封闭实验网络，支持自定义路由和网络参数。
• 完整生命周期管理：支持实验环境快速部署与销毁（基于containerlab），便于重复测试。

3. 使用场景和适用范围

• 网络路由实验：学习BGP协议原理、路由表传播机制及邻居关系建立过程。
• BGP策略测试：验证自定义路由策略（如AS路径、社区属性）对路由选路的影响。
• 路由表模拟环境：在本地环境中模拟完整互联网路由表，测试设备路由处理能力。
• 网络设备配置练习：通过SSH访问cEOS设备，练习BGP配置、路由监控等操作。

4. 使用方法和配置说明

4.1 环境准备

需提前部署容器化环境（如Docker、containerlab），并通过拓扑文件（如exabgp.yml）定义网络结构。环境包含以下组件：

• cEOS设备：ho-lumen-rt、ho-verizon-rt（网络路由设备）
• ExaBGP节点：iexcng（运行ExaBGP服务的Ubuntu容器）
• 二层交换机：连接iexcng与cEOS设备，构建BGP邻居关系

4.2 默认配置说明

ExaBGP默认配置文件（如internet-multi-bgp.cfg）包含路由宣告进程、邻居模板及具体邻居配置，示例如下：

# 需根据实验设计修改此文件
process route-announce-lum {
    run python3 /fullbgptable-lum.py;  # 向lum邻居宣告路由的脚本
    encoder text;
}
process route-announce-vzb {
    run python3 /fullbgptable-vzb.py;  # 向vzb邻居宣告路由的脚本
    encoder text;
}
template {
    neighbor AS_65000{  # 邻居模板，定义AS 65000的通用配置
        peer-as 65000;
        family {
            ipv4 unicast;  # 支持IPv4单播地址族
        }
    }
}
neighbor 192.168.0.2 {  # 具体邻居配置（如ho-lumen-rt）
    router-id 192.168.0.1;
    local-as 65001;
    inherit AS_65000;  # 继承模板配置
    local-address 192.168.0.1;
    api send {
        processes [route-announce-lum];  # 关联路由宣告进程
    }
}
neighbor 172.16.0.2 {  # 具体邻居配置（如ho-verizon-rt）
    router-id 172.16.0.1;
    local-as 65002;
    inherit AS_65000;
    local-address 172.16.0.1;
    api send2 {
        processes [route-announce-vzb];
    }
}

4.3 运行ExaBGP服务

4.3.1 方式一：作为系统服务运行

1. 修改exabgp.env文件，将运行用户改为root：

   bash
   vi /etc/exabgp/exabgp.env
   # 将 user="exabgp" 修改为 user="root"
   

2. 创建/修改systemd服务文件：

   bash
   vi /usr/lib/systemd/system/exabgp.service
   

   服务配置内容：

   ini
   [Unit]
   Description=ExaBGP
   Documentation=man:exabgp(1)
   Documentation=man:exabgp.conf(5)
   Documentation=https://github.com/Exa-Networks/exabgp/wiki
   After=network.target
   ConditionPathExists=/root/internet-multi-bgp.cfg  # 配置文件路径
   
   [Service]
   Environment=exabgp_daemon_daemonize=false
   User=root
   Group=root
   RuntimeDirectory=root
   RuntimeDirectoryMode=0750
   ExecStartPre=-/usr/bin/mkfifo /run/exabgp/exabgp.in  # 创建命名管道
   ExecStartPre=-/usr/bin/mkfifo /run/exabgp/exabgp.out
   ExecStart=/usr/sbin/exabgp /root/internet-multi-bgp.cfg  # 启动命令
   ExecReload=/bin/kill -USR1 $MAINPID
   Restart=always
   CapabilityBoundingSet=CAP_NET_ADMIN
   AmbientCapabilities=CAP_NET_ADMIN
   
   [Install]
   WantedBy=multi-user.target
   

3. 重载服务配置并启动：

   bash
   sudo systemctl daemon-reload
   sudo systemctl start exabgp
   

4. 验证服务状态：

   bash
   systemctl status exabgp
   

   预期输出包含服务运行状态及路由宣告日志。

4.3.2 方式二：手动运行

直接执行ExaBGP命令，指定配置文件：

bash
exabgp internet-v3.cfg

运行后将实时输出启动日志及路由宣告过程，适合调试场景。

4.4 网络配置

4.4.1 添加环回地址

在ExaBGP节点（iexcng）添加环回地址（如8.8.8.8/32）：

bash
ip addr add 8.8.8.8/32 dev lo label lo:8

4.4.2 配置返回流量路由

通过netplan配置客户端到内部网络的返回路由，示例配置文件（/etc/netplan/90-NM-xxx.yaml）：

yaml
network:
  version: 2
  ethernets:
    NM-1eb3ee1e-1b44-3d47-a9f6-90e202d34838:
      renderer: NetworkManager
      match:
        name: "ens5"
      addresses:
      - "192.168.0.0/30"  # 本地网络地址
      routes:
        - to: 198.*.*.0/27  # 目标网段
          via: 192.168.0.2  # 下一跳地址（cEOS设备）

4.5 访问设备

4.5.1 访问cEOS设备

通过SSH访问cEOS设备（如ho-lumen-rt）：

bash
ssh admin@ho-lumen-rt

4.5.2 访问客户端设备

通过docker exec进入ExaBGP节点（iexcng）的bash shell：

bash
docker exec -it iexcng bash

4.6 实验环境销毁

使用containerlab命令销毁实验环境，清理容器及网络资源：

bash
clab destroy -t exabgp.yml --cleanup

输出示例：

INFO[0000] Parsing & checking topology file: exabgp.yml 
INFO[0000] Destroying lab: exabgp                                     
INFO[0000] Removed container: iexcng                   
INFO[0000] Removed container: ho-lumen-rt                      
INFO[0000] Removed container: ho-verizon-rt                 
INFO[0000] Removing containerlab host entries from /etc/hosts file

若需保留实验配置文件等 artifacts，可移除--cleanup参数。

5. 反馈

如有问题或建议，可通过留言或提交issue反馈。