wodby/adminer

Adminer Docker镜像文档

1. 镜像概述和主要用途

Adminer是一款轻量级数据库管理工具，提供直观的Web界面用于管理多种数据库系统。本镜像基于https://github.com/wodby/adminer%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E4%B8%BADocker%E7%8E%AF%E5%A2%83%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E7%AE%A1%E7%90%86%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%EF%BC%8C%E6%94%AF%E6%8C%81%E5%BF%AB%E9%80%9F%E9%85%8D%E7%BD%AE%E5%92%8C%E9%9B%86%E6%88%90%E5%88%B0%E7%8E%B0%E6%9C%89%E5%AE%B9%E5%99%A8%E5%8C%96%E5%BA%94%E7%94%A8%E6%9E%B6%E6%9E%84%E4%B8%AD%E3%80%82

2. 核心功能和特性

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

3. 使用场景和适用范围

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

4. 使用方法和配置说明

4.1 快速启动（docker run）

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

bash
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内部数据库容器

bash
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集成

yaml
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. 相关链接

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