轻量安全的下载状态监控

基于 NZBGet JSON-RPC API 的下载状态监控工具，通过环境变量安全配置凭证，快速获取 Usenet 下载队列、速度及进度信息，适合个人 NAS 用户实时掌握下载动态。

基本信息

• 技能名称?nzbget
• 中文名称?轻量安全的下载状态监控
• 作者?aricus
• 分类?效率
• 版本?v1.0.1
• 标签?automation, content-media, backend, devops

使用方法

使用说明
核心用法
NZBGet Status Checker 是一款轻量级的 Usenet 下载监控技能，通过调用 NZBGet 的 JSON-RPC API 实现远程状态查询。用户需预先配置三个环境变量（NZBGET_HOST、NZBGET_USER、NZBGET_PASS），即可通过四种模式获取信息：
count 模式 ：快速返回当前活跃下载数量，适合自动化脚本或简洁查询
speed 模式 ：获取实时下载速度（MB/s）
queue 模式 ：列出队列前 10 个项目的名称与进度
默认模式 ：完整状态报告，包含活跃任务数、速度、剩余容量及队列详情
脚本采用 Bash 编写，依赖 curl 发起 HTTP 请求、jq 解析 JSON、bc 处理数值计算，输出经过格式化设计，兼顾机器可读性与人工阅读体验。
显著优点

1. 配置安全 ：凭证完全通过环境变量注入，源码中零硬编码，避免敏感信息泄露风险
2. 功能聚焦 ：单一职责设计，仅读取状态不执行任何写操作，行为边界清晰可控
3. 输出节制 ：队列展示强制限制 10 条，防止大队列（400+ 项目）导致信息过载
4. 错误完备 ：包含环境变量校验、网络不可达处理、空值检查等多重防护
5. 即开即用 ：无复杂依赖，主流 Linux/macOS 系统预装工具即可运行
   潜在缺点与局限性
   协议明文 ：当前仅支持 HTTP，凭证与数据在传输层无加密，存在网络嗅探风险
   网络限定 ：设计初衷为内网场景，公网部署需配合 VPN 或反向代理
   依赖外部 ：要求目标系统预装 curl、jq、bc，极简容器环境可能缺失
   功能只读 ：无法执行暂停、删除、优先级调整等管理操作，纯监控定位
   无超时配置 ：curl 默认超时较长，NZBGet 不可达时响应延迟不可控
   适合的目标群体
   NAS/Homelab 用户 ：运行 NZBGet 下载服务的个人服务器管理者
   自动化爱好者 ：需要将下载状态集成到通知系统或仪表盘的进阶用户
   Usenet 轻度用户 ：希望快速查看下载进度，无需登录 NZBGet Web 界面的便捷需求者
   多设备协同场景 ：通过聊天机器人或语音助手远程查询下载状态的智能家居用户
   使用风险
   性能风险 ：NZBGet 服务响应慢或不可达时，脚本可能挂起至 curl 超时
   依赖风险 ：jq 或 bc 未安装时脚本直接失败，需提前确保环境完备
   信息泄露风险 ：HTTP 明文传输下，同一局域网内的恶意嗅探可捕获 API 凭证
   误报风险 ：NZBGet 认证失败时返回的 JSON 结构可能与预期不符，导致解析异常