stempler/mongodb

tutum-docker-mongodb

镜像概述和主要用途

【重要提示】此镜像即将弃用，请使用Docker官方MongoDB镜像：https://hub.docker.com/_/mongo/

tutum-docker-mongodb是用于运行MongoDB数据库服务器的基础Docker镜像，支持多种配置方式，包括密码设置、用户与数据库自定义、存储引擎选择等。不同MongoDB版本通过不同文件夹构建，推荐使用tutum/mongodb镜像（详情见https://github.com/tutumcloud/tutum-docker-mongodb%EF%BC%89%E3%80%82

核心功能和特性

• 灵活的身份验证：支持随机生成管理员密码或预设密码，也可禁用密码验证
• 用户与数据库自定义：可指定非管理员用户及对应数据库
• 存储引擎配置：MongoDB 3.0及以上支持指定存储引擎（如mmapv1、wiredTiger）
• oplog大小调整：支持自定义 oplog 大小（单位：MB）
• Web管理界面：暴露28017端口提供HTTP状态页面

使用场景和适用范围

适用于需要快速部署MongoDB的开发、测试环境，支持单机实例的基础配置。由于镜像已计划弃用，生产环境建议迁移至官方MongoDB镜像。

使用方法和配置说明

构建镜像

在tutum-mongodb目录下，执行以下命令构建指定版本镜像（以2.6为例）：

bash
docker build -t tutum/mongodb 2.6/ .

运行MongoDB服务器

基础运行（随机密码）

bash
docker run -d -p 27017:27017 -p 28017:28017 tutum/mongodb

首次运行时会生成随机管理员密码，通过容器日志获取：

bash
docker logs <CONTAINER_ID>

日志输出示例：

========================================================================
You can now connect to this MongoDB server using:

    mongo admin -u admin -p 5elsT6KtjrqV --host <host> --port <port>

Please remember to change the above password as soon as possible!
========================================================================

使用生成的密码连接：

bash
mongo admin -u admin -p 5elsT6KtjrqV

设置管理员密码

通过MONGODB_PASS环境变量指定预设密码：

bash
docker run -d -p 27017:27017 -p 28017:28017 -e MONGODB_PASS="mypass" tutum/mongodb

验证密码：

bash
mongo admin -u admin -p mypass
# 或通过HTTP界面验证
curl --user admin:mypass --digest http://localhost:28017/

自定义用户与数据库

通过环境变量创建指定用户和数据库：

bash
docker run -d -p 27017:27017 -p 28017:28017 \
  -e MONGODB_USER="user" \
  -e MONGODB_DATABASE="mydatabase" \
  -e MONGODB_PASS="mypass" \
  tutum/mongodb

验证凭据：

bash
mongo mydatabase -u user -p mypass

注意：MongoDB 3.x版本会同时创建与该用户同名的管理员账户，可通过mongo admin -u user -p mypass登录。

无密码运行

设置AUTH=no禁用密码验证（默认启用密码验证）：

bash
docker run -d -p 27017:27017 -p 28017:28017 -e AUTH=no tutum/mongodb

指定存储引擎（MongoDB 3.0+）

通过STORAGE_ENGINE指定存储引擎（默认wiredTiger）：

bash
docker run -d -p 27017:27017 -p 28017:28017 \
  -e AUTH=no \
  -e STORAGE_ENGINE=mmapv1 \
  tutum/mongodb:3.0

调整oplog大小（MongoDB 3.0+）

通过OPLOG_SIZE指定oplog大小（单位：MB）：

bash
docker run -d -p 27017:27017 -p 28017:28017 \
  -e AUTH=no \
  -e OPLOG_SIZE=50 \
  tutum/mongodb:3.0

默认行为：MongoDB默认分配可用磁盘空间的5%作为oplog，最小1GB，最大50GB。

来源：[***]