calverley/mongo-express

mongo-express Docker镜像文档

镜像概述

mongo-express是一个基于Web的MongoDB管理界面，采用Node.js、Express和Bootstrap3开发。它提供了直观的图形化界面，用于管理MongoDB数据库、集合和文档，支持多种高级功能如GridFS、BSON数据类型处理等，适用于开发环境中的MongoDB管理操作。

核心功能和特性

• 多数据库管理：连接并管理多个MongoDB数据库
• 集合操作：查看、添加、重命名和删除集合
• 文档操作：查看、添加、更新和删除文档
• 媒体预览：内联预览音频、视频和图像资产
• 大型文档处理：按需异步加载大文档属性（默认>100KB）以保持界面流畅
• GridFS支持：管理超大文件的添加、获取和删除
• BSON数据类型：支持多种BSON数据类型（ObjectID、ISODate、DBRef等）
• 响应式设计：基于Bootstrap3，适配移动设备
• 权限控制：支持数据库级认证和管理员模式查看所有数据库
• 安全配置：数据库黑白名单、自定义CA及CA验证禁用
• 副本集支持：兼容MongoDB副本集

使用场景和适用范围

• 开发环境中的MongoDB数据库管理
• 快速查看和编辑MongoDB数据
• 演示和教学环境中的MongoDB操作展示
• 作为Express中间件集成到现有Node.js应用中

注意：mongo-express主要用于开发环境，不建议在生产环境中使用，因为Web界面可能存在安全风险。

使用方法

Docker快速启动

确保已运行MongoDB容器，并通过--link参数关联：

console
$ docker run -it --rm -p 8081:8081 --link YOUR_MONGODB_CONTAINER:mongo mongo-express

访问 http://localhost:8081 即可打开管理界面。

从源码构建

console
$ git clone https://github.com/mongo-express/mongo-express.git
$ cd mongo-express
$ docker build -t mongo-express .
$ docker run -it --rm -p 8081:8081 --link YOUR_MONGODB_CONTAINER:mongo mongo-express

Docker Compose示例

yaml
version: '3'
services:
  mongo:
    image: mongo
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: example
  mongo-express:
    image: mongo-express
    restart: always
    ports:
      - "8081:8081"
    environment:
      ME_CONFIG_MONGODB_ADMINUSERNAME: root
      ME_CONFIG_MONGODB_ADMINPASSWORD: example
      ME_CONFIG_MONGODB_SERVER: mongo
    depends_on:
      - mongo

配置参数（环境变量）

环境变量配置示例

console
$ docker run -it --rm \
    --name mongo-express \
    --link mongo:mongo \
    -p 8081:8081 \
    -e ME_CONFIG_OPTIONS_EDITORTHEME="ambiance" \
    -e ME_CONFIG_BASICAUTH_USERNAME="" \
    -e ME_CONFIG_MONGODB_ENABLE_ADMIN="true" \
    -e ME_CONFIG_MONGODB_ADMINUSERNAME="root" \
    -e ME_CONFIG_MONGODB_ADMINPASSWORD="password" \
    mongo-express

BSON数据类型支持

mongo-express支持以下BSON数据类型：

• 原生JavaScript类型：字符串、数字、列表、布尔值、null等
• ObjectID/ObjectId：ObjectID()创建新ID，ObjectID(id)使用指定ID
• ISODate：ISODate()创建当前时间，ISODate(timestamp)使用指定时间戳
• DBRef/Dbref：DBRef(collection, objectID)或DBRef(collection, objectID, database)
• Timestamp：Timestamp()创建值为0的时间戳，Timestamp(time, ordinal)指定时间和序号
• Code：Code(code)支持JavaScript函数或字符串
• MinKey：MinKey()
• MaxKey：MaxKey()
• Symbol：Symbol(string)

限制和注意事项

• 文档必须包含_id属性才能编辑
• 二进制BSON数据类型未经过充分测试
• 由于JSON文档通过JavaScript虚拟机解析，存在潜在的***代码执行风险，仅建议在私有开发环境中使用

搜索功能

• 简单搜索：通过提供的key和value生成MongoDB查询，返回所有字段
• 高级搜索：直接将find和projection对象传递给db.collection.find(query, projection)，支持复杂查询

详细使用方法参考MongoDB find()文档。