ungleich/bird

BIRD 路由守护进程 Docker 镜像

镜像概述

该镜像包含BIRD（BGP、OSPF等路由协议守护进程）及相关工具，旨在提供运行路由守护进程所需的容器化环境，集成路由功能所需的核心组件和必要工具，支持在容器化环境中部署路由服务。

核心功能与特性

• 内置BIRD路由守护进程，支持多种路由协议（如BGP、OSPF等）
• 集成运行路由守护进程所需的配套工具
• 轻量级设计，适合容器化部署场景
• 支持自定义配置，通过挂载配置文件实现灵活部署

使用场景与适用范围

• 需要运行路由守护进程的网络环境
• Kubernetes集群中作为路由组件部署
• 硬件路由器的容器化替代方案（复杂场景需注意配置难度）

使用方法与配置说明

基本使用

运行容器时，需将BIRD配置文件挂载到容器内的/etc/bird.conf路径，确保守护进程加载正确配置：

bash
docker run -v /path/to/local/bird.conf:/etc/bird.conf ungleich/bird:latest /usr/sbin/bird -f

说明：-f参数指定BIRD在前台运行，符合容器进程管理要求

Kubernetes 部署注意事项

• 推荐使用hostNetwork: true配置，使容器直接使用主机网络栈，简化路由协议网络交互
• 若需通过multus等CNI插件实现复杂网络配置，技术上可行但配置复杂度显著增加（尤其硬件路由器场景）

Kubernetes 部署示例

以下是Kubernetes Pod中集成BIRD镜像的配置示例：

yaml
- name: bird
  image: "ungleich/bird:{{ .Chart.AppVersion }}"  # 替换为实际版本标签
  ports:
  - containerPort: 179  # BGP协议默认端口，根据使用的路由协议调整
  command:
    - /usr/sbin/bird
    - -f  # 前台运行模式，确保容器进程持续运行
  securityContext:
    privileged: true  # 特权模式，允许操作网络接口和路由表
    capabilities:
      add:
        - NET_BIND_SERVICE  # 允许绑定特权端口
        - NET_RAW  # 允许原始套接字操作（路由协议必需）
        - NET_ADMIN  # 允许网络管理权限（修改路由表等操作）
  volumeMounts:
    - name: birdconfig
      mountPath: "/etc/bird.conf"
      subPath: "bird.conf"  # 挂载配置文件的特定子路径
  livenessProbe:
    tcpSocket:
      port: 179  # 通过TCP端口探测服务存活状态
    initialDelaySeconds: 60  # 初始化延迟60秒，确保服务完成启动
    periodSeconds: 30  # 每30秒执行一次存活探测

关键配置说明

• 配置文件挂载：必须将自定义bird.conf挂载到/etc/bird.conf，配置内容需根据实际路由需求编写（包含协议类型、邻居信息、路由策略等）
• 安全上下文：privileged: true及添加NET_BIND_SERVICE、NET_RAW、NET_ADMIN capabilities是必要的，确保容器具备操作网络和路由表的权限
• 健康检查：示例中通过TCP端口179探测存活状态，需根据实际使用的路由协议调整端口或探测方式