commerceblock/mongo

commerceblock/mongo 镜像文档

镜像概述

commerceblock/mongo 是基于官方 MongoDB 镜像的略微修改版本，主要增强了用户配置的便捷性。该镜像允许通过环境变量直接设置管理员用户和普通用户的凭据，简化了 MongoDB 实例的初始化配置流程，适用于需要快速部署并具备基础访问控制的场景。

核心功能与特性

• 基于官方镜像：保留官方 MongoDB 镜像的所有核心功能和稳定性
• 环境变量配置：支持通过环境变量设置管理员和普通用户的用户名及密码
• 自动用户创建：启动时自动根据提供的环境变量创建指定用户，无需手动执行数据库命令
• 基础安全控制：通过预配置用户实现对数据库访问的基本权限管理

使用场景

• 开发环境中快速部署带有预设用户的 MongoDB 实例
• 测试环境中需要标准化用户配置的 MongoDB 部署
• 对数据库访问有基础权限控制需求的小型应用场景
• 需要简化初始化流程的 MongoDB 容器化部署

使用方法与配置说明

环境变量配置

该镜像通过以下环境变量进行用户配置：

注意：若指定了 MONGO_USERNAME，则 MONGO_PASSWORD 为必填项；MONGO_ADMIN_PASSWORD 为必填项，若未指定 MONGO_ADMIN_USERNAME，默认用户名为 admin。

Docker Run 部署示例

bash
docker run -d \
  --name mongo-instance \
  -p 27017:27017 \
  -e MONGO_ADMIN_USERNAME=admin \
  -e MONGO_ADMIN_PASSWORD=AdminPass123! \
  -e MONGO_USERNAME=appuser \
  -e MONGO_PASSWORD=AppPass456! \
  -v mongo-data:/data/db \
  commerceblock/mongo

Docker Compose 配置示例

yaml
version: '3'
services:
  mongo:
    image: commerceblock/mongo
    container_name: mongo-instance
    ports:
      - "27017:27017"
    environment:
      - MONGO_ADMIN_USERNAME=admin
      - MONGO_ADMIN_PASSWORD=AdminPass123!
      - MONGO_USERNAME=appuser
      - MONGO_PASSWORD=AppPass456!
    volumes:
      - mongo-data:/data/db
    restart: unless-stopped

volumes:
  mongo-data:

连接到 MongoDB 实例

使用管理员用户连接：

bash
mongo -u admin -p AdminPass123! --authenticationDatabase admin

使用普通用户连接（需确保已创建）：

bash
mongo -u appuser -p AppPass456! --authenticationDatabase admin

数据持久化

建议通过挂载 volumes 来持久化 MongoDB 数据，如上述示例中的 -v mongo-data:/data/db，确保容器重启或重建后数据不丢失。