垦荒学园
  • 中文

      • 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. 配置环境变量

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

      方法二：使用 Chocolatey

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

      macOS 安装

      方法一：使用 Homebrew（推荐）

      # 更新 Homebrew
brew update

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

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

# 停止服务
brew services stop mongodb-community

      方法二：手动安装

      # 下载并解压
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）

      # 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）

      # 1. 创建仓库文件
sudo vi /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
      # 2. 安装 MongoDB
sudo yum install -y mongodb-org

# 3. 启动服务
sudo systemctl start mongod

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

      Docker 安装

      # 拉取官方镜像
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

      验证安装

      检查版本

      mongod --version

      启动 MongoDB Shell

      mongosh

      基本命令测试

      // 显示所有数据库
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

      常用配置项

      # 存储配置
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. 端口被占用

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

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

      2. 权限问题（Linux）

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

      3. 连接被拒绝

      # 检查防火墙设置
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 概念解析。