Ubuntu 安装 MongoDB 完整教程

一、系统环境说明

适配 Ubuntu 20.04 (Focal) / 22.04 (Jammy) / 24.04 (Noble)

1. 更新系统依赖

sudo apt update && sudo apt upgrade -y

2. 安装前置依赖

sudo apt install gnupg curl -y

3. 导入 MongoDB 官方 GPG 密钥

curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg --dearmor

4. 添加 MongoDB 软件源

Ubuntu 22.04 / 24.04

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

Ubuntu 20.04

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

5. 刷新软件源并安装

sudo apt update
# 安装完整服务端
sudo apt install mongodb-org -y

6. 启停 / 开机自启命令

# 启动
sudo systemctl start mongod
# 开机自启
sudo systemctl enable mongod
# 查看运行状态
sudo systemctl status mongod
# 重启
sudo systemctl restart mongod
# 停止
sudo systemctl stop mongod

7. 进入 Mongo 命令行

mongosh

基础安全配置（必做，否则外网可随意连接）

步骤 1：创建管理员账号

进入 mongosh 执行：

use admin
db.createUser({user: "root",pwd: "自定义强密码",roles: ["root"]
})
exit

步骤 2：修改配置文件开启身份验证

sudo nano /etc/mongod.conf

找到 #security: 注释，修改为：

yaml

security:authorization: enabled

保存退出：Ctrl+O → 回车 → Ctrl+X

重启服务生效：

sudo systemctl restart mongod

步骤 3：带密码登录

mongosh -u root -p --authenticationDatabase admin

允许外网访问（服务器开发常用）

修改配置文件

sudo nano /etc/mongod.conf

将 bindIp: 127.0.0.1 改为

yaml

bindIp: 0.0.0.0

重启服务

sudo systemctl restart mongod

放行防火墙 27017 端口

# ufw防火墙
sudo ufw allow 27017/tcp
# 云服务器额外需要在后台安全组放行27017端口

常用卸载命令（需要重装时）

sudo systemctl stop mongod
sudo apt remove mongodb-org* -y
sudo apt autoremove -y
# 删除数据（谨慎！会清空所有数据库）
sudo rm -rf /var/lib/mongodb
sudo rm -rf /etc/mongod.conf

常见问题

mongod 启动失败
- 检查磁盘权限：sudo chown -R mongodb:mongodb /var/lib/mongodb
- 查看日志：tail -f /var/log/mongodb/mongod.log
连接超时
- 确认 bindIp 0.0.0.0
- 防火墙 / 云服务器安全组放行 27017
登录提示认证失败
- 登录命令必须携带 --authenticationDatabase admin