Windows 平台安装 MongoDB(2025 年最新指南)
MongoDB 支持 Windows 平台安装,主要通过 Community Edition(免费版)进行。当前最新稳定版本为 MongoDB 8.0(截至 2025 年 11 月)。安装方式包括 MSI 安装包(推荐,图形化)和 ZIP 归档(手动配置)。以下基于官方文档(MongoDB 8.0)总结步骤,适用于 Windows 10/11 或 Windows 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:下载安装包
- 访问 MongoDB 下载中心。
- 选择:
- Version:8.0(最新稳定版)。
- Platform:Windows。
- Package:MSI。
- 点击 Download,保存
.msi文件(约 300 MB)。
步骤 2:运行安装
- 双击
.msi文件,以 管理员权限 运行。 - 在安装向导中:
- 选择 Complete(完整安装)或 Custom(自定义路径)。
- Install MongoDB as a Service:勾选(推荐,作为 Windows 服务自动启动)。
- Install MongoDB Compass:可选(图形化工具,推荐勾选)。
- 点击 Install,等待完成(约 2-5 分钟)。
步骤 3:配置数据目录
- 如果未自动创建,手动:
- 创建文件夹:
C:\data\db(数据存储)和C:\data\log\mongod.log(日志)。 - 编辑服务配置(可选):在
C:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg中设置dbPath: C:\data\db和logPath: C:\data\log\mongod.log。
步骤 4:验证安装
- 打开 命令提示符(以管理员运行)。
- 输入
mongod --version,检查版本输出。 - 启动服务:
net start MongoDB(如果作为服务安装)。 - 新终端输入
mongosh(MongoDB Shell),连接测试:
> show dbs
- 如果显示空列表,安装成功。
三、安装方法 2:ZIP 归档(手动安装)
步骤 1:下载并解压
- 在下载中心选择 ZIP 包,下载并解压到
C:\mongodb(自定义路径)。
步骤 2:创建目录
- 创建
C:\data\db和C:\data\log。
步骤 3:添加环境变量
- 右键 此电脑 > 属性 > 高级系统设置 > 环境变量。
- 在 系统变量 > 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
- CMD 中运行:
mongod --config "C:\mongodb\bin\mongod.cfg" --install(安装为服务)。 - 启动服务:
net start MongoDB。 - 验证:同上,使用
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/)