openoverlayrouter/oor

镜像概述

Open Overlay Router（OOR）是开源的可编程覆盖网络实现，可通过Docker容器部署。容器化部署无需在服务器安装OOR的依赖（依赖已内置容器中），能缩短从开发到生产的生命周期，并支持与DevOps工具集成以自动化开发流水线。

核心功能

1. 创建可编程覆盖网络，支持RLOC（路由定位符）和EID（终端标识符）网络配置
2. 提供两种Docker部署方式：环境变量配置（适合简单场景）、共享配置文件（适合灵活场景）
3. 支持Docker Compose定义多容器应用的网络栈
4. 集成Watchtower实现镜像自动更新
5. 支持Macvlan和Bridge两种网络驱动，适配不同网络场景

使用场景

1. 跨服务器部署覆盖网络，实现分布式应用的网络互联
2. DevOps流水线中自动化OOR的部署与更新
3. 多容器应用的网络管理，隔离不同业务的网络流量
4. 测试环境中快速搭建覆盖网络原型

配置说明

网络前提

• Linux服务器需具备至少一个网络接口
• 若使用RLOC网络，需确保接口支持混杂模式（如VMware环境需开启promiscuous mode和forged transmits）

软件前提

• 需联网以拉取镜像
• 安装Docker Engine（参考：[***]
• 可选：安装Docker Compose（参考：[***]

Docker Daemon部署步骤

1. 创建网络

• RLOC网络（建议命名为0rloc）：

bash
sudo docker network create -d macvlan --subnet=<RLOC子网> --gateway=<网关> \
  -o parent=<物理接口> -o macvlan_mode=bridge 0rloc

• EID网络（建议命名为1eid）：

bash
sudo docker network create -d macvlan --subnet=<EID前缀> -o parent=<物理接口> \
  -o macvlan_mode=bridge 1eid

（非物理网卡场景可替换为bridge驱动：sudo docker network create -d bridge --subnet=<EID前缀> <网络名>）

2. 运行容器

• 环境变量方式（需至少定义IPMAPSERVER、KEYMAPSERVER、IPMAPRESOLVER及EID前缀）：

bash
docker create --net=0rloc --ip=<RLOC_IP> --name oor_container -it \
  --device=/dev/net/tun --cap-add=NET_ADMIN --cap-add=NET_RAW \
  --sysctl="net.ipv4.conf.default.rp_filter=0" --sysctl="net.ipv4.conf.all.rp_filter=0" \
  --sysctl="net.ipv4.ip_forward=1" --sysctl="net.ipv6.conf.all.forwarding=1" \
  --sysctl="net.ipv6.conf.all.disable_ipv6=0" \
  -e IPV4EIDPREFFIX="<IPv4_EID/掩码>" -e IPMAPRESOLVER=<MR_IP> \
  -e IPMAPSERVER=<MS_IP> -e KEYMAPSERVER=<密钥> \
  openoverlayrouter/oor:latest

• 共享配置文件方式（配置文件需用绝对路径，且数据库映射使用rloc-address而非rloc-iface）：

bash
docker create --net=0rloc --ip=<RLOC_IP> --name oor_container -it \
  --device=/dev/net/tun --cap-add=NET_ADMIN --cap-add=NET_RAW \
  --sysctl="net.ipv4.conf.default.rp_filter=0" --sysctl="net.ipv4.conf.all.rp_filter=0" \
  --sysctl="net.ipv4.ip_forward=1" --sysctl="net.ipv6.conf.all.forwarding=1" \
  --sysctl="net.ipv6.conf.all.disable_ipv6=0" \
  --mount type=bind,source=<本地配置文件路径>,target=/oor/oor.conf \
  openoverlayrouter/oor:latest

3. 连接EID网络

bash
docker network connect 1eid --ip=<EID_IP> oor_container

4. 容器操作

• 启动：docker start oor_container
• 停止：docker stop oor_container
• 查看日志：docker logs -f oor_container
• 删除：docker rm oor_container

Docker Compose部署

配置文件示例（docker-compose.yml）

yaml
version: "2.3"
services:
  oor:
    image: openoverlayrouter/oor
    cap_add:
      - NET_ADMIN
      - NET_RAW
    sysctls:
      - net.ipv4.conf.default.rp_filter=0
      - net.ipv4.conf.all.rp_filter=0
      - net.ipv4.ip_forward=1
      - net.ipv6.conf.all.forwarding=1
      - net.ipv6.conf.all.disable_ipv6=0
    devices:
      - "/dev/net/tun:/dev/net/tun"
    networks:
      0rloc:
        ipv4_address: <RLOC_IP>
    environment:
      - IPV4EIDPREFFIX="<IPv4_EID/掩码>"
      - IPMAPRESOLVER=<MR_IP>
      - IPMAPSERVER=<MS_IP>
      - KEYMAPSERVER=<密钥>
networks:
  0rloc:
    driver: macvlan
    ipam:
      config:
        - subnet: <RLOC子网>
    driver_opts:
      parent: <物理接口>
      macvlan_mode: bridge
  1eid:
    driver: macvlan
    ipam:
      config:
        - subnet: <EID前缀>
    driver_opts:
      parent: <物理接口>
      macvlan_mode: bridge

命令操作

• 启动：docker-compose up -d
• 查看日志：docker-compose logs
• 停止并清理：docker-compose down