moonbuggy2000/phpmyadmin

Docker phpMyAdmin

镜像概述和主要用途

在Alpine Linux中运行的phpMyAdmin，集成Nginx和PHP-FPM，提供Web界面用于管理MySQL和MariaDB数据库。

核心功能和特性

• 基于Alpine Linux，轻量级且资源占用低
• 集成Nginx和PHP-FPM，提供稳定的Web服务
• 支持多语言（默认all-languages版本），也提供仅英文版本（标签带english）
• 通过环境变量灵活配置连接参数
• 支持SSL加密连接
• 可通过卷挂载自定义配置文件和持久化SSL证书

使用场景和适用范围

适用于需要通过Web界面管理MySQL或MariaDB数据库的开发人员、系统管理员，可用于本地开发环境、测试环境或小型生产环境的数据库管理。

使用方法和配置说明

基本使用

通过以下命令快速启动phpMyAdmin容器：

docker run --name phpmyadmin -d -p 8080:8080 moonbuggy2000/phpmyadmin:latest

默认使用all-languages版本。若需节省空间，可使用仅英文版本，标签为suffix english（如moonbuggy2000/phpmyadmin:latest-english）。

环境变量

可通过-e参数指定环境变量，支持的变量如下：

• PMA_ARBITRARY - 设置为true时允许连接到任意MySQL服务器
• PMA_HOST - 定义MySQL服务器的地址/主机名
• PMA_VERBOSE - 定义MySQL服务器的显示名称
• PMA_PORT - 定义MySQL服务器的端口
• PMA_HOSTS - 定义逗号分隔的多个MySQL服务器地址/主机名列表
• PMA_VERBOSES - 定义逗号分隔的多个MySQL服务器显示名称列表
• PMA_PORTS - 定义逗号分隔的多个MySQL服务器端口列表
• PMA_USER - 定义MySQL服务器认证用户名
• PMA_PASSWORD - 定义MySQL服务器认证密码
• PMA_ABSOLUTE_URI - 定义用户访问的URI
• PMA_SSL - 设置为true启用SSL（默认：false）
• PMA_SSL_KEY - 客户端密钥文件路径（默认：/certs/client-key.pem）
• PMA_SSL_CERT - 客户端证书文件路径（默认：/certs/client-cert.pem）
• PMA_SSL_CA - CA文件路径（默认：/certs/server-ca.pem）
• PMA_SSL_CA_PATH - 可信CA证书目录路径（默认：/certs/ca/）
• PMA_SSL_CIPHERS - 允许的密码套件列表（默认：NULL）
• PMA_SSL_VERIFY - 启用SSL验证（默认：true）
• PMA_CONSOLE_DARKTHEME - 控制台窗口深色主题（默认：false）
• NGINX_PORT - phpMyAdmin Web界面端口（默认：8080）
• PUID - 运行用户ID
• PGID - 运行组ID
• TZ - 时区

此镜像的运行方式与官方phpMyAdmin镜像基本相同，更多详细说明可参考官方https://github.com/phpmyadmin/docker%E6%88%96https://hub.docker.com/r/phpmyadmin/phpmyadmin%E9%A1%B5%E9%9D%A2%E3%80%82

卷

• 若希望通过配置文件而非环境变量配置phpMyAdmin，可挂载并编辑/etc/phpmyadmin/config.inc.php
• 要持久化SSL密钥/证书，应挂载/certs目录

示例docker-compose.yml

以下示例假设您已在另一个容器中运行https://hub.docker.com/_/traefik%E4%BD%9C%E4%B8%BA%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E3%80%82%E8%8B%A5%E6%B2%A1%E6%9C%89%EF%BC%8C%E5%8F%AF%E7%A7%BB%E9%99%A4%E5%AF%B9%60traefik%60%E7%BD%91%E7%BB%9C%E7%9A%84%E5%BC%95%E7%94%A8%E3%80%82

yaml
version: '2'

services:
  mariadb:
    image: jbergstroem/mariadb-alpine:latest
    container_name: mariadb
    restart: unless-stopped
    ports:
      - 3306:3306
    volumes:
      - mariadb_data:/var/lib/mysql
    environment:
      - "MYSQL_DATABASE=phpmyadmin"
      - "MYSQL_USER=user"
      - "MYSQL_PASSWORD=password"
      - "MYSQL_ROOT_PASSWORD=rootpassword"
    networks:
      - mariadb
      - traefik

  phpmyadmin:
    image: moonbuggy2000/phpmyadmin:latest-english
    container_name: phpmyadmin
    depends_on:
      - mariadb
    restart: unless-stopped
    ports:
      - 8080:8080
    volumes:
      - phpmyadmin_certs:/certs
    environment:
      - "PMA_ABSOLUTE_URI=phpmyadmin.local"
      - "PMA_HOST=mariadb"
      - "PMA_PORT=3306"
      - "PMA_USER=user"
      - "PMA_PASSWORD=password"
      - "TZ=Australia/Sydney"
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.phpmyadmin.rule=Host(`phpmyadmin.local`)"
      - "traefik.http.services.phpmyadmin.loadbalancer.server.port=8080"
    networks:
      - mariadb
      - traefik

volumes:
  mariadb_data:
    driver: local
    name: mariadb_data
  phpmyadmin_certs:
    driver: local
    name: phpmyadmin_certs

networks:
  mariadb:
    driver: bridge
    name: mariadb
  traefik:
    external:
      name: traefik

链接

• GitHub: https://github.com/moonbuggy/docker-phpmyadmin
• Docker Hub: https://hub.docker.com/r/moonbuggy2000/phpmyadmin