如何在群晖NAS的Docker套件中安装配置MySQL8.0-mysql教程-PHP中文网

MYSQL_ROOT_PASSWORD必须设置且不能含特殊字符，否则容器初始化失败；宿主机挂载路径须为/var/lib/mysql并赋写权限，配置文件需挂载至/etc/mysql/conf.d，端口映射须手动指定3306。

如何在群晖nas的docker套件中安装配置mysql8.0

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。

在 DSM「网络端口」设置里，把「本地端口」从「自动」改成手动填 3306，容器端口保持 3306。如果 NAS 局域网里已有设备占了 3306（比如另一台树莓派），那就填 3307，客户端连接 URL 也得同步改成 :3307。

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

外网访问时，路由器端口转发目标必须指向 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</p>

挂载时，把 /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 这两个路径，错一个，整个配置就白搭。