macOS 平台安装 MongoDB（2025 年最新完整指南）

MongoDB 在 macOS 上支持 Homebrew（推荐）、官方 .tgz 手动安装 和 Docker 三种方式。
推荐方式：使用 Homebrew（自动管理依赖、升级、开机自启）。
当前最新稳定版：MongoDB 8.0（2025 年 11 月）。

适用系统：macOS 12 Monterey+、macOS 13 Ventura、macOS 14 Sonoma、macOS 15 Sequoia
支持架构：Intel (x86_64) 和 Apple Silicon (arm64/M1/M2/M3)

---

一、系统准备

# 1. 安装 Xcode Command Line Tools（必须）
xcode-select --install

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

# 3. 更新 Homebrew
brew update

---

二、安装方式 1：Homebrew（推荐，一键安装）

步骤 1：添加 MongoDB 官方 Tap

# 添加 MongoDB Community 版源
brew tap mongodb/brew

步骤 2：安装 MongoDB

brew install mongodb-community@8.0

输出示例：

mongodb-community@8.0 is keg-only, which means it was not symlinked into /opt/homebrew
Because it conflicts with other MongoDB versions.

步骤 3：启动 MongoDB 服务

# 方式 A：作为 macOS 服务（推荐，开机自启）
brew services start mongodb-community@8.0

# 方式 B：手动启动（前台运行）
mongod --config /opt/homebrew/etc/mongod.conf --fork
# Apple Silicon 路径：/opt/homebrew/etc/mongod.conf
# Intel 路径：/usr/local/etc/mongod.conf

步骤 4：验证安装

# 检查版本
mongod --version

# 进入 MongoDB Shell
mongosh

# 测试命令
> show dbs
> use testdb
> db.users.insertOne({name: "macOS用户", platform: "M2"})
> db.users.find().pretty()

---

三、安装方式 2：官方 TGZ 手动安装（适合自定义路径）

# 1. 下载最新 macOS 包（自动检测架构）
curl -O https://fastdl.mongodb.org/osx/mongodb-macos-x86_64-8.0.3.tgz
# 或 Apple Silicon：
curl -O https://fastdl.mongodb.org/osx/mongodb-macos-aarch64-8.0.3.tgz

# 2. 解压并移动
tar -zxvf mongodb-macos-*.tgz
sudo mkdir -p /usr/local/mongodb
sudo mv mongodb-macos-*/* /usr/local/mongodb/

# 3. 添加环境变量
echo 'export PATH="/usr/local/mongodb/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 4. 创建数据目录
sudo mkdir -p /data/db
sudo chown $USER /data/db

# 5. 启动
mongod --dbpath /data/db --logpath /data/log/mongod.log --fork

---

四、安装方式 3：Docker 安装（推荐开发/测试）

# 拉取官方社区镜像
docker pull mongodb/mongodb-community-server:8.0

# 运行容器
docker run -d --name mongo \
  -p 27017:27017 \
  -v mongo-data:/data/db \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=yourpassword \
  mongodb/mongodb-community-server:8.0

连接：

mongosh "mongodb://admin:yourpassword@localhost:27017"

---

五、Homebrew 安装后的配置说明

项目	路径（Apple Silicon）	路径（Intel）
配置文件	/opt/homebrew/etc/mongod.conf	/usr/local/etc/mongod.conf
数据目录	/opt/homebrew/var/mongodb	/usr/local/var/mongodb
日志文件	/opt/homebrew/var/log/mongodb/mongo.log	/usr/local/var/log/mongodb/mongo.log
服务管理	brew services	brew services

查看默认配置

cat /opt/homebrew/etc/mongod.conf

systemLog:
  destination: file
  path: /opt/homebrew/var/log/mongodb/mongo.log
  logAppend: true
storage:
  dbPath: /opt/homebrew/var/mongodb
net:
  bindIp: 127.0.0.1
  port: 27017

---

六、生产环境安全配置（必须）

1. 启用身份认证

mongosh

use admin
db.createUser({
  user: "admin",
  pwd: "StrongP@ssw0rd2025!",
  roles: [ "root" ]
})
exit

2. 修改 mongod.conf 启用认证

# Apple Silicon
sudo nano /opt/homebrew/etc/mongod.conf
# Intel
sudo nano /usr/local/etc/mongod.conf

security:
  authorization: enabled

net:
  bindIp: 127.0.0.1  # 本地
  # bindIp: 0.0.0.0  # 远程访问（需防火墙）

3. 重启服务

brew services restart mongodb-community@8.0

4. 认证登录

mongosh -u admin -p --authenticationDatabase admin

---

七、常用管理命令（Homebrew）

命令	功能
brew services start mongodb-community@8.0	启动服务
brew services stop mongodb-community@8.0	停止服务
brew services restart mongodb-community@8.0	重启
brew services list	查看状态
tail -f /opt/homebrew/var/log/mongodb/mongo.log	查看日志
mongosh	进入 Shell

---

八、卸载 MongoDB

# 停止服务
brew services stop mongodb-community@8.0

# 卸载软件
brew uninstall mongodb-community@8.0
brew untap mongodb/brew

# 删除数据（谨慎！）
rm -rf /opt/homebrew/var/mongodb
rm -rf /usr/local/var/mongodb
rm -rf /data/db

---

九、推荐工具

工具	说明
MongoDB Compass	图形化客户端（下载）
mongosh	现代 Shell（随 MongoDB 安装）
TablePlus	第三方 GUI，支持 MongoDB
MongoDB Atlas	云数据库（免费注册）

---

十、一键安装脚本（Apple Silicon + Homebrew）

#!/bin/bash
brew tap mongodb/brew
brew install mongodb-community@8.0
brew services start mongodb-community@8.0
echo "MongoDB 已安装并启动！"
echo "使用 mongosh 连接数据库"
mongosh --eval 'db.runCommand({ping: 1})'

保存为 install-mongo.sh，运行 chmod +x install-mongo.sh && ./install-mongo.sh

---

总结：三步安装（Homebrew）

brew tap mongodb/brew
brew install mongodb-community@8.0
brew services start mongodb-community@8.0
mongosh

---

官方文档：https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-os-x/

如需 M1/M2 性能优化、副本集配置、备份恢复 或 与 Docker Compose 集成，欢迎继续提问！