一文掌握 MongoDB 详细安装与配置（Windows / Linux / macOS 全平台）

文章目录

- 一、准备工作
- - [1.1 版本选择](#1.1 版本选择)
  - [1.2 系统要求](#1.2 系统要求)
  - [1.3 下载地址](#1.3 下载地址)
  - [1.4 安装方式对比](#1.4 安装方式对比)
  - [1.5 使用建议](#1.5 使用建议)
- [二、Windows 安装与配置](#二、Windows 安装与配置)
- - [2.1 步骤 1：下载并运行安装程序](#2.1 步骤 1：下载并运行安装程序)
  - [2.2 步骤 2：创建数据与日志目录](#2.2 步骤 2：创建数据与日志目录)
  - [2.3 步骤 3：配置文件（可选但推荐）](#2.3 步骤 3：配置文件（可选但推荐）)
  - [2.4 步骤 4：启动服务](#2.4 步骤 4：启动服务)
  - [2.5 步骤 5：验证安装](#2.5 步骤 5：验证安装)
- [三、Linux 安装（以 Ubuntu 22.04 / CentOS 7 为例）](#三、Linux 安装（以 Ubuntu 22.04 / CentOS 7 为例）)
- - [3.1 Ubuntu / Debian （推荐：使用官方 APT 仓库，自动更新）](#3.1 Ubuntu / Debian （推荐：使用官方 APT 仓库，自动更新）)
  - [3.2 CentOS / RHEL / Rocky Linux（推荐：使用官方 YUM 仓库，自动更新）](#3.2 CentOS / RHEL / Rocky Linux（推荐：使用官方 YUM 仓库，自动更新）)
  - [3.3 手动安装（通用 .tgz 方式）](#3.3 手动安装（通用 .tgz 方式）)
- [四、macOS 安装](#四、macOS 安装)
- - [4.1 方式 1：Homebrew（推荐）](#4.1 方式 1：Homebrew（推荐）)
  - [4.2 方式 2：官方 .pkg 安装包](#4.2 方式 2：官方 .pkg 安装包)
- 五、安全加固（所有平台通用）
- - [5.1 创建管理员用户（首次启动后立即操作！）](#5.1 创建管理员用户（首次启动后立即操作！）)
  - [5.2 启用身份验证](#5.2 启用身份验证)
  - [5.3 连接时认证](#5.3 连接时认证)
- 六、其它注意事项
- - [6.1 常用配置项说明](#6.1 常用配置项说明)
  - [6.2 基本使用](#6.2 基本使用)
  - [6.3 卸载方式](#6.3 卸载方式)

本文提供 MongoDB（社区版 7.0+） 在三大主流操作系统的 完整安装、配置、启动、安全加固及基础使用，适用于开发、测试及生产环境。

一、准备工作

1.1 版本选择

MongoDB Community Edition：免费开源，适合大多数场景
MongoDB Enterprise Edition：商业版（需授权）

本文以 Community Edition 7.0+ 为例

1.2 系统要求

平台	最低要求
Windows	Windows 10 / Server 2016+，64位
Linux	glibc ≥ 2.17（CentOS 7+、Ubuntu 18.04+）
macOS	macOS 10.15+（Catalina 或更高）

1.3 下载地址

官网：https://www.mongodb.com/try/download/community
直接下载（选对应平台）：
- Windows: .msi
- Linux: .tgz（通用）或使用包管理器
- macOS: .pkg 或通过 Homebrew

1.4 安装方式对比

平台	推荐安装方式	配置文件位置	服务管理
Windows	MSI 安装包	`C:\Program Files\MongoDB\...\mongod.cfg`	`net start/stop MongoDB`
Linux	官方 APT/YUM 仓库	`/etc/mongod.conf`	`systemctl start mongod`
macOS	Homebrew	`/usr/local/etc/mongod.conf`	`brew services start mongodb`

1.5 使用建议

1、始终启用身份验证

2、不要将 bindIp 设为 0.0.0.0 除非必要

3、定期备份（使用 mongodump）

4、生产环境使用副本集（Replica Set）或分片集群

二、Windows 安装与配置

2.1 步骤 1：下载并运行安装程序

访问 MongoDB Download Center
选择 Windows x64 → 下载 .msi 文件
双击运行，选择 "Complete" 安装类型
勾选 "Install MongoD as a Service"（推荐）
完成安装

默认路径：C:\Program Files\MongoDB\Server\7.0\

2.2 步骤 2：创建数据与日志目录

powershell 复制代码

# 以管理员身份运行 PowerShell
mkdir C:\data\db
mkdir C:\data\log

2.3 步骤 3：配置文件（可选但推荐）

创建 C:\Program Files\MongoDB\Server\7.0\bin\mongod.cfg：

yaml 复制代码

systemLog:
  destination: file
  logAppend: true
  path: C:\data\log\mongod.log

storage:
  dbPath: C:\data\db
  journal:
    enabled: true

net:
  port: 27017
  bindIp: 127.0.0.1  # 仅本地访问（安全！）

processManagement:
  windowsService:
    serviceName: "MongoDB"
    displayName: "MongoDB"

2.4 步骤 4：启动服务

方法1（推荐）：
powershell 复制代码
```
net start MongoDB
```

方法2：手动启动（调试用）

powershell 复制代码

"C:\Program Files\MongoDB\Server\7.0\bin\mongod.exe" --config "C:\Program Files\MongoDB\Server\7.0\bin\mongod.cfg"

2.5 步骤 5：验证安装

powershell 复制代码

"C:\Program Files\MongoDB\Server\7.0\bin\mongo.exe"

在 shell 中输入：

js 复制代码

db.version()   // 应返回 7.0.x
show dbs       // 查看数据库

三、Linux 安装（以 Ubuntu 22.04 / CentOS 7 为例）

3.1 Ubuntu / Debian （推荐：使用官方 APT 仓库，自动更新）

bash 复制代码

# 1. 导入公钥
wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -

# 2. 添加仓库
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

# 3. 安装
sudo apt update
sudo apt install -y mongodb-org

# 4. 启动 & 开机自启
sudo systemctl start mongod
sudo systemctl enable mongod

# 5. 验证
mongo --eval "db.version()"

3.2 CentOS / RHEL / Rocky Linux（推荐：使用官方 YUM 仓库，自动更新）

bash 复制代码

# 1. 创建 repo 文件
cat <<EOF | sudo tee /etc/yum.repos.d/mongodb-org-7.0.repo
[mongodb-org-7.0]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/\$releasever/mongodb-org/7.0/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-7.0.asc
EOF

# 2. 安装
sudo yum install -y mongodb-org

# 3. 启动
sudo systemctl start mongod
sudo systemctl enable mongod

# 4. 验证
mongo --eval "db.version()"

注意：CentOS 7 需先启用 EPEL 并升级 glibc（或使用兼容版本）

3.3 手动安装（通用 .tgz 方式）

适用于无 root 权限或特殊环境：

bash 复制代码

# 1. 下载
wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu2204-7.0.0.tgz
tar -zxvf mongodb-linux-*.tgz
sudo mv mongodb-linux-*/ /opt/mongodb

# 2. 创建目录
sudo mkdir -p /data/db /var/log/mongodb
sudo chown `whoami` /data/db /var/log/mongodb

# 3. 启动
/opt/mongodb/bin/mongod --dbpath /data/db --logpath /var/log/mongodb/mongod.log --fork

四、macOS 安装

4.1 方式 1：Homebrew（推荐）

bash 复制代码

# 安装 Homebrew（若未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 MongoDB
brew tap mongodb/brew
brew install mongodb-community@7.0

# 启动服务
brew services start mongodb-community@7.0

# 验证
mongo --eval "db.version()"

4.2 方式 2：官方 .pkg 安装包

下载 .pkg 文件
双击安装
数据目录默认为 /usr/local/var/mongodb

启动命令：

bash 复制代码

mongod --config /usr/local/etc/mongod.conf

五、安全加固（所有平台通用）

5.1 创建管理员用户（首次启动后立即操作！）

js 复制代码

// 连接 MongoDB
mongo

// 切换到 admin 数据库
use admin

// 创建 root 用户
db.createUser({
  user: "admin",
  pwd: "YourStrongPassword123!",
  roles: [ { role: "root", db: "admin" } ]
})

// 启用认证（退出后需重启 MongoDB）
db.auth("admin", "YourStrongPassword123!")

5.2 启用身份验证

编辑配置文件（路径因平台而异）：

yaml 复制代码

security:
  authorization: enabled

Windows: mongod.cfg
Linux: /etc/mongod.conf
macOS (Homebrew): /usr/local/etc/mongod.conf

重启 MongoDB 服务生效

5.3 连接时认证

bash 复制代码

mongo -u admin -p --authenticationDatabase admin

六、其它注意事项

6.1 常用配置项说明

配置项	说明
`net.bindIp`	默认 `127.0.0.1`（仅本地），如需远程访问改为 `0.0.0.0`（需配合防火墙）
`storage.dbPath`	数据存储目录
`systemLog.path`	日志文件路径
`replication.oplogSizeMB`	副本集 oplog 大小（开发可设为 128）
`setParameter.wiredTigerEngineConfigString`	调整 WiredTiger 缓存（如 `cache_size=1G`）

6.2 基本使用

js 复制代码

// 连接（带认证）
mongo -u admin -p --authenticationDatabase admin

// 创建数据库 & 集合
use myapp
db.products.insertOne({ name: "Laptop", price: 999 })

// 查询
db.products.find()

// 创建索引
db.products.createIndex({ name: 1 })

6.3 卸载方式

平台	命令
Windows	控制面板 → 卸载程序 → MongoDB
Ubuntu	`sudo apt purge mongodb-org* && sudo rm -r /var/log/mongodb /var/lib/mongodb`
CentOS	`sudo yum erase mongodb-org* && sudo rm -r /var/log/mongodb /var/lib/mongodb`
macOS (Homebrew)	`brew services stop mongodb-community@7.0 && brew uninstall mongodb-community@7.0`