arm32v7/adminer 镜像文档

注意事项

本镜像为 adminer 官方镜像 的 arm32v7 架构专用仓库。更多信息请参见官方镜像文档中的 "非 amd64 架构说明" 和 "镜像源码变更处理"。

镜像概述与主要用途

Adminer（前身为 phpMinAdmin）是一款用 PHP 编写的全功能数据库管理工具。与 phpMyAdmin 不同，它仅由单个文件组成，可直接部署到目标服务器。支持 MySQL、PostgreSQL、SQLite、MS SQL、Oracle、Firebird、SimpleDB、Elasticsearch 和 MongoDB 等多种数据库。主要用途是提供轻量级、易部署的数据库管理界面。

核心功能与特性

• 单文件部署：仅需单个 PHP 文件即可运行，简化部署流程
• 多数据库支持：兼容 MySQL、PostgreSQL、SQLite 等主流数据库
• 插件扩展：内置所有官方插件，支持通过环境变量灵活加载
• 多部署模式：提供 Standalone（内置 Web 服务器）和 FastCGI（适用于现有 Web 服务器）两种模式
• 多架构支持：支持 amd64、arm32v6、arm32v7、arm64v8 等多种硬件架构
• 自定义设计：支持官方设计主题和自定义 CSS 样式

使用场景与适用范围

• 开发环境：快速搭建临时数据库管理界面，无需复杂配置
• 轻量级管理：适用于小型项目或个人开发者的数据库日常管理
• 多数据库统一管理：需要同时管理多种数据库类型的场景
• 现有 Web 架构集成：通过 FastCGI 模式与 Nginx、Apache 等 Web 服务器配合使用

支持的标签及对应 Dockerfile 链接

• 5.4.1, 5, latest, 5.4.1-standalone, 5-standalone, standalone
• 5.4.1-fastcgi, 5-fastcgi, fastcgi
• 4.17.1, 4, 4.17.1-standalone, 4-standalone
• 4.17.1-fastcgi, 4-fastcgi

详细使用方法与配置说明

1. 部署模式

1.1 Standalone 模式（内置 Web 服务器）

直接运行容器，使用内置 Web 服务器（默认端口 8080）：

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

访问 http://localhost:8080 或 [***] 即可打开管理界面。

1.2 FastCGI 模式（配合外部 Web 服务器）

适用于已运行 FastCGI 兼容 Web 服务器（如 Nginx）的场景：

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

需将 Web 服务器配置指向容器的 9000 端口。注意：此模式会暴露 FastCGI 套接字到网络，建议通过私有 Docker 网络或防火墙限制访问。

1.3 使用 docker compose

创建 compose.yaml 文件：

# 使用 root/example 作为用户名/密码凭证
services:
  adminer:
    image: arm32v7/adminer
    restart: always
    ports:
      - 8080:8080

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

启动服务：

$ docker compose up

初始化完成后访问 http://localhost:8080 即可。

2. 插件加载

本镜像内置所有官方插件（插件列表见 GitHub），通过 ADMINER_PLUGINS 环境变量指定加载的插件文件名：

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

需参数的插件

部分插件需要参数配置，直接通过 ADMINER_PLUGINS 加载会失败。例如加载 login-servers 插件：

$ docker run --link some_database:db -p 8080:8080 -e ADMINER_PLUGINS='login-servers' arm32v7/adminer

会提示需创建 /var/www/html/plugins-enabled/login-servers.php 文件，内容示例：

<?php
require_once('plugins/login-servers.php');

/** 设置支持的服务器
    * @param array 格式：array($域名) 或 array($域名 => $描述) 或 array($分类 => array())
    * @param string 驱动类型
    */
return new AdminerLoginServers(
    $servers = array('mysql' => 'MySQL服务器', 'pgsql' => 'PostgreSQL服务器'), // 自定义服务器列表
    $driver = 'server'
);

通过挂载文件添加配置：

$ docker run --link some_database:db -p 8080:8080 -v ./login-servers.php:/var/www/html/plugins-enabled/login-servers.php arm32v7/adminer

3. 界面设计自定义

3.1 使用官方设计主题

通过 ADMINER_DESIGN 环境变量指定官方设计主题名称（设计列表见 GitHub）：

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

3.2 自定义 CSS

挂载自定义样式文件到容器内 /var/www/html/adminer.css：

$ docker run --link some_database:db -p 8080:8080 -v ./custom.css:/var/www/html/adminer.css arm32v7/adminer

4. 连接外部服务器

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

$ docker run -p 8080:8080 -e ADMINER_DEFAULT_SERVER=mysql arm32v7/adminer

配置参数与环境变量

支持的数据库驱动

默认支持

• MySQL
• PostgreSQL
• SQLite
• SimpleDB
• Elasticsearch

需额外安装扩展的驱动

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

维护与支持

• 维护者：Tim Düsterhus（Docker 社区成员）
• 问题反馈：GitHub Issues
• 支持渠道：Docker Community Slack、Server Fault、Unix & Linux、Stack Overflow

许可信息

• 软件许可：详见 Adminer 开源许可
• 镜像包含的其他软件（如基础系统组件、依赖库等）可能具有独立许可，详情可参考 repo-info 仓库的 adminer 目录
• 使用前请确保遵守所有包含软件的许可协议。