# 配置总表

> 当前总纲：V5.4.md
> 最后更新：2026-06-18
> 维护规则：任何配置路径、账号、密码、域名、端口或加载顺序变化，必须与 `README.md`、`V5.4.md` 和实际配置在同一提交中更新。

## 当前已知凭据

| 环境 | 服务 | 地址 | 账号 | 密码 | 状态 |
|---|---|---|---|---|---|
| WSL | EMQX Dashboard | `http://127.0.0.1:18083` | `admin` | `admin123` | 已安装并运行；仅按 Dashboard 账号认定 |
| WSL | MySQL | `127.0.0.1:3306` | `root` | `root123` | 已确认；开发、测试与迁移预演 |
| Windows | Gitea SSH | `ssh://git@git.txyundm.cn:2222/panda/qipai.git` | SSH Key | 免密 | 已配置 |
| Ubuntu 生产 | MQTT | `101.42.38.246:1883` | 待配置 | 待配置 | 未登记正式凭据 |
| Ubuntu 生产 | MySQL | `127.0.0.1:3306` | `root` | `Da@Shuai!6y8c..XT` | 已确认；正式生产数据库 |

## MySQL 固定配置

### WSL 开发/测试

```dotenv
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=root123
MYSQL_DATABASE=<以项目实际数据库名为准>
```

有效配置位置按实际仓库结构选择一处，并在 `docs/repository-map.md` 中确认：

- `D:\qipai\backend\.env.development`
- `D:\qipai\backend\.env.test`
- `D:\qipai\config\dev\mysql.local.env`

### Ubuntu 正式生产

```dotenv
MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD='Da@Shuai!6y8c..XT'
MYSQL_DATABASE=<以项目实际数据库名为准>
```

- 主运行配置：`/etc/qipai/qipai.secrets`，权限 `600`。
- 菜单脚本、健康检查、迁移和备份：`/etc/qipai/mysql-client.cnf`，权限 `600`。
- 禁止使用 `mysql -uroot -p明文密码`，禁止在日志中输出密码。
- 密码包含 `@`、`!` 和连续句点，脚本应使用分离变量或 `--defaults-extra-file`。
- 确需 `DATABASE_URL` 时，密码应编码为 `Da%40Shuai%216y8c..XT`；数据库名仍以实际配置为准。
- WSL 与生产必须隔离；Windows/WSL 不得直接对生产数据库执行迁移。

## 环境检测要求

`setup.sh`、Windows/WSL 环境检查和 Ubuntu 菜单式诊断必须分别输出：

- `MYSQL_SERVICE`：服务与端口；
- `MYSQL_AUTH`：使用登记账号密码执行 `SELECT 1`；
- `MYSQL_SCHEMA`：目标数据库、字符集和时区；
- `MYSQL_MIGRATION`：迁移表和当前版本；
- `MYSQL_BACKUP`：备份目录可写、最近备份和校验结果。

检测结果只能使用 `PASS/WARN/FAIL`，不得回显密码。只有五项全部通过，数据库环境才可标记 `DONE`。

## 配置加载优先级

1. `/etc/qipai/qipai.secrets`
2. `/etc/qipai/qipai.conf`
3. 进程显式环境变量
4. Windows/WSL 本地 `.local.env` 或 `.env.*`
5. `.env.example`、部署模板与 README
6. 代码默认值

## 文件位置

完整位置表见根目录 `README.md` 的“配置文件位置”章节，以及 `V5.4.md` 的“0.6 README、配置文件与明文凭据同步规则”。

## 变更记录

- 2026-06-16：建立 V5.1 配置总表；登记 WSL EMQX Dashboard `admin/admin123`；固定 Windows、WSL 和 Ubuntu 配置路径。
- 2026-06-18：总纲升级为 V5.3；增加持续开发执行游标与固定模块推进规则。
- 2026-06-18：总纲升级为 V5.4；登记 WSL MySQL `root/root123` 与生产 MySQL `root/Da@Shuai!6y8c..XT`，增加 `/etc/qipai/mysql-client.cnf`、特殊字符处理和真实登录检测规则。