xavierh/external-ip

外部IP监控Docker镜像

镜像概述和主要用途

该Docker容器通过DIG命令从OpenDNS、Cloudflare或Google等服务获取外部IP地址，并支持按自定义计划定期检查。当IP地址发生变化时，可通过Pushover或Apprise发送警报通知，适用于需要监控动态IP变更的场景。

核心功能和特性

• 多来源IP获取：支持通过Cloudflare、Google或OpenDNS获取外部IP
• 自定义检查频率：可设置检查间隔（秒、分钟、小时或天）
• 变更警报：IP地址变化时发送通知
• 恢复警报：网络恢复或重新获取IP时可发送恢复通知（可选）
• 多通知方式：支持Pushover直接集成和Apprise多平台通知（最多10个通知端点）
• 多架构支持：兼容linux/amd64、linux/arm/v7和linux/arm64/v8架构

使用场景和适用范围

• 家庭服务器或NAS设备的动态IP监控
• 需要实时了解公网IP变更的远程访问场景
• 网络故障恢复通知
• 多平台通知需求的IP监控场景

使用方法和配置说明

Docker镜像信息

• 镜像地址：https://hub.docker.com/r/xavierh/external-ip
• 支持架构：
  • linux/amd64
  • linux/arm/v7
  • linux/arm64/v8
• 标签：latest（稳定版）
• 项目仓库：https://github.com/xavier-hernandez/docker-external-ip

Docker Compose配置示例

Pushover通知配置

yml
external_ip:
    image: xavierh/external-ip:latest
    container_name: external_ip
    restart: always
    environment:
        - TZ=America/New_York
        - RECOVERY_ALERT=True/False  # 可选，默认False
        - DELAY=5m  # 可选，默认5分钟
        - PROVIDER=CLOUDFLARE  # 可选，默认CLOUDFLARE
        - NOTIFICATION_TYPE=PUSHOVER  # 可选
        - PUSHOVER_TOKEN=your_pushover_token  # 必选（使用PUSHOVER时）
        - PUSHOVER_USER=your_pushover_user  # 必选（使用PUSHOVER时）
        - PUSHOVER_TITLE=自定义标题  # 可选，默认"EXTERNAL IP"

Apprise通知配置

yml
external_ip:
    image: xavierh/external-ip:latest
    container_name: external_ip
    restart: always
    environment:
        - TZ=America/New_York
        - RECOVERY_ALERT=True/False  # 可选，默认False
        - DELAY=5m  # 可选，默认5分钟
        - PROVIDER=CLOUDFLARE  # 可选，默认CLOUDFLARE
        - NOTIFICATION_TYPE=APPRISE  # 可选
        - APPRISE_TITLE=自定义标题  # 可选，默认"EXTERNAL IP"
        - APPRISE_1=pover://user@token  # 必选（使用APPRISE时）
        - APPRISE_2=pushed://appkey/appsecret/  # 可选
        - APPRISE_3=discord://webhook_id/webhook_token  # 可选
        # 最多支持10个通知端点：APPRISE_1至APPRISE_10

配置参数说明

日志示例

Starting...
Setting sleep delay...
IP: 00.00.00.00 [CHANGE]

Sending pushover message...
{"status":1,"request":"gfdgdf-gdfg-gdfgd-dfgd-fgdfgd"}

IP: 00.00.00.00
dig: couldn't get address for 'ns1.google.com': not found

[Error or Invalid IP address]
dig: couldn't get address for 'ns1.google.com': not found

[Error or Invalid IP address]
IP: 00.00.00.00 [RECOVERY]
IP: 00.00.00.00
IP: 00.00.00.01 [CHANGE]

Sending pushover message...
{"status":1,"request":"gfdgdf-gdfg-gdfgd-dfgd-fgdfgd"}

IP: 00.00.00.01