直接用群晖Container Manager部署MySQL 8.0大概率失败，因界面缺失认证插件、字符集、挂载权限等关键配置入口；必须手动设置MYSQL_ROOT_PASSWORD（非空无特殊字符）、严格挂载/volume1/docker/mysql8/data→/var/lib/mysql、指定端口映射（如3306:3306）、挂载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，根本找不到服务
挂载路径和权限怎么配才不报 Permission denied？
Container Manager 不校验宿主机目录权限，但 MySQL 进程以 mysql 用户运行，而 NAS 默认目录属 root，写入会被拒绝。必须提前在 DSM 中显式放权：
- 在 File Station 中创建
/volume1/docker/mysql8/data和/volume1/docker/mysql8/conf两个文件夹 - 右键 →「属性」→「权限」→ 勾选「所有人」的「读取/写入」→ 勾选「应用至所有子文件夹和文件」
- 在「存储空间设置」里填两处：
– 数据目录：宿主机路径/volume1/docker/mysql8/data，装载路径必须是/var/lib/mysql
– 配置目录：宿主机路径/volume1/docker/mysql8/conf，装载路径填/etc/mysql/conf.d（不是/etc/mysql/my.cnf！后者被忽略）
必须手动加的环境变量有哪些？
仅填 MYSQL_ROOT_PASSWORD 不够。Container Manager 不支持命令行参数，必须在「环境变量」里逐条新增：
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
-
MYSQL_ROOT_PASSWORD=MySqlRoot2026（纯字母+数字，避免$、@、#） -
MYSQL_INITDB_SKIP_TZINFO=1（跳过时区初始化，避免因宿主机无/usr/share/zoneinfo失败） -
MYSQL_ALLOW_EMPTY_PASSWORD=no（显式关闭空密码 fallback） -
MYSQL_DEFAULT_AUTHENTICATION_PLUGIN=caching_sha2_password（MySQL 8.0.4+ 必须显式声明，否则初始化阶段退出）
注意：MYSQL_ROOT_HOST=% 只影响 root 登录来源，不能替代后续建 % 用户；且别改 root 的认证方式，DSM 某些组件依赖它。
custom.cnf 挂载后中文还是乱码？
DSM 界面不提供编辑配置入口，而 MySQL 8.0 默认字符集是 latin1，custom.cnf 必须放在 /volume1/docker/mysql8/conf/custom.cnf，内容至少包含：
[client] default-character-set = utf8mb4 [mysql] default-character-set = utf8mb4 [mysqld] character-set-server = utf8mb4 collation-server = utf8mb4_unicode_ci bind-address = 0.0.0.0
挂载目标必须是 /etc/mysql/conf.d，且首次登录后执行 SHOW VARIABLES LIKE 'char%';，确认输出全是 utf8mb4 才算生效。远程连不上？90% 是因为没建 admin@'%' 用户并指定 mysql_native_password 插件——caching_sha2_password 不被多数 GUI 客户端原生支持，这个细节常被跳过。
