Windows 平台安装 MongoDB

Windows 平台安装 MongoDB(2025 年最新指南)

MongoDB 支持 Windows 平台安装,主要通过 Community Edition(免费版)进行。当前最新稳定版本为 MongoDB 8.0(截至 2025 年 11 月)。安装方式包括 MSI 安装包(推荐,图形化)和 ZIP 归档(手动配置)。以下基于官方文档(MongoDB 8.0)总结步骤,适用于 Windows 10/11Windows Server 2019/2022

重要提示

  • MongoDB 默认安装到 C:\Program Files\MongoDB\Server\8.0\
  • 安装后需手动创建数据目录(C:\data\db)和日志目录(C:\data\log)。
  • Windows 不支持分片(Sharding)或存储引擎自定义;生产环境推荐 MongoDB Atlas 云服务。
  • 确保以 管理员权限 运行命令提示符(CMD)或 PowerShell。

一、系统要求(Prerequisites)

要求说明
操作系统Windows 10+ / Windows Server 2016+(x64 架构)
磁盘空间至少 1 GB(不含数据存储)
权限管理员权限;防火墙允许端口 27017
依赖无需额外依赖(内置 WiredTiger 引擎)

防火墙配置:安装后,在 Windows 防火墙中允许 MongoDB 通过端口 27017(TCP)。


二、安装方法 1:MSI 安装包(推荐,图形化)

步骤 1:下载安装包

  1. 访问 MongoDB 下载中心
  2. 选择:
  • Version:8.0(最新稳定版)。
  • Platform:Windows。
  • Package:MSI。
  1. 点击 Download,保存 .msi 文件(约 300 MB)。

步骤 2:运行安装

  1. 双击 .msi 文件,以 管理员权限 运行。
  2. 在安装向导中:
  • 选择 Complete(完整安装)或 Custom(自定义路径)。
  • Install MongoDB as a Service:勾选(推荐,作为 Windows 服务自动启动)。
  • Install MongoDB Compass:可选(图形化工具,推荐勾选)。
  1. 点击 Install,等待完成(约 2-5 分钟)。

步骤 3:配置数据目录

  • 如果未自动创建,手动:
  1. 创建文件夹:C:\data\db(数据存储)和 C:\data\log\mongod.log(日志)。
  2. 编辑服务配置(可选):在 C:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg 中设置 dbPath: C:\data\dblogPath: C:\data\log\mongod.log

步骤 4:验证安装

  1. 打开 命令提示符(以管理员运行)。
  2. 输入 mongod --version,检查版本输出。
  3. 启动服务:net start MongoDB(如果作为服务安装)。
  4. 新终端输入 mongosh(MongoDB Shell),连接测试:
   > show dbs
  • 如果显示空列表,安装成功。

三、安装方法 2:ZIP 归档(手动安装)

步骤 1:下载并解压

  1. 在下载中心选择 ZIP 包,下载并解压到 C:\mongodb(自定义路径)。

步骤 2:创建目录

  • 创建 C:\data\dbC:\data\log

步骤 3:添加环境变量

  1. 右键 此电脑 > 属性 > 高级系统设置 > 环境变量
  2. 系统变量 > Path 中添加 C:\mongodb\bin

步骤 4:创建配置文件

  • C:\mongodb\bin 创建 mongod.cfg 文件:
  systemLog:
    destination: file
    path: C:\data\log\mongod.log
  storage:
    dbPath: C:\data\db
  net:
    port: 27017
    bindIp: 127.0.0.1  # 本地绑定,生产环境调整

步骤 5:启动 MongoDB

  1. CMD 中运行:mongod --config "C:\mongodb\bin\mongod.cfg" --install(安装为服务)。
  2. 启动服务:net start MongoDB
  3. 验证:同上,使用 mongosh 连接。

四、安装后配置与优化

配置项说明与命令
作为 Windows 服务管理启动:net start MongoDB
停止:net stop MongoDB
移除:sc.exe delete MongoDB
安全设置启用认证:mongosh 中运行 db.createUser({user: "admin", pwd: "password", roles: ["root"]})
编辑 mongod.cfg 添加 security: authorization: enabled
远程访问mongod.cfg 设置 bindIp: 0.0.0.0,重启服务。
卸载MSI:控制面板 > 程序 > 卸载。
ZIP:删除文件夹 + 移除环境变量。

五、常见问题排查

问题解决方案
端口 27017 被占用检查进程:netstat -ano | findstr :27017,结束占用进程。
权限错误以管理员运行 CMD;确保目录权限为 Everyone(测试用)。
mongosh 命令未找到检查 Path 环境变量,重启终端。
服务启动失败查看日志 C:\data\log\mongod.log,常见因目录不存在。
ARM64 支持Windows on ARM 支持,但需 ZIP 版(MSI 仅 x64)。

六、推荐工具与下一步

  • MongoDB Compass:安装时可选,图形化管理界面(下载:Compass)。
  • MongoDB Shell (mongosh):命令行客户端,已随安装包包含。
  • 云替代:新手推荐 MongoDB Atlas(免费层 512 MB 存储,无需本地安装)。

总结:MSI 方式 5 分钟搞定!安装后立即试试插入数据:use testdb; db.users.insertOne({name: "测试"});

如需 详细视频教程生产环境配置与 Docker 安装对比,继续提问!(参考官方文档:https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-windows/)

文章已创建 2349

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

相关文章

开始在上面输入您的搜索词,然后按回车进行搜索。按ESC取消。

返回顶部