KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

netcup-monitor

★ 35 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 📊 Netcup Monitor Pro

**专为 Netcup RS/VPS 打造的智能化流量监控与自动化流控面板**

---

## 📖 项目简介

**Netcup Monitor Pro** 解决了 Netcup 用户最大的痛点：**限速（Throttling）后的自动化处理,保证服务器以最快的速度恢复高速状态**。

不同于普通的监控脚本，本项目通过对接 Netcup 官方全新 **SCP REST API**（基于 Keycloak OAuth2/OIDC 认证）精准识别服务器状态。当检测到限速时，它能自动指挥 **qBittorrent** 和 **Vertex** 进行精细化的流量规避，保证服务器快速恢复高速状态，并在限速解除后自动恢复生产，实现真正的“无人值守”。

### 🛡️ 智能流控策略
* **HR 智能保护**：限速期间，对 **下载中** 的 HR 种子自动暂停，对 **做种中** 的 HR 种子限制上传速度（保种模式），防止因删种导致 HR 考核失败。
* **分类管理**：
    * **保留分类 (Keep)**：限速时仅暂停任务，保留文件。
    * **自动清理**：非保留、非 HR 分类的种子，在限速时自动删除以释放空间。
* **自动恢复**：检测到限速解除（恢复高速）后，自动恢复所有暂停任务并解除速度限制。
* **停机看门狗**：智能识别断点与监控停机时间，防止虚假累计限速时长。

### 📊 双轨流量监控与高精统计
* **双轨数据并轨**：同时呈现 **Netcup 官方网卡月度计费流量** (`rxMonthlyInMiB` / `txMonthlyInMiB`) 与 **qBittorrent PT 做种流量**，偷跑流量一目了然。
* **Delta 异常穿透保护**：重构流量增量计算引擎，彻底解决 qB 重启或计数器重置导致的虚假暴增与负值穿透。
* **趋势大屏**：内置 7 日流量消耗与限速健康度折线分析图表。

### 🚀 高性能并发与安全架构
* **并发巡检引擎**：基于多线程并发检测所有 VPS 实例与 qB 状态，巡检耗时压缩至秒级。
* **安全加固**：管理员登录采用加盐哈希 (PBKDF2) 与 IP 防暴力破解保护。
* **数据库自愈维护**：复合索引加速查询，每日凌晨自动修剪旧日志并压缩数据库体积。

### 🔔 即时事件告警与多渠道通知
* **秒级突发告警**：限速触发与解除恢复时秒级即时推送，详细汇报流控动作。
* **定时健康简报**：支持自定义简报周期（1/3/6/12/24小时），与突发告警互不干扰。
* **通知渠道**：支持 Telegram Bot、企业微信 Webhook、企业微信应用（App）。

### 🔗 生态联动与一键诊断
* **Vertex 深度集成**：根据限速状态动态更新 Vertex 的 RSS 下载规则，确保任务只分发给未限速的机器。
* **qBittorrent 全管**：支持多实例管理，面板内置一键测试 qB 连通性与诊断工具。

<h2 id="logic">🧠 自动化策略逻辑</h2>

系统每 5 分钟（默认）检测一次状态，根据 Netcup API 返回的 `trafficThrottled` 状态执行以下逻辑：

推荐使用 Docker Compose 进行一键部署。

### 1. 准备工作
确保服务器已安装 Docker 和 Docker Compose。

### 2. 配置文件
创建目录并编写 `docker-compose.yml`：

~~~bash
mkdir -p /root/netcup-monitor/data
cd /root/netcup-monitor
nano docker-compose.yml
~~~

填入以下内容：

~~~yaml
version: '3.8'

services:
  netcup-monitor:
    image: ghcr.io/agonie0v0/netcup-monitor:latest
    container_name: netcup-monitor
    restart: unless-stopped
    # 端口映射 (宿主机端口:容器端口)
    ports:
      - "5000:5000"
    volumes:
      # 数据与配置文件持久化
      - ./data:/app/data
      # 宿主机时间同步
      - /etc/localtime:/etc/localtime:ro
      # (可选) 若需自动重启 Vertex 容器，必须挂载此 Socket
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
~~~

### 3. 启动服务

~~~bash
docker compose up -d
~~~
访问面板：`http://你的IP:5000`

### 4. 容器更新

~~~bash
# 步骤 1: 强制拉取最新的镜像版本

cd /root/netcup-monitor

docker compose pull

# 如果拉取失败: 先注销 ghcr.io

docker logout ghcr.io

# 重新拉取

docker compose pull

# 步骤 2: 停止旧容器，使用最新镜像重新创建并启动
docker compose up -d --force-recreate
~~~

首次访问点击右上角 **“登录”**（默认admin），进入设置页面。

### 1. 基础连接
* **qBittorrent 设置**：填写 QB 的地址、账号、密码。
* **Vertex 设置**：
    * **API 地址**：Vertex 的访问地址。
    * **容器名**：如果 Vertex 和本服务在同一台机器，填写 Vertex 的容器名（如 `vertex`）可实现自动重启。
    * **监控 RSS ID**：在 Vertex 规则列表中找到需要动态管理的规则 ID（如 `4c145005`），多个 ID 用逗号分隔。

### 2. Netcup SCP 账号 (核心)
在“SCP 账号”标签页添加账号。
* **Customer ID**：Netcup 客户号（数字）。
* **Password**：登录 SCP 面板的密码。

> 🔒 **安全提示**：密码仅保存在本地 `data/config.json` 中，通过 Docker 隔离，不会上传第三方。

### 3. 策略管理
* **保留分类 (Keep Categories)**：填写分类名，如 `Keep, FRD`。这些分类下的种子在限速时只会暂停，不会被删除。
* **HR 保护分类**：填写如 `HR, VIP`。
* **限速上传限制**：设置限速期间 HR 种子的最大上传速度（KB/s），防止长时间无流量被站点判定为不再做种。

### 4. 实例配置 (Servers)
添加你需要监控的 VPS 实例：
* **名称**：自定义别名。
* **IP 地址**：必须与 Netcup 后台显示的 IP 一致（用于匹配 API 数据）。
* **Client ID**：对应 Vertex 中下载器的ID（用于更新 RSS 规则）。
* **不托管 (Unmanaged)**：开启后，脚本只监控流量和状态，**不执行**任何删除、暂停操作。

## 📸 界面预览
### 仪表盘
<img width="1545" height="1271" alt="PixPin_2025-12-26_20-46-59" src="https://github.com/user-attachments/assets/bf7658c7-9805-4866-b962-9d177f6e50e4" />

### 流量统计
<img width="1534" height="1253" alt="PixPin_2025-12-26_20-46-34" src="https://github.com/user-attachments/assets/ebb135bf-4af8-4932-ae21-6101ecf23bb0" />

1.  **数据安全**：本项目涉及对 qBittorrent 种子的 **删除** 操作。请务必正确配置 “保留分类” 及 “不托管” 选项。
2.  **账号安全**：Netcup 账号密码存储在你的服务器本地，请确保服务器安全。
3.  **责任界定**：作者不对因使用该项目导致的数据丢失或账号问题负责。
4.  **项目更新**：懒得更新，如果需要可以自己fork仓库修改。

---

<div align="center">
    Project maintained by <a href="https://github.com/agonie0v0">懒羊羊
</div>

netcup-monitor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README