印刻数据库

外观

MongoDB Windows安装 ​

系统要求 ​

在安装 MongoDB 之前，请确保您的 Windows 系统满足以下要求：

版本系统要求
MongoDB 7.0+Windows Server 2019 或 Windows 10/11
MongoDB 6.0+Windows Server 2016/2019 或 Windows 10/11
MongoDB 5.0+Windows Server 2012 R2/2016/2019 或 Windows 10

硬件要求 ​

  • CPU：至少 2 核
  • 内存：至少 4 GB RAM
  • 磁盘空间：至少 10 GB 可用空间
  • 文件系统：NTFS

下载 MongoDB ​

  1. 访问 MongoDB 官方下载页面：https://www.mongodb.com/try/download/community
  2. 选择以下选项：
    • Product：MongoDB Community Server
    • Version：选择最新的稳定版本
    • Platform：Windows
    • Package：选择 "MSI" 安装包
  3. 点击 "Download" 按钮下载安装包

安装 MongoDB ​

步骤 1：运行安装程序 ​

  1. 双击下载的 MSI 安装包
  2. 在 "Welcome to the MongoDB Setup Wizard" 页面，点击 "Next"
  3. 在 "End-User License Agreement" 页面，勾选 "I accept the terms in the License Agreement"，然后点击 "Next"

步骤 2：选择安装类型 ​

  1. 在 "Choose Setup Type" 页面，选择以下安装类型之一：
    • Complete：安装所有组件（推荐用于大多数用户）
    • Custom：自定义安装组件和安装路径
    • Typical：安装典型组件
  2. 点击 "Next"

步骤 3：选择安装路径 ​

  1. 如果选择了 "Custom" 安装类型，在 "Choose Installation Location" 页面，指定 MongoDB 的安装路径
  2. 默认安装路径为：C:\Program Files\MongoDB\Server\<version>\
  3. 点击 "Next"

步骤 4：配置服务 ​

  1. 在 "Service Configuration" 页面，配置 MongoDB 服务：
    • Install MongoDB as a Service：勾选此选项将 MongoDB 安装为 Windows 服务（推荐）
    • Run service as Network Service user：使用 Network Service 账户运行服务（默认选项）
    • Run service as a local or domain user：使用本地或域账户运行服务
    • Data Directory：指定数据文件存储路径，默认：C:\Program Files\MongoDB\Server\<version>\data\
    • Log Directory：指定日志文件存储路径，默认：C:\Program Files\MongoDB\Server\<version>\log\
  2. 点击 "Next"

步骤 5：配置 MongoDB Compass ​

  1. 在 "MongoDB Compass" 页面，选择是否安装 MongoDB Compass（图形化管理工具）：
    • 勾选 "Install MongoDB Compass" 安装图形化管理工具
    • 或取消勾选跳过安装
  2. 点击 "Next"

步骤 6：完成安装 ​

  1. 在 "Ready to Install MongoDB Community Edition" 页面，点击 "Install"
  2. 等待安装完成
  3. 点击 "Finish" 完成安装

配置 MongoDB ​

检查环境变量 ​

  1. 打开 "系统属性" → "高级" → "环境变量"
  2. 在 "系统变量" 中，检查是否已添加 MongoDB 的 bin 目录到 Path 变量
  3. 如果没有，点击 "编辑" → "新建"，添加 MongoDB 的 bin 目录路径，例如：C:\Program Files\MongoDB\Server\7.0\bin

验证安装 ​

  1. 打开命令提示符（cmd）或 PowerShell
  2. 运行以下命令检查 MongoDB 版本：
    bash
    mongod --version
  3. 运行以下命令检查 MongoDB Shell 版本：
    bash
    mongosh --version

启动和停止 MongoDB 服务 ​

通过服务管理器 ​

  1. 按 Win + R 键，输入 services.msc 并回车
  2. 在服务列表中找到 "MongoDB Server"
  3. 右键点击，选择 "Start" 启动服务，或 "Stop" 停止服务

通过命令行 ​

  1. 以管理员身份打开命令提示符
  2. 启动 MongoDB 服务：
    bash
    net start MongoDB
  3. 停止 MongoDB 服务：
    bash
    net stop MongoDB

连接到 MongoDB ​

使用 MongoDB Shell ​

  1. 打开命令提示符或 PowerShell
  2. 运行以下命令连接到本地 MongoDB 实例：
    bash
    mongosh
  3. 如果连接成功，您将看到 MongoDB Shell 提示符：
    test>

使用 MongoDB Compass ​

  1. 如果安装了 MongoDB Compass，打开应用程序
  2. 在连接页面，使用默认连接字符串 mongodb://localhost:27017
  3. 点击 "Connect" 连接到本地 MongoDB 实例

配置 MongoDB ​

编辑配置文件 ​

  1. MongoDB 的默认配置文件位于：C:\Program Files\MongoDB\Server\<version>\bin\mongod.cfg
  2. 使用文本编辑器打开该文件
  3. 根据需要修改配置参数，例如：
    yaml
    systemLog:
  destination: file
  logAppend: true
  path: C:\Program Files\MongoDB\Server\7.0\log\mongod.log

storage:
  dbPath: C:\Program Files\MongoDB\Server\7.0\data
  journal:
    enabled: true

net:
  port: 27017
  bindIp: 127.0.0.1

processManagement:
  windowsService:
    serviceName: MongoDB
    displayName: MongoDB Server
    description: MongoDB Server Database Engine
  4. 保存修改后，重启 MongoDB 服务使配置生效

自定义数据和日志目录 ​

如果您希望将数据和日志存储在自定义位置：

  1. 创建数据和日志目录，例如：
    bash
    mkdir C:\MongoDB\data
mkdir C:\MongoDB\log
  2. 修改 mongod.cfg 文件中的 dbPath 和 path 配置
  3. 重启 MongoDB 服务

常见问题与解决方案 ​

问题：MongoDB 服务无法启动 ​

可能原因：

  • 数据目录不存在或权限不足
  • 配置文件错误
  • 端口被占用
  • 日志目录权限不足

解决方案：

  1. 检查数据目录是否存在，权限是否正确
  2. 检查配置文件语法是否正确
  3. 检查端口 27017 是否被占用：
    bash
    netstat -ano | findstr :27017
  4. 检查日志文件获取详细错误信息

问题：无法连接到 MongoDB ​

可能原因：

  • MongoDB 服务未启动
  • 防火墙阻止了连接
  • 配置了错误的 bindIp

解决方案：

  1. 确保 MongoDB 服务已启动
  2. 检查 Windows 防火墙是否允许端口 27017
  3. 如果需要远程连接，修改配置文件中的 bindIp 为 0.0.0.0 或特定 IP 地址

问题：MongoDB Shell 无法找到 ​

可能原因：

  • 环境变量未正确配置
  • MongoDB Shell 未安装

解决方案：

  1. 检查环境变量中是否添加了 MongoDB 的 bin 目录
  2. 重新安装 MongoDB，确保选择安装 MongoDB Shell

问题：安装程序无法运行 ​

可能原因：

  • 缺少 .NET Framework
  • 权限不足
  • 安装包损坏

解决方案：

  1. 确保安装了最新的 .NET Framework
  2. 以管理员身份运行安装程序
  3. 重新下载安装包，确保文件完整

卸载 MongoDB ​

通过控制面板 ​

  1. 打开 "控制面板" → "程序" → "程序和功能"
  2. 在程序列表中找到 "MongoDB Community Edition"
  3. 右键点击，选择 "Uninstall"
  4. 按照卸载向导完成卸载

手动卸载 ​

  1. 停止 MongoDB 服务：
    bash
    net stop MongoDB
  2. 删除 MongoDB 服务：
    bash
    sc delete MongoDB
  3. 删除 MongoDB 安装目录：
    bash
    rmdir /s /q "C:\Program Files\MongoDB"
  4. 删除数据和日志目录：
    bash
    rmdir /s /q "C:\Program Files\MongoDB\Server\<version>\data"
rmdir /s /q "C:\Program Files\MongoDB\Server\<version>\log"
  5. 从环境变量中移除 MongoDB 的 bin 目录

最佳实践 ​

  1. 使用服务方式运行：将 MongoDB 安装为 Windows 服务，确保自动启动和管理
  2. 定期备份：定期备份 MongoDB 数据目录
  3. 启用身份验证：在生产环境中，启用 MongoDB 的身份验证机制
  4. 配置防火墙：限制 MongoDB 端口的访问权限
  5. 监控性能：使用 MongoDB Compass 或其他监控工具监控 MongoDB 性能
  6. 定期更新：及时更新 MongoDB 到最新稳定版本
  7. 使用配置文件：通过配置文件管理 MongoDB 设置，便于维护和备份

常见问题（FAQ） ​

Q1: MongoDB 默认端口是什么？ ​

A1: MongoDB 默认使用端口 27017。如果需要修改端口，可以在配置文件中修改 net.port 参数。

Q2: 如何修改 MongoDB 的数据目录？ ​

A2: 修改 mongod.cfg 文件中的 storage.dbPath 参数，然后重启 MongoDB 服务。

Q3: 如何允许远程连接到 MongoDB？ ​

A3: 修改配置文件中的 net.bindIp 参数为 0.0.0.0 或特定 IP 地址，然后重启 MongoDB 服务，并确保防火墙允许端口 27017。

Q4: 如何查看 MongoDB 日志？ ​

A4: MongoDB 日志文件默认位于 C:\Program Files\MongoDB\Server\<version>\log\mongod.log，可以使用文本编辑器打开查看。

Q5: 如何升级 MongoDB？ ​

A5: 升级 MongoDB 的步骤：

  1. 备份数据目录
  2. 下载新版本的 MSI 安装包
  3. 运行安装程序，选择与旧版本相同的安装路径
  4. 安装程序会自动升级 MongoDB
  5. 升级完成后，启动 MongoDB 服务并验证

MongoDB 命令行工具 ​

安装 MongoDB 后，您可以使用以下命令行工具：

命令描述
mongodMongoDB 服务器进程
mongoshMongoDB Shell，用于连接和管理 MongoDB
mongodump备份 MongoDB 数据
mongorestore恢复 MongoDB 数据
mongoexport导出 MongoDB 数据到 JSON 或 CSV
mongoimport导入 JSON 或 CSV 数据到 MongoDB
mongostat实时监控 MongoDB 状态
mongotop监控 MongoDB 集合级别的读写统计
mongosMongoDB 分片路由进程

通过以上步骤，您已经成功在 Windows 系统上安装并配置了 MongoDB。您可以开始使用 MongoDB 进行开发和测试，或配置生产环境。