zuohuadong/networkdownload repository overview

docker run zuohuadong/networkdownload

docker run zuohuadong/networkdownload

docker run -e th=10 zuohuadong/networkdownload

docker run -e url_custom=https://your-speedtest-server.com/testfile.bin zuohuadong/networkdownload

# debian/alpine 版本
docker run -e ui="" zuohuadong/networkdownload

# bun 版本
docker run -e ui="" zuohuadong/networkdownload:bun

# 所有版本通用 - 完全禁用日志输出
docker run -e ui=silent zuohuadong/networkdownload

# 或者使用
docker run -e ui=--silent zuohuadong/networkdownload

# 设置速度阈值为 500 KB/s，每 10 分钟测速一次
docker run -e min_speed=500 -e check_interval=600 zuohuadong/networkdownload

# 增加并发测速数量以加快节点评估（适合高带宽网络）
docker run -e benchmark_concurrent=10 zuohuadong/networkdownload

# 限制保留最快的 3 个节点，过滤掉低于 1000 KB/s 的节点
docker run -e top_urls=3 -e min_benchmark_speed=1000 zuohuadong/networkdownload

# 不限制节点数量，保留所有高于平均速度的节点（默认行为）
docker run -e top_urls=0 -e min_benchmark_speed=500 zuohuadong/networkdownload

# 容忍多次慢速检测后再切换节点（适合网络波动环境）
docker run -e slow_threshold=3 zuohuadong/networkdownload

# 调整滑动窗口大小以平滑速度波动（保留最近5次测速）
docker run -e speed_window_size=5 zuohuadong/networkdownload

# 禁用滑动窗口，使用实时速度判断（更敏感）
docker run -e speed_window_enabled=false -e slow_threshold=1 zuohuadong/networkdownload

# 高性能测速：只使用最快节点，快速响应网络变化
docker run \
  -e th=20 \
  -e top_urls=3 \
  -e min_benchmark_speed=1000 \
  -e slow_threshold=1 \
  -e speed_window_enabled=false \
  -e check_interval=300 \
  zuohuadong/networkdownload

# 稳定性优先：保留所有快速节点，容忍短暂波动（推荐）
docker run \
  -e th=10 \
  -e top_urls=0 \
  -e min_benchmark_speed=300 \
  -e slow_threshold=3 \
  -e speed_window_size=5 \
  -e check_interval=600 \
  zuohuadong/networkdownload

# 全面测速：保留所有高于平均速度的节点
docker run \
  -e th=15 \
  -e top_urls=0 \
  -e min_benchmark_speed=200 \
  -e slow_threshold=2 \
  zuohuadong/networkdownload

# ⚠️ 注意：带宽限速功能仅支持 Debian 版本（latest/debian）

# 模拟 10 MB/s 限速环境进行测速 - Debian 版本
docker run -e bandwidth_limit_download=10240 zuohuadong/networkdownload

# 同时限制下载和上传带宽进行测速 - Debian 版本
docker run -e bandwidth_limit_download=10240 -e bandwidth_limit_upload=5120 zuohuadong/networkdownload:debian

# 在限速环境下进行网络测速 - Debian 版本
docker run -e th=10 -e bandwidth_limit_download=20480 -e min_speed=500 zuohuadong/networkdownload:latest

# 启用 Webhook 告警（当网络异常或无可用节点时发送通知）
docker run -e webhook_url=https://your-webhook-endpoint.com/notify zuohuadong/networkdownload

# 自定义 Webhook 配置（最小通知间隔 30 分钟）
docker run -e webhook_url=https://your-webhook-endpoint.com/notify \
  -e webhook_min_interval=1800 \
  zuohuadong/networkdownload

# 只在无可用节点时通知，不在速度过低时通知
docker run -e webhook_url=https://your-webhook-endpoint.com/notify \
  -e webhook_notify_slow=false \
  -e webhook_notify_no_nodes=true \
  zuohuadong/networkdownload

# 结合测速监控使用 Webhook 告警
docker run -e webhook_url=https://your-webhook-endpoint.com/notify \
  -e min_speed=500 \
  -e slow_threshold=3 \
  -e webhook_min_interval=3600 \
  zuohuadong/networkdownload

# 禁用 Webhook 通知
docker run -e webhook_enabled=false zuohuadong/networkdownload

{
  "title": "网络速度异常警告",
  "message": "测速结果持续低于阈值 (平均 180 KB/s < 200 KB/s)，已连续检测 2 次。正在尝试切换测速节点...",
  "level": "warning",
  "hostname": "container-hostname",
  "timestamp": "2025-11-06T12:34:56Z",
  "stats": {
    "total_traffic": "15.23 GB",
    "avg_speed": "5420 KB/s",
    "session_duration": "02:45:30",
    "download_cycles": 33,
    "current_node": "2/5"
  }
}

# 构建 debian 版本
docker build -t networkdownload:debian -f Dockerfile .

# 构建 alpine 版本
docker build -t networkdownload:alpine -f Dockerfile-alpine .

# 构建 bun 版本
docker build -t networkdownload:bun -f Dockerfile-bun .

# 模拟 10 MB/s 限速环境进行测速 - 仅 Debian 版本
docker run -e bandwidth_limit_download=10240 zuohuadong/networkdownload:debian

# 同时限制下载和上传带宽进行测速（下载 10 MB/s，上传 5 MB/s） - 仅 Debian 版本
docker run -e bandwidth_limit_download=10240 -e bandwidth_limit_upload=5120 zuohuadong/networkdownload:latest

# 使用 Docker 网络限流（需要 NET_ADMIN 权限）
docker run --network=my-network \
  --cap-add=NET_ADMIN \
  zuohuadong/networkdownload:alpine

# debian/alpine 版本
docker run -e ui="" zuohuadong/networkdownload

# bun 版本
docker run -e ui="" zuohuadong/networkdownload:bun

测试 10 个节点，结果如下：
  节点 1:  6000 KB/s  ⚡ (远超平均)
  节点 2:  1500 KB/s  ↑ (高于平均)
  节点 3:  1200 KB/s  ↑ (高于平均)
  节点 4:   800 KB/s  → (接近平均)
  节点 5:   600 KB/s  → (接近平均)
  节点 6:   300 KB/s  (低于平均)
  节点 7-10: < 200 KB/s (慢速)

平均速度: 1200 KB/s
过滤阈值: max(200, 1200) = 1200 KB/s

✓ 保留节点 1、2、3（速度 ≥ 1200 KB/s）
✗ 过滤节点 4-10（速度 < 1200 KB/s 或 < 平均值）

结果：只使用真正高速的节点，确保测速准确性

场景 1：最快节点稳定
  节点 #1 (Cloudflare 6000 KB/s) → 持续使用 → 不切换
  结果：流量稳定，速度始终保持在 6 MB/s

场景 2：短暂网络波动（新：智能容错）
  测速 1: 5000 KB/s → 正常
  测速 2: 180 KB/s  → 检测到慢速 [1/2] 继续观察
  测速 3: 5100 KB/s → 速度恢复，重置计数器
  结果：识别出短暂波动，保持在优质节点，避免误判

场景 3：节点持续变慢（新：滑动窗口判断）
  测速 1: 5000 KB/s → 滑动平均: 5000
  测速 2: 180 KB/s  → 滑动平均: 2590 (仍高于阈值) [1/2]
  测速 3: 150 KB/s  → 滑动平均: 1777 (低于阈值) [2/2]
    ↓ 连续 2 次检测到慢速，触发切换
  节点 #2 (Hetzner 5000 KB/s) → 切换成功
  结果：准确识别真正变慢的节点并切换

场景 4：所有快速节点都变慢
  节点 #1, #2, #3 都低于阈值
    ↓ 触发全局重测
  重新测试所有 10 个 URL
    ↓ 发现其他节点变快
  更新为新的最快 3 个节点
  结果：适应网络环境变化，始终使用最优节点

docker run -e url_custom=https://your-cdn.com/file.bin zuohuadong/networkdownload

# 1. 基本配置（最简单）
docker run -e webhook_url=https://your-webhook.com/notify zuohuadong/networkdownload

# 2. 生产环境配置（推荐）
docker run \
  -e webhook_url=https://your-webhook.com/notify \
  -e webhook_min_interval=3600 \
  -e webhook_notify_slow=true \
  -e webhook_notify_no_nodes=true \
  -e min_speed=500 \
  -e slow_threshold=3 \
  zuohuadong/networkdownload

# 3. 仅关键告警（只在无可用节点时通知）
docker run \
  -e webhook_url=https://your-webhook.com/notify \
  -e webhook_notify_slow=false \
  -e webhook_notify_no_nodes=true \
  zuohuadong/networkdownload

# 禁用运行时自动更新
docker run -e url_update_enabled=false zuohuadong/networkdownload

# 自定义更新间隔（每 3 天更新一次）
docker run -e url_update_interval=3 zuohuadong/networkdownload