MongoDB 安装教程

Windows 系统安装

1. 下载MongoDB

访问MongoDB官网下载页面：https://www.mongodb.com/try/download/community - 选择Windows版本 - 下载.msi安装包

2. 安装MongoDB

1. 双击下载的.msi文件
2. 按照向导进行安装
3. 建议选择"Complete"完整安装
4. 取消勾选"Install MongoDB Compass"（可选，Compass是图形界面工具）

3. 配置环境变量

1. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
2. 在系统变量的Path中添加MongoDB的bin目录路径，例如： C:\Program Files\MongoDB\Server\5.0\bin

4. 创建数据目录

1. 创建数据存储目录（默认MongoDB需要这个目录）： md C:\data\db

5. 启动MongoDB服务

1. 以管理员身份打开命令提示符
2. 运行以下命令启动MongoDB： mongod 或作为Windows服务安装： mongod --install --dbpath="C:\data\db" --logpath="C:\data\log\mongod.log" net start MongoDB

6. 连接MongoDB

打开新的命令提示符窗口，运行：

mongo

macOS 系统安装

方法1：使用Homebrew安装

1. 安装Homebrew（如果尚未安装）： /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. 使用brew安装MongoDB： brew tap mongodb/brew brew install mongodb-community

方法2：手动下载安装

1. 从官网下载macOS版本的.tgz文件
2. 解压并移动到合适位置： tar -zxvf mongodb-macos-x86_64-5.0.6.tgz sudo mv mongodb-macos-x86_64-5.0.6 /usr/local/mongodb
3. 配置环境变量： 在~/.zshrc或~/.bash_profile中添加： export PATH=/usr/local/mongodb/bin:$PATH

创建数据目录

sudo mkdir -p /data/db
sudo chown -R `id -un` /data/db

启动MongoDB

mongod

或作为服务启动：

brew services start mongodb-community

连接MongoDB

mongo

Linux 系统安装（以Ubuntu为例）

1. 导入公钥

sudo apt-get install gnupg
wget -qO - https://www.mongodb.org/static/pgp/server-5.0.asc | sudo apt-key add -

2. 创建列表文件

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list

3. 更新包管理器

sudo apt-get update

4. 安装MongoDB

sudo apt-get install -y mongodb-org

5. 启动MongoDB服务

sudo systemctl start mongod
sudo systemctl enable mongod

6. 检查服务状态

sudo systemctl status mongod

7. 连接MongoDB

mongo

Docker方式安装（所有平台通用）

1. 拉取MongoDB镜像

docker pull mongo

2. 运行MongoDB容器

docker run --name some-mongo -d -p 27017:27017 mongo

3. 连接MongoDB

docker exec -it some-mongo mongo

验证安装

无论哪种安装方式，连接MongoDB后可以运行以下命令验证：

> db.version()

应该返回安装的MongoDB版本号。

常见问题解决

1. 端口冲突：确保27017端口未被占用
2. 权限问题：确保对数据目录有读写权限
3. 服务无法启动：检查日志文件中的错误信息
   • Windows: C:\data\log\mongod.log
   • Linux/macOS: /var/log/mongodb/mongod.log

图形界面工具推荐

1. MongoDB Compass - 官方GUI工具
2. Robo 3T - 轻量级GUI工具
3. Studio 3T - 功能丰富的商业工具

安装完成后，您就可以开始使用MongoDB进行开发了！