Speedtest-Tracker 项目中"Started但未Completed"问题的分析与解决

问题背景

Speedtest-Tracker 是一个基于 Docker 的网络测速工具，它通过定期执行 Ookla Speedtest 来监控网络性能。近期用户反馈了一个常见问题：测速结果显示为"Started"状态，但很少或从未达到"Completed"状态。

问题根源分析

经过技术团队调查，发现该问题主要由以下几个因素导致：

1. 服务器不可用：用户配置的 Speedtest 服务器 ID 可能已经失效或不再提供服务。Ookla 的服务器列表会定期更新，某些服务器可能被移除或暂时下线。

2. 错误处理不完善：当 Speedtest CLI 遇到无效服务器时，应用程序未能正确处理错误状态，导致测试卡在"Started"阶段。

3. 网络限制：部分案例中，容器的出站连接被网络策略阻止（特别是 TCP/8080 端口），导致测试无法完成。

解决方案

1. 验证并更新服务器列表

用户应检查当前配置的服务器是否仍然有效。可以通过以下方法获取最新可用的服务器列表：

• 访问 Ookla 提供的官方服务器列表页面
• 选择地理位置靠近的稳定服务器
• 避免使用单一服务器，配置多个备选服务器

2. 配置最佳实践

在 docker-compose 配置中，建议：

environment:
  - SPEEDTEST_SERVERS=52770,44081  # 替换为已验证的有效服务器ID
  - SPEEDTEST_SCHEDULE='*/15 * * * *'  # 每15分钟测试一次

3. 错误处理改进

开发团队已在最新版本中改进了错误处理机制：

• 当服务器不可用时，测试将明确失败而非卡在"Started"状态
• 增加了更详细的错误日志记录
• 实现了服务器列表的自动验证功能

技术细节

当 Speedtest-Tracker 执行测试时，其工作流程如下：

1. 应用程序根据配置的服务器ID启动测试
2. Speedtest CLI 尝试连接指定服务器
3. 如果服务器不可用，旧版本会静默失败，新版本会抛出明确错误
4. 有效的测试结果会被记录并显示为"Completed"

用户操作指南

对于遇到此问题的用户，建议采取以下步骤：

1. 更新到 Speedtest-Tracker 的最新版本
2. 检查并更新服务器ID配置
3. 验证容器网络连接，确保出站连接未被阻止
4. 监控日志以获取更详细的错误信息

结论

"Started但未Completed"问题主要源于服务器配置问题，通过更新服务器列表和升级到最新版本可以有效解决。Speedtest-Tracker 团队持续改进错误处理机制，为用户提供更稳定的网络性能监测体验。对于高级用户，建议定期检查服务器可用性并配置多个备用服务器以提高测试成功率。

该问题的解决体现了开源社区协作的价值，用户反馈与开发者响应共同促成了产品质量的提升。