[mongodb]mongodb安装(下载安装包)

8 阅读4分钟

如果你是mac电脑, 那么你首先想到的安装方式应该是homebrew, 但是有的时候通过Homebrew安装MongoDB会失败了,那么不用担心,本文介绍最可靠的办法是改用手动安装

这需要你从官网下载压缩包并完成配置。

下面是一个详细的步骤指南,主要基于MongoDB官方文档,并融合了其他实用建议。

整个过程的关键步骤清晰明了,你可以根据自己Mac的芯片类型,在右侧表格中找到对应的操作要点,表格下方则是每个步骤的详细解释和常见问题处理。

步骤Intel芯片 (x86_64)Apple Silicon (M系列芯片)
1. 下载选择 macOS 平台与 tgz 包。选择 macOS ARM 64 平台与 tgz 包。
2. 解压tar -zxvf mongodb-macos-x86_64-8.0.tgztar -zxvf mongodb-macos-arm64-8.0.tgz
3. 设置路径将解压出的bin/目录添加到系统PATH中(推荐方式见下文)。同左。
4. 创建目录在用户主目录创建~/data/db作为数据存储目录。同左。

📦 详细安装与配置步骤

  1. 下载安装包 访问MongoDB社区版下载中心,在版本下拉框中选择最新版(如8.0),然后根据你的芯片类型,在“Platform”中选择 macOSmacOS ARM 64,最后在“Package”中选择 tgz 格式并下载。

  2. 解压文件 打开终端,进入下载文件所在的目录(通常在~/Downloads),执行对应的解压命令。

    # 根据你的芯片类型选择一行执行
    tar -zxvf mongodb-macos-x86_64-8.0.tgz  # Intel芯片
    tar -zxvf mongodb-macos-arm64-8.0.tgz    # Apple Silicon芯片
    

    解压后会得到一个类似mongodb-macos-x86_64-8.0的文件夹。

  3. 配置环境变量 (让系统能找到命令) 为了让终端能直接运行mongodmongosh等命令,你需要将MongoDB的可执行文件路径加入系统PATH

    • 推荐方法 (创建符号链接):将解压出的bin目录下的所有命令链接到系统目录(如/usr/local/bin)。
      # 将 /path/to/the/mongodb-directory/ 替换为你解压出的文件夹的完整路径
      sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/
      
    • 完成后,可以运行 mongod --version 测试是否配置成功。
  4. 准备数据与日志目录 MongoDB需要一个目录来存储数据。官方推荐在用户主目录下创建。

    # 创建数据目录
    mkdir -p ~/data/db
    # 创建日志目录(可选,但利于排查问题)
    mkdir -p ~/data/log/mongodb
    
  5. 启动MongoDB服务 在终端中,使用--dbpath参数指向你创建的数据目录来启动服务。

    mongod --dbpath ~/data/db --logpath ~/data/log/mongodb/mongo.log --fork
    
    • --dbpath: 指定数据目录。
    • --logpath: 指定日志文件路径,方便查看运行状态。
    • --fork: 让服务在后台运行。
  6. 连接数据库 打开一个新的终端窗口,运行mongosh命令,即可连接并开始使用MongoDB。

    mongosh
    

⚠️ 常见问题与解决

  • 启动失败:提示“Address already in use” 这表示默认端口(27017)被占用。可能是之前安装的MongoDB实例未正确关闭。可以先执行 pkill -f mongod 终止所有相关进程再启动,或者检查是否有其他程序占用该端口。
  • 权限问题 如果启动时提示对/tmp/mongodb-27017.sock等文件没有权限,可以尝试用sudo chown命令更改文件所有者。
  • “command not found: mongo” 从MongoDB 6.0开始,旧的mongo shell被新的mongosh替代。请确保安装的是mongosh(如果手动安装的tgz包不包含,需要单独下载),并使用mongosh命令连接。

✅ 验证安装成功

在运行mongosh成功连接后,可以执行几个简单的命令来测试:

  1. 查看当前数据库:show dbs
  2. 创建一个测试数据库:use testdb
  3. 插入一条数据:db.testcollection.insertOne({ name: "Mac User" }) 如果这些操作都能正常执行,说明你的本地MongoDB服务已经安装并运行成功。

总结来说,手动安装是最直接、可控的备选方案,避免了Homebrew可能出现的复杂依赖或网络问题。只要按照步骤设置好目录和路径,启动过程通常会很顺利。

如果你在安装过程中遇到了上面没有提到的具体错误信息,或者需要了解如何将MongoDB设置为开机自动启动,我可以提供更详细的帮助。