# 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 可正常建表
