webhippie/mongodb

mongodb

https://github.com/dockhippie/mongodb/actions/workflows/docker.yml/badge.svg](https://github.com/dockhippie/mongodb/actions/workflows/docker.yml)

镜像概述和主要用途

这些是基于https://github.com/dockhippie/ubuntu运行的MongoDB的Docker镜像，提供MongoDB数据库服务，支持灵活的配置和环境变量自定义，适用于快速部署MongoDB实例。

核心功能和特性

• 基于Ubuntu系统构建，稳定可靠
• 支持数据持久化存储，提供专用数据卷和备份卷
• 开放MongoDB标准端口，支持客户端连接
• 丰富的环境变量配置，可自定义认证、网络、存储、日志等参数
• 支持MongoDB的多种功能，如复制集、分片、认证等
• 提供备份保留机制，可配置备份路径和保留天数

使用场景和适用范围

• 开发环境：快速搭建本地MongoDB测试环境
• 测试环境：部署用于应用测试的MongoDB实例
• 小型生产环境：支持单机、复制集等配置，满足小规模应用需求
• 学习和演示：方便快速部署MongoDB进行学习和功能演示

版本信息

可用版本请查看：

• https://hub.docker.com/r/webhippie/mongodb/tags
• Quay
• https://github.com/dockhippie/mongodb中的现有文件夹

卷配置

• /var/lib/mongodb: MongoDB数据存储目录，建议挂载持久化卷以保留数据
• /var/lib/backup: 备份文件存储目录，用于存放数据库备份

端口映射

• 27017: MongoDB默认客户端连接端口
• 27018: 内部复制集通信端口
• 27019: 分片集群配置服务器端口

环境变量配置

可用环境变量

console
MONGODB_AUTH = false  # 是否启用认证
MONGODB_AUTH_DB = admin  # 认证数据库名称
MONGODB_AWS_IAM_SESSION_TOKEN =  # AWS IAM会话令牌，仅4.2及以上版本可用
MONGODB_BACKUP_IGNORE = (admin|local)  # 备份时忽略的数据库，默认忽略admin和local
MONGODB_BACKUP_PATH = /var/lib/backup  # 备份文件存储路径
MONGODB_BACKUP_RETENTION = 14  # 备份保留天数，默认14天
MONGODB_CLUSTER_AUTH_MODE =  # 集群认证模式
MONGODB_CLUSTER_IP_SOURCE_WHITELIST =  # 集群IP源白名单
MONGODB_CONFIG =  # 自定义配置内容
MONGODB_CONFIG_EXPAND =  # 配置扩展，仅4.2及以上版本可用
MONGODB_CONFIGSVR = false  # 是否作为配置服务器
MONGODB_CPU = false  # 是否启用CPU性能分析
MONGODB_DATABASE =  # 要创建的数据库名称
MONGODB_DBPATH = /var/lib/mongodb  # 数据存储路径
MONGODB_DIRECTORYPERDB = false  # 是否每个数据库使用单独目录
MONGODB_ENABLE_FREE_MONITORING = off  # 是否启用免费监控，仅4.4及以下版本可用
MONGODB_ENABLE_MAJORITY_READ_CONCERN = false  # 是否启用多数读关注
MONGODB_FREE_MONITORING_TAG =  # 免费监控标签，仅4.4及以下版本可用
MONGODB_IPV6 = false  # 是否启用IPv6
MONGODB_JOURNAL_COMMIT_INTERVAL =  # 日志提交间隔（毫秒）
MONGODB_JOURNAL_OPTIONS =  # 日志选项，仅4.0及以下版本可用
MONGODB_KEY_FILE =  # 密钥文件路径，用于复制集认证
MONGODB_LISTEN_BACKLOG =  # 监听连接队列大小
MONGODB_LOGAPPEND = false  # 是否追加日志（而非覆盖）
MONGODB_LOGPATH =  # 日志文件路径
MONGODB_MAX_CONNS =  # 最大连接数限制
MONGODB_NETWORK_MESSAGE_COMPRESSORS =  # 网络消息压缩器，如snappy,zlib
MONGODB_NO_INDEX_BUILD_RETRY = false  # 是否禁用索引构建重试
MONGODB_NOAUTH = false  # 是否禁用认证（与MONGODB_AUTH互斥）
MONGODB_NOJOURNAL = false  # 是否禁用日志功能
MONGODB_NOPREALLOC = false  # 是否禁用预分配，仅4.0及以下版本可用
MONGODB_NOSCRIPTING = false  # 是否禁用JavaScript执行
MONGODB_NOTABLESCAN = false  # 是否禁用表扫描
MONGODB_NSSIZE =  # 命名空间大小（MB）
MONGODB_OPLOG_MIN_RETENTION_HOURS =  # oplog最小保留小时数，仅4.2及以上版本可用
MONGODB_OPLOG_SIZE =  # oplog大小（MB）
MONGODB_PASSWORD =  # 数据库用户密码（需配合MONGODB_USERNAME使用）
MONGODB_PERFORM_REPAIR = false  # 是否在启动时执行数据库修复
MONGODB_PERFORM_UPGRADE = true  # 是否在启动时执行数据库升级
MONGODB_PROFILE =  # 性能分析级别（0=禁用，1=仅慢查询，2=所有操作）
MONGODB_PROFILE_FILTER =  # 性能分析过滤器，仅4.2及以上版本可用
MONGODB_QUIET = false  # 是否启用安静模式（减少日志输出）
MONGODB_QUOTA = false  # 是否启用配额，仅4.0及以下版本可用
MONGODB_QUOTA_FILES =  # 配额文件数，仅4.0及以下版本可用
MONGODB_REPAIRPATH =  # 修复路径，仅4.0及以下版本可用
MONGODB_REPL_INDEX_PREFETCH =  # 复制索引预取模式，仅4.0及以下版本可用
MONGODB_REPL_SET =  # 复制集名称（启用复制集时设置）
MONGODB_ROOT_PASSWORD =  # 管理员密码（启用认证时必填）
MONGODB_ROOT_USERNAME =  # 管理员用户名（启用认证时必填）
MONGODB_SET_PARAMETER =  # 设置MongoDB参数，格式为"param1=value1,param2=value2"
MONGODB_SHARDSVR = false  # 是否作为分片服务器
MONGODB_LOGROTATE =  # 日志轮转配置
MONGODB_SKIP_CHOWN = false  # 是否跳过数据目录权限更改
MONGODB_SLOW_OP_SAMPLE_RATE =  # 慢操作采样率
MONGODB_SLOWMS =  # 慢操作阈值（毫秒）
MONGODB_SMALLFILES = false  # 是否使用小文件模式（减少初始文件大小）
MONGODB_SSL_ALLOW_CONNECTIONS_WITHOUT_CERTIFICATES = false  # 是否允许无证书SSL连接
MONGODB_SSL_ALLOW_INVALID_CERTIFICATES = false  # 是否允许无效SSL证书
MONGODB_SSL_ALLOW_INVALID_HOSTNAMES = false  # 是否允许无效主机名SSL连接
MONGODB_SSL_CA_FILE =  # CA证书文件路径
MONGODB_SSL_CERTIFICATE_KEY_FILE = ${MONGODB_SSL_PEM_KEY_FILE}  # 证书密钥文件路径
MONGODB_SSL_CERTIFICATE_KEY_FILE_PASSWORD = ${MONGODB_SSL_PEM_KEY_PASSWORD}  # 证书密钥密码
MONGODB_SSL_CLUSTER_CA_FILE =  # 集群CA证书文件
MONGODB_SSL_CLUSTER_FILE =  # 集群证书文件
MONGODB_SSL_CLUSTER_PASSWORD =  # 集群证书密码
MONGODB_SSL_CRL_FILE =  # CRL文件路径
MONGODB_SSL_DISABLED_PROTOCOLS =  # 禁用的SSL协议
MONGODB_SSL_FIPS_MODE = false  # 是否启用FIPS模式
MONGODB_SSL_LOG_VERSIONS =  # SSL日志版本，仅4.0及以下版本可用
MONGODB_SSL_MODE =  # SSL模式（如requireSSL）
MONGODB_SSL_ON_NORMAL_PORTS = false  # 是否在普通端口使用SSL
MONGODB_SSL_WEAK_CERTIFICATE_VALIDATION =  # 弱证书验证，仅4.0及以下版本可用
MONGODB_STORAGE_ENGINE =  # 存储引擎（如wiredTiger）
MONGODB_SYNCDELAY =  # 同步延迟（秒）
MONGODB_SYSINFO = false  # 是否显示系统信息
MONGODB_SYSLOG = false  # 是否记录日志到系统日志
MONGODB_TIMESTAMP_FORMAT =  # 时间戳格式
MONGODB_TIMEZONE_INFO =  # 时区信息
MONGODB_TRANSITION_TO_AUTH = false  # 是否过渡到认证模式
MONGODB_USERNAME =  # 数据库用户名（需配合MONGODB_PASSWORD使用）
MONGODB_VERBOSE = false  # 是否启用详细日志输出
MONGODB_WIRED_TIGER_CACHE_SIZE =  # WiredTiger缓存大小
MONGODB_WIRED_TIGER_COLLECTION_BLOCK_COMPRESSOR =  # WiredTiger集合块压缩器
MONGODB_WIRED_TIGER_DIRECTORY_FOR_INDEXES =  # WiredTiger索引目录
MONGODB_WIRED_TIGER_INDEX_PREFIX_COMPRESSION =  # WiredTiger索引前缀压缩
MONGODB_WIRED_TIGER_JOURNAL_COMPRESSOR =  # WiredTiger日志压缩器
MONGODB_ZSTD_DEFAULT_COMPRESSION_LEVEL =  # ZSTD默认压缩级别，仅4.2及以上版本可用

继承的环境变量

• https://github.com/dockhippie/ubuntu#available-environment-variables%EF%BC%88%E5%9F%BA%E7%A1%80Ubuntu%E9%95%9C%E5%83%8F%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%EF%BC%89

使用方法示例

基本运行命令

bash
docker run -d \
  --name mongodb \
  -p 27017:27017 \
  -v mongodb_data:/var/lib/mongodb \
  webhippie/mongodb

启用认证的运行命令

bash
docker run -d \
  --name mongodb \
  -p 27017:27017 \
  -v mongodb_data:/var/lib/mongodb \
  -v mongodb_backup:/var/lib/backup \
  -e MONGODB_AUTH=true \
  -e MONGODB_ROOT_USERNAME=admin \
  -e MONGODB_ROOT_PASSWORD=secretpassword \
  webhippie/mongodb

Docker Compose配置示例

yaml
version: '3'
services:
  mongodb:
    image: webhippie/mongodb
    container_name: mongodb
    ports:
      - "27017:27017"
    volumes:
      - mongodb_data:/var/lib/mongodb
      - mongodb_backup:/var/lib/backup
    environment:
      - MONGODB_AUTH=true
      - MONGODB_ROOT_USERNAME=admin
      - MONGODB_ROOT_PASSWORD=secret
      - MONGODB_DATABASE=myappdb
      - MONGODB_USERNAME=appuser
      - MONGODB_PASSWORD=apppass123
      - MONGODB_BACKUP_RETENTION=7
    restart: unless-stopped

volumes:
  mongodb_data:
  mongodb_backup:

贡献

Fork -> Patch -> Push -> Pull Request

作者

• https://github.com/tboerger

许可证

MIT

版权

console
Copyright (c) 2015 Thomas Boerger <http://www.webhippie.de>