设置本地 MongoDB 数据库

概述

本页介绍如何安装和配置 MongoDB 数据库服务器 和默认的 mongo shell。本指南将介绍如何在您的计算机上安装和设置这些组件以进行本地访问。

本指南将涵盖以下平台

• 在 Windows 上设置 MongoDB
• 在 macOS 上设置 MongoDB
• 在 Linux 上设置 MongoDB
  • Debian 和 Ubuntu
  • CentOS

导航到与您将要使用的平台匹配的部分。

在 Windows 上设置 MongoDB

注意： 本指南是为 MongoDB 版本 4 编写的，自编写之时起，安装过程已发生更改。要为 Windows 安装更新版本的 MongoDB，请查看 MongoDB 的 Windows 安装文档。

MongoDB 提供了一个原生 Windows 安装程序来安装和配置您的数据库。

访问 MongoDB Community Server 的下载页面，然后选择适用于 Windows 的最新 msi 包。单击下载以获取安装程序

下载完成后，双击该文件以运行安装程序（您可能需要确认您希望允许该程序对您的计算机进行更改）

下载完成后，双击该文件以运行安装程序（您可能需要确认您希望允许该程序对您的计算机进行更改）

在初始页面上单击下一步以继续。

在下一页上，阅读并查看最终用户许可协议，然后选中复选框以确认您同意这些条款

单击下一步继续。

下一页允许您选择要安装的组件

选择完整安装以安装所有 MongoDB 组件。

下一个屏幕允许您自定义安装位置和其他配置项

默认值应适用于大多数情况。当您对您的选择感到满意时，单击下一步。

接下来，选择是否要安装 MongoDB Compass，这是一个图形界面，您可以使用它连接和管理 MongoDB 服务器。此组件是可选的

做出决定后，单击下一步。

下一个屏幕指示预安装配置已完成，MongoDB 已准备好安装

单击安装以开始在您的计算机上安装所有 MongoDB 组件。

安装完成后，MongoDB Compass 可能会自动打开。如果是这样，您可以暂时忽略它。

现在 MongoDB 已安装，我们可以运行服务器并使用随附的 MongoDB shell 连接到它。这两个组件都从命令行运行。

在您的开始菜单中，键入 cmd 并单击 Windows 命令提示符以启动终端会话。

在您运行服务器之前，您需要创建 MongoDB 存储其数据的默认目录：\data\db。您可以通过键入以下内容来创建该目录

md \data\db

之后，您可以通过键入 mongod.exe 可执行文件的绝对路径来启动 MongoDB 服务器。路径的一部分包含您安装的 MongoDB 版本号，因此您的安装路径可能与下面使用的路径略有不同

C:\Program Files\MongoDB\Server\4.4\bin\mongod.exe

如果一切正常，服务器将启动并将诊断信息输出到控制台。要验证启动是否成功，请查找一条消息，指示它现在正在接受来自客户端的连接

要连接到正在运行的 MongoDB 服务器，请打开另一个命令提示符窗口。与之前类似，我们需要键入可执行文件的绝对路径。

在这种情况下，我们尝试运行 mongo.exe 可执行文件，因此，考虑到版本号的差异，命令应如下所示

C:\Program Files\MongoDB\Server\4.4\bin\mongo.exe

一旦 shell 连接到服务器，它将打印有关连接的信息并将您放入 MongoDB 提示符中

要验证服务器是否正在响应命令，请运行 show dbs 命令

如果您安装了 MongoDB Compass 组件，您还可以从图形界面连接和管理您的 MongoDB 服务器。

打开 MongoDB Compass 开始。

初始屏幕将让您有机会通过提供连接字符串来连接到正在运行的 MongoDB 服务器

如果您在不输入任何信息的情况下单击连接，Compass 将自动尝试连接到使用默认配置运行的本地 MongoDB 服务器。

单击连接以连接到您正在运行的 MongoDB 服务器。

一旦 Compass 连接到您的本地服务器，它将显示有关其中数据库的信息，并允许您使用友好的图形界面管理您的数据

当您完成 MongoDB 服务器的工作后，您可以停止每个组件。

在 MongoDB Compass 中，单击连接菜单，然后选择断开连接以断开与 MongoDB 服务器的连接。之后，您可以安全地关闭 MongoDB Compass 应用程序。

在 MongoDB shell 中，您可以键入 exit 以结束您的会话。

要停止 MongoDB 服务器，请键入 CTRL-c 以开始服务器组件的关闭过程。

在 macOS 上设置 MongoDB

MongoDB 提供了一个原生 macOS 安装程序来安装和配置您的数据库。

访问 MongoDB Community Server 的下载页面，然后选择适用于 macOS 的最新 .tgz 文件。单击下载以获取安装程序

下载完成后，打开一个新的终端窗口，导航到您下载 MongoDB .tgz 文件的位置。

通过键入以下内容来提取 .tgz 文件的内容

tar xzvf mongodb-macos*.tgz

更改到解压后的目录，然后将可执行文件复制到您的 /usr/local/bin 目录，以便它们成为操作系统用于搜索可执行文件的 PATH 的一部分

cd mongodb-macos*
sudo cp bin/* /usr/local/bin

在您可以启动 MongoDB 服务器之前，您需要创建一些它需要的目录。

首先，通过键入以下内容来创建 MongoDB 服务器数据目录

sudo mkdir -p /usr/local/var/mongodb

接下来，创建一个 MongoDB 可以用来存储其日志的目录

sudo mkdir -p /usr/local/var/log/mongodb

接下来，让您当前的用户拥有新目录的所有权，以便当您使用您的用户运行服务器时，MongoDB 可以写入它们

sudo chown $USER /usr/local/var/mongodb
sudo chown $USER /usr/local/var/log/mongodb

现在 MongoDB 服务器需要的目录已就绪，您可以使用我们创建的路径启动 MongoDB 服务器，方法是键入

mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log --fork

根据您的 macOS 版本，您可能会看到一个提示，说明 MongoDB 服务器的执行已被阻止

这是一个安全策略，每当运行 Apple 不识别的应用程序时，该策略都会被激活。您可以通过转到您的系统偏好设置，单击安全性与隐私，然后单击 MongoDB 服务器条目旁边的仍然允许来允许您的 MongoDB 服务器例外

当您再次运行该命令时，可能会出现另一个提示。但是，这一次，您可以选择通过单击打开来允许程序执行

现在 MongoDB 服务器正在运行，您可以启动 MongoDB shell 以连接和管理您的服务器。要运行 MongoDB shell，请键入

mongo

根据您的 macOS 版本，您可能会再次收到执行被阻止的通知。如果是这种情况，请按照与之前相同的步骤进行操作，以允许例外并确认您要运行 MongoDB shell。

当一切顺利时，MongoDB shell 将连接到您的本地 MongoDB 服务器，并为您提供 MongoDB 提示符

要验证服务器是否正在响应命令，请运行 show dbs 命令

show dbs

您还可以选择安装一个名为 MongoDB compass 的图形 MongoDB 管理器。要安装 Compass，请使用 MongoDB 安装中包含的 install_compass 命令

install_compass

偶尔，安装程序会遇到错误，如上所示，但通常它不会影响实际安装。

初始屏幕将让您有机会通过提供连接字符串来连接到正在运行的 MongoDB 服务器

如果您在不输入任何信息的情况下单击连接，Compass 将自动尝试连接到使用默认配置运行的本地 MongoDB 服务器。

单击连接以连接到您正在运行的 MongoDB 服务器。

一旦 Compass 连接到您的本地服务器，它将显示有关其中数据库的信息，并允许您使用友好的图形界面管理您的数据

当您完成 MongoDB 服务器的工作后，您可以停止每个组件。

在 MongoDB Compass 中，单击连接菜单，然后选择断开连接以断开与 MongoDB 服务器的连接。之后，您可以安全地关闭 MongoDB Compass 应用程序。

在 MongoDB shell 中，您可以键入 exit 以结束您的会话。

要停止 MongoDB 服务器，您可以找到并杀死 MongoDB 服务器进程，方法是键入

pkill mongod

在 Linux 上设置 MongoDB

安装方法因您使用的 Linux 发行版而异。请按照下面与您的 Linux 发行版匹配的部分进行操作。

• Debian 和 Ubuntu
• CentOS

curl -L https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -

LATEST_MONGO_VERSION=$(. /etc/os-release && curl -L repo.mongodb.org/apt/${ID}/dists/${VERSION_CODENAME}/mongodb-org | grep -Eo '[0-9]+\.[0-9]+' | sort -V | tail -1)

(. /etc/os-release && echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/${ID} ${VERSION_CODENAME}/mongodb-org/${LATEST_MONGO_VERSION} multiverse") | sudo tee /etc/apt/sources.list.d/mongodb-org-${LATEST_MONGO_VERSION}.list

(. /etc/os-release && echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/${ID} ${VERSION_CODENAME}/mongodb-org/${LATEST_MONGO_VERSION} main") | sudo tee /etc/apt/sources.list.d/mongodb-org-${LATEST_MONGO_VERSION}.list

sudo apt update
sudo apt install mongodb-org

sudo systemctl start mongod.service

sudo systemctl enable mongod.service

mongo

show dbs

sudo systemctl stop mongod.service

LATEST_MONGO_VERSION=$(. /etc/os-release && curl -L repo.mongodb.org/yum/redhat/${VERSION_ID}/mongodb-org | grep -Eo '[0-9]+\.[0-9]+' | sort -V | tail -1)

sudo tee /etc/yum.repos.d/mongodb-org-${LATEST_MONGO_VERSION}.repo << EOF
[mongodb-org-${LATEST_MONGO_VERSION}]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/\$releasever/mongodb-org/${LATEST_MONGO_VERSION}/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-${LATEST_MONGO_VERSION}.asc
EOF

sudo yum install mongodb-org

sudo systemctl start mongod.service

sudo systemctl enable mongod.service

mongo

show dbs

sudo systemctl stop mongod.service