自定义MariaDB Docker容器在Intel macOS可运行，Ubuntu下启动失败

容器启动失败的核心原因是在Docker容器中使用service mysql start这类依赖init系统的命令不可靠。Docker容器默认以PID 1运行你的脚本，而非systemd/sysvinit这类init进程，service命令依赖这些init系统管理服务，Ubuntu的Docker环境下这种差异直接导致启动失败；而macOS的Docker Desktop因底层虚拟化的特殊处理，勉强兼容了这种不规范用法。

具体问题点 #

• service mysql start在容器中会尝试后台启动mysqld，但容器没有正常的init进程，后台进程无法被正确管理，后续mariadb命令连接不上数据库，进而卡住。
• 你修改配置文件的方式可能造成配置冲突（比如重复添加bind-address和includedir），引发MariaDB加载配置出错，且容器中日志路径权限或init机制问题导致无日志输出，无法排查。

修复步骤 #

1. 替换service命令，直接用mysqld启动并初始化 #

Docker容器运行数据库的正确方式是直接将数据库进程作为PID 1运行，而非通过service命令。调整启动脚本如下：

#!/bin/bash

# 仅修改必要配置，避免重复覆盖
sed -i "s|skip-networking|# skip-networking|g" /etc/mysql/mariadb.conf.d/50-server.cnf
sed -i "s|.*bind-address\s*=.*|bind-address=0.0.0.0|g" /etc/mysql/mariadb.conf.d/50-server.cnf

echo "CNF File Modified"

# 首次启动时初始化数据库
if [ ! -d "/var/lib/mysql/mysql" ]; then
    mysqld --initialize --user=root
fi

# 启动临时mysqld进程执行初始化操作
mysqld_safe --skip-networking &
MYSQL_PID=$!

# 等待数据库完全启动
until mariadb -u root -e "SELECT 1"; do
    sleep 1
done

# 执行数据库初始化
mariadb -u root -e "ALTER USER 'root'@'localhost' IDENTIFIED BY '$MYSQL_ROOT_PASSWORD'"
mariadb -u root -e "CREATE DATABASE IF NOT EXISTS wpdb"
mariadb -u root -e "CREATE USER IF NOT EXISTS 'wpuser'@'%' IDENTIFIED BY '$MYSQL_PASSWORD'"
mariadb -u root -e "GRANT ALL PRIVILEGES ON wpdb.* TO 'wpuser'@'%'"
mariadb -u root -e "CREATE USER IF NOT EXISTS 'root'@'%' IDENTIFIED BY '$MYSQL_ROOT_PASSWORD'"
mariadb -u root -e "GRANT ALL PRIVILEGES ON *.* TO 'root'@'%'"
mariadb -u root -e "FLUSH PRIVILEGES"

echo "Database Setup Complete"

# 关闭临时进程
kill $MYSQL_PID
wait $MYSQL_PID

# 启动前台mysqld作为容器PID 1
exec mysqld --bind-address=0.0.0.0

2. 优化Dockerfile，减小镜像体积 #

FROM debian:buster

RUN apt-get update -y && \
    apt-get install mariadb-server mariadb-client -y && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

COPY ./conf/script.sh /script.sh
RUN chmod +x /script.sh

# 暴露数据库端口
EXPOSE 3306

ENTRYPOINT ["/script.sh"]

3. 正确传递环境变量 #

运行容器时通过-e参数传入所需变量：

docker run -d -e MYSQL_ROOT_PASSWORD=你的根密码 -e MYSQL_PASSWORD=wp用户密码 -p 3306:3306 你的镜像名称

为什么macOS能正常运行？ #

Docker Desktop for macOS底层依赖HyperKit虚拟化出完整的Linux虚拟机，该虚拟机自带init系统，因此service命令能勉强工作；而Ubuntu上的Docker直接复用宿主机的cgroup和namespace，容器内无init进程，service命令无法正确启动后台服务，最终导致失败。

内容的提问来源于stack exchange，提问作者user15970572