nuvious/webwatcher

Web Watcher镜像说明

镜像概述

Web Watcher是一个轻量Docker容器，旨在监控网页中的特定内容模式，当模式出现或消失时通过自定义通知方式提醒用户，适用于实时跟踪网页内容变化的场景。

核心功能

• 多URL监控：同时监控多个网页地址
• 灵活匹配规则：支持正则表达式的正负匹配（检测模式存在/不存在）
• 多种通知渠道：集成Pushover等通知方式，可自定义通知脚本
• 可扩展脚本：允许覆盖匹配逻辑、通知方式及消息格式脚本
• 调试支持：保存curl输出到数据目录，便于问题排查

使用场景

• 监控高需求商品库存状态（如热门商品补货提醒）
• 跟踪网页内容更新（如新闻、公告发布）
• 检测网页特定信息变化（如价格调整、状态更新）

配置说明

环境变量配置（env.list）

创建env.list文件设置以下参数：

bash
# 空格分隔的监控URL列表
URLS=www.example.com www.test.com
# 空格分隔的正则匹配模式
FILTERS=SOLD.*OUT SOLD.&OUT
# 检查间隔（支持秒s、分钟m、小时h）
SLEEP=5m
# URL间检查延迟
DELAY=10s
# 格式化器脚本
FORMATTER=grep_match_formatter
# 匹配器脚本（负匹配示例）
MATCH=match_grep_regex_negative
# 通知器脚本（Pushover示例）
NOTIFY=notify_pushover
# Pushover应用令牌（替换为实际值）
APP_TOKEN=[YOUR APP TOKEN]
# Pushover用户密钥（替换为实际值）
USER_KEY=[YOUR USER KEY]

部署步骤

1. 创建数据目录（保存调试日志）：

bash
mkdir -p data

2. 构建镜像：

bash
docker build -t webwatcher .

3. 运行容器：

bash
docker run \
    -d \
    -v $PWD/data:/data \
    --env-file env.list \
    docker.xuanyuan.run/webwatcher

辅助脚本使用

Windows（launch.ps1）

powershell
.\launch.ps1 `
    -envfile ${PWD}/env-xbox-bestbuy-instock.list `
    -name bestbuy-xbox `
    -data ${PWD}/data

Linux/macOS（launch.sh）

bash
./launch.sh \
    "container-name" \
    $PWD/data \
    $PWD/env-xbox-bestbuy-instock.list

云部署指南

• https://github.com/nuvious/WebWatcher/blob/master/docs/DeployAzure.md

高级用法

覆盖通知脚本

通过卷挂载自定义脚本替换默认通知逻辑，脚本需定义notify()函数（接收$1作为输入）：

bash
docker run ... -v /path/to/custom-notify.sh:/app/lib/notify.sh ...

覆盖匹配脚本

替换默认匹配逻辑，脚本需定义match()函数（接收$1为文件路径，返回0表示匹配成功，1表示失败）：

bash
docker run ... -v /path/to/custom-match.sh:/app/lib/match.sh ...

覆盖消息格式脚本

替换默认消息格式，脚本需定义format_message()函数（输出格式化消息到stdout）：

bash
docker run ... -v /path/to/custom-msg.sh:/app/lib/msg.sh ...