[macos系统]mongodb(安装, 通过homebrew方式)

977 阅读2分钟

1/使用 Homebrew 安装(推荐)

步骤 1:安装 Homebrew(如果尚未安装)

# 打开终端(Terminal)
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 添加 Homebrew 到 PATH(根据安装完成后的提示操作)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

# 验证安装
brew --version

步骤 2:添加 MongoDB 仓库并安装

# 添加 MongoDB 的 Homebrew 仓库
brew tap mongodb/brew

# 更新 Homebrew
brew update

# 安装 MongoDB Community Edition
brew install mongodb-community

# 或者安装特定版本(可选)
# brew install mongodb-community@6.0

步骤 3:创建必要目录

# 创建数据存储目录
sudo mkdir -p /usr/local/var/mongodb

# 创建日志目录
sudo mkdir -p /usr/local/var/log/mongodb

# 设置目录权限(使用你的用户名替换 YOUR_USERNAME)
sudo chown -R $(whoami) /usr/local/var/mongodb
sudo chown -R $(whoami) /usr/local/var/log/mongodb

步骤 4:启动 MongoDB 服务

# 方法A:使用 Homebrew Services(推荐,自动启动)
brew services start mongodb-community

# 方法B:手动启动
mongod --config /usr/local/etc/mongod.conf

# 方法C:使用自定义配置启动
mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log --fork

步骤 5:验证安装和运行状态

# 检查服务状态
brew services list | grep mongo

# 连接到 MongoDB
mongosh

# 或者使用旧版 mongo shell(如果已安装)
# mongo

# 在 MongoDB shell 中运行测试命令
> db.runCommand({ ping: 1 })
# 应该返回:{ "ok": 1 }

2/常用命令和操作

(1)基本操作

# 连接到 MongoDB
mongosh

# 查看数据库
show dbs

# 使用数据库
use test

# 查看集合
show collections

# 创建集合
db.createCollection("users")

# 插入文档
db.users.insertOne({name: "John", age: 30})

# 查询文档
db.users.find()

(2)服务管理命令

# 停止 MongoDB
brew services stop mongodb-community

# 重启 MongoDB
brew services restart mongodb-community

# 查看日志
tail -f /usr/local/var/log/mongodb/mongo.log

# 停止 MongoDB 进程
mongod --shutdown

(3)故障排除

# 如果遇到端口占用
sudo lsof -i :27017
sudo kill -9 <PID>

# 修复权限问题
sudo chown -R $(whoami):admin /data/db

# 查看 MongoDB 版本
mongod --version

# 重置数据库(谨慎使用)
rm -rf /data/db/*

(4)安装 MongoDB Compass(图形界面)

# 使用 Homebrew 安装 Compass
brew install --cask mongodb-compass

# 或从官网下载:https://www.mongodb.com/products/compass

(5)配置环境变量

# 添加到 ~/.zshrc 或 ~/.bash_profile
echo 'export PATH="/usr/local/opt/mongodb-community/bin:$PATH"' >> ~/.zshrc
echo 'export MONGO_PATH=/usr/local/mongodb' >> ~/.zshrc
echo 'export PATH=$PATH:$MONGO_PATH/bin' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc

(6)验证安装完成

# 运行验证脚本
echo "=== MongoDB 安装验证 ==="
echo "1. 检查服务状态:"
brew services list | grep mongo

echo "\n2. 检查版本:"
mongod --version | head -3

echo "\n3. 测试连接:"
mongosh --eval "db.runCommand({ ping: 1 })"

echo "\n4. 检查进程:"
ps aux | grep mongod | grep -v grep

3/注意事项

  1. 数据备份:定期备份 /data/db/usr/local/var/mongodb 目录
  2. 安全配置:生产环境需要配置认证
  3. 内存使用:MongoDB 会尽可能使用可用内存
  4. 版本兼容:确保客户端驱动与服务器版本兼容
  5. 磁盘空间:确保有足够的磁盘空间供数据库使用

4/卸载 MongoDB

# 如果使用 Homebrew 安装
brew services stop mongodb-community
brew uninstall mongodb-community
brew untap mongodb/brew

# 删除数据目录(谨慎操作)
sudo rm -rf /data/db
sudo rm -rf /usr/local/var/mongodb

现在你已经成功在 macOS 上安装并启动了 MongoDB 服务!可以使用 mongosh 连接到数据库开始使用了。