phpmyadmin/phpmyadmin

phpMyAdmin 官方 Docker 镜像

注意：phpMyAdmin 已被收录到 https://hub.docker.com/_/phpmyadmin%EF%BC%8C%E6%82%A8%E5%8F%AF%E4%BB%A5%E4%BD%BF%E7%94%A8%E8%AF%A5%E5%AE%98%E6%96%B9%E4%BB%93%E5%BA%93%E6%88%96%E6%97%A7%E7%89%88 https://hub.docker.com/r/phpmyadmin/phpmyadmin/ 进行 Docker 安装。旧仓库仍在维护以方便未迁移的用户。

镜像概述和主要用途

phpMyAdmin 是 MySQL 和 MariaDB 的 Web 管理界面。本 Docker 镜像基于 Alpine、Apache 和 PHP FPM 构建，提供开箱即用的 phpMyAdmin 部署方案，支持通过 Web 界面（默认 http://localhost:8080）进行 MySQL 数据库管理。

核心功能和特性

• 多架构支持：兼容 amd64、arm32v5/6/7、arm64v8、i386、mips64le、ppc64le、s390x 等架构
• 镜像变体：提供三种部署模式（apache/fpm/fpm-alpine），满足不同场景需求
• 灵活配置：通过环境变量自定义连接参数、认证方式、资源限制等
• 外部集成：支持连接 Docker 内部或外部的 MySQL/MariaDB 服务器
• 安全特性：支持 Docker secrets（通过 _FILE 变量读取敏感信息）、隐藏 PHP 版本等
• 自定义扩展：支持挂载用户配置文件 config.user.inc.php 实现高级配置

使用场景和适用范围

• 开发/测试环境：快速部署 phpMyAdmin 管理本地或容器化 MySQL 服务
• 多服务器管理：通过环境变量配置多台 MySQL 服务器，实现集中管理
• 现有 Web 架构集成：使用 fpm 变体配合已有的 Nginx/Apache 服务器
• 资源受限环境：通过 fpm-alpine 变体减少镜像体积和资源占用
• 反向代理部署：支持在反向代理后使用，通过 PMA_ABSOLUTE_URI 配置正确路径

详细使用方法和配置说明

Docker Hub 标签

以下标签可用：

• latest、fpm、fpm-alpine：最新稳定版本
• 主版本号（如 5、5-fpm、5-fpm-alpine）
• 次版本号（如 5.0、5.0-fpm、5.0-fpm-alpine）
• 补丁版本号（如 5.0.0、5.0.0-fpm、5.0.0-fpm-alpine），部分版本可能包含 Docker 专用修订号（如 4.9.2-1）

完整标签列表见 https://hub.docker.com/r/phpmyadmin/phpmyadmin/tags%E3%80%82

镜像变体

凭证说明

phpMyAdmin 使用 MySQL 服务器的凭证进行连接。官方 MySQL 和 MariaDB 镜像通过以下环境变量定义凭证：

• MYSQL_ROOT_PASSWORD：必填，设置 root 超级用户密码
• MYSQL_USER/MYSQL_PASSWORD：可选，创建自定义用户并设置密码

使用示例

1. 链接 Docker 中的数据库服务器

将 phpMyAdmin 链接到 Docker 中运行的 MySQL/MariaDB 容器（假设数据库容器名为 mysql_db_server）：

sh
docker run --name myadmin -d --link mysql_db_server:db -p 8080:80 docker.xuanyuan.run/phpmyadmin

访问 http://localhost:8080 即可管理数据库。

2. 连接外部数据库服务器

通过 PMA_HOST（和可选的 PMA_PORT）指定外部 MySQL 服务器地址和端口：

sh
docker run --name myadmin -d -e PMA_HOST=dbhost -e PMA_PORT=3306 -p 8080:80 docker.xuanyuan.run/phpmyadmin

3. 允许连接任意服务器

设置 PMA_ARBITRARY=1 允许在登录页面手动输入任意 MySQL 服务器地址：

sh
docker run --name myadmin -d -e PMA_ARBITRARY=1 -p 8080:80 docker.xuanyuan.run/phpmyadmin

4. 使用 docker-compose 部署

以下示例启动 MariaDB 和 phpMyAdmin（支持任意服务器连接）：

yaml
version: '3.1'

services:
  db:
    image: docker.xuanyuan.run/mariadb:10.3
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: notSecureChangeMe  # 替换为安全密码

  phpmyadmin:
    image: docker.xuanyuan.run/phpmyadmin
    restart: always
    ports:
      - 8080:80
    environment:
      - PMA_ARBITRARY=1  # 允许连接任意服务器

启动命令：

sh
docker-compose up -d

5. 运行 E2E 测试

使用项目提供的 docker-compose.testing.yml 运行测试环境（需先克隆 https://github.com/phpmyadmin/docker 仓库）：

sh
docker-compose -f docker-compose.testing.yml up phpmyadmin

6. 添加自定义配置

通过挂载 config.user.inc.php 文件添加高级配置（如配置存储设置）：

sh
docker run --name myadmin -d \
  --link mysql_db_server:db \
  -p 8080:80 \
  -v /本地路径/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php \
  docker.xuanyuan.run/phpmyadmin

配置文件参考：https://docs.phpmyadmin.net/en/latest/config.html#config%E3%80%82

7. 在反向代理后使用

设置 PMA_ABSOLUTE_URI 为反向代理暴露的完整 URL（如 https://pma.example.net/）：

sh
docker run --name myadmin -d \
  -e PMA_HOST=dbhost \
  -e PMA_ABSOLUTE_URI=https://pma.example.net/ \
  -p 8080:80 \
  docker.xuanyuan.run/phpmyadmin

环境变量详细说明

核心连接参数

高级配置参数

资源限制参数

Docker Secrets 支持

以下变量支持通过 _FILE 后缀从文件读取值（优先级高于直接变量）：

• PMA_PASSWORD_FILE
• MYSQL_ROOT_PASSWORD_FILE
• MYSQL_PASSWORD_FILE
• PMA_HOSTS_FILE
• PMA_HOST_FILE
• PMA_CONTROLPASS_FILE

示例（从文件读取密码）：

sh
docker run --name myadmin -d \
  -e PMA_PASSWORD_FILE=/run/secrets/db_password.txt \
  -p 8080:80 \
  docker.xuanyuan.run/phpmyadmin

问题反馈

• Docker 容器相关问题：https://github.com/phpmyadmin/docker/issues
• phpMyAdmin 本身问题：https://github.com/phpmyadmin/phpmyadmin/issues

更多详细文档：https://docs.phpmyadmin.net/en/latest/setup.html#installing-using-docker