使用Docker部署MongoDB和Mongo Express的完整指南

前言

在现代应用开发中，NoSQL数据库MongoDB因其灵活的数据模型和强大的查询能力而广受欢迎。本文将详细介绍如何使用Docker容器技术快速部署MongoDB数据库及其Web管理工具Mongo Express。

准备工作

在开始之前，请确保您已经具备以下条件：

1. 一台运行Debian或Ubuntu操作系统的服务器
2. 已安装Docker和Docker Compose
3. 基本的Linux命令行操作知识

环境检查

首先，我们需要验证Docker环境是否准备就绪：

# 检查Docker版本
sudo docker --version

# 检查Docker Compose版本
docker-compose version

正常情况下，您应该看到类似以下的输出（版本号可能有所不同）：

Docker version 20.10.10, build b485636
Docker Compose version v2.1.0

配置Docker Compose文件

我们将使用Docker Compose来定义和管理我们的服务。创建一个名为docker-compose.yaml的文件，内容如下：

version: '3'

services:
  mongodb:
    container_name: mongodb
    image: mongo:4.4.6
    environment:
      - MONGO_INITDB_DATABASE=mongodb
      - MONGO_INITDB_ROOT_USERNAME=mongouser
      - MONGO_INITDB_ROOT_PASSWORD=mongopasswd
    ports:
      - '27017:27017'
    volumes:
      - mongodb_volume:/data/db
    networks:
      - mongo_backend_network

  mongo-express:
    container_name: mongo-express
    image: mongo-express:1.0.0-alpha.4
    depends_on:
      - mongodb
    environment:
      - ME_CONFIG_MONGODB_SERVER=mongodb
      - ME_CONFIG_MONGODB_ADMINUSERNAME=mongouser
      - ME_CONFIG_MONGODB_ADMINPASSWORD=mongopasswd
      - ME_CONFIG_BASICAUTH_USERNAME=adminuser
      - ME_CONFIG_BASICAUTH_PASSWORD=adminpasswd
    ports:
      - '8081:8081'
    volumes:
      - mongo_express_volume:/data/db
    networks:
      - mongo_backend_network

volumes:
  mongodb_volume:
  mongo_express_volume:

networks:
  mongo_backend_network:
    driver: bridge

配置文件解析

1. MongoDB服务配置：

   • 使用官方mongo:4.4.6镜像
   • 设置了初始数据库和root用户凭证
   • 将容器内的27017端口映射到主机
   • 使用卷持久化数据

2. Mongo Express服务配置：

   • 使用mongo-express:1.0.0-alpha.4镜像
   • 配置了MongoDB连接参数
   • 设置了Web界面登录凭证
   • 将8081端口映射到主机

3. 网络配置：

   • 创建了一个桥接网络，使两个服务能够相互通信

启动服务

执行以下命令启动服务：

# 启动MongoDB
docker-compose up -d mongodb

# 启动Mongo Express
docker-compose up -d mongo-express

-d参数表示在后台运行服务。

验证服务状态

检查容器运行状态：

docker ps -a

正常输出应显示两个服务都处于"Up"状态：

CONTAINER ID   IMAGE                         COMMAND                  CREATED         STATUS         PORTS                                           NAMES
64eea9ca7a0f   mongo:4.4.6                   "docker-entrypoint.s…"   2 minutes ago   Up 2 minutes   0.0.0.0:27017->27017/tcp, :::27017->27017/tcp   mongodb
8c525825faf6   mongo-express:1.0.0-alpha.4   "tini -- /docker-ent…"   2 minutes ago   Up 2 minutes   0.0.0.0:8081->8081/tcp, :::8081->8081/tcp       mongo-express

查看日志

检查服务日志有助于排查问题：

# 查看MongoDB日志
docker logs mongodb

# 查看Mongo Express日志
docker logs mongo-express

访问Mongo Express

在浏览器中访问http://<您的服务器IP>:8081，使用以下凭证登录：

用户名: adminuser
密码: adminpasswd

登录后，您可以：

• 创建新数据库
• 管理集合(Collection)
• 执行文档(Document)的CRUD操作
• 运行查询和索引管理

安全注意事项

1. 修改默认凭证：在生产环境中，务必修改默认的用户名和密码
2. 限制访问：考虑使用防火墙限制对8081端口的访问
3. 启用TLS：对于生产环境，建议配置TLS加密连接

服务停止与清理

当不再需要这些服务时，可以执行以下命令进行清理：

docker-compose down

此命令会停止并移除所有相关容器，但会保留数据卷以便下次使用。如需完全清理，可添加-v参数：

docker-compose down -v

常见问题解答

Q: 如何备份MongoDB数据？ A: 可以使用mongodump命令或直接备份数据卷。

Q: 如何升级MongoDB版本？ A: 修改docker-compose.yaml中的镜像版本，然后重新部署。

Q: 连接失败怎么办？ A: 检查容器日志，确认网络配置和凭证是否正确。

总结

通过Docker部署MongoDB和Mongo Express是一种快速、高效的方案，特别适合开发和测试环境。本文详细介绍了从环境准备到服务部署的完整流程，希望能帮助您快速搭建MongoDB开发环境。