Bitnami phpMyAdmin 镜像文档

镜像概述和主要用途

phpMyAdmin 是一款用 PHP 编写的免费软件工具，旨在通过 Web 界面管理 MySQL 和 MariaDB 数据库。它支持对 MySQL 和 MariaDB 进行广泛的操作，是 Web 托管服务中最流行的数据库管理工具之一。Bitnami 提供的 phpMyAdmin 镜像/Helm Chart 经过优化，便于在 Kubernetes 集群或 Docker 环境中快速部署和使用，适用于开发、测试及生产环境（需注意后续安全镜像迁移说明）。

核心功能和特性

核心功能

• 通过 Web 界面执行 SQL 语句、管理数据库、表、字段、索引等
• 支持导入/导出数据库（SQL、CSV、XML 等格式）
• 用户权限管理、数据库备份与恢复
• 支持 MySQL 和 MariaDB 的多种高级特性（存储过程、触发器等）

Bitnami 镜像特性

• 预配置的安全优化环境，非 root 用户运行
• 支持 Kubernetes 部署（通过 Helm Chart）
• 可集成 Ingress 控制器实现外部访问
• 支持 Prometheus 监控（通过 apache-exporter 侧car容器）
• 灵活的环境变量配置和自定义初始化脚本
• 兼容 Docker 和 Kubernetes 生态系统

使用场景和适用范围

适用场景

• 开发环境：本地或开发服务器中快速搭建数据库管理界面
• Web 主机服务：作为托管服务的 MySQL/MariaDB 配套管理工具
• Kubernetes 集群：在容器化环境中可视化管理数据库资源
• 小型团队协作：通过 Web 界面共享数据库管理权限

适用范围

• 需要通过 Web 界面管理 MySQL/MariaDB 的用户
• 采用 Docker 或 Kubernetes 进行容器化部署的环境
• 对安全性和部署便捷性有要求的场景

详细的使用方法和配置说明

1. Docker 快速部署

基本 Docker Run 命令

docker run -d \
  --name phpmyadmin \
  -p 8080:8080 \
  -e PMA_HOST=mysql-host \  # MySQL/MariaDB 主机地址
  -e PMA_PORT=3306 \        # MySQL/MariaDB 端口
  -e PMA_USER=root \        # 数据库管理员用户名（可选）
  -e PMA_PASSWORD=password  # 数据库管理员密码（可选）
  bitnami/phpmyadmin:latest

访问 http://localhost:8080 即可打开 phpMyAdmin 界面。

Docker Compose 配置示例

version: '3'
services:
  phpmyadmin:
    image: bitnami/phpmyadmin:latest
    ports:
      - "8080:8080"
    environment:
      - PMA_HOST=mysql
      - PMA_PORT=3306
      - PMA_ARBITRARY=1  # 允许连接任意主机（开发环境用）
    depends_on:
      - mysql

  mysql:
    image: bitnami/mysql:latest
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=testdb
    volumes:
      - mysql-data:/bitnami/mysql/data

volumes:
  mysql-data:

2. Kubernetes Helm Chart 部署

先决条件

• Kubernetes 1.23+
• Helm 3.8.0+

安装 Helm Chart

# 添加 Bitnami 仓库（若未添加）
helm repo add bitnami [***]
helm repo update

# 安装 Chart（ release 名称为 my-release）
helm install my-release oci://registry-1.docker.io/bitnamicharts/phpmyadmin

自定义参数安装

通过 --set 覆盖默认参数：

helm install my-release oci://registry-1.docker.io/bitnamicharts/phpmyadmin \
  --set service.type=NodePort \
  --set ingress.enabled=true \
  --set ingress.hostname=phpmyadmin.example.com \
  --set pmaHost=mysql-service \  # Kubernetes 集群内 MySQL 服务名
  --set pmaPort=3306

3. 关键配置说明

环境变量配置

Ingress 配置（Kubernetes）

启用 Ingress 以通过域名访问：

ingress:
  enabled: true
  hostname: phpmyadmin.example.com
  annotations:
    kubernetes.io/ingress.class: nginx
    cert-manager.io/cluster-issuer: letsencrypt-prod  # 若使用 cert-manager
  tls:
    - hosts:
        - phpmyadmin.example.com
      secretName: phpmyadmin-tls

Prometheus 监控集成（Kubernetes）

启用 Prometheus 指标收集：

metrics:
  enabled: true
  serviceMonitor:
    enabled: true  # 若使用 Prometheus Operator
  service:
    annotations:
      prometheus.io/scrape: "true"
      prometheus.io/port: "9117"

参数说明

全局参数

通用参数

phpMyAdmin 特定参数

⚠️ 重要通知：Bitnami 镜像目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将启动 Bitnami Secure Images 计划，调整公共镜像目录：

主要变更

1. 安全镜像开放：首次向社区用户提供安全优化版容器镜像。
2. 非硬化镜像 deprecation：逐步停止对 Debian 基础的非硬化镜像的免费支持，公共目录将仅保留少量硬化镜像（仅 latest 标签，用于开发）。
3. 旧镜像迁移：所有现有容器镜像（含历史版本标签，如 2.50.0、10.6）将在两周内从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy，且不再更新。
4. 生产环境建议：生产环境需采用 Bitnami Secure Images，包含硬化容器、更小攻击面、CVE 透明度（VEX/KEV）、SBOM 及企业支持。

影响与建议

• 开发环境：可继续使用 latest 标签的硬化镜像，但需注意无长期更新。
• 生产环境：迁移至 Bitnami Secure Images 以获取长期支持和安全更新。

详情参见 Bitnami Secure Images 公告。