arm64v8/phpmyadmin

phpMyAdmin Docker镜像文档 (arm64v8架构)

镜像概述与主要用途

本镜像为https://hub.docker.com/_/phpmyadmin%E7%9A%84%60arm64v8%60%E6%9E%B6%E6%9E%84%E4%B8%93%E7%94%A8%E7%89%88%E6%9C%AC%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8ARM64%E5%B9%B3%E5%8F%B0%E4%B8%8A%E6%8F%90%E4%BE%9BphpMyAdmin%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E3%80%82phpMyAdmin%E6%98%AF%E4%B8%80%E6%AC%BE%E5%9F%BA%E4%BA%8EPHP%E5%BC%80%E5%8F%91%E7%9A%84%E5%85%8D%E8%B4%B9%E5%BC%80%E6%BA%90%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%97%A8%E5%9C%A8%E9%80%9A%E8%BF%87Web%E7%95%8C%E9%9D%A2%E7%AE%A1%E7%90%86MySQL%E5%92%8CMariaDB%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%82%E5%AE%83%E6%94%AF%E6%8C%81%E6%95%B0%E6%8D%AE%E5%BA%93%E3%80%81%E8%A1%A8%E3%80%81%E5%88%97%E3%80%81%E5%85%B3%E7%B3%BB%E3%80%81%E7%B4%A2%E5%BC%95%E3%80%81%E7%94%A8%E6%88%B7%E5%8F%8A%E6%9D%83%E9%99%90%E7%AD%89%E6%97%A5%E5%B8%B8%E7%AE%A1%E7%90%86%E6%93%8D%E4%BD%9C%EF%BC%8C%E5%90%8C%E6%97%B6%E5%85%81%E8%AE%B8%E7%9B%B4%E6%8E%A5%E6%89%A7%E8%A1%8CSQL%E8%AF%AD%E5%8F%A5%E3%80%82

维护方：https://github.com/phpmyadmin/docker
获取帮助：Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

核心功能与特性

核心功能

• 通过Web界面管理MySQL/MariaDB数据库
• 支持数据库、表、列、索引、关系等对象的创建与管理
• 用户与权限管理
• 直接执行SQL语句及批量操作
• 导入/导出数据库（支持多种格式）
• 数据库结构与数据可视化

镜像特性

• 多变体支持：提供apache、fpm、fpm-alpine三种镜像变体
• 跨架构兼容：针对arm64v8架构优化
• 灵活配置：通过环境变量或自定义配置文件调整参数
• 安全支持：支持SSL连接数据库及反向代理部署
• 资源控制：可自定义内存限制、上传大小限制等

适用场景与范围

适用场景

• 开发环境：快速搭建MySQL/MariaDB的Web管理界面
• 测试环境：临时数据库管理需求
• 生产环境：配合现有Web服务器（如Nginx）或独立运行（apache变体）
• 多数据库管理：通过环境变量配置连接多个数据库服务器

适用范围

• ARM64架构设备（如树莓派、ARM服务器等）
• 需要轻量级数据库管理工具的场景
• 容器化部署环境（Docker、Kubernetes等）

支持的标签及Dockerfile链接

完整标签列表见https://hub.docker.com/_/phpmyadmin?tab=tags

使用方法与配置说明

前置条件

• 已安装Docker环境（支持arm64v8架构）
• 已部署MySQL或MariaDB服务器（容器化或外部服务）
• 数据库访问凭证（用户名、密码等）

基本用法

1. 链接到数据库容器

若MySQL/MariaDB已容器化部署（名称为mysql_db_server），可通过--link参数链接：

sh
docker run --name phpmyadmin -d \
  --link mysql_db_server:db \
  -p 8080:80 \
  arm64v8/phpmyadmin

访问http://localhost:8080即可打开phpMyAdmin界面，使用数据库凭证登录。

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

通过PMA_HOST环境变量指定外部数据库地址，PMA_PORT指定端口（默认3306）：

sh
docker run --name phpmyadmin -d \
  -e PMA_HOST=192.168.1.100 \  # 数据库服务器IP/主机名
  -e PMA_PORT=3306 \           # 数据库端口（可选）
  -p 8080:80 \
  arm64v8/phpmyadmin

3. 支持任意服务器连接

设置PMA_ARBITRARY=1允许在登录页面输入任意数据库服务器地址：

sh
docker run --name phpmyadmin -d \
  -e PMA_ARBITRARY=1 \
  -p 8080:80 \
  arm64v8/phpmyadmin

Docker Compose部署示例

以下示例通过docker-compose同时部署MariaDB和phpMyAdmin：

yaml
version: '3'

services:
  db:
    image: arm64v8/mariadb:10.11
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: notSecureChangeMe  # 数据库root密码
    volumes:
      - db_data:/var/lib/mysql

  phpmyadmin:
    image: arm64v8/phpmyadmin
    restart: always
    ports:
      - "8080:80"
    environment:
      - PMA_ARBITRARY=1  # 允许连接任意数据库
    depends_on:
      - db

volumes:
  db_data:

执行docker-compose up -d启动服务，访问http://localhost:8080即可。

自定义配置

1. 挂载自定义配置文件

创建config.user.inc.php文件添加自定义配置（如启用PHP信息显示）：

php
<?php
$cfg['ShowPhpInfo'] = true;  // 在首页添加phpinfo()链接

通过-v参数挂载到容器：

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

2. 通过conf.d目录添加多配置

挂载本地conf.d目录到容器/etc/phpmyadmin/conf.d，支持多文件配置：

sh
docker run --name phpmyadmin -d \
  --link mysql_db_server:db \
  -p 8080:80 \
  -v /本地路径/conf.d:/etc/phpmyadmin/conf.d:ro \  # ro表示只读
  arm64v8/phpmyadmin

可在conf.d目录下创建server-1.php、server-2.php等文件分别配置不同服务器。

反向代理配置

部署在反向代理后时，需设置PMA_ABSOLUTE_URI指定完整访问路径：

sh
docker run --name phpmyadmin -d \
  -e PMA_HOST=db \
  -e PMA_ABSOLUTE_URI=https://pma.example.com/ \  # 反向代理后的完整URL
  arm64v8/phpmyadmin

会话持久化

为避免容器重启后会话丢失，挂载/sessions目录：

sh
docker run --name phpmyadmin -d \
  --link mysql_db_server:db \
  -p 8080:80 \
  -v /本地路径/sessions:/sessions:rw \  # rw表示读写权限
  arm64v8/phpmyadmin

SSL连接数据库

通过PMA_SSL=1启用SSL连接，多服务器可使用PMA_SSLS指定每个服务器是否启用SSL：

sh
# 单服务器SSL连接
docker run --name phpmyadmin -d \
  -e PMA_HOST=sslhost \
  -e PMA_SSL=1 \
  -p 8080:80 \
  arm64v8/phpmyadmin

# 多服务器分别配置SSL
docker run --name phpmyadmin -d \
  -e PMA_HOSTS=sslhost,nosslhost \
  -e PMA_SSLS=1,0 \  # sslhost启用SSL，nosslhost禁用
  -p 8080:80 \
  arm64v8/phpmyadmin

环境变量详解

镜像变体说明

apache（默认变体）

• 包含完整Apache Web服务器和PHP环境
• 开箱即用，无需额外配置Web服务器
• 镜像体积较大，适合独立部署场景

fpm

• 仅包含PHP-FPM进程，需配合外部Web服务器（如Nginx）使用
• 包含更多工具，镜像体积大于fpm-alpine
• 适合已有Web服务器架构的集成

fpm-alpine

• 基于Alpine Linux，镜像体积最小
• 仅包含PHP-FPM进程，需配合外部Web服务器
• 适合对镜像体积敏感的场景，功能较精简

许可证

本镜像包含的软件许可证信息见https://github.com/phpmyadmin/docker/blob/master/LICENSE%E3%80%82

Docker镜像可能包含基础系统（如Alpine、Debian）及依赖软件，其许可证需另行参考。用户应确保使用本镜像符合所有包含软件的许可证要求。

问题反馈

• 镜像相关问题：https://github.com/phpmyadmin/docker/issues
• phpMyAdmin软件问题：https://github.com/phpmyadmin/phpmyadmin/issues