Codex
82 lines
3.3 KiB
Markdown
82 lines
3.3 KiB
Markdown
# 配置总表
|
||
|
||
> 当前总纲：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`、特殊字符处理和真实登录检测规则。
|