马来西亚服务器如何部署MongoDB?从安装配置到服务状态验证

发布人:A5数据发布时间:2026-11-02 14:14阅读量:99

在马来西亚服务器上首次部署 MongoDB,建议先明确服务器系统、软件版本和应用连接方式。下面以 Ubuntu 22.04 LTS、amd64 架构、MongoDB 7.0 为示例,完成安装、服务启动、身份认证、监听地址配置及状态验证。马来西亚机房不会改变 MongoDB 的安装命令,但需要留意服务器到软件仓库的 HTTPS 连通性、系统时区以及云平台安全组规则。

首次安装时,MongoDB 默认只监听本机 127.0.0.1:27017,适合数据库和应用部署在同一台服务器的场景。如果应用位于另一台服务器,应优先使用内网地址,并且只允许应用服务器访问 27017 端口,不要直接将 MongoDB 端口开放给整个公网。

针对MongoDB数据库及其配套应用的部署需求,A5idc数据提供马来西亚吉隆坡物理服务器资源,覆盖不同CPU、内存、存储与网络配置,可承载网站后台、业务接口和数据库服务。结合本地及跨境访问场景,相关服务器可用于MongoDB单机部署,也能为应用与数据库分离架构提供独立的计算、存储和网络基础。

一、准备服务器与部署条件

1. 确认系统、架构和权限

先确认系统版本、CPU 架构、当前用户权限及磁盘空间:

cat /etc/os-release
dpkg --print-architecture
uname -m
id
df -h /
free -h

本文命令对应的典型结果应接近以下内容:

PRETTY_NAME="Ubuntu 22.04.4 LTS"
amd64
x86_64
uid=0(root) ...

如果系统不是 Ubuntu 22.04,或者架构不是 amd64,不要直接套用本文仓库地址。应根据实际发行版和架构选择对应的 MongoDB 软件仓库,否则可能出现没有安装候选版本、依赖不匹配或服务无法启动的问题。

建议首次部署至少确认以下条件:

检查项建议条件验证方式
系统Ubuntu 22.04 LTScat /etc/os-release
架构amd64 或已确认受支持的架构dpkg --print-architecture
权限root 或具备 sudo 权限id、sudo -v
磁盘数据目录所在分区有充足可用空间df -h
内存能满足应用、操作系统和 MongoDB 的共同使用free -h
出站网络可通过 HTTPS 访问软件仓库curl、apt-get update
入站网络默认不开放 27017 公网访问云防火墙和 UFW 规则

磁盘空间不要只按 MongoDB 当前数据量估算,还应预留索引、日志、临时文件、数据增长和备份所需的空间。测试环境可以从几十 GB 的空闲空间起步,生产环境则应根据数据增长量单独规划。

2. 确认时间和网络状态

MongoDB 内部时间、应用时间和日志时间可能由不同组件处理。建议先查看系统时区和时间同步状态:

timedatectl status
timedatectl show -p Timezone -p NTPSynchronized

马来西亚常用时区为 Asia/Kuala_Lumpur。如果运维团队确实需要在系统日志中使用当地时间,可以调整系统时区:

sudo timedatectl set-timezone Asia/Kuala_Lumpur

这只改变操作系统显示时间,不代表 MongoDB 中已有的业务时间字段会自动转换。应用层仍建议统一使用 UTC 存储时间,并在展示时转换为业务所需时区。

确认 DNS 和 HTTPS 出站连接:

getent hosts repo.mongodb.org
curl -I --max-time 10 https://repo.mongodb.org/

如果 getent 无法解析域名,先检查 DNS;如果 HTTPS 访问失败,检查服务器出站防火墙、云平台安全策略或机房网络,不要先修改 MongoDB 配置。

二、添加仓库并安装 MongoDB

1. 安装仓库管理工具

先刷新 Ubuntu 软件索引并安装导入仓库密钥所需的软件:

sudo apt-get update
sudo apt-get install -y gnupg curl

验证工具是否可用:

gpg --version | sed -n '1,2p'
curl --version | sed -n '1,2p'

如果 apt-get update 已经报错,应先处理 Ubuntu 软件源或网络问题。不要在软件索引失败时继续安装 MongoDB,因为此时无法确认依赖包来源。

2. 添加 MongoDB 7.0 软件源

导入 MongoDB 7.0 仓库密钥,并将密钥保存到独立的 keyring 文件:

curl -fsSL https://pgp.mongodb.com/server-7.0.asc \
  | sudo gpg --dearmor --yes \
  -o /usr/share/keyrings/mongodb-server-7.0.gpg

写入 Ubuntu 22.04 对应的仓库配置:

echo "deb [ 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

重新刷新软件索引,并检查 MongoDB 是否有可安装版本:

sudo apt-get update
apt-cache policy mongodb-org

预期能够看到以 7.0 开头的候选版本,例如:

mongodb-org:
  Candidate: 7.0.x

这里的 x 代表仓库当前提供的补丁版本,不应将示例版本号当作固定的当前版本。如果没有 Candidate,重点检查以下项目:

  • 仓库文件中的 jammy 是否与系统版本一致;
  • 仓库地址是否被 DNS、出站防火墙或代理拦截;
  • keyring 文件是否存在且权限可读;
  • 是否误用了其他发行版或其他 MongoDB 大版本的仓库。

3. 安装 MongoDB 软件包

确认候选版本正常后执行安装:

sudo apt-get install -y mongodb-org

安装完成后查看二进制版本:

mongod --version | sed -n '1,4p'
mongosh --version

预期输出中应包含 7.0 版本信息。此时先不要修改数据目录权限,也不要手动创建 MongoDB 系统用户。通过官方软件包安装时,服务用户、默认目录和日志目录通常会一并创建。

常见目录如下:

用途默认路径
配置文件/etc/mongod.conf
数据目录/var/lib/mongodb
日志文件/var/log/mongodb/mongod.log
systemd 服务mongod.service
默认端口27017

三、启动服务并完成本机验证

1. 备份初始配置

首次安装后,先保存一份配置文件。后续修改监听地址或启用认证时,可以使用该文件恢复到已知状态。

sudo cp -a /etc/mongod.conf \
  "/etc/mongod.conf.before-deployment-$(date +%F-%H%M%S)"

确认备份文件已经生成:

ls -l /etc/mongod.conf*

配置文件备份只用于恢复服务配置,不等同于 MongoDB 数据备份。数据库数据仍位于 /var/lib/mongodb,不要把配置文件备份当成数据回滚点。

2. 启用并启动 mongod

使用 systemd 设置开机启动并立即启动服务:

sudo systemctl enable --now mongod

分别检查服务是否正在运行,以及是否已经设置开机启动:

systemctl is-active mongod
systemctl is-enabled mongod

正常结果应为:

active
enabled

进一步查看服务状态:

sudo systemctl status mongod --no-pager

如果服务正常,通常可以看到类似以下状态:

Active: active (running)

这里的输出属于结果示例,不代表某台实际服务器已经执行过该命令。

3. 验证 MongoDB 本机连接

MongoDB 默认监听本机地址时,可以使用 mongosh 执行 ping:

mongosh --host 127.0.0.1 --port 27017 \
  --quiet \
  --eval 'db.runCommand({ ping: 1 })'

预期结果:

{ ok: 1 }

再查看服务版本和连接地址:

mongosh --host 127.0.0.1 --port 27017 \
  --quiet \
  --eval 'db.runCommand({ buildInfo: 1 }).version'

查看 27017 是否监听:

sudo ss -lntp | grep ':27017'

首次使用默认配置时,预期接近:

LISTEN ... 127.0.0.1:27017 ... users:(("mongod",pid=...,fd=...))

如果能看到 active (running),但 ping 失败,应继续检查日志:

sudo journalctl -u mongod -n 50 --no-pager
sudo tail -n 50 /var/log/mongodb/mongod.log

四、配置认证和应用连接权限

1. 首次创建管理用户

初始安装阶段通常还没有开启访问认证。应先在本机创建管理用户,再开启 authorization。这样可以避免先启用认证、后续却没有可用账号的问题。

启动本机 Shell:

mongosh --host 127.0.0.1 --port 27017

在 mongosh 中执行:

use admin

db.createUser({
  user: "mongoAdmin",
  pwd: passwordPrompt(),
  roles: [
    { role: "userAdminAnyDatabase", db: "admin" }
  ]
})

passwordPrompt() 会交互式提示输入密码,密码不会直接出现在命令历史中。密码应使用独立的高强度凭据,并保存到密码管理工具中,不要写入网页目录、代码仓库或普通文本脚本。

创建成功时,通常会返回:

{ ok: 1 }

如果提示用户已经存在,不要反复执行创建命令。可以先查看用户:

use admin
db.getUsers()

userAdminAnyDatabase 主要用于管理数据库用户,不等同于拥有所有数据库操作权限。应用程序不应直接使用这个账号连接业务数据库。

2. 开启 MongoDB 认证

编辑配置文件前再次备份:

sudo cp -a /etc/mongod.conf \
  "/etc/mongod.conf.before-auth-$(date +%F-%H%M%S)"

打开配置文件:

sudoedit /etc/mongod.conf

在文件中加入以下配置。如果文件中已经存在 security:,只补充或修改对应项,不要重复写入多个同名 YAML 节点:

security:
  authorization: enabled

保存后重启服务:

sudo systemctl restart mongod

检查服务状态和日志:

systemctl is-active mongod
sudo journalctl -u mongod -n 30 --no-pager

开启认证后,不带用户名的连接不应再作为业务连接方式使用。使用刚才创建的管理用户验证:

mongosh --host 127.0.0.1 \
  --port 27017 \
  --username mongoAdmin \
  --authenticationDatabase admin

Shell 提示输入密码后,执行:

db.runCommand({ ping: 1 })

预期仍然返回:

{ ok: 1 }

如果认证后 ping 成功,说明服务、端口和管理用户均已正常工作。

3. 为应用创建独立账号

应用不应使用 mongoAdmin。在已经认证的 mongosh 中,为业务数据库创建独立用户:

四、配置认证和应用连接权限配图

use appdb

db.createUser({
  user: "appuser",
  pwd: passwordPrompt(),
  roles: [
    { role: "readWrite", db: "appdb" }
  ]
})

这个用户的认证数据库是 appdb,应用连接字符串中的 authSource 也应对应设置:

mongodb://appuser:<密码>@127.0.0.1:27017/appdb?authSource=appdb

如果密码包含 @、:、/、?、# 等 URI 特殊字符,需要先进行 URL 编码。应用配置中不要直接把密码提交到代码仓库,也不要在命令行历史中明文传递密码。

在同机部署场景下,应用使用 127.0.0.1 连接即可。此时 MongoDB 不需要对公网提供监听。

五、需要跨服务器连接时的监听配置

如果应用和 MongoDB 位于同一台马来西亚服务器,不需要调整 bindIp。只有应用部署在另一台服务器时,才需要增加数据库服务器的内网地址。

1. 确认数据库服务器内网地址

ip -br addr

假设数据库服务器的内网地址为 10.20.0.10,应用服务器的内网地址为 10.20.0.21。实际操作时必须替换为服务器真实地址,不要照搬示例地址。

编辑配置文件:

sudoedit /etc/mongod.conf

将 net 部分调整为类似内容:

五、需要跨服务器连接时的监听配置配图

net:
  port: 27017
  bindIp: 127.0.0.1,10.20.0.10

这里保留 127.0.0.1,可以继续支持数据库服务器本机管理;增加内网 IP 后,应用服务器才能通过内网访问。不要为了省事设置为:

bindIp: 0.0.0.0

这会让 MongoDB 监听所有网卡,若云防火墙或系统防火墙规则不严,可能造成公网暴露。

重启并检查监听结果:

sudo systemctl restart mongod
systemctl is-active mongod
sudo ss -lntp | grep ':27017'

预期可以同时看到以下类型的监听地址:

127.0.0.1:27017
10.20.0.10:27017

2. 限制系统防火墙来源

先查看 UFW 是否启用:

sudo ufw status verbose

只有在 UFW 已经启用,且确认不会影响 SSH 管理连接时,才添加针对应用服务器的规则:

sudo ufw allow from 10.20.0.21 to any port 27017 proto tcp

该规则只允许 10.20.0.21 访问本机 27017 端口。云平台安全组或外部防火墙也需要使用同样的最小来源范围。不要使用以下宽泛规则:

sudo ufw allow 27017/tcp

如果 UFW 当前处于 inactive,不要为了 MongoDB 直接执行 ufw enable,因为错误的默认规则可能导致 SSH 连接中断。应先确认 SSH 放行规则、云安全组和维护窗口。

从应用服务器发起实际认证连接:

mongosh --host 10.20.0.10 \
  --port 27017 \
  --username appuser \
  --authenticationDatabase appdb

认证成功后执行:

db.runCommand({ ping: 1 })

如果应用服务器无法连接,先根据错误类型判断:

六、常见失败处理配图

  • connection refused:通常表示 MongoDB 没有监听该地址、服务未启动或端口被拒绝;
  • connection timed out:通常表示云安全组、UFW、路由或网络 ACL 丢弃了连接;
  • 能建立连接但认证失败:重点检查用户名、密码和 authSource;
  • 本机可连接、远程不可连接:优先检查 bindIp 和防火墙,而不是修改数据库用户。

六、常见失败处理

1. 软件仓库没有候选版本

检查仓库配置和系统版本:

cat /etc/apt/sources.list.d/mongodb-org-7.0.list
cat /etc/os-release
apt-cache policy mongodb-org

如果系统是 Ubuntu 24.04,却仍使用 jammy 仓库,不能简单忽略提示。应更换为与系统及 MongoDB 版本匹配的安装方案。仓库版本、操作系统版本和 CPU 架构必须保持对应关系。

2. mongod 启动失败

先查看 systemd 和 MongoDB 自身日志:

sudo systemctl status mongod --no-pager
sudo journalctl -u mongod -b --no-pager
sudo tail -n 80 /var/log/mongodb/mongod.log

重点检查:

  • YAML 缩进错误;
  • bindIp 中填写了本机不存在的 IP;
  • 27017 已被其他程序占用;
  • 数据目录或日志目录不可写;
  • 修改时重复写入了 net:、security: 等配置节点。

检查端口占用:

sudo ss -lntp | grep ':27017'

如果端口被其他程序使用,不要直接执行 kill -9。先确认占用进程的用途,再决定是调整 MongoDB 端口、停止冲突服务,还是恢复原配置。

3. 开启认证后无法登录

确认连接参数中的认证数据库:

  • mongoAdmin 创建在 admin 数据库,使用 --authenticationDatabase admin;
  • appuser 创建在 appdb 数据库,连接字符串使用 authSource=appdb。

本机管理账号的验证命令如下:

mongosh --host 127.0.0.1 \
  --port 27017 \
  --username mongoAdmin \
  --authenticationDatabase admin

不要为了绕过密码错误而直接关闭认证并开放网络。如果确实遗失管理凭据,应先隔离数据库网络,仅保留本机维护入口,再按照已批准的账号恢复流程处理。

4. 修改 bindIp 后服务无法启动

恢复配置前,先停止服务并保留当前错误配置,方便后续分析:

sudo systemctl stop mongod
sudo cp -a /etc/mongod.conf \
  "/etc/mongod.conf.failed-$(date +%F-%H%M%S)"

然后选择最近一次确认可用的配置备份恢复。恢复后应保持 bindIp: 127.0.0.1,确认本机服务恢复,再重新规划内网地址和防火墙规则。

七、部署结果验收

首次部署完成后,建议按以下顺序验收:

七、部署结果验收配图

  1. 确认软件版本:
   mongod --version | sed -n '1,4p'

结果应为预期的 MongoDB 7.0 系列。

  1. 确认服务运行和开机启动:
   systemctl is-active mongod
   systemctl is-enabled mongod

两项分别应返回 active 和 enabled。

  1. 确认本机端口监听:
   sudo ss -lntp | grep ':27017'

同机应用只应看到 127.0.0.1:27017;跨服务器场景还应看到指定内网 IP。

  1. 确认认证连接:
   mongosh --host 127.0.0.1 \
     --port 27017 \
     --username mongoAdmin \
     --authenticationDatabase admin

登录后执行:

   db.runCommand({ ping: 1 })

应返回 { ok: 1 }。

  1. 确认应用账号权限。在新建的测试数据库中执行一组最小读写验证:
   use appdb

   db.deployment_check.insertOne({
     check: "mongodb-deployment",
     createdAt: new Date()
   })

   db.deployment_check.findOne({
     check: "mongodb-deployment"
   })

该测试只适用于新建或明确允许写入的数据库。已有业务库不要直接执行插入或删除测试,避免影响真实数据。

  1. 确认日志没有持续报错:
   sudo journalctl -u mongod -n 50 --no-pager
   sudo tail -n 50 /var/log/mongodb/mongod.log
  1. 确认网络边界:
  • 27017 没有对整个公网开放;
  • 跨服务器访问时只允许应用服务器 IP;
  • 云安全组和系统防火墙规则保持一致;
  • 应用使用独立的 readWrite 账号,而不是管理账号。

八、回滚检查项

配置修改导致服务异常时,可以回滚到最近一次已验证的配置:

sudo systemctl stop mongod
sudo cp -a /etc/mongod.conf.before-auth-YYYY-MM-DD-HHMMSS /etc/mongod.conf
sudo systemctl start mongod
systemctl is-active mongod

命令中的备份文件名需要替换为实际存在的文件,可先查看:

ls -1t /etc/mongod.conf*

回滚时需要注意以下边界:

  • 只恢复配置文件,不要删除 /var/lib/mongodb;
  • 不要把删除数据目录当作普通回滚手段;
  • 如果恢复的旧配置关闭了认证,必须同时确认 bindIp 仍为 127.0.0.1,不得让未认证服务暴露在内网或公网;
  • 如果已经产生业务数据,配置回滚不会撤销数据写入、用户创建或索引变化;
  • 数据层面的回滚应使用经过验证的快照或 mongodump 备份,并先确认备份可恢复;
  • 执行卸载或清理软件包前,应单独备份数据目录、配置文件和日志,不能依赖 apt remove 或 apt purge 自动保留数据。

完成以上验收后,马来西亚服务器上的 MongoDB 首次部署应至少具备可运行、可认证、可验证和可回退四个条件。实际接入应用前,再根据应用所在位置决定继续保持本机监听,还是增加受限的内网监听地址。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7206.html

相关推荐