Dashy项目中Glances小工具的API版本兼容性问题解析

问题背景

Dashy是一款开源的仪表盘工具，它支持通过Glances小工具来展示系统监控信息。近期有用户反馈Glances小工具突然停止工作，经过排查发现这是由于Glances API从v3升级到v4版本导致的兼容性问题。

问题分析

Glances是一款跨平台的系统监控工具，它提供了REST API接口供其他应用调用。在最近的更新中，Glances将其API从v3升级到了v4版本，这导致Dashy中原先配置的API端点/api/3/无法正常工作，返回404错误。

当用户手动将URL中的/api/3/改为/api/4/后，可以正常获取到监控数据，这证实了问题的根源在于API版本不匹配。

解决方案

针对这个问题，Dashy开发团队已经发布了修复版本，主要做了以下改进：

1. 将默认API路径从/api/3/更新为/api/4/
2. 修复了部分监控项的数据解析逻辑

用户可以通过以下方式解决问题：

方法一：更新Dashy到最新版本

对于使用Docker部署的用户，只需重新拉取最新镜像并重建容器即可：

docker-compose pull
docker-compose up -d

方法二：手动配置代理

如果更新后仍然遇到跨域问题(CORS)，可以在widget配置中添加useProxy: true参数，让Dashy通过后端代理请求Glances API。

方法三：Nginx反向代理配置

对于使用Nginx Proxy Manager的用户，可以通过以下配置解决CORS问题：

1. 创建自定义location /，指向Glances的IP和端口
2. 在高级设置中添加CORS头：

add_header 'Access-Control-Allow-Origin' *;

注意事项

1. 部分监控项如IP地址、网络流量和CPU温度可能在v4 API中有不同的数据结构，需要额外关注
2. 如果使用WSL环境，可能需要额外配置才能获取CPU温度等传感器数据
3. 建议在更新后检查所有Glances相关widget是否正常工作

总结

API版本升级是软件开发中的常见情况，这次Glances API从v3到v4的升级虽然导致了短暂的兼容性问题，但通过Dashy团队的快速响应和用户的积极反馈，问题得到了及时解决。这也提醒我们在使用依赖外部API的服务时，需要关注其更新日志和变更说明，以便在出现问题时能够快速定位原因。

对于Dashy用户来说，保持软件更新是避免类似问题的最佳实践。同时，了解基本的故障排查方法（如检查浏览器控制台日志）也能帮助快速解决问题。