能搭，但必须绕过群晖Container Manager图形界面默认配置陷阱：MYSQL_ROOT_PASSWORD未设或含特殊字符、宿主机路径未严格映射到容器/var/lib/mysql、端口未手动设为3306，三者缺一不可，否则报“database is uninitialized”并秒退。
能搭，但必须绕过群晖 Container Manager 图形界面的默认配置陷阱——它不暴露 MYSQL_ROOT_PASSWORD 校验逻辑、不提示挂载路径硬编码规则、也不支持直接编辑 my.cnf，直接点“运行”大概率容器秒退或连不上。
为什么容器启动后立刻退出？
三个硬性条件缺一不可，任一失败都只报同一句日志：error: database is uninitialized 或 Initialization of mysqld failed：
-
MYSQL_ROOT_PASSWORD没设，或值为空（含空格、回车）、含$、@、#等 shell 特殊字符——DSM 界面会截断或转义，实际传给容器的是空字符串 - 宿主机路径（如
/volume1/docker/mysql8/data）没映射到容器内/var/lib/mysql——映射成/data、/mysql、/root全无效，MySQL 8.0 镜像硬编码所有数据写入该路径 - 端口映射选了“自动”——DSM 分配的通常是
32768–32775这类高位端口，而 Navicat、Java 应用默认连:3306，根本找不到服务
挂载路径和权限怎么配才不丢数据？
删容器后数据丢失，90% 是因为没挂对或权限没开。这不是警告，是事实：
Mysql Skill 1.0.0 (3)
下载
MySQL 数据库管理技能，能够通过自然语言查询和管理数据库，支持 SELECT/INSERT/UPDATE/DELETE、表管理、备份恢复等操作。当用户提及 MySQL、数据库查询、建表或数据备份时使用此技能。
- 数据目录必须映射：NAS 路径（如
/volume1/docker/mysql8/data）→ 容器内/var/lib/mysql；不能少斜杠、不能换名、不能映射到/etc/mysql或空目录 - 配置目录必须另建：NAS 路径（如
/volume1/docker/mysql8/conf）→ 容器内/etc/mysql/conf.d（不是/etc/mysql/my.cnf！后者被忽略） - NAS 上这两个文件夹必须提前创建，并在 File Station 中右键 →「属性」→「权限」→ 勾选「应用至所有子文件夹和文件」→ 将「读取/写入」权限赋予
users群组（MySQL 进程以mysql用户运行，非root）
custom.cnf 文件内容和挂载位置必须严格匹配
跳过这步，数据库等于半残：默认字符集是 latin1，插入中文直接报错；bind-address 默认为 127.0.0.1，远程连接被拒绝。
- 文件必须放在 NAS 的
/volume1/docker/mysql8/conf/custom.cnf，内容至少含三段：[client]、[mysql]、[mysqld] -
[mysqld]段必须有：character-set-server = utf8mb4、collation-server = utf8mb4_unicode_ci、bind-address = 0.0.0.0 - 首次登录后立即执行：
SHOW VARIABLES LIKE 'char%';，输出全为utf8mb4才算生效；否则检查挂载路径、文件名、目录是否拼错
远程连不上？别动 root，新建用户并指定认证插件
容器跑着、端口开着、密码没错，但 Navicat / HeidiSQL 连不上——大概率是 MySQL 8.0 默认 root@localhost 且认证插件为 caching_sha2_password，多数 GUI 客户端不原生支持。
- 进容器执行：
docker exec -it mysql8-main mysql -uroot -p，输密码后运行：CREATE USER 'admin'@'%' IDENTIFIED WITH mysql_native_password BY 'your_strong_pass'; - 再执行：
GRANT ALL ON *.* TO 'admin'@'%' WITH GRANT OPTION;，然后必须FLUSH PRIVILEGES; - 别改
root用户的认证方式——DSM 某些后台组件依赖它；外网访问时，路由器端口转发目标必须指向 NAS 上你设的本地端口（如3307），不是容器内3306
最常被忽略的其实是权限和挂载路径的组合问题：NAS 文件夹属 root，但容器里 MySQL 进程跑在 mysql 用户下，users 群组权限没开，或者挂载路径少了个斜杠，都会导致初始化失败——日志里不会明说，只会反复报“database is uninitialized”。
