shinsenter/phpmyadmin

镜像概述

shinsenter/phpmyadmin 是一款生产就绪的 Docker 镜像，内置自动 phpMyAdmin 安装程序，基于 PHP 环境构建。该镜像提供 Debian 和 Alpine 两种版本，适用于快速部署和管理 MySQL/MariaDB 数据库的 Web 界面工具。

• Docker Hub: [***]
• GitHub Packages: [***]

核心功能与特性

1. 灵活配置：支持通过环境变量自定义 PHP 和 PHP-FPM 配置，无需重建镜像即可调整参数。
2. 自动安装：挂载空目录时，自动下载并部署 phpMyAdmin 源代码，快速初始化项目。
3. 内置工具：集成最新版 Composer，便于依赖管理和项目构建。
4. HTTPS 支持：预包含测试用 SSL 证书，可通过挂载自定义证书实现生产环境 HTTPS。
5. 持续更新：每日构建以同步上游 PHP、基础 OS 及依赖组件的最新安全更新。

使用场景

• 快速部署：个人或企业环境中快速搭建 phpMyAdmin 管理界面。
• 开发环境：本地开发时通过容器化方式隔离 phpMyAdmin 运行环境，避免依赖冲突。
• 生产环境：配合自定义 SSL 证书和稳定镜像标签，构建安全可靠的数据库管理平台。

使用方法

新建项目

当挂载空目录至容器时，镜像会自动下载 phpMyAdmin 源代码并完成初始化，适用于从零开始搭建项目。

步骤：

1. 在主机创建空目录用于存放项目代码：

   shell
   mkdir phpmyadmin
   

2. 运行容器并挂载该目录：

   shell
   docker run -p 80:80 -p 443:443 -p 443:443/udp \
       -v ./phpmyadmin:/var/www/html \
       shinsenter/phpmyadmin:latest
   

   容器会检测 /var/www/html 为空目录，并自动克隆 phpMyAdmin 源代码至该路径。

使用现有项目

若需部署已有的 phpMyAdmin 项目，可将主机项目目录直接挂载至容器的 /var/www/html 路径。由于采用卷挂载方式，主机端代码修改会实时同步至容器内，便于开发调试。

示例命令：

shell
docker run -p 80:80 -p 443:443 \
    -v /path/to/existing/phpmyadmin:/var/www/html \
    shinsenter/phpmyadmin:latest

配置 HTTPS

测试环境

镜像内置测试用 SSL 证书，路径如下：

• 证书：/etc/ssl/site/server.crt
• 私钥：/etc/ssl/site/server.key

生产环境

通过以下方式替换为自定义 SSL 证书：

方法 1：使用 Dockerfile

dockerfile
FROM shinsenter/phpmyadmin:latest

# 复制自定义证书至容器
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

# 可选：添加项目代码（若未通过卷挂载）
# ADD --chown=$APP_USER:$APP_GROUP ./phpmyadmin/ /var/www/html/

方法 2：使用 docker run

shell
docker run -p 80:80 -p 443:443 \
    -v ./phpmyadmin:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    shinsenter/phpmyadmin:latest

方法 3：使用 docker-compose

yaml
services:
  phpmyadmin:
    image: shinsenter/phpmyadmin:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./phpmyadmin:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

稳定镜像标签

由于上游依赖（PHP、OS、Composer 等）持续更新，同一源代码构建的镜像可能存在差异。建议通过以下步骤标记稳定版本，确保生产环境一致性：

1. 拉取最新镜像：

   shell
   docker pull shinsenter/phpmyadmin:latest
   

2. 标记为稳定版本：

   shell
   docker tag shinsenter/phpmyadmin:latest your-repo/phpmyadmin:stable
   

3. 推送至私有仓库（可选）：

   shell
   docker push your-repo/phpmyadmin:stable
   

生产环境中使用 your-repo/phpmyadmin:stable 作为基础镜像，避免非预期更新。

贡献与支持

若该镜像对您有帮助，可通过 *** ***支持开发，或在 GitHub 提交 issue 反馈问题。

许可证

本项目基于 GNU General Public License v3.0 许可协议开源。使用或二次开发时，请遵守协议要求并注明出处。