MongoDB 服务器安装是一个涉及环境准备、依赖安装、配置文件调整及服务启动的系统性过程,适用于不同操作系统(如Linux、Windows、macOS),以下以CentOS 7和Ubuntu 20.04为例,详细说明Linux环境下的安装步骤,同时补充Windows和macOS的简要方案,并附上常见问题解答。

安装前准备
-
系统要求
- CPU:x86_64架构(支持ARM64)
- 内存:最低512MB(推荐2GB以上)
- 操作系统:CentOS 7+/Ubuntu 18.04+(或Windows Server 2025+、macOS 10.14+)
- 网络:确保服务器可访问MongoDB官方仓库(若使用在线安装)
-
卸载旧版本
若系统已安装MongoDB,需先彻底卸载:# CentOS/RHEL sudo yum erase -y mongodb-org mongodb-org-server mongodb-org-shell mongodb-org-mongos mongodb-org-tools # Ubuntu/Debian sudo apt-get purge -y mongodb-org mongodb-org-server mongodb-org-shell mongodb-org-mongos mongodb-org-tools
Linux环境下安装(以MongoDB 6.0为例)
(一)CentOS 7安装步骤
-
配置MongoDB官方Yum仓库
创建MongoDB仓库文件:sudo vi /etc/yum.repos.d/mongodb-org-6.0.repo ``` 如下(根据实际需求选择版本): ```ini [mongodb-org-6.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/7/mongodb-org/6.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-6.0.asc
-
安装MongoDB组件
(图片来源网络,侵删)sudo yum install -y mongodb-org
-
配置防火墙
开放MongoDB默认端口27017:sudo firewall-cmd --permanent --add-port=27017/tcp sudo firewall-cmd --reload
(二)Ubuntu 20.04安装步骤
-
导入MongoDB公钥
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -
-
配置APT仓库
创建仓库文件:echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
-
安装MongoDB
(图片来源网络,侵删)sudo apt-get update sudo apt-get install -y mongodb-org
(三)通用配置(Linux)
-
启动MongoDB服务
sudo systemctl start mongod sudo systemctl enable mongod # 设置开机自启
-
验证安装
mongosh --eval "db.runCommand({ connectionStatus: 1 })"若返回
status: 1,表示安装成功。 -
配置文件调整
编辑MongoDB配置文件/etc/mongod.conf,修改关键参数:storage: dbPath: /var/lib/mongo # 数据存储路径 net: port: 27017 # 监听端口 bindIp: 0.0.0.0 # 允许所有IP访问(生产环境建议限制为特定IP) security: authorization: enabled # 启用认证(生产环境必须开启)
修改后重启服务:
sudo systemctl restart mongod
Windows环境下安装
-
下载安装包
访问MongoDB官网(https://www.mongodb.com/try/download/community)下载Windows版的MSI安装包(如“mongodb-windows-x86_64-6.0.0.msi”)。 -
安装步骤
- 双击运行安装包,勾选“Install MongoDB as a Service”(作为服务安装),并选择“Run as a Service”。
- 选择“Complete”完整安装模式,默认安装路径为
C:\Program Files\MongoDB\Server\6.0。
-
环境变量配置
将MongoDB的bin目录(如C:\Program Files\MongoDB\Server\6.0\bin)添加到系统环境变量Path中。 -
启动与验证
- 通过服务管理器(services.msc)启动“MongoDB”服务。
- 打开命令提示符,运行
mongosh,若成功进入Shell则安装完成。
macOS环境下安装
-
使用Homebrew安装
brew tap mongodb/brew brew install mongodb-community
-
启动服务
brew services start mongodb-community
-
验证安装
mongosh
常见问题解答(FAQs)
Q1: MongoDB安装后无法连接,提示“connection refused”怎么办?
A: 可能原因及解决方案:
- 服务未启动:检查服务状态(Linux:
sudo systemctl status mongod;Windows:services.msc),确保MongoDB服务正在运行。 - 端口未开放:Linux环境下需开放27017端口(如CentOS的
firewall-cmd);Windows检查防火墙是否阻止该端口。 - bindIp配置错误:检查
/etc/mongod.conf中的bindIp参数,默认为0.0.1,若需远程访问需修改为0.0.0或指定IP。 - 认证未关闭:若开启了
authorization: enabled但未创建用户,需先通过mongosh创建管理员用户(如use admin; db.createUser({ user: "admin", pwd: "password", roles: ["root"] }))。
Q2: 如何修改MongoDB的数据存储路径?
A: 修改数据存储路径需分步骤操作(以Linux为例):
- 停止MongoDB服务:
sudo systemctl stop mongod。 - 创建新目录并授权:
sudo mkdir -p /data/mongo sudo chown -R mongod:mongod /data/mongo
- 修改配置文件:编辑
/etc/mongod.conf,将storage.dbPath修改为新路径(如/data/mongo)。 - 移动旧数据(可选):若需保留旧数据,可执行
sudo rsync -av /var/lib/mongo/ /data/mongo/。 - 启动服务:
sudo systemctl start mongod,验证dbPath是否生效(可通过mongosh --eval "db.serverStatus().storage"查看)。
通过以上步骤,可完成MongoDB服务器的安装与基础配置,实际生产环境中,还需结合安全认证、性能优化(如调整内存、索引策略)等需求进行进一步配置。
