nazarpc/phpmyadmin

nazarpc/phpmyadmin Docker镜像文档

镜像概述和主要用途

该镜像提供phpMyAdmin作为Docker容器，可与MySQL或MariaDB链接容器配合使用，用于通过Web界面管理MySQL/MariaDB数据库。基于官方PHP 7.2容器与内置Apache2 Web服务器构建，确保组件版本保持最新。

核心功能和特性

• 基于官方PHP 7.2镜像，内置Apache2 Web服务器
• 支持导入所有phpMyAdmin兼容的压缩格式SQL dump
• 可连接多个数据库服务器或任意MySQL主机
• 自动生成唯一的blowfish_secret配置，支持cookie会话
• 支持自定义上传文件大小、会话超时、主机名、URI等配置
• 兼容OpenShift，可使用非特权用户运行

使用场景和适用范围

• 开发环境中快速部署phpMyAdmin管理数据库
• 需要临时访问数据库的场景（配合--rm选项自动清理）
• 多数据库服务器管理需求
• 需要自定义phpMyAdmin配置的场景
• OpenShift等容器平台部署

使用方法和配置说明

基本使用方法

与MySQL配合使用

bash
docker run --name mysql -e MYSQL_ROOT_PASSWORD=my_password -d mysql
docker run --rm --link mysql:mysql -p 1234:80 nazarpc/phpmyadmin

与MariaDB配合使用

bash
docker run --name mariadb -e MYSQL_ROOT_PASSWORD=my_password -d mariadb
docker run --rm --link mariadb:mysql -p 1234:80 nazarpc/phpmyadmin

注意：内部始终需要将链接名称设为mysql

执行上述命令后，可通过http://localhost:1234访问phpMyAdmin。按Ctrl+C停止容器会自动删除（因--rm选项），可将1234替换为任意端口。

配置选项

指定允许的上传文件大小

默认上传限制为128M，可通过UPLOAD_SIZE环境变量修改：

bash
docker run --rm --link mysql:mysql -p 1234:80 -e UPLOAD_SIZE=1G nazarpc/phpmyadmin

增加会话超时时间

默认会话超时为1440秒（24分钟），可通过SESSION_TIMEOUT环境变量修改：

bash
docker run --rm --link mysql:mysql -p 1234:80 -e SESSION_TIMEOUT=86400 nazarpc/phpmyadmin

自定义主机名

默认假设MySQL通过mysql主机名访问，可通过MYSQL_HOST环境变量覆盖：

bash
docker run --rm --link mysql:mysql -p 1234:80 -e MYSQL_HOST=mariadb:9999 nazarpc/phpmyadmin

MYSQL_HOST有效值示例：

• mariadb - 主机名mariadb
• mariadb:9999 - 主机名mariadb，端口9999
• mariadb;root - 主机名mariadb，用户root
• mariadb;root;123 - 主机名mariadb，用户root，密码123
• mariadb:9999;root;123 - 主机名mariadb，用户root，密码123，端口9999
• mysql, mariadb:9999, mariadb:9999;root;123 - 多个服务器

允许连接任意MySQL主机

bash
docker run --rm --link mysql:mysql -p 1234:80 -e ALLOW_ARBITRARY=1 nazarpc/phpmyadmin

自定义phpMyAdmin实例URI

当phpMyAdmin自动检测URI不正确时，可通过ABSOLUTE_URI指定：

bash
docker run --rm --link mysql:mysql -p 1234:80 -e ABSOLUTE_URI=https://domain.tld/phpmyadmin nazarpc/phpmyadmin

自定义phpMyAdmin设置

通过JSON_CONFIG环境变量传递JSON对象自定义配置（会合并到现有配置）：

bash
docker run --rm --link mysql:mysql -p 1234:80 -e JSON_CONFIG='{"AllowUserDropDatabase": true,"MaxTableList": 450, "NavigationTreeTableSeparator": "_"}' nazarpc/phpmyadmin

容器内HTTP和HTTPS自定义端口

当以非特权用户运行时，可通过HTTP_PORT和HTTPS_PORT指定非默认端口：

bash
docker run --rm --user 1001 -p 8080:8080 -p 4443:4443 -e HTTP_PORT=8080 -e HTTPS_PORT=4443 nazarpc/phpmyadmin

与其他类似镜像的区别

• 基于官方PHP 7.2容器，无自定义基础镜像
• 支持所有phpMyAdmin兼容的压缩格式SQL导入
• 支持多服务器连接或任意服务器连接
• 容器启动时自动生成唯一blowfish_secret配置，无需手动重建
• 持续更新以保持phpMyAdmin、PHP及其他组件的最新版本
• 支持OpenShift等平台的非特权用户运行（需指定非特权端口）

问题反馈

如有问题，请在https://github.com/nazar-pc/docker-phpmyadmin/issues%E6%8F%90%E4%BA%A4issue%E3%80%82

许可证

公共领域（Public Domain）