Adminer Docker镜像使用指南

快速参考

维护者

Tim Düsterhus（Docker社区成员）

获取帮助

可通过以下渠道获取帮助：

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

支持的标签及对应Dockerfile链接

• 5.x版本

  • 5.4.0, 5, latest, 5.4.0-standalone, 5-standalone, standalone
  • 5.4.0-fastcgi, 5-fastcgi, fastcgi

• 4.x版本

  • 4.17.1, 4, 4.17.1-standalone, 4-standalone
  • 4.17.1-fastcgi, 4-fastcgi

快速参考（续）

提交issue

[***]

支持的架构

（更多信息）

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

镜像 artifact 详情

repo-info 仓库的 repos/adminer/ 目录（历史记录）
（包含镜像元数据、传输大小等）

镜像更新

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

本文档来源

docs 仓库的 adminer/ 目录（历史记录）

Adminer

Adminer是什么？

Adminer（前身为phpMinAdmin）是一款用PHP编写的全功能数据库管理工具。与phpMyAdmin不同，它仅需单个文件即可部署到目标服务器。支持MySQL、PostgreSQL、SQLite、MS SQL、Oracle、Firebird、SimpleDB、Elasticsearch和MongoDB等数据库。

adminer.org

!logo

如何使用此镜像

独立运行（Standalone）

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

运行后，在浏览器中访问 [***] 或 [***] 即可使用。

FastCGI模式

若已运行支持FastCGI的Web服务器，可通过FastCGI运行Adminer：

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

然后将Web服务器指向容器的9000端口。

注意：此方式会将FastCGI socket暴露到互联网，需配置防火墙规则或使用私有Docker网络以防止直接访问。

通过 docker compose 使用

compose.yaml 示例：

yaml
# 使用 root/example 作为用户名/密码凭证

services:
  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080

  db:
    image: mysql:5.6
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example

运行 docker compose up，待初始化完成后，访问 [***] 或 [***]

加载插件

此镜像内置所有***Adminer插件，插件列表见GitHub：[***]。

通过环境变量加载插件：
使用 ADMINER_PLUGINS 环境变量指定插件文件名列表：

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

需参数的插件：
若插件需要参数（如 login-servers），直接通过 ADMINER_PLUGINS 添加会提示错误。需在容器内创建自定义文件 /var/www/html/plugins-enabled/[插件名].php，示例：

console
$ docker run --link some_database:db -p 8080:8080 -e ADMINER_PLUGINS='login-servers' adminer
# 错误提示会显示需创建文件，内容示例：
<?php
require_once('plugins/login-servers.php');
return new AdminerLoginServers(
    $servers = ???,  # 需自行定义服务器列表
    $driver = 'server'
);

选择设计风格

镜像内置Adminer源码包中的所有设计风格，列表见GitHub：[***]。

使用内置设计：通过 ADMINER_DESIGN 环境变量指定设计名称：

console
$ docker run --link some_database:db -p 8080:8080 -e ADMINER_DESIGN='nette' adminer

自定义设计：添加文件 /var/www/html/adminer.css 即可应用自定义样式。

外部服务器使用

通过 ADMINER_DEFAULT_SERVER 环境变量指定默认数据库主机，适用于连接外部服务器或非默认名称（db）的Docker容器：

console
docker run -p 8080:8080 -e ADMINER_DEFAULT_SERVER=mysql adminer

支持的数据库驱动

镜像默认支持以下驱动：

• MySQL
• PostgreSQL
• SQLite
• SimpleDB
• Elasticsearch

其他驱动需额外安装PHP扩展：

• MS SQL：pdo_dblib
• Oracle：oci8
• Firebird：interbase
• MongoDB：mongodb

许可协议

查看此镜像包含软件的许可信息：[***]。

与所有Docker镜像一样，可能包含其他软件（如Bash等基础系统组件），其许可协议需另行确认。部分自动检测的许可信息可在 repo-info 仓库的 adminer/ 目录 查看。

使用前，用户需确保遵守所有包含软件的相关许可协议。