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界面

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

[***]

配置参数说明

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

参数	说明
`--publish 5000:5000`	端口映射，格式为`宿主机端口:容器端口`，默认容器内服务运行在5000端口。
`--add-host localhost:172.17.0.1`	配置容器内`localhost`指向宿主机（Docker默认网关IP），用于连接宿主机MongoDB服务。
`--rm`	容器停止后自动删除，避免残留临时文件（可选）。
`--restart`	配置容器重启策略（如`unless-stopped`），适用于需要持久运行的场景（可选）。