samueltallet/mongodb-php-gui

MongoDB-PHP-GUI Docker镜像文档

镜像概述和主要用途

MongoDB-PHP-GUI是一个基于PHP、JavaScript、HTML和CSS开发的开源MongoDB图形化管理界面（GUI）。该镜像提供免费、轻量级的可视化工具，旨在简化MongoDB数据库的管理操作，支持通过直观的界面执行查询、查看数据结构及管理数据库资源，适用于需要快速部署可视化管理工具的场景。

核心功能和特性

• 图形化管理界面：提供直观的Web界面，支持数据库、集合的可视化浏览与操作。
• 开源免费：基于MIT许可协议开源，无需付费即可使用全部功能。
• 跨平台部署：通过Docker容器化封装，可在任何支持Docker的环境中快速部署。
• 轻量级设计：依赖资源少，启动迅速，适合本地开发或小型服务器环境。
• 基础查询支持：支持MongoDB基本查询操作，简化数据检索流程。

使用场景和适用范围

• 开发环境：开发人员在本地开发时管理MongoDB测试实例，简化数据调试与验证。
• 小型项目管理：个人或小型团队用于管理项目中的MongoDB数据库，降低命令行操作门槛。
• 快速部署需求：需要无需复杂配置即可启动的MongoDB可视化工具场景。

使用方法和配置说明

前提条件

• 已安装Docker引擎（Docker官方安装指南）。
• 若需连接宿主机MongoDB服务，确保MongoDB实例已启动并允许外部访问（或通过--add-host配置容器网络）。

获取镜像

通过Docker Hub拉取最新镜像：

bash
docker pull samueltallet/mongodb-php-gui

启动容器

基本运行命令

bash
docker run \
  --add-host localhost:172.17.0.1 \  # 允许容器访问宿主机MongoDB（172.17.0.1为Docker默认网关）
  --publish 5000:5000 \             # 端口映射：宿主机5000端口映射到容器5000端口
  --rm \                            # 容器退出后自动删除临时文件
  samueltallet/mongodb-php-gui

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mongodb-gui:
    image: samueltallet/mongodb-php-gui
    ports:
      - "5000:5000"  # 端口映射
    extra_hosts:
      - "localhost:172.17.0.1"  # 配置宿主机访问
    restart: unless-stopped  # 容器退出后自动重启（可选）

启动服务：

bash
docker-compose up -d

访问GUI界面

容器启动后，在浏览器中访问以下地址即可打开管理界面：

http://127.0.0.1:5000/

配置参数说明

目前镜像主要通过启动命令参数配置，核心参数说明如下：

注：当前版本暂不支持通过环境变量自定义配置，所有参数需通过启动命令指定。

截图展示

!https://raw.githubusercontent.com/SamuelTallet/MongoDB-PHP-GUI/master/docs/screenshots/query-database.png
图：MongoDB-PHP-GUI查询数据库界面