MYSQL_ROOT_PASSWORD必须设置且不能含特殊字符，否则容器初始化失败；宿主机挂载路径须为/var/lib/mysql并赋写权限，配置文件需挂载至/etc/mysql/conf.d，端口映射须手动指定3306。
MYSQL_ROOT_PASSWORD 必须设，且不能含特殊字符
容器启动失败、反复重启、日志只报 Initialization of mysqld failed 或 database is uninitialized，90% 是因为没设或设错了 MYSQL_ROOT_PASSWORD。群晖 DSM 图形界面会悄悄截断 $、@、# 等符号，导致实际传入为空字符串。
必须填一个非空、纯字母+数字组合的值，比如 MySqlRoot2026。这个值只在首次初始化时生效，写进 /var/lib/mysql 目录后就固化了，后续改密码得进容器执行 SQL，不是改环境变量就能生效。
- 别用中文、空格、下划线开头、连字符
- DSM 的「环境变量」字段里必须显式填写，不能留空
- 设完后容器日志里应出现
MySQL init process done. Ready for start up.
挂载路径必须是 /var/lib/mysql，且宿主机目录要有写权限
MySQL 8.0 官方镜像硬编码了数据路径，挂成 /data、/mysql 或 /volume1/docker/mysql8/db 都无效——容器能启动，但数据不落盘，删容器就丢库。
正确做法是：宿主机建目录（如 /volume1/docker/mysql8/data），然后在 DSM「卷」设置中映射到容器内 /var/lib/mysql。更关键的是，群晖 ACL 默认禁止 Docker 写入该目录。
- 进 DSM「控制面板 → 共享文件夹」，右键你建的文件夹 →「编辑 → 权限」
- 勾选「所有人」的「读取/写入」，并打钩「应用至所有子文件夹」
- 别直接挂载系统默认的
/docker根目录，它可能被 DSM 自身服务占用
端口映射必须手动填 3306:3306，别信“自动”
选「自动」映射，容器大概率分到 32768–32775 这类高位端口，Navicat、Java 应用、甚至 mysql -h 192.168.x.x -P 3306 都连不上——它们默认只找 3306。
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
在 DSM「网络端口」设置里，把「本地端口」从「自动」改成手动填 3306，容器端口保持 3306。如果 NAS 局域网里已有设备占了 3306（比如另一台树莓派），那就填 3307，客户端连接 URL 也得同步改成 :3307。
- 外网访问时，路由器端口转发目标必须指向 NAS 的这个本地端口（比如
3307），不是容器端口 - 确认 DSM「防火墙」已放行你填的本地端口（比如
3307） - 容器启动后，
docker ps输出里PORTS列应显示0.0.0.0:3306->3306/tcp
custom.cnf 必须挂到 /etc/mysql/conf.d，不是 /etc/mysql/my.cnf
DSM 图形界面不提供编辑配置文件的入口，但 MySQL 8.0 默认用 latin1 字符集、默认关闭远程访问、默认只允许 localhost 登录——这三个问题不解决，数据库等于半残。
在 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
挂载时，把 /volume1/docker/mysql8/conf 映射到容器内 /etc/mysql/conf.d（注意：不是 /etc/mysql/my.cnf，后者会被忽略）。
- 首次登录后运行
SHOW VARIABLES LIKE 'char%';，确认输出全是utf8mb4 - 远程连不上？进容器执行
CREATE USER 'admin'@'%' IDENTIFIED WITH mysql_native_password BY 'your_strong_pass';，再GRANT ALL ON *.* TO 'admin'@'%'; FLUSH PRIVILEGES; - 别动
root用户的认证插件，DSM 某些组件依赖它
容器跑起来只是第一步，真正卡住人的永远是那几个看似微小却硬性生效的路径、权限、挂载点和插件选择。尤其 /etc/mysql/conf.d 和 /var/lib/mysql 这两个路径，错一个，整个配置就白搭。
