krnbr/mongo

MongoDB复制集会话管理镜像

镜像概述

本Docker镜像基于MongoDB复制集构建，专门优化用于会话管理场景。通过MongoDB的复制集功能，实现会话数据的高可用存储、自动故障转移和数据冗余，满足分布式系统中会话共享与可靠性需求。

核心功能与特性

• MongoDB复制集架构：包含主节点（Primary）和从节点（Secondary），支持数据自动同步与故障转移
• 会话管理优化：支持TTL（生存时间）索引，自动清理过期会话数据，减少存储占用
• 高可用性：主节点故障时自动选举新主节点，保障会话服务持续可用
• 数据冗余：多节点数据复制，防止单点数据丢失
• Docker化部署：简化部署流程，确保环境一致性，支持快速扩展

使用场景与适用范围

• 分布式Web应用的会话存储（如多服务器部署的网站、应用平台）
• 需要高可用会话管理的系统（电商平台、社交应用、企业SaaS系统）
• 对会话数据可靠性有要求的场景（用户认证状态、临时会话信息存储）
• 需自动清理过期会话数据的应用

使用方法与配置说明

基本部署（单节点测试）

bash
docker run -d \
  --name mongo-replica-session \
  -p 27017:27017 \
  -e MONGO_REPLICA_SET_NAME=rs0 \
  -e MONGO_INITIAL_PRIMARY=localhost:27017 \
  mongo-replica-session:latest

多节点复制集部署（docker-compose）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mongo1:
    image: mongo-replica-session:latest
    container_name: mongo1
    ports:
      - "27017:27017"
    environment:
      - MONGO_REPLICA_SET_NAME=rs0
      - MONGO_INITIAL_PRIMARY=mongo1:27017
      - MONGO_SECONDARY_NODES=mongo2:27017,mongo3:27017
    volumes:
      - mongo1-data:/data/db

  mongo2:
    image: mongo-replica-session:latest
    container_name: mongo2
    ports:
      - "27018:27017"
    environment:
      - MONGO_REPLICA_SET_NAME=rs0
      - MONGO_INITIAL_PRIMARY=mongo1:27017
    volumes:
      - mongo2-data:/data/db

  mongo3:
    image: mongo-replica-session:latest
    container_name: mongo3
    ports:
      - "27019:27017"
    environment:
      - MONGO_REPLICA_SET_NAME=rs0
      - MONGO_INITIAL_PRIMARY=mongo1:27017
    volumes:
      - mongo3-data:/data/db

volumes:
  mongo1-data:
  mongo2-data:
  mongo3-data:

启动复制集：

bash
docker-compose up -d

初始化复制集

进入主节点容器配置复制集：

bash
docker exec -it mongo1 mongo

在MongoDB shell中执行：

javascript
rs.initiate({
  _id: "rs0",
  members: [
    {_id: 0, host: "mongo1:27017"},
    {_id: 1, host: "mongo2:27017"},
    {_id: 2, host: "mongo3:27017"}
  ]
})

配置会话集合TTL索引

创建会话集合并设置过期时间（例如24小时）：

javascript
use sessionDB
db.sessions.createIndex({ "expiresAt": 1 }, { expireAfterSeconds: 86400 })

环境变量配置

注意事项

• 生产环境建议至少部署3个节点（1主2从）以确保高可用性
• 启用认证时需提前创建管理员用户并配置访问权限
• 确保容器间网络互通（使用Docker网络或指定固定IP）
• 数据卷挂载需持久化，防止容器重启导致数据丢失