hachque/phpmyadmin

phpMyAdmin Docker镜像文档

镜像概述和主要用途

该镜像提供phpMyAdmin的Docker化部署，用于通过Web界面管理MySQL/MariaDB数据库。支持链接Docker环境中的MariaDB容器或连接外部MySQL/MariaDB服务器，配置通过宿主机挂载的配置目录进行管理。

核心功能和特性

• 支持链接Docker环境中的MariaDB容器，自动获取数据库连接信息
• 支持连接外部MySQL/MariaDB服务器，可手动配置数据库地址
• 通过自定义脚本生成phpMyAdmin配置文件，灵活适配不同环境
• 可配合反向代理使用或直接暴露HTTP/HTTPS端口
• 设计为每次启动创建新容器，避免旧容器状态影响

使用场景和适用范围

适用于需要通过Web界面管理MySQL/MariaDB数据库的场景，特别适合Docker化部署环境，包括开发、测试和生产环境的数据库管理需求。

使用方法和配置说明

配置准备

1. 创建配置目录及脚本文件

   bash
   mkdir -p /path/to/config
   touch /path/to/config/script.pre
   chmod +x /path/to/config/script.pre
   

2. 编辑script.pre文件，添加以下内容（根据实际环境调整）：

   bash
   #!/bin/bash
   
   echo "Generating configuration.."
   cat >/srv/www/config.inc.php <<EOF
   <?php
   /* vim: set expandtab sw=4 ts=4 sts=4: */
   /**
    * phpMyAdmin sample configuration, you can use it as base for
    * manual configuration. For easier setup you can use setup/
    *
    * All directives are explained in Documentation.html and on phpMyAdmin
    * wiki <http://wiki.phpmyadmin.net>.
    *
    * @version \$Id$
    * @package phpMyAdmin
    */
   
   /*
    * This is needed for cookie based authentication to encrypt password in
    * cookie
    */
   \$cfg['blowfish_secret'] = '<replace this with random text>';
   
   /*
    * Servers configuration
    */
   \$i = 0;
   
   /*
    * First server
    */
   \$i++;
   /* Authentication type */
   \$cfg['Servers'][\$i]['auth_type'] = 'cookie';
   /* Server parameters */
   \$cfg['Servers'][\$i]['host'] = '${LINKED_MARIADB_PORT_3306_TCP_ADDR}:${LINKED_MARIADB_PORT_3306_TCP_PORT}';
   \$cfg['Servers'][\$i]['connect_type'] = 'tcp';
   \$cfg['Servers'][\$i]['compress'] = false;
   /* Select mysqli if your server has it */
   \$cfg['Servers'][\$i]['extension'] = 'mysqli';
   \$cfg['Servers'][\$i]['AllowNoPassword'] = false;
   
   /* rajk - for blobstreaming */
   \$cfg['Servers'][\$i]['bs_garbage_threshold'] = 50;
   \$cfg['Servers'][\$i]['bs_repository_threshold'] = '32M';
   \$cfg['Servers'][\$i]['bs_temp_blob_timeout'] = 600;
   \$cfg['Servers'][\$i]['bs_temp_log_threshold'] = '32M';
   
   \$cfg['UploadDir'] = '';
   \$cfg['SaveDir'] = '';
   
   
   EOF
   

   注意：若连接外部服务器，需将host参数替换为实际数据库地址，如'db.example.com:3306'

运行容器

链接MariaDB容器（Docker内部数据库）

bash
/usr/bin/docker run -v /path/to/config:/config --name=phpmyadmin --link mariadb:linked_mariadb hachque/phpmyadmin

连接外部服务器（非Docker内部数据库）

bash
/usr/bin/docker run -v /path/to/config:/config --name=phpmyadmin hachque/phpmyadmin

参数说明

• -v /path/to/config:/config: 将宿主机配置目录挂载到容器内，用于提供配置脚本
• --name phpmyadmin: 指定容器名称为phpmyadmin
• --link mariadb:linked_mariadb: （可选）链接MariaDB容器，自动获取数据库连接信息
• hachque/phpmyadmin: 镜像名称

直接暴露端口（不使用反向代理）

若不使用反向代理（如hachque/nginx-autoproxy），可添加端口映射参数：

bash
/usr/bin/docker run -v /path/to/config:/config --name=phpmyadmin -p 80:80 -p 443:443 hachque/phpmyadmin

系统服务配置（systemd）

推荐配置systemd服务以实现自动启动和管理，创建/etc/systemd/system/phpmyadmin.service文件：

ini
[Unit]
Description=phpmyadmin
Requires=docker.service mariadb.service

[Service]
ExecStart=/usr/bin/docker run -v /path/to/config:/config --name=phpmyadmin --link mariadb:linked_mariadb hachque/phpmyadmin
ExecStop=/usr/bin/docker stop phpmyadmin
ExecStop=/usr/bin/docker rm phpmyadmin
Restart=always
RestartSec=5s

[Install]
WantedBy=multi-user.target

注意：根据实际运行命令调整ExecStart中的参数

SSH登录信息

• 用户名: root
• 密码: linux
• 端口: 24

注意：Phabricator的仓库托管服务使用22端口