intermedia/loopbackip

镜像概述

本镜像旨在为容器内的回环接口（loopback）分配IP地址，支持从指定文件读取IP列表并动态更新配置，适用于需要在回环接口绑定多个IP的场景。

核心功能

1. 从/loopback_ip.txt文件读取IP地址（每行一个）并分配到回环接口；
2. 接收SIGHUP信号时重新加载IP配置；
3. 需启用NET_ADMIN权限及特定系统参数以确保功能正常。

使用场景

• 测试环境中需要为本地服务绑定多个回环IP；
• 容器内应用需模拟多IP访问场景；
• 开发调试时需要快速切换回环IP配置。

配置说明

运行镜像时需满足以下条件：

• 添加NET_ADMIN权限：--cap-add NET_ADMIN；
• 设置sysctl参数：

  yaml
  sysctls:
    net.ipv4.conf.lo.arp_announce: 2
    net.ipv4.conf.lo.arp_ignore: 3
  

部署示例

Docker Run命令

bash
docker run \
  --cap-add NET_ADMIN \
  --sysctl net.ipv4.conf.lo.arp_announce=2 \
  --sysctl net.ipv4.conf.lo.arp_ignore=3 \
  -v /本地路径/loopback_ip.txt:/loopback_ip.txt \
  intermedia/loopbackip

Docker Compose示例

yaml
version: '3'
services:
  loopbackip:
    image: intermedia/loopbackip
    cap_add:
      - NET_ADMIN
    sysctls:
      net.ipv4.conf.lo.arp_announce: 2
      net.ipv4.conf.lo.arp_ignore: 3
    volumes:
      - ./loopback_ip.txt:/loopback_ip.txt

单元测试

bash
# 构建镜像并运行测试
docker build -t intermedia/loopbackip . && docker build -t loopbackip:pytest tests
docker run --cap-add=NET_ADMIN loopbackip:pytest

# 远程调试（需pydev支持）
docker run --rm --cap-add=NET_ADMIN -e PYDEV_IP=10.9.3.185 -e PYDEV_PORT=4444 loopbackip:pytest