Nexus/docs/changelog/2026-06-05-install-mysql-tcp-probe.md

2026-06-05 — 安装向导 MySQL TCP 检测与 2003 错误说明

摘要

Docker 部署下步骤 3 报 (2003) Can't connect to MySQL server on 'host.docker.internal' 多为宿主机未安装/未启动 MySQL。增加步骤 2 MySQL TCP 探测、init-db 前置 TCP 检查与可读错误文案；README-1panel 补充 1Panel 建库步骤。

动机

外置 MySQL 需用户在 1Panel 应用商店自行安装；原向导步骤 2 不检测 MySQL，步骤 3 直接 pymysql 报错难以理解。

涉及文件

• server/api/install.py — _probe_mysql_installed、init-db TCP 预检
• deploy/README-1panel.md — 1Panel MySQL 安装与验证命令

验证

• 未装 MySQL：步骤 2 显示「未检测到 MySQL」；步骤 3 返回中文说明而非裸 pymysql 栈
• 已装 MySQL：步骤 2 显示可访问；步骤 3 可正常建表