下载 MongoDB
MongoDB 的版本偶数版本为稳定版,奇数版本为开发版。
MongoDB 对于 32 位系统支持不佳,所以 3.2 版本以后没有再对 32 位系统的支持。
Windows 平台
安装类型说明
- Complete 安装
安装所有默认组件:MongoDB Server、Compass、MongoDB Shell 等
自动使用默认 Data/Log 目录
适合快速学习和开发
- Custom 安装(以 v8.2.3 为例)
可自定义安装目录和组件
可以选择是否安装 Compass、是否注册服务、是否添加 PATH
不会自动添加 bin 到 PATH
适合多实例或企业环境
Custom 安装灵活但需要手动管理 PATH 和服务配置;Complete 安装一键搞定。
安装步骤(Custom 模式)
- 双击 MSI → 点击 Next
- 选择 Custom 安装
- 选择安装目录和组件(MongoDB Server 必选)
- 勾选
Install MongoDB as a Service
设置服务名称(Service Name,默认 MongoDB)
作用:Windows 系统注册服务时的唯一标识。
你可以通过它启动/停止/重启 MongoDB 服务:
net start MongoDB
net stop MongoDB⚠️ 注意
如果同一台机器上安装了多个 MongoDB 实例,每个实例必须使用不同的 Service Name,否则会冲突。
Service Name 不影响数据库文件目录,只是系统管理服务的标签。
设置服务账户(Run service as,默认 Network Service user)
MongoDB 在 Windows 下以某个账户身份运行服务,需要这个账户对 Data/Log 目录 有读写权限。
| 选项 | 描述 | 适用场景 | 权限特点 |
|---|---|---|---|
| Network Service user | 内置 Windows 系统账户 | 开发/学习、单机测试 | 权限有限,只能访问本地资源和必要系统服务;简单、安全;推荐初学者使用 |
| Local / domain user | 自定义本地或域账户 | 企业生产环境,多实例部署 | 需要手动配置账户权限,对 Data/Log 目录、端口、网络访问有完全控制;适合生产环境 |
🔔 提示
"开发/学习" => 选默认 Network Service 即可
"生产/企业部署" => 用 Local / domain user 并确保目录和网络权限配置正确
- 设置
Data Directory和Log Directory
默认 Data Directory:
C:\Program Files\MongoDB\Server\版本号\data\
默认 Log Directory:
C:\Program Files\MongoDB\Server\版本号\log\
⚠️ 注意:服务账户必须对目录有读写权限,否则启动失败(exitCode:100)
建议放在非系统盘以避免权限问题,例如:D:\MongoDB\data、D:\MongoDB\log 等
安装 GUI 客户端 MongoDB Compass(可选,默认安装)
点击 Install => Finish
⚠️ 注意
Custom 安装不会自动把 bin 添加到 PATH,需要手动配置
手动添加 MongoDB bin 到系统 PATH(Custom 安装需要)
打开 高级系统设置 => 环境变量
在 系统变量 Path 中点击 编辑 => 新建
C:\Program Files\MongoDB\Server\版本号\bin
点击 确定 保存
打开 新的命令行窗口,测试:
mongod --version
mongosh --version如果
mongosh找不到,很可能 Custom 安装中没有安装 MongoDB Shell,可单独安装 Shell 或使用 Compass 自带 Shell。
启动 MongoDB 服务
通过服务启动(推荐)
使用管理员权限打开命令行:
net start MongoDB查看 PID:
netstat -ano | findstr 27017⚠️ 注意
服务已经启动,不需要手动再执行 mongod → 否则会报 exitCode:100(端口被占用)
手动启动(仅测试/临时用)
mongod --dbpath "C:\Program Files\MongoDB\Server\版本号\data" --logpath "C:\Program Files\MongoDB\Server\版本号\log\mongod.log"⚠️ 注意
- Windows 下必须 管理员权限
- Custom 安装 Data/Log 目录权限必须可写,否则启动失败(exitCode:100)
连接 MongoDB
方式 1:MongoDB Shell(mongosh)
mongosh如果 Custom 安装未包含 Shell,可以:
- 单独下载安装 MongoDB Shell
- 或使用 Compass 自带 Shell
测试示例:
show dbs
use test
db.test.insertOne({name:"zc"})
db.test.find()