mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-06-07 13:44:24 +00:00
32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
|
# 任务记录：uninstall-mariadb-option
|
|||
|
|
|
|||
|
|
- 日期：2026-04-15
|
|||
|
|
- 关联模块：x-ui uninstall flow / database cleanup / test script
|
|||
|
|
- 变更类型：优化
|
|||
|
|
|
|||
|
|
## 背景
|
|||
|
|
卸载流程原先只移除面板服务与文件，不处理 MariaDB 业务库、业务账号和本机 MariaDB 包，用户在希望彻底清理时需要手动处理。
|
|||
|
|
|
|||
|
|
## 修改内容
|
|||
|
|
- 在 `x-ui.sh` 的 `uninstall()` 中新增交互项：`是否删除数据库并卸载本机 MariaDB？`。
|
|||
|
|
- 当当前数据库类型为 MariaDB 且 host 为本机地址（`127.0.0.1`/`localhost`/`::1`）时：
|
|||
|
|
- 删除业务库与业务账号（`localhost`、`127.0.0.1`、`::1`）。
|
|||
|
|
- 卸载本机 MariaDB 服务与相关软件包。
|
|||
|
|
- 当数据库为远程 MariaDB 时，输出提示并跳过数据库删除与卸载，避免误删远程资源。
|
|||
|
|
- 新增 `remove_local_mariadb_data` 与 `uninstall_local_mariadb_packages` 两个函数。
|
|||
|
|
- 更新 `tests/mariadb_install_switch_test.sh`，增加新卸载逻辑关键文本断言。
|
|||
|
|
|
|||
|
|
## 影响范围
|
|||
|
|
- 影响文件：`x-ui.sh`、`tests/mariadb_install_switch_test.sh`。
|
|||
|
|
- 不影响面板安装流程、数据库切换流程、数据库结构。
|
|||
|
|
- 仅在卸载流程中新增可选数据库清理能力。
|
|||
|
|
|
|||
|
|
## 验证情况
|
|||
|
|
- 执行 `bash -n x-ui.sh`，通过。
|
|||
|
|
- 执行 `bash -n install.sh`，通过。
|
|||
|
|
- 执行 `bash tests/mariadb_install_switch_test.sh`，通过。
|
|||
|
|
|
|||
|
|
## 风险与后续
|
|||
|
|
- 用户若选择删除数据库，相关业务数据将不可恢复。
|
|||
|
|
- 后续可增加二次确认，显示将删除的数据库名和用户名，以进一步降低误操作风险。
|