oriaks/phpmyadmin

oriaks/docker-images: phpMyAdmin 镜像文档

镜像概述

oriaks/docker-images 中的 phpMyAdmin 镜像提供了容器化的 phpMyAdmin 部署方案。phpMyAdmin 是一款广泛使用的基于 Web 的 MySQL 和 MariaDB 数据库管理工具，通过直观的图形界面简化数据库管理操作，无需复杂的命令行操作。

核心功能与特性

• Web 图形界面：提供直观的浏览器界面，支持数据库管理的全流程操作
• 数据库管理：支持数据库、表、字段的创建、修改、删除等操作
• SQL 功能：内置 SQL 编辑器，支持执行、保存和导出 SQL 查询
• 数据操作：支持数据导入（SQL、CSV 等格式）和导出（SQL、CSV、Excel 等格式）
• 用户权限管理：可配置和管理数据库用户及其权限
• 多语言支持：支持多种语言界面，满足不同地区用户需求
• 轻量级部署：容器化设计，部署简单，资源占用低

使用场景与适用范围

• 本地开发环境：开发人员快速搭建数据库管理界面，方便调试和测试
• 小型生产环境：小型项目或团队用于数据库日常维护和管理
• 教学与学习：学习 MySQL/MariaDB 数据库操作的可视化工具
• 临时管理需求：需要快速部署数据库管理界面的临时场景

使用方法与配置说明

基本部署（docker run）

通过以下命令快速启动 phpMyAdmin 容器，连接到本地或远程 MySQL/MariaDB 数据库：

bash
docker run -d \
  --name phpmyadmin \
  -p 8080:80 \
  -e PMA_HOST=mysql-host \  # 指定 MySQL/MariaDB 主机地址
  -e PMA_PORT=3306 \        # 指定数据库端口，默认为 3306
  -e PMA_USER=admin \       # 可选，默认登录用户名
  -e PMA_PASSWORD=password  # 可选，默认登录密码
  oriaks/docker-images:phpmyadmin

启动后，通过 http://localhost:8080 访问 phpMyAdmin 界面。

Docker Compose 配置示例

创建 docker-compose.yml 文件，实现 phpMyAdmin 与 MySQL 的联动部署：

yaml
version: '3'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: testdb
      MYSQL_USER: testuser
      MYSQL_PASSWORD: testpass
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - pma-network

  phpmyadmin:
    image: oriaks/docker-images:phpmyadmin
    ports:
      - "8080:80"
    environment:
      PMA_HOST: mysql  # 与 MySQL 服务名一致
      PMA_PORT: 3306
      PMA_ARBITRARY: 1  # 允许连接任意主机
    depends_on:
      - mysql
    networks:
      - pma-network

networks:
  pma-network:

volumes:
  mysql-data:

执行 docker-compose up -d 启动服务，访问 http://localhost:8080 即可使用 phpMyAdmin 管理 MySQL 数据库。

主要环境变量配置

注意事项

• 生产环境中建议通过 SSL 加密传输，配置 PMA_SSL_KEY 和 PMA_SSL_CERT 环境变量
• 避免使用弱密码，建议通过环境变量或 secrets 管理敏感信息
• 容器内数据不会持久化，数据库数据需通过挂载卷或外部数据库存储