Adminer Docker镜像文档

镜像概述与主要用途

Adminer（前身为phpMinAdmin）是一款用PHP编写的全功能数据库管理工具。与phpMyAdmin不同，它仅由单个文件构成，可直接部署到目标服务器。Adminer支持MySQL、PostgreSQL、SQLite、MS SQL、Oracle、Firebird、SimpleDB、Elasticsearch和MongoDB等多种数据库系统，适用于轻量级、便捷的数据库管理场景。

核心功能与特性

• 多数据库支持：兼容MySQL、PostgreSQL、SQLite等主流数据库系统。
• 单文件部署：仅需单个PHP文件即可运行，部署简单高效。
• 轻量级设计：资源占用低，适合开发环境和小型服务器。
• 插件扩展：支持***插件系统，可通过环境变量加载插件增强功能。
• 主题定制：内置多种设计主题，支持自定义CSS样式。
• 灵活部署模式：支持独立运行（内置Web服务器）和FastCGI模式（配合现有Web服务器）。

使用场景与适用范围

• 开发环境数据库管理：快速搭建本地数据库管理界面，简化开发流程。
• 轻量级服务器部署：适用于资源有限的服务器，替代复杂的数据库管理工具。
• 多数据库系统管理：统一管理不同类型数据库，减少工具切换成本。
• 临时数据库维护：通过单文件部署特性，快速接入临时环境进行数据操作。

支持的标签及对应Dockerfile链接

快速参考

维护者

Tim Düsterhus（Docker社区成员）

获取帮助

• Docker社区Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

提交问题

[***]

支持的架构

amd64、arm32v6、arm32v7、arm64v8、i386、ppc64le、riscv64、s390x

镜像更新信息

• official-images仓库library/adminer标签
• official-images仓库library/adminer文件（历史记录）

使用方法

独立运行（Standalone）

Adminer可独立运行，内置Web服务器，直接通过浏览器访问：

console
$ docker run --link some_database:db -p 8080:8080 amd64/adminer

• --link some_database:db：将数据库容器链接到Adminer（some_database为数据库容器名称）。
• -p 8080:8080：映射容器8080端口到主机，通过http://localhost:8080或[***]访问。

FastCGI模式

若已有FastCGI兼容的Web服务器（如Nginx），可通过FastCGI模式运行：

console
$ docker run --link some_database:db -p 9000:9000 amd64/adminer:fastcgi

• 容器暴露9000端口，需将Web服务器配置指向该端口。
• 注意：此模式会将FastCGI socket暴露到网络，需配置防火墙规则或使用私有Docker网络限制访问。

使用Docker Compose

通过docker-compose快速部署Adminer及数据库（以MySQL为例）：

yaml
# compose.yaml
services:
  adminer:
    image: amd64/adminer
    restart: always
    ports:
      - 8080:8080  # 访问端口

  db:
    image: mysql:5.6
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example  # MySQL root密码

启动命令：

console
$ docker compose up

等待初始化完成后，通过http://localhost:8080访问。

加载插件

镜像内置所有***插件（插件列表），通过ADMINER_PLUGINS环境变量指定插件名称（空格分隔）：

console
$ docker run --link some_database:db -p 8080:8080 -e ADMINER_PLUGINS='tables-filter tinymce' amd64/adminer

需参数的插件

若插件需要参数（如login-servers），需手动创建插件文件并挂载到容器/var/www/html/plugins-enabled/目录：

1. 运行时若插件需参数，会提示创建文件（例如login-servers）：

   需创建文件 "/var/www/html/plugins-enabled/login-servers.php"，内容如下：
   <?php
   require_once('plugins/login-servers.php');
   return new AdminerLoginServers(
       $servers = ['mysql-host', 'pgsql-host'],  # 服务器列表
       $driver = 'server'  # 驱动类型
   );
   

2. 创建文件后，通过-v挂载到容器：

   console
   $ docker run -v ./login-servers.php:/var/www/html/plugins-enabled/login-servers.php -e ADMINER_PLUGINS='login-servers' ... amd64/adminer
   

选择设计主题

通过ADMINER_DESIGN环境变量指定内置主题（主题列表）：

console
$ docker run -p 8080:8080 -e ADMINER_DESIGN='nette' amd64/adminer

• 内置主题名称：如nette、haeckel、pepa-linha等。
• 自定义主题：挂载自定义CSS文件到容器/var/www/html/adminer.css。

连接外部服务器

通过ADMINER_DEFAULT_SERVER指定默认数据库主机（适用于外部服务器或非db名称的容器）：

console
$ docker run -p 8080:8080 -e ADMINER_DEFAULT_SERVER=mysql-host amd64/adminer

• mysql-host为数据库服务器地址（如192.168.1.100或容器名称）。

配置参数与环境变量

支持的数据库驱动

默认支持

镜像默认支持以下驱动（无需额外配置）：

• MySQL
• PostgreSQL
• SQLite
• SimpleDB
• Elasticsearch

需额外安装的驱动

其他驱动需安装对应PHP扩展（基于镜像构建自定义镜像）：

• MS SQL：安装pdo_dblib扩展
• Oracle：安装oci8扩展
• Firebird：安装interbase扩展
• MongoDB：安装mongodb扩展

许可证信息

• Adminer软件许可证：查看详情。
• 镜像包含的其他软件（如Bash、基础系统组件等）可能具有独立许可证，详细信息见repo-info仓库adminer目录。

使用前请确保遵守所有包含软件的许可证要求。