phpMyAdmin Docker镜像文档 (arm64v8架构)

镜像概述与主要用途

本镜像为官方phpMyAdmin镜像的arm64v8架构专用版本，用于在ARM64平台上提供phpMyAdmin的容器化部署。phpMyAdmin是一款基于PHP开发的免费开源工具，旨在通过Web界面管理MySQL和MariaDB数据库。它支持数据库、表、列、关系、索引、用户及权限等日常管理操作，同时允许直接执行SQL语句。

维护方：phpMyAdmin团队
获取帮助：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链接

完整标签列表见Docker Hub

使用方法与配置说明

前置条件

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

基本用法

1. 链接到数据库容器

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

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）：

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允许在登录页面输入任意数据库服务器地址：

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

Docker Compose部署示例

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

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
$cfg['ShowPhpInfo'] = true;  // 在首页添加phpinfo()链接

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

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，支持多文件配置：

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指定完整访问路径：

docker run --name phpmyadmin -d \
  -e PMA_HOST=db \
  -e PMA_ABSOLUTE_URI=[***] \  # 反向代理后的完整URL
  arm64v8/phpmyadmin

会话持久化

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

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：

# 单服务器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服务器
• 适合对镜像体积敏感的场景，功能较精简

许可证

本镜像包含的软件许可证信息见phpmyadmin/docker仓库。

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

问题反馈

• 镜像相关问题：phpmyadmin/docker Issues
• phpMyAdmin软件问题：phpmyadmin/phpmyadmin Issues