mongocamp/mongodb

mongocamp/mongodb:8.0.15 镜像文档

!Docker Pulls !Docker Image Size with architecture (latest by date/latest semver) !Docker Image Version (latest semver)

镜像概述和主要用途

本镜像用于构建MongoDB 8.0.15的Docker容器，旨在简化MongoDB的容器化部署流程。通过该镜像，用户可快速搭建MongoDB数据库服务，并支持通过环境变量灵活配置数据库参数，满足开发、测试及生产环境的不同需求。

核心功能和特性

• 持久化存储：支持数据目录挂载，确保容器重启后数据不丢失，默认数据目录为/var/lib/mongodb，可通过环境变量自定义
• 灵活配置：提供丰富的环境变量，支持配置认证、端口、存储引擎、副本集、最大连接数等关键参数
• 副本集支持：通过设置MONGO_REPLICA_SET_NAME可快速配置MongoDB副本集
• 存储引擎选择：默认使用wiredTiger存储引擎，支持通过MONGO_STORAGEENGINE切换其他引擎
• 额外参数扩展：通过MONGO_EXTRA_ARGS可传递任意mongod命令行参数，满足个性化配置需求

使用场景和适用范围

• 开发环境：快速搭建本地MongoDB服务，无需复杂的本地安装配置
• 测试环境：通过环境变量快速调整数据库参数，验证不同配置下的应用表现
• 生产环境：支持副本集等高可用配置，结合容器编排工具（如Kubernetes、Docker Compose）实现稳定部署
• 定制化需求：需要自定义存储引擎、连接数、缓存大小等高级参数的场景

详细使用方法和配置说明

安装

从Docker Hub拉取（推荐）

镜像已在Docker Hub自动化构建，可直接拉取：

bash
docker pull mongocamp/mongodb:8.0.15

本地构建

也可手动构建镜像：

bash
docker build . --tag 'mongocamp/mongodb:dev'

快速启动

基础启动命令

通过以下命令启动MongoDB容器，映射默认端口27017：

bash
docker run --publish 27017:27017 mongocamp/mongodb:8.0.15

使用Docker Compose

可参考示例docker-compose.yml文件，通过Docker Compose启动：

yaml
# 示例docker-compose.yml片段
version: '3'
services:
  mongodb:
    image: mongocamp/mongodb:8.0.15
    ports:
      - "27017:27017"
    volumes:
      - mongodb-data:/var/lib/mongodb
    environment:
      - MONGO_ROOT_USERNAME=admin
      - MONGO_ROOT_PWD=securepassword
volumes:
  mongodb-data:

持久化配置

MongoDB数据默认存储在容器内的/var/lib/mongodb目录。为确保数据持久化，需将该目录挂载到宿主机或命名卷：

bash
# 挂载宿主机目录
docker run --publish 27017:27017 -v /path/on/host:/var/lib/mongodb mongocamp/mongodb:8.0.15

# 或使用命名卷（推荐）
docker run --publish 27017:27017 -v mongodb-data:/var/lib/mongodb mongocamp/mongodb:8.0.15

如需自定义数据目录，可通过MONGO_DATA_DIR环境变量指定，例如：

bash
docker run --publish 27017:27017 -e MONGO_DATA_DIR=/data/mongodb -v /path/on/host:/data/mongodb mongocamp/mongodb:8.0.15

环境变量配置

通过以下环境变量可配置MongoDB服务，具体说明如下：

配置示例：启用认证

bash
docker run -d \
  --publish 27017:27017 \
  -e MONGO_ROOT_USERNAME=admin \
  -e MONGO_ROOT_PWD=mysecretpassword \
  --name mongodb-auth \
  mongocamp/mongodb:8.0.15

配置示例：副本集+自定义缓存

bash
docker run -d \
  --publish 27017:27017 \
  -e MONGO_REPLICA_SET_NAME=rs0 \
  -e MONGO_WIREDTIGER_CACHE_SIZE_GB=2 \
  -e MONGO_MAX_CONNECTIONS=1000 \
  --name mongodb-replica \
  mongocamp/mongodb:8.0.15

问题反馈

使用中遇到问题时，请先尝试更新Docker至最新版本。若问题仍存在，请提供以下信息提交issue：

• docker version和docker info命令输出
• 启动容器的docker run命令或docker-compose.yml（注意脱敏敏感信息）

贡献

欢迎通过以下方式贡献：

• 提交功能改进或bug修复的PR
• 帮助其他用户解决https://github.com/MongoCamp/docker-mongodb/issues