mongodb

下载并安装mongodb https://www.mongodb.com/download-center?jmp=nav#community

MongoDB 社区版下载与安装全指南（Windows/Linux/macOS）

做Node.js后端开发时，MongoDB是最常用的NoSQL数据库之一，社区版免费且功能足够满足大部分开发/生产场景。今天基于实操经验，把MongoDB社区版的下载、安装、验证流程整理清楚，覆盖Windows、Linux、macOS三大系统，新手也能一步到位。

一、先明确：为什么选社区版？

MongoDB分为社区版（Community）和企业版（Enterprise）：

  • 社区版：免费开源，包含核心功能（CRUD、索引、聚合等），适合开发、测试、中小规模生产环境；
  • 企业版：收费，增加了审计、加密、高级监控等企业级功能，适合大型生产环境。

日常开发/个人项目，社区版完全够用。

二、第一步：下载MongoDB社区版

官方下载地址（永久有效）

1
https://www.mongodb.com/download-center?jmp=nav#community

下载页面操作要点：

  1. 选择版本：优先选「Current Release」（最新稳定版）或「Previous Stable Releases」（前稳定版，如7.0.x）；
  2. 选择系统：根据自己的操作系统（Windows/macOS/Linux）选择；
  3. 选择包类型：
    • Windows：选「msi」（安装程序，推荐）或「zip」（免安装包）；
    • Linux：选对应发行版（如Ubuntu/Debian选「deb」，CentOS/RHEL选「rpm」）；
    • macOS：选「tgz」（压缩包）或「brew」（包管理器，更便捷）。

三、分系统安装步骤（核心）

场景1：Windows系统安装（以Windows 10/11为例）

方式1：MSI安装程序（推荐，带图形界面）

  1. 双击下载的 mongodb-windows-x86_64-xxx.msi 文件，启动安装向导；
  2. 选择安装类型：
    • 「Complete」（完整安装）：适合新手，默认安装到 C:\Program Files\MongoDB\Server\版本号\；
    • 「Custom」（自定义）：可修改安装路径（建议避开C盘）；
  3. 可选配置（关键）：
    • 勾选「Install MongoDB as a Service」：将MongoDB注册为Windows服务（开机自启，推荐）；
    • 选择「Run service as Network Service user」（默认，无需手动配置权限）；
    • 可勾选「Install MongoDB Compass」（可视化工具，新手推荐安装）；
  4. 点击「Install」完成安装，等待进度条结束。

方式2：ZIP免安装包（适合自定义路径）

  1. 解压下载的zip包到指定目录（如 D:\mongodb）；
  2. 在解压目录下创建两个文件夹：data（存储数据）、log（存储日志）；
  3. 启动MongoDB：
    1
    2
    3
    4
    5
    6
    # 进入bin目录
    cd D:\mongodb\bin
    # 启动服务（指定数据/日志路径）
    mongod --dbpath D:\mongodb\data --logpath D:\mongodb\log\mongod.log --logappend --serviceName "MongoDB" --install
    # 启动服务
    net start MongoDB

Windows验证安装是否成功：

  1. 打开CMD，输入以下命令：
    1
    2
    3
    4
    5
    6
    # 进入MongoDB的bin目录（若已配置环境变量，可直接输）
    cd C:\Program Files\MongoDB\Server\7.0\bin
    # 连接MongoDB
    mongo
    # 或新版MongoDB用mongosh（推荐）
    mongosh
  2. 若出现 > 或 test> 提示符，说明连接成功，输入 db.version() 可查看版本号。

场景2：Linux系统安装（以Ubuntu 22.04为例）

方式1：APT包管理器（推荐，自动配置依赖）

  1. 添加MongoDB官方源：
    1
    2
    3
    4
    # 导入公钥
    wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -
    # 添加源到apt列表
    echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
  2. 更新包索引并安装：
    1
    2
    3
    sudo apt update
    # 安装最新社区版
    sudo apt install -y mongodb-org
  3. 启动并设置开机自启：
    1
    2
    3
    4
    5
    6
    # 启动服务
    sudo systemctl start mongod
    # 设置开机自启
    sudo systemctl enable mongod
    # 查看服务状态
    sudo systemctl status mongod

Linux验证安装是否成功：

1
2
3
4
# 连接MongoDB
mongosh
# 查看版本
db.version()

场景3：macOS系统安装

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

  1. 确保已安装Homebrew（未安装则执行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"）；
  2. 安装MongoDB：
    1
    2
    3
    4
    5
    6
    # 安装社区版
    brew install mongodb-community
    # 启动服务（开机自启）
    brew services start mongodb-community
    # 临时启动（仅当前会话）
    mongod --config /usr/local/etc/mongod.conf

方式2：TGZ压缩包

  1. 解压下载的tgz包到 /usr/local：
    1
    2
    tar -zxvf mongodb-macos-x86_64-7.0.tgz
    sudo mv mongodb-macos-x86_64-7.0 /usr/local/mongodb
  2. 配置环境变量（可选，方便全局调用）：
    1
    2
    3
    4
    # 编辑~/.zshrc（zsh）或~/.bash_profile（bash）
    echo 'export PATH=/usr/local/mongodb/bin:$PATH' >> ~/.zshrc
    # 生效配置
    source ~/.zshrc
  3. 启动MongoDB：
    1
    2
    3
    4
    # 创建数据目录
    mkdir -p ~/mongodb/data
    # 启动服务
    mongod --dbpath ~/mongodb/data

macOS验证安装是否成功：

1
2
mongosh
db.version()

四、关键配置（新手必看）

1. 配置环境变量（Windows/Linux/macOS通用）

将MongoDB的bin目录加入系统环境变量，可全局调用mongod/mongosh命令，无需每次进入bin目录：

  • Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 编辑「Path」，添加C:\Program Files\MongoDB\Server\7.0\bin；
  • Linux/macOS：如上述步骤，修改~/.bashrc/~/.zshrc，添加export PATH=MongoDB安装路径/bin:$PATH。

2. 常用服务命令

系统 启动服务 停止服务 查看状态
Windows net start MongoDB net stop MongoDB sc query MongoDB
Linux sudo systemctl start mongod sudo systemctl stop mongod sudo systemctl status mongod
macOS（brew） brew services start mongodb-community brew services stop mongodb-community brew services list

五、常见坑与避坑指南

  1. Windows启动失败：
    • 原因：数据目录无权限/未创建；
    • 解决：手动创建data目录，给目录赋予读写权限，重新执行启动命令。
  2. Linux报错「找不到mongod」：
    • 原因：未配置环境变量/包未安装成功；
    • 解决：检查apt源是否正确，重新安装并配置PATH。
  3. macOS brew安装失败：
    • 原因：网络问题导致源无法访问；
    • 解决：切换国内brew源（如中科大源），再重新安装。
  4. 端口被占用：
    • MongoDB默认端口是27017，若被占用，启动时指定新端口：mongod --dbpath 数据路径 --port 27018。

总结

关键点回顾

  1. 下载：从MongoDB官网社区版下载页，选择对应系统/版本；
  2. 安装：
    • Windows：MSI安装（推荐）或ZIP免安装；
    • Linux：APT包管理器一键安装；
    • macOS：Homebrew最便捷；
  3. 验证：通过mongosh连接，执行db.version()确认安装成功；
  4. 核心配置：环境变量（全局调用）、服务自启（避免手动启动）。

MongoDB社区版安装流程整体简单，核心是确保数据目录权限、服务正常启动，验证连接成功后即可开始使用。

学无止境
mongodb
https://cszy.top/2018-06-01 mongodb/
作者
csorz
发布于
2018年6月1日
许可协议