在阿里云ECS安装MongoDB,服务启动只是第一步。系统版本和软件源是否匹配、谁能访问数据库、账号权限怎么分配,以及数据能否恢复,都会影响后续使用。下面以Ubuntu 22.04/24.04为例,介绍通过MongoDB官方软件源安装MongoDB 8.0,并配置应用通过内网连接。
安装前检查阿里云ECS环境
先通过SSH登录服务器,确认Ubuntu版本和处理器架构:
lsb_release -a
uname -m
本文命令适用于Ubuntu 22.04或24.04的x86_64服务器。部署前也要留意磁盘空间:MongoDB数据会持续增长,不能只按安装时的占用量规划。测试环境可以从较低规格开始;生产环境则应结合并发量、数据规模和备份安排,评估CPU、内存与磁盘性能。
检查阿里云安全组时,不要预先向公网开放27017端口。若应用也部署在阿里云上,优先通过同一VPC内的私网地址访问数据库。
添加MongoDB官方软件源
Ubuntu自带的软件源未必提供所需版本。这里使用MongoDB官方仓库安装8.0版本。先安装所需工具,并创建用于保存签名密钥的目录:
sudo apt-get update
sudo apt-get install -y gnupg curl
sudo mkdir -p /usr/share/keyrings
导入MongoDB官方签名密钥:
curl -fsSL https://pgp.mongodb.com/server-8.0.asc | sudo gpg –dearmor -o /usr/share/keyrings/mongodb-server-8.0.gpg
查看Ubuntu发行版代号。22.04通常为jammy,24.04通常为noble,实际操作以服务器输出为准:
. /etc/os-release && echo “$VERSION_CODENAME”
确认代号后添加软件源。以下示例使用jammy;如果服务器显示noble,应将命令中的jammy替换为noble:
echo “deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse” | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
更新软件包索引并安装MongoDB:
sudo apt-get update
sudo apt-get install -y mongodb-org
如果更新索引时提示找不到对应发行版,先核对Ubuntu代号、处理器架构和仓库地址。不要为了消除报错,直接换成其他Ubuntu版本的软件源;发行版不匹配可能带来依赖或升级问题。
启动MongoDB并检查服务
安装完成后,设置mongod开机启动并立即运行:
sudo systemctl enable –now mongod
查看服务状态:
sudo systemctl status mongod
状态显示active (running)后,可在本机打开MongoDB命令行:
mongosh
执行db.runCommand({ ping: 1 }),如果返回ok: 1,说明本机可以连接MongoDB。输入exit退出。若服务没有启动,查看systemd日志通常能找到配置错误、磁盘空间不足等线索:
sudo journalctl -u mongod -n 100 –no-pager
创建管理员账号并启用认证
新装的MongoDB不应长期保持无认证状态。先在本机使用mongosh连接,再切换到admin数据库创建管理员账号:
use admin
db.createUser({ user: “siteAdmin”, pwd: passwordPrompt(), roles: [{ role: “userAdminAnyDatabase”, db: “admin” }, { role: “readWriteAnyDatabase”, db: “admin” }, { role: “dbAdminAnyDatabase”, db: “admin” }] })
passwordPrompt()会提示输入密码,避免把密码直接写进命令记录。这个账号拥有较广的管理权限,应使用强密码并妥善保管。应用程序不要使用siteAdmin连接,建议另建业务账号,只授予应用所需数据库的权限。
编辑配置文件:
sudo nano /etc/mongod.conf
在配置中检查或补充以下内容:
security:
authorization: enabled
保存后重启服务:
sudo systemctl restart mongod
再通过账号验证连接:
mongosh -u siteAdmin –authenticationDatabase admin
顺序不要颠倒:先在本机创建管理员账号,再启用authorization。若认证已经开启而账号尚未建立,首次创建账号可能无法按预期完成。修改配置后也要检查服务状态,确认mongod正常运行。
按需开放内网连接
MongoDB默认通常只监听本机地址。如果应用和数据库在同一台ECS上,保留127.0.0.1即可,不需要开放27017端口。若应用部署在另一台ECS上,则可通过私网连接,并在mongod.conf中将bindIp设置为本机地址和数据库ECS的私网IP,例如:
bindIp: 127.0.0.1,10.0.1.20
10.0.1.20只是示例,需替换为数据库ECS的实际私网IP。修改后重启mongod。随后在阿里云安全组中,只允许应用服务器的私网IP访问TCP 27017;不要配置成0.0.0.0/0。若系统防火墙已启用,也要设置相同范围的放行规则。
客户端连接时需要提供账号、地址和认证数据库,例如:
mongosh “mongodb://appUser:密码@10.0.1.20:27017/shop?authSource=admin”
连接字符串中的密码不要提交到代码仓库。可以通过环境变量或密钥管理服务提供凭据,并为应用单独创建最小权限账号。这样即使应用账号泄露,也能减少对其他数据库和管理操作的影响。
案例:小型商城连接MongoDB
假设商城应用运行在ECS A,MongoDB部署在同一VPC的ECS B。运维人员在ECS B安装MongoDB并启用认证,再把ECS B的私网IP加入bindIp;安全组则只允许ECS A的私网IP访问27017。商城连接shop数据库时使用专属业务账号,不使用siteAdmin。
这种配置不会把数据库端口直接暴露到公网。正式上线前,建议实际重启应用,确认它能重新连接数据库;再检查密码轮换是否生效,并做一次备份恢复演练。备份文件存在并不代表备份可用,能否还原要通过恢复操作确认。
常见连接问题与维护
- 服务无法启动:检查mongod.conf的缩进、磁盘空间和日志,可先运行sudo journalctl -u mongod -n 100 –no-pager定位问题。
- 远程连接超时:依次核对bindIp、阿里云安全组、系统防火墙、私网路由和客户端使用的地址。
- 认证失败:检查用户名、密码及authSource。账号创建在admin库时,连接通常需要指定authSource=admin。
- 确实需要跨网络访问:优先考虑VPN、专线或SSH隧道,并限制来源地址;不要仅靠开放公网端口解决连通问题。
完成阿里云ECS安装MongoDB后,还要安排补丁升级,关注磁盘使用率和服务状态,并定期验证备份能否恢复。把网络范围、账号权限和恢复流程一并检查,后续应用上线和故障排查会更稳妥。