如何在 Docker 中安装 MongoDB

1. 前提条件

   安装 Docker：确保你的系统已安装 Docker（Docker Desktop for Windows/macOS 或 Docker Engine for Linux）。

    验证：运行 docker --version，应输出类似 Docker version 27.0.3。

   网络连接：拉取 MongoDB 镜像需要访问 Docker Hub。
   基本 Docker 知识：了解 Docker 命令（如 docker run、docker ps）。

2. 拉取 MongoDB 镜像

MongoDB 提供官方镜像，托管在 Docker Hub（https://hub.docker.com/_/mongo）。
步骤：

拉取最新 MongoDB 镜像：

docker pull mongo
    1

    这将拉取最新版本的 MongoDB 镜像（例如 mongo:latest）。
    如果需要特定版本（如 MongoDB 8.0），运行：

    docker pull mongo:8.0
        1

验证镜像：

docker images
    1

    应看到 mongo 镜像及其版本。

3. 运行 MongoDB 容器

使用 docker run 命令启动 MongoDB 容器。
基本运行命令：

docker run -d –name mongodb -p 27017:27017 mongo

1

参数说明：
    -d：后台运行容器。
    --name mongodb：为容器命名（可自定义）。
    -p 27017:27017：将主机的 27017 端口映射到容器的 27017 端口（MongoDB 默认端口）。
    mongo：使用的镜像名称（若指定版本，如 mongo:8.0）。

验证容器运行：

docker ps

1

应看到 mongodb 容器处于 Up 状态。

连接到 MongoDB：

进入容器并使用 MongoDB Shell：

docker exec -it mongodb mongosh
    1

    在 mongosh 提示符下运行：

    show databases
        1

从主机连接：
    使用 MongoDB 客户端（如 MongoDB Compass）连接到 localhost:27017。
    或者使用 Python 的 PyMongo：

    from pymongo import MongoClient
    client = MongoClient("mongodb://localhost:27017/")
    print(client.list_database_names())
        1
        2
        3

4. 配置 MongoDB 容器

为了满足实际需求（如持久化数据、设置认证），需要对容器进行额外配置。
a. 持久化数据

Docker 容器是临时的，停止并删除容器后数据会丢失。使用 Docker 卷或绑定挂载来持久化数据。
使用 Docker 卷：

docker run -d –name mongodb -p 27017:27017 -v mongodb-data:/data/db mongo

1

-v mongodb-data:/data/db：创建名为 mongodb-data 的卷，映射到容器的 /data/db（MongoDB 默认数据目录）。
验证卷：

docker volume ls
    1

使用绑定挂载：

mkdir -p ~/mongodb-data
docker run -d –name mongodb -p 27017:27017 -v ~/mongodb-data:/data/db mongo

1
2

-v ~/mongodb-data:/data/db：将主机目录 ~/mongodb-data 映射到容器。

b. 设置用户名和密码（启用认证）

MongoDB 默认不启用认证。为安全起见，建议设置管理员账户。
运行命令：

docker run -d –name mongodb -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=admin -e MONGO_INITDB_ROOT_PASSWORD=46ys3zjsvqXIZ0oc -v mongodb-data:/data/mongodb mongo

1
2
3
4
5

环境变量：
    MONGO_INITDB_ROOT_USERNAME：管理员用户名。
    MONGO_INITDB_ROOT_PASSWORD：管理员密码。
连接时需认证：

docker exec -it mongodb mongosh -u admin -p secret
    1

或在 PyMongo 中：

client = MongoClient("mongodb://admin:secret@localhost:27017/")
    1

c. 自定义配置文件

如果需要自定义 MongoDB 配置（如修改端口或存储引擎），可以挂载配置文件。

创建配置文件（如 mongod.conf）：

net:
  port: 27017
storage:
  dbPath: /data/db
    1
    2
    3
    4

运行容器：

docker run -d --name mongodb -p 27017:27017 \
  -v $(pwd)/mongod.conf:/etc/mongod.conf \
  -v mongodb-data:/data/db \
  mongo --config /etc/mongod.conf
    1
    2
    3
    4

5. 管理 MongoDB 容器

以下是常用管理命令：

停止容器：

docker stop mongodb
    1

启动容器：

docker start mongodb
    1

删除容器（数据卷不会删除）：

docker rm mongodb
    1

查看日志：

docker logs mongodb
    1

检查容器资源使用：

docker stats mongodb
    1

6. 使用 Docker Compose（推荐）

Docker Compose 是一个更方便的方式，通过 YAML 文件定义和运行 MongoDB 容器，适合多容器应用。
示例 docker-compose.yml：

version: ‘3.8’
services:
mongodb:
image: mongo:8.0
container_name: mongodb
ports:

  - "27017:27017"
volumes:
  - mongodb-data:/data/db
environment:
  - MONGO_INITDB_ROOT_USERNAME=admin
  - MONGO_INITDB_ROOT_PASSWORD=secret
networks:
  - mongo-network

volumes:
mongodb-data:
networks:
mongo-network:
driver: bridge

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

运行：

保存以上内容为 docker-compose.yml。
执行：

docker-compose up -d
    1

验证：

docker-compose ps
    1

停止和删除：

docker-compose down
    1

优点：

配置清晰，易于维护。
支持多容器环境（例如与 Python 应用容器集成）。
自动管理卷和网络。

7. 在 Python 中连接 Docker 化的 MongoDB

以下是使用 PyMongo 连接到 Docker 容器中的 MongoDB 的示例。
示例代码：

from pymongo import MongoClient

连接到 MongoDB（无认证）

client = MongoClient(“mongodb://localhost:27017/“)

如果启用了认证

client = MongoClient(“mongodb://admin:secret@localhost:27017/“)

db = client[“mydatabase”]
collection = db[“mycollection”]

插入测试数据

collection.insert_one({“name”: “Alice”, “age”: 25})

查询数据

for doc in collection.find():
print(doc)

client.close()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

8. 最佳实践

   持久化数据：始终使用卷或绑定挂载，避免数据丢失。
   启用认证：生产环境中必须设置用户名和密码。
   限制资源：为容器设置 CPU 和内存限制：

   docker run -d –name mongodb –cpus=”1” –memory=”512m” -p 27017:27017 mongo

    1

   网络隔离：使用 Docker 网络（默认或自定义）隔离 MongoDB 和其他服务。
   监控日志：定期检查 docker logs 以排查问题。
   备份数据：

    使用 mongodump 备份：
   
    docker exec mongodb mongodump -u admin -p secret --archive=/data/db/backup.archive
        1
   
    复制备份到主机：
   
    docker cp mongodb:/data/db/backup.archive ./backup.archive
        1

   版本管理：指定明确的 MongoDB 版本（如 mongo:8.0），避免使用 latest 以确保兼容性。

9. 常见问题与解决

   端口冲突：

    如果主机 27017 端口被占用，修改映射端口（如 -p 27018:27017）。
    检查：netstat -tuln | grep 27017（Linux）或 netstat -a（Windows）。

   连接失败：

    确保容器运行（docker ps）。
    检查认证设置（用户名/密码是否正确）。
    对于 Atlas，验证 IP 白名单。

   数据丢失：

    确认是否配置了卷（docker volume ls）。
    检查卷挂载路径是否正确。

   性能问题：

    确保主机有足够资源（CPU、内存、磁盘）。
    使用索引优化查询（参考 PyMongo 索引操作）。

10. 学习建议

    练习基本操作：在容器中运行 CRUD 操作，熟悉 mongosh 和 PyMongo。
    尝试 Docker Compose：构建一个包含 MongoDB 和 Python 应用的完整项目。
    学习备份与恢复：实践 mongodump 和 mongorestore。
    参考资源：

    MongoDB Docker Hub：https://hub.docker.com/_/mongo
    MongoDB 官方文档：https://www.mongodb.com/docs/
    Docker 文档：https://docs.docker.com/
    MongoDB University：https://university.mongodb.com/

11. 完整示例（Docker Compose + Python）

以下是一个结合 Docker Compose 和 Python 应用的完整示例。
————————————————

                        版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

原文链接：https://blog.csdn.net/u013172930/article/details/148317208