library/phpmyadmin

phpMyAdmin Docker 镜像使用指南

概述

phpMyAdmin 是一款免费的 PHP 软件工具，用于通过 Web 界面管理 MySQL 和 MariaDB 数据库。它支持数据库、表、列、关系、索引、用户权限等常见操作，同时也允许直接执行 SQL 语句。本 Docker 镜像提供了基于 Alpine、Apache 和 PHP FPM 的运行环境。

快速参考

维护方

[phpMyAdmin]

帮助支持

可通过以下渠道获取帮助：
[Docker Community Slack] 、[Server Fault] 、[Unix & Linux] 或 [Stack Overflow]

问题反馈

提交问题至：[[]]

支持的架构

（更多信息见 [官方说明] ）
amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x
（各架构镜像地址可通过链接查看，例如 [amd64] ）

镜像信息

• 镜像元数据、传输大小等详情：[repo-info 仓库的 repos/phpmyadmin/ 目录] （含 [历史记录] ）
• 镜像更新：[official-images 仓库的 library/phpmyadmin 标签] 及 [文件] （含 [历史记录] ）
• 本文档来源：[docs 仓库的 phpmyadmin/ 目录] （含 [历史记录] ）

支持的标签及对应 Dockerfile

如何使用本镜像

所有示例均会在 `[] 启动 phpMyAdmin，用于管理 MySQL 或 MariaDB。

镜像变体

本镜像提供三种变体，适用于不同场景：

• apache：包含完整的 Apache 服务器和 PHP，开箱即用。指定版本号时默认使用此变体。
• fpm：仅启动 PHP FPM 容器，需配合独立的 Web 服务器使用。包含更多工具，镜像体积比 fpm-alpine 大。
• fpm-alpine：基于 Alpine Linux，体积极小，仅启动 PHP FPM 进程。需配合独立 Web 服务器，适合对镜像大小敏感的场景；若需 Alpine 不支持的工具，建议使用 fpm 变体。

数据库凭证

phpMyAdmin 通过 MySQL 服务器的凭证连接，需参考数据库镜像的默认用户名/密码配置，或自定义凭证。官方 MySQL/MariaDB 镜像通常使用以下环境变量：

• MYSQL_ROOT_PASSWORD：必填，设置 root 用户密码。
• MYSQL_USER、MYSQL_PASSWORD：可选，用于创建自定义用户及密码。

使用示例

1. 与已链接的数据库服务器配合使用

先运行 MySQL/MariaDB 容器，再链接 phpMyAdmin 容器： CODE_TOKEN_0 （mysql_db_server 为数据库容器名称，db 为链接别名）

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

通过 PMA_HOST 指定外部数据库地址，PMA_PORT 指定端口（非默认时）： CODE_TOKEN_1 （dbhost 为外部数据库的 IP 或域名）

3. 支持任意数据库服务器连接

设置 PMA_ARBITRARY=1，允许在登录页输入任意 MySQL/MariaDB 服务器信息： CODE_TOKEN_2

4. 使用 Docker Compose

以下示例通过 docker compose 启动 phpMyAdmin 和 MariaDB，并启用任意服务器连接： CODE_TOKEN_3 启动命令：docker compose up -d

自定义配置

方法 1：通过 config.user.inc.php

创建 config.user.inc.php 文件（首行需为 <?php），添加自定义配置（如启用高级功能），并挂载到容器： CODE_TOKEN_4 示例配置（启用 phpinfo 链接）： CODE_TOKEN_5 配置详情参考：[phpMyAdmin 文档] 、[安装指南]

方法 2：通过 /etc/phpmyadmin/conf.d 目录

将多个配置文件（如 server-1.php、server-2.php）放入宿主机目录，挂载到容器的 /etc/phpmyadmin/conf.d： CODE_TOKEN_6 （:ro 表示只读挂载）

反向代理场景

若通过反向代理访问 phpMyAdmin，需设置 PMA_ABSOLUTE_URI 为完整访问路径（如 [] 会话持久化 为避免容器重启后会话丢失，需挂载 /sessions` 目录：

sh
docker run --name phpmyadmin -d --link mysql_db_server:db -p 8080:80 \
  -v /本地路径/sessions:/sessions:rw \
  docker.xuanyuan.run/phpmyadmin

通过 SSL 连接数据库

设置 PMA_SSL=1 启用 SSL 连接；多服务器时，用 PMA_SSLS 指定各服务器是否启用（逗号分隔的 0/1）：

sh
# 单服务器
docker run --name docker.xuanyuan.run/phpmyadmin -d -e PMA_HOST=sslhost -e PMA_SSL=1 -p 8080:80 phpmyadmin

# 多服务器（第一个启用 SSL，第二个不启用）
docker run --name docker.xuanyuan.run/phpmyadmin -d -e PMA_HOSTS='sslhost,nosslhost' -e PMA_SSLS='1,0' -p 8080:80 phpmyadmin

环境变量汇总

更多变量及详细说明见 [官方文档] 。

镜像变体详情

phpmyadmin:<version>-alpine

基于 Alpine Linux，镜像体积极小（约 5MB 基础镜像），适合对大小敏感的场景。但需注意：Alpine 使用 musl libc，部分依赖 glibc 的软件可能存在兼容性问题。如需额外工具（如 git、bash），需在 Dockerfile 中自行安装。

许可证

镜像中软件的许可信息见 [phpmyadmin/docker 仓库 LICENSE] 。
Docker 镜像可能包含其他软件（如基础系统的 Bash 等），其许可证需用户自行确认合规性。
自动检测的许可信息可参考 [repo-info 仓库的 phpmyadmin/ 目录] 。