tozd/phpmyadmin

tozd/phpmyadmin

<[***]>

可用地址：

• https://hub.docker.com/r/tozd/phpmyadmin
• registry.gitlab.com/tozd/docker/phpmyadmin

镜像继承

tozd/base ← tozd/dinit ← tozd/nginx ← tozd/nginx-mailer ← tozd/nginx-cron ← tozd/php ← tozd/phpmyadmin

标签

• latest: phpMyAdmin v5.2.1

环境变量

• PHPMYADMIN_HOST: 要连接的数据库主机名。默认值为 mysql。
• PHPMYADMIN_PORT: 要连接的数据库端口。默认值为 3306。

镜像概述

本镜像提供 phpMyAdmin 工具，容器运行时可通过 /phpmyadmin/ URL 访问 phpMyAdmin 界面。默认用于安装范围内的 Web 管理场景，每个用户可查看自己有权限访问的数据库，也可通过挂载卷或扩展镜像自定义配置（在 /etc/phpmyadmin/conf.d 添加 .php 配置文件）。

核心功能与特性

• 基于 phpMyAdmin 构建，提供直观的 Web 界面管理 MySQL 数据库
• 默认通过 /phpmyadmin/ 路径访问服务
• 支持通过环境变量灵活配置数据库连接（主机名和端口）
• 可自定义配置：通过挂载卷或扩展镜像，在 /etc/phpmyadmin/conf.d 目录添加 .php 配置文件
• 需配置 blowfish_secret 确保安全（默认使用镜像内置共享密钥，建议生产环境自定义）

使用场景

适用于需要通过 Web 界面管理 MySQL 数据库的场景，如开发环境、小型部署等。默认支持多用户按权限访问各自数据库，也可根据需求自定义配置以满足特定管理需求。

配置与使用说明

数据库连接配置

通过环境变量配置数据库连接信息：

• PHPMYADMIN_HOST: 数据库主机名，默认值 mysql
• PHPMYADMIN_PORT: 数据库端口，默认值 3306

安全配置

必须在 /etc/phpmyadmin/conf.d 目录添加 blowfish_secret.inc.php 文件，内容示例：

php
<?php
$cfg['blowfish_secret'] = '至少 32 个随机字符的密钥';

若无此文件，phpMyAdmin 将使用镜像内置的共享密钥，不建议在生产环境使用。

自定义配置

可通过以下方式添加自定义配置：

1. 挂载卷：将包含 .php 配置文件的目录挂载到 /etc/phpmyadmin/conf.d
2. 扩展镜像：基于本镜像构建新镜像，在 /etc/phpmyadmin/conf.d 添加配置文件

启动示例

连接名为 mysql 的数据库容器，启动 phpMyAdmin：

bash
docker run -d -p 80:80 --link mysql:mysql -e PHPMYADMIN_HOST=mysql tozd/phpmyadmin

访问 http://localhost/phpmyadmin/ 即可使用 phpMyAdmin。

GitHub 镜像

项目提供只读 https://github.com/tozd/docker-phpmyadmin%EF%BC%8C%E5%A6%82%E9%9C%80%E5%9C%A8 GitHub 上 fork 项目可使用。