diff --git a/docs/guide/oneclickvirt/images/edituser.png b/docs/guide/oneclickvirt/images/edituser.png new file mode 100644 index 0000000000..f912253995 Binary files /dev/null and b/docs/guide/oneclickvirt/images/edituser.png differ diff --git a/docs/guide/oneclickvirt/images/resetuserpassword.png b/docs/guide/oneclickvirt/images/resetuserpassword.png new file mode 100644 index 0000000000..95e17bf0dd Binary files /dev/null and b/docs/guide/oneclickvirt/images/resetuserpassword.png differ diff --git a/docs/guide/oneclickvirt/images/resetuserpasswordsuccess.png b/docs/guide/oneclickvirt/images/resetuserpasswordsuccess.png new file mode 100644 index 0000000000..54e60d78cb Binary files /dev/null and b/docs/guide/oneclickvirt/images/resetuserpasswordsuccess.png differ diff --git a/docs/guide/oneclickvirt/images/switch.png b/docs/guide/oneclickvirt/images/switch.png new file mode 100644 index 0000000000..c557fb69a4 Binary files /dev/null and b/docs/guide/oneclickvirt/images/switch.png differ diff --git a/docs/guide/oneclickvirt/oneclickvirt_qa.md b/docs/guide/oneclickvirt/oneclickvirt_qa.md index ffe9b18be6..28d147676e 100644 --- a/docs/guide/oneclickvirt/oneclickvirt_qa.md +++ b/docs/guide/oneclickvirt/oneclickvirt_qa.md @@ -4,6 +4,60 @@ outline: deep # 如有问题请反馈对应仓库 +## 忘记了管理员密码怎么办 + +需要通过数据库操作强行更改密码 + +1. 生成密码哈希 + +```bash +# 使用 Python 生成(将 NewPassword123! 替换为您的新密码) +python3 -c "import bcrypt; print(bcrypt.hashpw(b'NewPassword123!', bcrypt.gensalt()).decode('utf-8'))" +``` + +输出示例:`$2b$12$xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` + +2. 进入数据库 + +**Docker 部署(一体化版本):** +```bash +docker exec -it oneclickvirt mysql -u root oneclickvirt +``` + +**独立数据库部署:** +```bash +mysql -h 127.0.0.1 -P 3306 -u root -p oneclickvirt +``` + +3. 更新密码 + +```sql +-- 查看管理员账户 +SELECT id, username, user_type FROM users WHERE user_type = 'admin'; + +-- 更新密码(替换为第1步生成的哈希值) +UPDATE users +SET password = '$2b$12$xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' +WHERE username = 'admin'; + +-- 退出 +EXIT; +``` + +4. 登录测试 + +使用新密码登录系统验证。 + +**注意事项** + +- 哈希值必须以 `$2a$`、`$2b$` 或 `$2y$` 开头 +- 默认管理员用户名为 `admin`,可通过查询确认 +- 建议使用强密码(≥8位,含大小写字母、数字、特殊字符) +- 修改前建议备份数据库: + ```bash + docker exec oneclickvirt mysqldump -u root oneclickvirt > backup.sql + ``` + ## Docker如何删除持久化的数据库和存储卷 删除对应的容器后 diff --git a/docs/guide/oneclickvirt/oneclickvirt_usage.md b/docs/guide/oneclickvirt/oneclickvirt_usage.md index 94b110b354..2174f036b3 100644 --- a/docs/guide/oneclickvirt/oneclickvirt_usage.md +++ b/docs/guide/oneclickvirt/oneclickvirt_usage.md @@ -10,12 +10,18 @@ outline: deep 登录进入管理员界面后,打开用户管理页面后,必须点击重置密码,以确保admin账户的密码为强密码,确保不会被恶意爆破。如果初始化的时候,你使用了自行定义的密码,那么不重置密码也可以。 +![](./images/resetuserpassword.png) + 重置密码会自动生成强密码,仅展示一次,务必复制保存好,避免遗忘。 -(如果忘记了密码,需要通过数据库操作强行更改密码,占位施工) +![](./images/resetuserpasswordsuccess.png) + +![](./images/edituser.png) 如果需要更改用户的类型,就需要点击对应用户进行编辑,编辑的弹窗支持更改用户类型。 +![](./images/switch.png) + 管理员可以点击右上角头像,下拉栏目中有切换管理员和普通用户视图的按钮,如果需要测试任何功能,可以直接使用管理员用户测试。(普通用户没有这个视图切换按钮) ## 纳管节点