群晖Container Manager图形界面部署MySQL 8.0大概率失败，因缺认证插件、字符集、挂载权限等关键配置入口；必须手动补全MYSQL_ROOT_PASSWORD（非空无特殊字符）、严格挂载/volume1/docker/mysql8/data→/var/lib/mysql、指定端口映射、挂载custom.cnf至/etc/mysql/conf.d启用utf8mb4及远程访问，并创建%用户、放行防火墙。
直接用群晖 Container Manager 图形界面部署 MySQL 8.0 容器，大概率启动失败或连不上——不是镜像问题，而是界面缺关键配置入口，比如认证插件、字符集、挂载权限控制等。必须手动补全环境变量、挂载路径和配置文件，否则容器会秒退或卡在 Initialization of mysqld failed。
为什么容器启动后立刻退出？
根本原因就三个硬性条件没满足：
-
MYSQL_ROOT_PASSWORD没设，或值为空、含$、@、#等特殊字符 —— DSM 界面会截断或转义，日志只报error: database is uninitialized - 宿主机路径（如
/volume1/docker/mysql8/data）没映射到容器内/var/lib/mysql—— 映射成/data或/mysql都无效，MySQL 8.0 镜像硬编码该路径 - 端口映射选了“自动” —— DSM 会随机分一个高位端口（如
32768），但 Navicat、Java 应用默认只连:3306，根本找不到服务
必须挂载的两个路径怎么配？
图形界面里“存储空间”设置要填两处，缺一不可：
- 数据目录：宿主机路径填
/volume1/docker/mysql8/data，装载路径必须是/var/lib/mysql（不能少斜杠、不能换名） - 配置目录：宿主机路径填
/volume1/docker/mysql8/conf，装载路径填/etc/mysql/conf.d（不是/etc/mysql/my.cnf！后者被忽略） - 注意：NAS 上这两个文件夹必须提前建好，并在「控制面板 → 共享文件夹」里对“所有人”开放「读取/写入」权限，且勾选「应用至所有子文件夹」
custom.cnf 文件内容怎么写才生效？
这个文件得放在 NAS 的 /volume1/docker/mysql8/conf/custom.cnf，内容至少包含三段，否则中文存不进、远程连不上：
[client] default-character-set = utf8mb4 <p>[mysql] default-character-set = utf8mb4</p><p>[mysqld] character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci bind-address = 0.0.0.0
首次登录后执行 SHOW VARIABLES LIKE 'char%';，如果输出全是 utf8mb4 才算生效；否则说明挂载路径错、文件名错、或没放对目录。
远程连接连不上？先查这三个点
容器运行中、端口开着、密码没错，还是连不上，90% 卡在这儿：
- MySQL 8.0 默认 root 只允许
localhost登录，且认证插件是caching_sha2_password—— HeidiSQL、旧版 Navicat 不原生支持 - 别改
root用户，DSM 某些组件依赖它；应进容器执行：CREATE USER 'admin'@'%' IDENTIFIED WITH mysql_native_password BY 'your_strong_pass'; - 然后执行：
GRANT ALL ON *.* TO 'admin'@'%' WITH GRANT OPTION;和FLUSH PRIVILEGES; - 确认群晖防火墙已放行你设的本地端口（比如
3307），不是容器端口3306
最易被忽略的是：配置文件挂载路径必须是 /etc/mysql/conf.d，且 custom.cnf 必须以 .cnf 结尾；哪怕多一个空格、少一个中括号，MySQL 都会静默跳过，不报错也不生效。
