正确做法是让MySQL和phpMyAdmin在同一自定义网络下，用服务名通信（如PMA_HOST: db）；需配置healthcheck与service_healthy依赖确保MySQL就绪，并明确指定PMA_USER/PMA_PASSWORD而非依赖MYSQL_ROOT_PASSWORD自动透传。

docker-compose.yml 文件写对了，MySQL 和 phpMyAdmin 就能自动连上，不用手动查 IP、改配置、硬编码地址。

为什么 PMA_HOST 不能写 127.0.0.1 或宿主机 IP？

容器内 127.0.0.1 指的是它自己，不是宿主机；宿主机 ip（比如 192.168.1.100）在容器里通常不可达，尤其在 linux 上默认被 docker 网络隔离。
正确做法是让两个服务在同一自定义网络下，用服务名通信：pma_host: db —— 这里的 db 是你在 docker-compose.yml 里给 mysql 服务起的名字。

depends_on 只控制启动顺序，不保证 MySQL 已就绪

即使写了 depends_on: db，phpMyAdmin 容器启动时 MySQL 可能还在初始化（尤其是首次启动或数据卷为空时），导致连接失败、页面报错 “Cannot log in to the MySQL server”。

• 必须加 healthcheck：让 Compose 知道 MySQL 真正“活”了才启动 phpMyAdmin
• 推荐写法：

  healthcheck:
    test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$$MYSQL_ROOT_PASSWORD"]
    interval: 10s
    timeout: 5s
    retries: 5
    start_period: 30s

• start_period 很关键：给 MySQL 足够时间完成初始化（特别是带初始化 SQL 或大体积数据卷时）
• phpMyAdmin 侧用 condition: service_healthy，而不是 service_started

环境变量别名冲突：MYSQL_ROOT_PASSWORD 到底该谁设？

phpMyAdmin 镜像会读 MYSQL_ROOT_PASSWORD，但只在 PMA_ARBITRARY=1 且没设 PMA_PASSWORD 时 fallback 使用——这容易引发混淆和权限错乱。

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

• 明确指定 PMA_USER 和 PMA_PASSWORD，值与 MySQL 的 MYSQL_ROOT_PASSWORD 一致
• 不要依赖 MYSQL_ROOT_PASSWORD 自动透传；它本质是为 phpMyAdmin 连接“外部任意 MySQL”时准备的，不是为内部 Compose 服务间通信设计的
• 若 MySQL 启用了 mysql_native_password 认证插件（MySQL 8.0+ 默认），需额外加 command 覆盖默认启动命令：

  command: mysqld --default-authentication-plugin=mysql_native_password

持久化和配置挂载最容易漏掉的两件事

数据丢了或配置每次重启都重置，基本都是这两处没处理好：

• volumes 必须声明命名卷（如 db_data:），不能只写路径；否则 docker compose down 后数据全丢
• 自定义 phpMyAdmin 配置（如允许上传大文件、禁用 gzip）要挂载到 /etc/phpmyadmin/config.user.inc.php，且文件必须以 $cfg[...] 开头、PHP 语法合法，否则容器启动失败
• UPLOAD_LIMIT 环境变量只控制界面显示上限，真正生效还得配 PHP 的 upload_max_filesize 和 post_max_size（需挂载自定义 php.ini 或用 FPM 版镜像）

实际部署时，最常卡住的不是语法错误，而是 MySQL 健康检查没通过就急着访问 phpMyAdmin，或者误把宿主机网络概念套进容器网络。多等 20 秒再刷新页面，比反复删容器重试更省时间。