垦荒学园

简体中文

English

简体中文

English

切换主题

MongoDB 环境安装 ​

本章将详细介绍如何在不同操作系统上安装和配置 MongoDB，包括社区版和企业版的安装方法。

系统要求 ​

最低配置要求 ​

  • 操作系统：Windows 10/11、macOS 10.14+、Linux（Ubuntu 18.04+、CentOS 7+）
  • 内存：至少 4GB RAM（推荐 8GB+）
  • 磁盘空间：至少 10GB 可用空间
  • 处理器：64位处理器

Windows 安装 ​

方法一：使用 MSI 安装包 ​

  1. 下载安装包

  2. 运行安装程序

    1. 双击下载的 .msi 文件
2. 选择 "Complete" 完整安装
3. 勾选 "Install MongoD as a Service"
4. 勾选 "Install MongoDB Compass"（可选，图形化管理工具）
5. 点击 Install 完成安装

  3. 配置环境变量

    powershell
    # 将 MongoDB bin 目录添加到 PATH
C:\Program Files\MongoDB\Server\7.0\bin

方法二：使用 Chocolatey ​

powershell
# 以管理员身份运行 PowerShell
choco install mongodb

macOS 安装 ​

方法一：使用 Homebrew（推荐） ​

bash
# 更新 Homebrew
brew update

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

# 启动 MongoDB 服务
brew services start mongodb-community

# 停止服务
brew services stop mongodb-community

方法二：手动安装 ​

bash
# 下载并解压
curl -O https://fastdl.mongodb.org/osx/mongodb-macos-x86_64-7.0.tgz
tar -zxvf mongodb-macos-x86_64-7.0.tgz

# 移动到 /usr/local
sudo mv mongodb-macos-x86_64-7.0 /usr/local/mongodb

# 添加到 PATH
echo 'export PATH=/usr/local/mongodb/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Linux 安装（Ubuntu/Debian） ​

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 focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

# 3. 更新包列表
sudo apt-get update

# 4. 安装 MongoDB
sudo apt-get install -y mongodb-org

# 5. 启动服务
sudo systemctl start mongod

# 6. 设置开机自启
sudo systemctl enable mongod

# 7. 检查状态
sudo systemctl status mongod

Linux 安装（CentOS/RHEL） ​

bash
# 1. 创建仓库文件
sudo vi /etc/yum.repos.d/mongodb-org-7.0.repo

添加以下内容：

ini
[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
bash
# 2. 安装 MongoDB
sudo yum install -y mongodb-org

# 3. 启动服务
sudo systemctl start mongod

# 4. 设置开机自启
sudo systemctl enable mongod

Docker 安装 ​

bash
# 拉取官方镜像
docker pull mongo:7.0

# 运行容器
docker run -d \
  --name mongodb \
  -p 27017:27017 \
  -v mongodb_data:/data/db \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=password \
  mongo:7.0

# 进入容器
docker exec -it mongodb mongosh

验证安装 ​

检查版本 ​

bash
mongod --version

启动 MongoDB Shell ​

bash
mongosh

基本命令测试 ​

javascript
// 显示所有数据库
show dbs

// 切换到 test 数据库
use test

// 插入测试数据
db.users.insertOne({ name: "张三", age: 25 })

// 查询数据
db.users.find()

// 退出
exit

配置文件说明 ​

配置文件位置 ​

  • Windows: C:\Program Files\MongoDB\Server\7.0\bin\mongod.cfg
  • Linux/macOS: /etc/mongod.conf

常用配置项 ​

yaml
# 存储配置
storage:
  dbPath: /var/lib/mongodb
  journal:
    enabled: true

# 网络配置
net:
  port: 27017
  bindIp: 127.0.0.1  # 如需远程访问，改为 0.0.0.0

# 安全配置
security:
  authorization: enabled  # 启用认证

# 日志配置
systemLog:
  destination: file
  logAppend: true
  path: /var/log/mongodb/mongod.log

# 进程管理
processManagement:
  fork: true
  pidFilePath: /var/run/mongodb/mongod.pid

常见问题 ​

1. 端口被占用 ​

bash
# 查找占用 27017 端口的进程
sudo lsof -i :27017

# 或更改 MongoDB 端口
# 在配置文件中修改 net.port

2. 权限问题（Linux） ​

bash
# 修复数据目录权限
sudo chown -R mongodb:mongodb /var/lib/mongodb
sudo chown -R mongodb:mongodb /var/log/mongodb

3. 连接被拒绝 ​

bash
# 检查防火墙设置
sudo ufw allow 27017

# 检查 MongoDB 服务状态
sudo systemctl status mongod

安装 MongoDB Compass（图形化工具） ​

MongoDB Compass 是官方提供的图形化管理工具，支持可视化查询、索引管理、数据导入导出等功能。

下载安装 ​

连接数据库 ​

  1. 打开 Compass
  2. 输入连接字符串：mongodb://localhost:27017
  3. 点击 Connect

总结 ​

本章介绍了多种 MongoDB 安装方式：

  • Windows：MSI 安装包或 Chocolatey
  • macOS：Homebrew 或手动安装
  • Linux：包管理器安装
  • Docker：容器化部署

选择适合你环境的安装方式，完成 MongoDB 的安装和基本配置。

在下一章中，我们将学习 MongoDB 概念解析。