因为debian 12官方源已用mariadb取代mysql,不提供mysql-server包,直接apt install会报“no installation candidate”错误;必须先安装mysql-apt-config配置官方仓库并选mysql 8.0,再apt update后安装。

直接用 apt install mysql-server 会失败,因为 Debian 12 官方源默认只提供 MariaDB,不包含 MySQL 8.0。 必须先配置 MySQL 官方 APT 仓库,否则找不到包或装上的是旧版/错误分支。
为什么 apt install mysql-server 找不到 MySQL 8.0?
Debian 12 的默认 main 和 contrib 源里没有 MySQL 8.0 的二进制包 —— 它被 MariaDB 取代了。直接运行该命令通常返回 E: Package 'mysql-server' has no installation candidate 或装上的是 mariadb-server。
MySQL 官方维护独立的 APT 仓库,版本号、签名、依赖都与 Debian 自带源隔离。跳过这步就等于没接通“电源”。
- 别信
apt search mysql列出的mysql-client或mysql-common—— 它们可能是兼容层,但无法拉起 MySQL 8.0 服务 - 别尝试
apt install default-mysql-server:这是 MariaDB 的别名,不是 MySQL - 确认方式:安装后执行
mysql --version,输出含MySQL 8.0才算成功;若显示10.11.8-MariaDB就是踩坑了
必须安装 mysql-apt-config 并正确选版本
这个 .deb 包不是 MySQL 本身,而是“APT 源配置器”——它会自动修改 /etc/apt/sources.list.d/mysql.list,告诉 apt 去哪拉取 MySQL 8.0 的包。
关键操作点:
- 下载最新稳定版(2026 年推荐用
mysql-apt-config_0.8.29-1_all.deb,路径见https://repo.mysql.com/apt/debian/pool/mysql-apt-config/m/mysql-apt-config/) - 安装时会弹出 ncurses 界面,用方向键选择:MySQL Server & Cluster → 选择
mysql-8.0(不是mysql-5.7或mysql-advanced) - 按
TAB切换到Ok,回车确认;若二次提示,同样选Ok,不要跳过 - 装完立刻执行
sudo apt update,检查输出里是否出现Hit:...mysql-apt-config...InRelease和Get:...mysql-8.0...Packages
安装后必须运行 mysql_secure_installation
MySQL 8.0 默认启用 caching_sha2_password 插件,且 root 密码在安装过程中**不会强制设置**(Debian 12 的 mysql-community-server 包跳过了交互式密码设置)。直接 mysql -u root -p 会报错 Access denied for user 'root'@'localhost'。
补救步骤:
- 先用
sudo mysql(无密码)登录,然后执行:ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的强密码'; - 更稳妥的做法是立即运行
sudo mysql_secure_installation:它会引导你设置 root 密码、禁用匿名用户、删除 test 数据库、禁用远程 root 登录(安全起见) - 注意:该脚本默认不允许空密码,也不接受简单密码(如
123456),需满足大小写字母+数字+特殊字符 - 如果已改过认证插件,后续连接客户端(如 DBeaver、Navicat)时需在连接参数里显式指定
defaultAuthenticationPlugin=mysql_native_password
验证服务状态和基础连通性
安装完成≠可用。常见静默失败点是服务未启动、防火墙拦截、或 bind-address 锁死本地。
- 检查服务:运行
systemctl is-active mysql,返回active才算真正跑起来了;若为inactive,手动sudo systemctl start mysql - 检查监听:
ss -tlnp | grep :3306应看到127.0.0.1:3306或*:3306;若只有127.0.0.1,远程无法访问(需改/etc/mysql/mysql.conf.d/mysqld.cnf中的bind-address) - 测试登录:用
mysql -u root -p输入刚设的密码,能进mysql>提示符即通过 - 别忽略日志:
sudo tail -20 /var/log/mysql/error.log,任何启动失败都会在这里留下线索,比如Can't start server: Bind on TCP/IP port表示端口冲突
最常被跳过的其实是 mysql_secure_installation 和 bind-address 检查 —— 很多人以为装完就能连,结果卡在权限或网络层,来回折腾半天才发现根本没跑起来或只听本地。











