nzbget

核心用法

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 结构可能与预期不符，导致解析异常