正文

宝塔面板安装MongoDB完整指南，从零开始搭建NoSQL数据库

admin
admin V管理员 /1.13 K阅读/0评论
0621
文章最后更新时间2026年06月21日，若文章内容或图片失效，请留言反馈！
本文将详细介绍如何在宝塔面板上安装并搭建MongoDB NoSQL数据库，需要在宝塔面板中安装MongoDB，接着配置数据库相关参数，如端口、数据存储路径等，创建新的数据库和集合，并导入初始化数据，通过客户端工具连接到MongoDB数据库，进行数据的增删改查操作，本文将引导您完成整个过程，确保您能够熟练地使用MongoDB数据库。

宝塔面板如何安装MongoDB？一篇老运维教你轻松搞定

在 IDC 行业摸爬滚打 10 年，我接触过各种各样的 IT 问题，但 MongoDB 的安装对我来说并不陌生，我想分享一下如何在宝塔面板上安装 MongoDB，让那些刚开始接触 MongoDB 的朋友能够轻松搞定。

咱们得明确一点：宝塔面板是一个非常流行的服务器管理面板，它可以让你方便地管理服务器上的一切，包括安装各种软件，而 MongoDB 是一个基于分布式文件存储的数据库系统,适用于处理大量的数据。

准备工作

宝塔面板安装MongoDB完整指南，从零开始搭建NoSQL数据库

宝塔面板安装MongoDB完整指南，从零开始搭建NoSQL数据库

在开始安装之前，你需要确保已经安装了宝塔面板，并且面板中已经添加了 MySQL 环境，这是因为 MongoDB 需要依赖于 MySQL 进行数据交互，虽然 MongoDB 也可以独立运行，但在生产环境中，我们通常会把它当成 MySQL 的一个扩展来使用。

安装步骤

  1. 登录宝塔面板

    打开你的浏览器，输入宝塔面板的地址，然后输入你的账号和密码，登录后,你会看到面板的主界面。

  2. 安装 MySQL

    在面板主界面上，找到“软件商店”这个选项，点击进入后搜索“MySQL”，然后选择一个适合你服务器的版本进行安装，在安装过程中，你需要设置好 MySQL 的数据目录、端口等信息。

  3. 安装 MongoDB

    我们要安装 MongoDB，在“软件商店”里搜索“MongoDB”，选择一个适合的版本，注意，MongoDB 在安装过程中可能会提示你安装一些依赖包,务必按照提示操作。

    安装完成后，你需要为 MongoDB 创建一个数据目录，并设置好相关参数，这个数据目录将用于存储 MongoDB 的数据文件和日志文件。

  4. 配置 MongoDB

    打开 MongoDB 的配置文件，默认路径通常是 /etc/mongod.conf，在这个文件里，你需要修改几个重要的参数，比如数据目录、端口号等,确保这些参数与你之前设置的参数一致。

  5. 启动 MongoDB

    修改完配置文件后，重启 MongoDB 服务，在宝塔面板中，你可以找到“服务”这个选项，点击进入后找到 MongoDB 服务，点击“启动”按钮即可。

  6. 验证 MongoDB 是否安装成功

    打开一个终端窗口，输入 mongo 命令，如果能够成功进入 MongoDB 的命令行界面，那么恭喜你，MongoDB 已经成功安装！

在实际操作过程中可能会遇到一些问题，比如端口冲突、权限不足等，这时候，你不妨看看宝塔面板的日志文件，或者在网上搜索相关的解决方案,希望这篇文章能对你有所帮助！


MongoDB作为最流行的NoSQL数据库之一,因其灵活的文档存储模型和强大的查询能力，被广泛应用于现代Web应用、大数据分析、物联网等场景，对于使用宝塔面板（BT Panel）管理服务器的用户来说，通过图形化界面安装MongoDB可以大幅降低操作门槛，本文将详细介绍在宝塔面板中安装MongoDB的两种主流方法，并涵盖常见问题的解决方案。

通过宝塔应用商店一键安装（推荐新手）

步骤1：登录宝塔面板

在浏览器输入 http://你的服务器IP:8888，输入账号密码进入面板首页。

步骤2：进入软件商店

点击左侧菜单栏「软件商店」，在搜索框输入 MongoDB。

步骤3：选择版本并安装

  • 你会看到宝塔官方提供的MongoDB插件,通常支持4.4、5.0、6.0等主流版本。
  • 点击对应版本右侧的「安装」按钮，弹窗中选择安装模式：
    • 编译安装：更稳定，适合生产环境，但耗时较长（约10-20分钟）。
    • 极速安装：使用预编译包，适合测试环境，安装快但可能缺少某些优化。
  • 点击「开始安装」，等待进度条完成。

步骤4：配置数据库

安装完成后,在软件商店「已安装」列表中找到MongoDB：

  • 点击「设置」可以启动/停止服务、修改端口、开启认证。
  • 重要：为安全考虑，建议立即设置管理员账号密码：
    1. 进入MongoDB管理页面,点击「安全」标签。
    2. 开启「身份验证」功能，创建root用户。
    3. 记录好用户名和密码。

方法一优点：

  • 全程图形化操作,无需命令行
  • 自动处理依赖和系统配置
  • 内置状态监测和日志查看功能

手动编译安装（适合需要特定版本或优化）

应用场景

  • 宝塔商店的版本不适合你的项目需求
  • 需要自定义安装路径或配置参数
  • 追求最新版本或企业级性能调优

具体步骤

下载MongoDB社区版

cd /usr/local/src
wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu2204-7.0.0.tgz
# 版本号请根据官方更新替换，建议去https://www.mongodb.com/try/download/community查看最新
tar -zxvf mongodb-linux-x86_64-*.tgz
mv mongodb-linux-x86_64-* /usr/local/mongodb

创建数据目录和日志文件

mkdir -p /data/mongodb/data
mkdir -p /data/mongodb/log
touch /data/mongodb/log/mongod.log
chmod 777 /data/mongodb/log/mongod.log

创建配置文件

编辑 /etc/mongod.conf：

systemLog:
  destination: file
  logAppend: true
  path: /data/mongodb/log/mongod.log
storage:
  dbPath: /data/mongodb/data
  journal:
    enabled: true
processManagement:
  fork: true
  pidFilePath: /var/run/mongod.pid
net:
  bindIp: 127.0.0.1
  port: 27017

配置环境变量

echo 'export PATH=/usr/local/mongodb/bin:$PATH' >> /etc/profile
source /etc/profile

启动MongoDB

mongod -f /etc/mongod.conf
# 检查是否启动成功
ps aux | grep mongo

通过宝塔面板管理

  • 手动编译安装后,宝塔面板默认不会自动识别。
  • 可通过宝塔的计划任务或自定义脚本实现启动/停止管理。
  • 若希望在宝塔的软件列表中看到它,可安装「宝塔数据管理工具」插件进行关联。

常见问题排查

Q1：宝塔安装MongoDB后无法启动？

原因：通常为端口冲突或权限问题。 解决：

  • 检查 netstat -tlnp | grep 27017 确认端口是否被占用。
  • 检查 /data/mongodb/data 目录权限：chown -R mongod:mongod /data/mongodb/data（若使用系统用户启动）。

Q2：如何开启远程访问？

警告：生产环境建议避免，除非配置防火墙白名单。

  • 在MongoDB配置文件中将 bindIp 改为 0.0.0。
  • 重启服务：systemctl restart mongod（或使用宝塔面板重启）。
  • 在宝塔的安全组放行27017端口。

Q3：忘记认证密码如何重置？

  1. 停止MongoDB服务。
  2. 以无认证模式启动：mongod --auth --port 27017 --dbpath /data/mongodb/data
  3. 进入shell重置密码：
    use admin
db.createUser({ user: "admin", pwd: "新密码", roles: ["root"] })
  4. 重启服务,恢复正常模式。

安全加固建议

  1. 立即开启认证：不使用无密码的默认配置。
  2. 绑定内网IP：除非必要，不要监听0.0.0.0。
  3. 定期备份：通过宝塔的计划任务执行 mongodump。
  4. 监控日志：宝塔面板的日志功能可及时捕获异常连接。
  5. 版本更新：关注MongoDB官方安全公告，及时升级。

对于大多数用户,推荐方法一（宝塔应用商店） 即可满足需求，它足够稳定且维护简单，若你熟悉Linux操作且需要定制化环境，方法二（手动编译） 能给你更大的自由度。

无论采用哪种方式,安装完成后务必做好安全配置和定期备份，MongoDB与宝塔面板的结合，能让你在Web应用开发中如虎添翼，高效管理你的文档型数据。

提示：宝塔面板版本持续迭代，本文所述功能可能随版本更新略有变化，建议操作前参考宝塔官方文档。