2026.10.08
DOCSight：把有线网络故障整理成可核查的时间线
DOCSight 是面向 DOCSIS 用户的自托管证据系统，可汇总信号、测速、延迟、事件和笔记，并生成本地报告。它适合反复遭遇有线网络异常、需要向 ISP 说明问题的人，但部署前应确认调制解调器兼容性并审查导出内容。
它解决什么问题
DOCSight 面向经常遇到有线宽带掉线、晚间变慢、延迟或丢包异常的用户。项目把 DOCSIS 信号历史、测速、延迟、调制解调器事件和个人笔记放在同一条时间线上，帮助用户判断某次问题是孤立现象，还是在多个指标上反复出现。它的重点不是替用户修复线路，而是把零散截图和口头描述整理成可复核的记录。
项目采用 MIT License，并以自托管方式运行。官方页面强调，监控历史和生成的报告保存在用户自己的设备上；可选集成由用户自行配置。不过“本地”不等于可以直接分享所有文件：官方文档提醒，导出内容可能含有连接详情和事件笔记，因此发送给 ISP 前需要人工检查。
图片来源：docsight。项目公开截图，界面可能随版本变化。
已知功能
README 列出的核心界面包括实时仪表板、信号趋势、连接监控、事件日志和事件记录。用户可以持续观察延迟、丢包、断线、路由检查和原始 ping 日志，也可以记录附件、导入数据和事件分组。证据流程支持选择事件或时间窗口，查看证据是否缺失或过期，并生成包含信件文本、清单和 PDF 的投诉材料。
项目还提供信号、速度和事件的关联分析，以及维修或 ISP 变更前后的对比。外部数据方面，README 提到 Speedtest、BQM、SmokePing、BNetzA 测量、Home Assistant、通知、备份恢复和 API 令牌等功能。界面支持多语言、明暗主题及 PWA/离线使用；具体集成仍取决于相应服务和配置。
图片来源：docsight。项目公开截图，界面可能随版本变化。
适合谁
它最适合拥有受支持有线调制解调器、愿意长期保存数据，并需要与 ISP 沟通反复故障的家庭用户、技术爱好者和 homelab 使用者。已经使用测速或延迟监控工具的人，也可以把 DOCSight 作为本地 DOCSIS 信号和投诉材料层，而不是把它当作单纯的在线率监控器。
如果需求只是 HTTP 可用性告警、公共状态页或托管云服务，DOCSight 可能并不匹配。Generic Router 模式虽然支持光纤、DSL 和卫星连接的测速、延迟、笔记与报告，但没有 DOCSIS 信号数据；项目的主要价值仍在有线线路证据。
部署前的限制
首先要核对硬件。README 列出 22 个调制解调器系列，但不同设备使用的接口并不相同；PYUR FAST3896-15 驱动仍在 main，尚未进入标记版本，因此不应与稳定发布版支持混为一谈。README 提到的信号健康和 SC-QAM 容量估计描述的是物理或信道层，不是互联网吞吐量或套餐速率。
其次要选择版本策略。README 的 Docker 示例使用 stable；latest 跟随 main，可能包含尚未发布的变更。官方 v2026-09-16.1 release 还记录了 CGA 设备慢响应修复，并明确列出若干 API 变更。需要自定义集成的人应先检查发布说明，而不是默认认为升级不会影响接口。
最后是持续运行条件和数据治理。Docker 需要一个正在运行的 Docker 引擎；持续监控还需要长期在线的主机、可访问的调制解调器以及可靠的数据卷备份。官方资料没有在所给来源中确认最低硬件配置、完整兼容性边界或任何 ISP/法律结果。可以先使用合成数据演示评估工作流，再连接真实设备；但演示数据不能证明真实线路会获得同样结果。
资料来源
资料核对日期：2026-10-08