MongoDB（一） - MongoDB安装教程（Windows + Linux）

2025-04-29 02:01:19 0 阅读

文章目录

前言
一、Windows安装单机MongoDB
- 1. 下载并解压MongoDB安装包
- - 1.1 下载
  - 1.2 解压
  - 1.3 相关文件介绍
- 2. 配置
- - 2.1 配置环境变量
  - - 2.1.1 打开系统属性设置
    - 2.1.2 编辑 PATH 环境变量
    - 2.1.3 验证环境变量是否配置成功
  - 2.2 创建相关目录和文件
  - 2.3 修改MongoDB配置文件 mongodb.conf
- 3. 启动 MongoDB
- 4. 进入 MongoDB 客户端
- - 4.1 本地进入 MongoDB 客户端
  - 4.2 远程进入 MongoDB 客户端
- 5. 启用身份认证（选看）
- - 5.1 创建管理员用户（如果尚未创建）
  - 5.2 启动MongoDB时启用认证
  - 5.3 使用认证连接到MongoDB
二、Linux安装单机MongoDB
- 1. 上传安装包
- 2. 解压并重命名
- - 2.1 解压
  - 2.2 重命名
- 3. 配置
- - 3.1 配置环境变量
  - 3.2 创建相关目录和文件
  - 3.3 修改MongoDB配置文件 mongodb.conf
- 4. 启动MongoDB
- 5. 进入MongoDB客户端
三、使用IDEA连接MongoDB
- 1. 新建数据源
- 2. 配置 MongoDB 数据源并连接
- 3. 新建查询控制台
- 4. 选择要使用的数据库
- 5. 测试能否正常查询

前言

在当今数据驱动的时代，高效且灵活的数据库管理系统对于各类应用程序的开发与运行至关重要。MongoDB作为一款领先的非关系型数据库，以其出色的文档存储模型、高扩展性以及对复杂数据结构的良好支持，在大数据处理、Web应用开发等众多领域得到了广泛应用。

无论是Windows系统下的开发环境搭建，还是Linux系统中的服务器部署，掌握MongoDB的安装与配置方法都是迈向数据管理与应用开发征程的关键一步。本教程旨在为读者提供详尽且易懂的Windows和Linux系统中单机MongoDB的安装指南，从下载安装包开始，逐步深入到环境变量配置、目录与文件创建、配置文件调整，再到最后的启动与客户端访问，每一个步骤都配有清晰的操作说明和直观的截图示例，确保无论是初涉数据库领域的新手，还是寻求快速部署方案的专业人士，都能轻松上手，顺利搭建起属于自己的MongoDB运行环境，为后续的数据存储、查询与分析工作奠定坚实基础。

一、Windows安装单机MongoDB

1. 下载并解压MongoDB安装包

1.1 下载

MongoDB安装包下载地址：https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-5.0.30.zip

1.2 解压

把下载好的MongoDB安装包mongodb-windows-x86_64-5.0.30.zip解压到D:igdata目录中。

1.3 相关文件介绍

进入D:igdatamongodb-win32-x86_64-windows-5.0.30in目录后，可以看到如下文件。

文件的介绍如下：

文件名	作用描述
Install-Compass.ps1	自动化安装或配置 MongoDB Compass 的 PowerShell 脚本。
mongo.exe	MongoDB 的命令行客户端工具，用于连接和管理 MongoDB 数据库。
mongo.pdb	与 `mongo.exe` 相关的调试信息文件。
mongod.exe	MongoDB 数据库服务器进程，用于运行 MongoDB 数据库服务。
mongod.pdb	与 `mongod.exe` 相关的调试信息文件。
mongos.exe	MongoDB Sharded Cluster 中的查询路由器，用于处理跨分片的查询。
mongos.pdb	与 `mongos.exe` 相关的调试信息文件。
vcredist_x64.exe	Microsoft Visual C++ 运行时库的安装程序，用于支持需要该库的应用程序。

2. 配置

2.1 配置环境变量

2.1.1 打开系统属性设置

右键点击“此电脑”，选择“属性”，点击“高级系统设置”。
在弹出的“系统属性”窗口中，点击“环境变量”。

2.1.2 编辑 PATH 环境变量

在“环境变量”窗口中，找到“系统变量”部分，并从列表中找到名为 Path 的变量，然后点击“编辑”。在编辑环境变量窗口中，点击“新建”，然后输入 MongoDB 的 bin 目录路径，即 D:igdatamongodb-win32-x86_64-windows-5.0.30in，点击“确定”保存更改，然后连续点击每个窗口上的“确定”按钮以关闭所有设置窗口并保存更改。

如下图所示：

2.1.3 验证环境变量是否配置成功

打开一个新的命令提示符窗口（cmd），输入 mongo --version 或 mongod --version 来验证 MongoDB 是否正确配置。如果显示了版本信息，则说明环境变量配置成功。

配置成功如下图所示：

2.2 创建相关目录和文件

在D:igdatamongodb-win32-x86_64-windows-5.0.30目录下创建data目录和logs目录。
在D:igdatamongodb-win32-x86_64-windows-5.0.30data目录下创建db目录。
在D:igdatamongodb-win32-x86_64-windows-5.0.30logs目录下创建日志文件mongodb.log。
db目录用于存放数据库文件，logs目录用于存放日志文件。

2.3 修改MongoDB配置文件 mongodb.conf

在D:igdatamongodb-win32-x86_64-windows-5.0.30目录下创建conf目录，在D:igdatamongodb-win32-x86_64-windows-5.0.30conf目录下创建配置文件mongodb.conf。

给配置文件D:igdatamongodb-win32-x86_64-windows-5.0.30confmongodb.conf添加如下配置内容。

storage:
  dbPath: D:igdatamongodb-win32-x86_64-windows-5.0.30datadb
systemLog:
  destination: file
  path: D:igdatamongodb-win32-x86_64-windows-5.0.30logsmongodb.log
  logAppend: true
net:
  port: 27017
  bindIp: 0.0.0.0

3. 启动 MongoDB

打开一个新的命令提示符窗口（cmd），执行如下命令通过指定配置文件启动 MongoDB。

mongod -f D:igdatamongodb-win32-x86_64-windows-5.0.30confmongodb.conf

执行启动命令时，若出现如下提示，点击“允许”。

如下图所示，没有报任何提示信息说明启动成功。

4. 进入 MongoDB 客户端

4.1 本地进入 MongoDB 客户端

打开一个新的命令提示符窗口（cmd），执行如下命令进入 MongoDB 客户端。

mongo

启动成功如下图所示：

4.2 远程进入 MongoDB 客户端

打开一个新的命令提示符窗口（cmd），执行如下命令进入 MongoDB 客户端。

mongo --host 127.0.0.1 --port 27017

启动成功如下图所示：

5. 启用身份认证（选看）

在MongoDB中，“开启认证”指的是在启动MongoDB实例时启用身份验证，以确保只有经过授权的用户才能访问数据库。这通常涉及到配置MongoDB使用用户名和密码进行认证，并且需要在启动MongoDB服务时指定相应的参数。

5.1 创建管理员用户（如果尚未创建）

在启用了身份验证之前，需要至少有一个拥有适当权限的用户来管理其他用户的访问。这通常是一个管理员用户，具有userAdminAnyDatabase角色或类似的管理权限。

use admin
db.createUser(
  {
    user: "admin",
    pwd: "admin",
    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
  }
)

执行结果如下图所示：

5.2 启动MongoDB时启用认证

要启动MongoDB并启用认证，可以使用如下命令：

mongod --auth -f D:bigdatamongodb-win32-x86_64-windows-5.0.30confmongodb.conf

mongod：这是MongoDB数据库服务器的主进程命令。运行此命令以启动MongoDB实例。
--auth：这个标志告诉MongoDB要求所有连接进行身份验证。
-f 或 --config：这个选项用于指定MongoDB配置文件的位置。

5.3 使用认证连接到MongoDB

要在启用认证的MongoDB实例上进行连接，需要提供用户名、密码以及指定包含用户信息的数据库（通常是admin）。

mongo -u "admin" -p "admin" --authenticationDatabase "admin"

二、Linux安装单机MongoDB

MongoDB安装包下载地址：https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel70-5.0.30.tgz

1. 上传安装包

将下载的MongoDB安装包mongodb-linux-x86_64-rhel70-5.0.30.tgz上传至虚拟机Hadoop1的/export/software目录。

2. 解压并重命名

2.1 解压

在虚拟机Hadoop1将上传的MongoDB安装包通过解压方式安装至/export/servers目录。

tar -zxvf /export/software/mongodb-linux-x86_64-rhel70-5.0.30.tgz -C /export/servers/

2.2 重命名

在虚拟机Hadoop1执行如下命令将mongodb-linux-x86_64-rhel70-5.0.30重命名为mongodb-5.0.30。

mv /export/servers/mongodb-linux-x86_64-rhel70-5.0.30 /export/servers/mongodb-5.0.30

3. 配置

3.1 配置环境变量

在虚拟机Hadoop1执行如下命令配置mongodb环境变量。

echo >> /etc/profile
echo 'export MONGODB_HOME=/export/servers/mongodb-5.0.30' >> /etc/profile
echo 'export PATH=$PATH:$MONGODB_HOME/bin' >> /etc/profile

加载环境变量。

source /etc/profile

3.2 创建相关目录和文件

在虚拟机Hadoop1执行如下命令创建相关目录和文件。

mkdir -p /export/servers/mongodb-5.0.30/logs
touch /export/servers/mongodb-5.0.30/logs/mongodb.log
mkdir -p /export/data/mongodb-5.0.30/data/db

3.3 修改MongoDB配置文件 mongodb.conf

在虚拟机Hadoop1修改MongoDB配置文件 mongodb.conf ，执行如下命令添加配置内容。

cat > /export/servers/mongodb-5.0.30/mongodb.conf<<EOF
# 数据库文件位置
dbpath=/export/data/mongodb-5.0.30/data/db
# 日志文件位置
logpath=/export/servers/mongodb-5.0.30/logs/mongodb.log
# 以追加方式写入日志
logappend=true
# 端口
port=27017
# 是否以守护进程方式运行
fork=true
# 允许远程连接
bind_ip=0.0.0.0
EOF

4. 启动MongoDB

在虚拟机Hadoop1执行如下命令通过指定配置文件启动MongoDB。

mongod -f /export/servers/mongodb-5.0.30/mongodb.conf

5. 进入MongoDB客户端

本地进入MongoDB客户端。

mongo

远程进入MongoDB客户端。

mongo --host 192.168.121.160 --port 27017

三、使用IDEA连接MongoDB

1. 新建数据源

打开数据库管理工具：确保数据库管理工具已打开，并且你处于管理数据库和数据源的主界面。
开始创建新的数据源：点击左上角的“+”按钮。这个按钮用于添加新数据源。
选择数据源类型：点击“+”按钮后，会弹出一个下拉菜单。从这个菜单中选择“数据源”。
选择 MongoDB：在下一个窗口中，你会看到可以配置为数据源的不同数据库类型的列表。滚动列表并选择“MongoDB”。