Adminer Docker镜像文档

1. 镜像概述和主要用途

Adminer是一款轻量级数据库管理工具，提供直观的Web界面用于管理多种数据库系统。本镜像基于wodby/adminer构建，旨在为Docker环境提供便捷的数据库管理解决方案，支持快速配置和集成到现有容器化应用架构中。

2. 核心功能和特性

• 多数据库支持：兼容MySQL、PostgreSQL、SQLite、MongoDB等主流数据库系统
• 轻量级设计：体积小（约5MB），资源占用低，启动速度快
• 安全特性：内置CSRF保护、SQL注入防护及会话管理机制
• 界面定制：支持自定义主题（如pico、nette）和多语言切换
• 功能完整性：提供数据库创建、表结构管理、数据查询、导入/导出等核心功能
• 容器化适配：优化Docker环境下的网络配置，支持与数据库容器联动

3. 使用场景和适用范围

• 本地开发环境：配合Docker化应用快速调试数据库
• 临时管理需求：无需安装客户端，通过浏览器临时访问远程或本地数据库
• 多数据库统一管理：在单一界面中切换管理不同类型的数据库实例
• CI/CD流程集成：作为测试环境的辅助工具，验证数据库迁移或数据初始化结果

4. 使用方法和配置说明

4.1 快速启动（docker run）

基础命令（连接外部数据库）

docker run -d \
  --name adminer \
  -p 8080:8080 \
  -e ADMINER_DB_HOST=mysql-host \
  -e ADMINER_DB_USER=root \
  -e ADMINER_DB_PASSWORD=secret \
  wodby/adminer:latest

连接Docker内部数据库容器

docker run -d \
  --name adminer \
  -p 8080:8080 \
  --link mysql-container:db \  # 链接到数据库容器（假设容器名为mysql-container）
  -e ADMINER_DB_HOST=db \       # 使用链接别名作为数据库主机
  wodby/adminer:latest

4.2 Docker Compose配置示例

与MySQL集成

version: '3.8'

services:
  adminer:
    image: wodby/adminer:latest
    ports:
      - "8080:8080"
    environment:
      ADMINER_DEFAULT_DB: app_db          # 默认数据库名
      ADMINER_THEME: pico                 # 主题（支持pico/nette/pepa-linha等）
      ADMINER_LANGUAGE: zh                 # 界面语言（zh=中文，en=英文等）
    depends_on:
      - mysql
    networks:
      - app-network

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: app_db
    networks:
      - app-network

networks:
  app-network:

4.3 网络配置说明

• 外部数据库访问：通过ADMINER_DB_HOST指定数据库IP或域名，需确保容器网络可访问目标地址
• 容器内部访问：通过--link或自定义网络（如示例中的app-network）实现与数据库容器的通信，推荐使用自定义网络而非--link（Docker官方已不推荐--link）
• 端口映射：默认暴露8080端口，可通过-p <宿主机端口>:8080自定义访问端口

5. 配置参数和环境变量

6. 相关链接

• 官方仓库：wodby/adminer
• Docker4WordPress集成方案：docker4wordpress
• Wodby WordPress部署文档：wodby.com/stacks/wordpress