在腾讯云轻量应用服务器上部署 MongoDB 是一个常见的需求,适用于小型应用、测试环境或个人项目。以下是详细的部署步骤,帮助你在腾讯云轻量服务器(Ubuntu/CentOS 系统)上成功安装和配置 MongoDB。
✅ 一、准备工作
-
购买并登录轻量服务器
- 登录腾讯云控制台:https://console.cloud.tencent.com/lighthouse
- 购买轻量应用服务器(推荐选择 Ubuntu 20.04/22.04 或 CentOS 7/8)
- 获取公网 IP、用户名(如
ubuntu或root)、密码或密钥
-
连接服务器
使用 SSH 工具(如 Terminal、PuTTY、Xshell)连接:ssh ubuntu@<你的公网IP>
✅ 二、安装 MongoDB
方法一:使用 MongoDB 官方仓库(推荐)
以 Ubuntu 20.04/22.04 为例:
-
导入 MongoDB GPG 密钥
wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -注意:MongoDB 从 6.0 开始使用
.asc密钥,不再支持apt-key(新版本 Ubuntu 可能提示弃用),可改用以下方式:sudo mkdir -p /etc/apt/keyrings curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | sudo gpg --dearmor -o /etc/apt/keyrings/mongodb-server-7.0.gpg -
添加 MongoDB 仓库
echo "deb [ arch=amd64, signed-by=/etc/apt/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如果是 Ubuntu 22.04,将
focal改为jammy -
更新软件包并安装 MongoDB
sudo apt update sudo apt install -y mongodb-org
方法二:CentOS 7/8 安装
-
创建
/etc/yum.repos.d/mongodb-org.repo文件:sudo vi /etc/yum.repos.d/mongodb-org.repo内容如下(以 7.0 版本为例):
[mongodb-org-7.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/7.0/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-7.0.asc -
安装:
sudo yum install -y mongodb-org
✅ 三、启动 MongoDB 服务
# 启动服务
sudo systemctl start mongod
# 设置开机自启
sudo systemctl enable mongod
# 查看状态
sudo systemctl status mongod
如果提示
mongod.service not found,尝试:sudo systemctl start mongodb
✅ 四、配置 MongoDB 远程访问(重要!)
默认 MongoDB 只监听 127.0.0.1,需修改配置文件以支持X_X连接。
-
编辑配置文件
Ubuntu:
/etc/mongod.conf
CentOS: 同上sudo vi /etc/mongod.conf -
修改
network interfaces部分:net: port: 27017 bindIp: 0.0.0.0 # 原来是 127.0.0.1,改为 0.0.0.0 允许远程连接 -
重启服务
sudo systemctl restart mongod
✅ 五、配置腾讯云安全组(关键!)
- 登录腾讯云控制台 → 轻量应用服务器 → 找到你的实例
- 进入「防火墙」或「安全组」设置
- 添加规则:
- 协议:TCP
- 端口:27017
- 源 IP:建议填写你的 IP(如
1.2.3.4/32),或临时0.0.0.0/0(不推荐长期开放)
⚠️ 注意:开放 27017 端口有安全风险,建议配合用户名密码认证使用。
✅ 六、启用身份认证(强烈建议)
-
先创建管理员用户
进入 MongoDB shell:
mongosh创建用户:
use admin db.createUser({ user: "admin", pwd: "yourStrongPassword123", // 修改为强密码 roles: [ { role: "userAdminAnyDatabase", db: "admin" }, "readWriteAnyDatabase" ] }) -
启用认证
编辑
/etc/mongod.conf:security: authorization: enabled -
重启服务
sudo systemctl restart mongod -
远程连接测试
mongosh "mongodb://admin:yourPassword@<公网IP>:27017/admin"
✅ 七、可选:使用 GUI 工具连接
推荐工具:
- MongoDB Compass
- Robo 3T(已停更,可用 Studio 3T)
- VS Code + MongoDB 插件
连接字符串示例:
mongodb://admin:yourPassword@<公网IP>:27017/admin
✅ 八、常见问题排查
| 问题 | 解决方法 |
|---|---|
Failed to start mongod.service |
检查日志:sudo journalctl -u mongod,常见原因是磁盘空间不足或配置文件错误 |
| 无法远程连接 | 检查防火墙、安全组、bindIp 是否为 0.0.0.0 |
| 认证失败 | 确保 authorization: enabled,并使用正确的用户名密码和数据库(admin) |
✅ 九、安全建议
- 不要长期开放 27017 给 0.0.0.0/0
- 使用强密码,避免弱口令
- 定期备份数据(可用
mongodump) - 考虑使用腾讯云 MongoDB 服务(托管版)用于生产环境
总结
你已成功在腾讯云轻量服务器上部署 MongoDB,并支持远程访问。适合开发、测试或小项目使用。如需高可用、自动备份、监控等功能,建议升级为 腾讯云 MongoDB 云数据库。
如需一键脚本或 Docker 部署方式,也可以告诉我,我可以提供。
需要我提供 自动化部署脚本 或 Docker 部署方案 吗?
秒懂云