morriz/mongo-express

mongo-express

镜像概述和主要用途

mongo-express是一个基于Node.js、Express和Bootstrap3开发的Web-based MongoDB管理界面。它提供直观的可视化操作界面，用于管理MongoDB数据库、集合及文档，支持多数据库连接、GridFS文件管理、响应式设计等功能，适用于开发环境下的MongoDB可视化管理。

核心功能和特性

• 多数据库连接：支持同时连接多个MongoDB数据库
• 数据库管理：查看、添加、删除数据库
• 集合管理：查看、添加、重命名、删除集合
• 文档操作：查看、添加、更新、删除文档
• 媒体预览：内联预览音频、视频、图片资源
• 文档优化：可折叠嵌套/大型对象，便于概览；按需异步加载大文档属性（默认>100KB）以保持集合视图流畅
• GridFS支持：添加、获取、删除超大文件
• BSON数据类型：支持在文档中使用各种BSON数据类型
• 响应式设计：基于Bootstrap 3，在小屏幕设备上可正常使用
• 权限控制：支持单个数据库认证或管理员权限查看所有数据库
• 数据库过滤：支持数据库黑白名单设置

使用场景和适用范围

• 开发环境中MongoDB数据库的可视化管理
• 快速查看和操作MongoDB中的数据
• 管理GridFS中的大型文件
• 作为Express中间件集成到现有应用中提供数据库管理功能

详细使用方法和配置说明

Docker部署

构建镜像

从项目目录构建镜像：

bash
docker build -t mongo-express .

运行容器

确保已运行MongoDB容器，并通过--link参数指定MongoDB容器名称：

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

环境变量配置

可通过以下环境变量修改容器配置：

使用示例

bash
docker run -it --rm \
    --name mongo-express \
    --link web_db_1:mongo \
    -p 8081:8081 \
    -e ME_CONFIG_OPTIONS_EDITORTHEME="ambiance" \
    -e ME_CONFIG_BASICAUTH_USERNAME="" \
    mongo-express

此示例链接到docker-compose生成的典型容器名称，修改编辑器主题为"ambiance"，并禁用基本认证。

访问方式

容器默认暴露8081端口，访问http://localhost:8081即可使用；若作为中间件挂载，需访问配置的config.site.baseUrl路径。

BSON数据类型支持

mongo-express文档编辑器/查看器支持以下BSON数据类型：

• 原生Javascript类型：字符串、数字、列表、布尔值、null等
• ObjectID/ObjectId：ObjectID()（创建新ID）、ObjectID(id)（使用24位十六进制字符串ID）
• ISODate：ISODate()（当前时间）、ISODate(timestamp)（指定时间戳），也支持new Date()
• DBRef/Dbref：DBRef(collection, objectID)、DBRef(collection, objectID, database)（数据库参数可选）
• Timestamp：Timestamp()（值为0）、Timestamp(time, ordinal)（如Timestamp(ISODate(), 0)）
• Code：Code(code)（代码可为原生Javascript函数或字符串，不支持作用域/上下文）
• MinKey：MinKey()
• MaxKey：MaxKey()
• Symbol：Symbol(string)

搜索功能

• 简单搜索：根据用户提供的key和value生成MongoDB find()对象，返回所有字段
• 高级搜索：直接将find和projection对象传递给db.collection.find(query, projection)，find用于查询，projection用于指定返回字段

限制

• 文档必须包含document._id属性才能编辑
• 二进制BSON数据类型未测试
• 由于JSON文档通过Javascript虚拟机解析，Web界面可能被用于在服务器上执行***Javascript，仅建议在私有开发环境中使用

许可证

MIT License

Copyright (c) 2012 Chun-hao Hu

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.