WGDashboard升级至4.0.2版本后登录异常的解决方案

在Debian 12系统环境下，用户将WGDashboard从2024年5月发布的Hotfix版本升级到4.0.2后，出现了无法登录控制面板的问题。系统日志显示关键错误为"ValueError: Invalid salt"，这表明密码验证过程中出现了盐值校验失败的情况。

问题现象分析

当用户尝试通过Web界面登录时，后台服务抛出以下关键错误：

ValueError: Invalid salt

该错误发生在bcrypt密码校验环节，表明存储的密码哈希值可能已损坏或格式不正确。系统环境为：

• Debian GNU/Linux 12 (bookworm)
• Python 3.11.2
• Linux内核6.6.21-v8+

根本原因

经过技术分析，这是由于数据库中的密码存储结构在升级过程中出现了异常。bcrypt算法生成的密码哈希通常包含：

1. 算法标识符（$2a$, $2b$等）
2. 成本因子
3. 22字符的盐值
4. 31字符的哈希值

在本次案例中，存储的密码哈希可能因升级过程导致部分数据损坏，使得bcrypt无法正确解析盐值部分。

解决方案

对于遇到此问题的用户，可以通过以下步骤修复：

1. 定位WGDashboard安装目录下的配置文件wg-dashboard.ini
2. 修改[Account]段落的用户名和密码配置为默认值：

[Account]
username = admin
password = $2b$12$AX0vFZ5YmZrZacMF2mkY1Ou6n3Jo3b2CNCckhTEcUaPayxSk60B1m

3. 保存文件后重启WGDashboard服务

这个预设的哈希值对应默认密码"admin"，采用bcrypt算法生成，包含完整的盐值和哈希结构。修改后用户可使用admin/admin作为临时凭证登录系统，登录后应立即修改为强密码。

预防措施

为避免类似问题再次发生，建议：

1. 在升级前备份配置文件
2. 考虑实现配置文件的版本迁移机制
3. 对关键配置项增加校验机制