WGDashboard 内存泄漏问题分析与解决方案

问题现象描述

WGDashboard 用户报告了一个严重的内存泄漏问题：当在界面中点击"添加对等节点"对话框的"取消"按钮时，系统资源会被迅速耗尽。具体表现为：

1. Python 进程内存占用急剧上升至 750MB 以上
2. 容器资源使用率接近 100%
3. 系统响应变慢甚至完全卡死
4. 只有强制终止 WGDashboard 进程才能恢复系统正常运行

问题复现环境

多位用户在不同环境中复现了该问题：

• 操作系统：Debian Bookworm、Ubuntu 24.04 LTS 等
• Python 版本：3.11.2
• 硬件配置：1 核 CPU、512MB 内存的容器环境
• 浏览器：Google Chrome 125
• WGDashboard 版本：v3.0.6.2

根本原因分析

经过开发者调查和用户反馈，发现该问题与以下因素相关：

1. IP地址配置：当网络接口配置中包含特定地址格式时（如 fdXX:XX:XX::1/64），点击取消按钮会触发内存泄漏；仅配置常规地址时则不会出现此问题。

2. 后端处理逻辑：当前版本的 WGDashboard 采用后端集中处理模式，当处理大量对等节点时会产生较高的内存开销。

3. 前端交互问题：特定浏览器环境下，"取消"操作未能正确终止某些后台进程。

解决方案

开发者提供了以下解决方案：

1. 临时解决方案：

   • 暂时移除配置中的特定地址格式
   • 使用 sudo ./wgd.sh debug 命令以调试模式运行，观察具体错误

2. 长期解决方案：

   • 升级到 WGDashboard v4.0 beta 版本（git clone -b v4.0.beta3）
   • v4 版本重构了架构，将大量功能迁移到前端，后端仅作为 REST API

3. 配置优化：

   • 为容器分配更多内存资源（至少 1GB）
   • 监控 Python 进程内存使用情况

技术建议

对于使用 WGDashboard 的管理员，建议：

1. 定期检查系统资源使用情况
2. 考虑升级到最新稳定版本
3. 复杂网络环境下优先使用常规配置
4. 在生产环境中使用性能监控工具

该问题已在后续版本中得到修复，用户可关注项目更新获取最新解决方案。对于仍遇到此问题的用户，建议提供详细的配置信息和错误日志以便进一步分析。