台湾服务器如何部署MongoDB数据库并验证服务正常运行?
在台湾服务器上首次部署 MongoDB,建议先将范围限定为 Ubuntu 22.04 LTS、amd64 架构、MongoDB 8.0 单机实例。实施顺序为:确认系统与磁盘条件,安装匹配的软件包,启动本机服务,创建管理员和业务账号,开启认证,最后通过服务状态、端口监听、数据库命令和日志四个层面验证运行是否正常。

本文采用单机部署方式,适合开发环境、测试环境或业务量较小的应用。默认只监听 127.0.0.1,应用与数据库部署在同一台台湾服务器上时不需要开放公网数据库端口。如果应用位于其他服务器,应优先使用内网地址,并同时限制云防火墙、系统防火墙和 MongoDB 的监听地址,避免将 27017 直接暴露给所有公网地址。
A5idc数据提供中国台湾台北物理服务器资源,覆盖不同CPU、内存、磁盘及优化线路配置,可为MongoDB数据库、业务后台和接口服务提供独立运行环境。针对本地应用部署、跨地区访问及数据规模增长等场景,也可结合香港、日本、韩国、新加坡等地区的服务器资源,构建与业务访问范围相匹配的数据库和应用部署基础。
一、准备条件与部署边界
适用环境
本文示例使用以下环境:
| 项目 | 示例值 | 说明 |
|---|---|---|
| 服务器地区 | 台湾 | 地区不改变 MongoDB 的安装方式,主要影响网络路径和访问延迟 |
| 操作系统 | Ubuntu 22.04 LTS | 以下软件源命令按 jammy 编写 |
| CPU架构 | amd64 | 其他架构不能直接照搬 amd64 软件源 |
| MongoDB | 8.0 | 使用 mongodb-org 软件包 |
| 部署模式 | 单机单实例 | 不包含副本集、分片和跨地域容灾 |
| 默认端口 | TCP 27017 | 仅在确有远程访问需求时开放 |
测试或轻量业务可以从 2 vCPU、4 GB 内存起步,但这不是固定生产规格。MongoDB 的内存使用、索引数量、数据增长速度和并发连接数都会影响资源需求。正式部署前,应至少确认数据盘容量能够覆盖现有数据、索引、日志和备份空间。
检查系统、架构和磁盘
先使用具备 sudo 权限的账号登录台湾服务器,确认系统版本、架构、内存和磁盘:
cat /etc/os-release
dpkg --print-architecture
free -h
df -h /
df -h /var/lib
Ubuntu 22.04 通常应看到:
VERSION_ID="22.04"
VERSION_CODENAME=jammy
amd64
如果系统是 Ubuntu 24.04、Debian 或 ARM 架构,不要直接执行后续的 jammy、amd64 软件源命令。应先确认对应 MongoDB 版本是否提供匹配的软件包,或者改用与系统版本相符的安装方式。
检查当前是否已经有服务占用 MongoDB 默认端口:
sudo ss -lntp | grep ':27017'
没有任何输出表示当前没有进程监听该端口。如果已经有输出,应先确认进程归属,不要直接终止未知进程:
sudo ss -lntp | grep ':27017'
ps -fp <PID>
确认网络和防火墙边界
如果应用和 MongoDB 在同一台服务器,MongoDB 只需要监听 127.0.0.1,不必为 27017 增加入站规则。
如果应用位于其他服务器,应提前确认以下信息:
- 应用服务器的固定内网地址或固定公网地址;
- 台湾服务器是否有云平台安全组或边缘防火墙;
- 系统是否启用了 UFW;
- MongoDB 是否需要监听服务器的内网地址。
查看 UFW 状态:
sudo ufw status verbose
只有在确实需要远程访问、且已经确认来源地址的情况下,才添加精确规则。下面的地址仅为示例,实际操作时替换为应用服务器的固定地址:
sudo ufw allow from 203.0.113.10 to any port 27017 proto tcp
sudo ufw status numbered
不要使用以下类型的开放方式:
27017/tcp 允许来自 0.0.0.0/0
如果 UFW 当前未启用,不要为了开放端口直接执行 ufw enable。启用防火墙前应先配置并验证 SSH 规则,否则可能导致远程管理连接中断。
二、安装 MongoDB 软件包
添加匹配的软件源
先安装导入密钥和配置软件源所需的工具:
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
导入 MongoDB 8.0 软件源密钥,并保存到系统密钥目录:
curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc \
| sudo gpg --dearmor --yes -o /usr/share/keyrings/mongodb-server-8.0.gpg
为 Ubuntu 22.04 写入软件源:
echo "deb [ arch=amd64 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
apt-cache policy mongodb-org
验证时应能看到 mongodb-org 的候选版本。如果出现 404 Not Found、does not have a Release file 或没有候选版本,通常是操作系统代号、架构或软件源路径不匹配。此时应先检查以下结果,不要混用其他系统的软件包:
. /etc/os-release
printf 'ID=%s\nVERSION_ID=%s\nVERSION_CODENAME=%s\n' "$ID" "$VERSION_ID" "$VERSION_CODENAME"
dpkg --print-architecture
安装并确认版本
确认软件源正常后安装 MongoDB:
sudo apt-get install -y mongodb-org
检查服务端和命令行客户端版本:
mongod --version
mongosh --version
示例输出中的服务端版本应为 8.0.x,其中小版本号可能随软件源更新而变化。版本检查通过后,说明安装包、服务端程序和 Shell 客户端均已进入系统。
三、首次启动并创建数据库账号
启动默认服务
MongoDB 软件包通常会创建名为 mongod 的 systemd 服务。执行启动并设置开机启动:
sudo systemctl enable --now mongod
立即检查服务状态:
systemctl is-enabled mongod
systemctl is-active mongod
sudo systemctl status mongod --no-pager -l
正常情况下,is-enabled 返回:
enabled
is-active 返回:
active
检查默认数据目录和日志目录的写入权限:
sudo -u mongodb test -w /var/lib/mongodb && echo "data directory writable"
sudo -u mongodb test -w /var/log/mongodb && echo "log directory writable"
如果两个目录均可写,说明服务账号具备基本运行权限。不要在没有确认路径的情况下对整个 /var 或根目录执行递归 chown。
确认初始监听地址
默认配置一般只允许本机访问。使用以下命令检查端口:
sudo ss -lntp | grep ':27017'
预期可以看到类似结果:
LISTEN 0 4096 127.0.0.1:27017 0.0.0.0:* users:(("mongod",pid=...,fd=...))
如果只显示 127.0.0.1:27017,说明 MongoDB 没有直接接受公网连接,这符合单机应用与数据库同机部署的安全边界。
创建管理员和业务账号
首次启动且尚未启用认证时,可以通过本机 Shell 创建账号:
mongosh --host 127.0.0.1 --port 27017
在 mongosh 交互界面中创建管理员账号。使用 passwordPrompt() 可以避免把明文密码直接写入命令历史:
use admin
db.createUser({
user: "dbadmin",
pwd: passwordPrompt(),
roles: [
{ role: "root", db: "admin" }
]
})
返回以下结果表示创建成功:
{ ok: 1 }
管理员账号用于初始化和维护,不建议直接写入业务程序。继续创建一个只访问业务库的账号:
use appdb
db.createUser({
user: "appuser",
pwd: passwordPrompt(),
roles: [
{ role: "readWrite", db: "appdb" }
]
})
此时退出 Shell:
exit
appuser 只拥有 appdb 数据库的读写权限,不能代替管理员执行所有数据库操作。生产环境中应将两个账号的密码分别保存到应用密钥配置或密码管理系统中,不要提交到代码仓库。
四、开启认证并配置监听范围
备份配置文件
启用认证前先备份当前配置文件。该操作只复制配置,不会停止服务:
sudo cp -a /etc/mongod.conf \
"/etc/mongod.conf.$(date +%F-%H%M%S).bak"
使用编辑器打开配置:
sudoedit /etc/mongod.conf
在配置文件顶层增加以下内容,注意 YAML 缩进:
security:
authorization: enabled
不要在文件中重复增加多个 security: 节点。如果原文件已经存在 security 配置,应在同一个节点下修改 authorization,避免配置结构冲突。
默认情况下保留:
net:
port: 27017
bindIp: 127.0.0.1
保存后重启服务:
sudo systemctl restart mongod
验证认证是否生效
重启后使用管理员账号执行 ping:
mongosh \
--host 127.0.0.1 \
--port 27017 \
-u dbadmin \
-p \
--authenticationDatabase admin \
--quiet \
--eval 'db.adminCommand({ ping: 1 })'
输入密码后,预期返回:
{ ok: 1 }
这一步同时验证了服务可连接、管理员账号存在、密码正确以及认证数据库填写正确。
再使用业务账号验证权限范围:
mongosh \
--host 127.0.0.1 \
--port 27017 \
-u appuser \
-p \
--authenticationDatabase appdb \
--quiet \
--eval 'db.runCommand({ ping: 1 })'
如果业务程序的连接字符串使用 appdb,认证源也应设置为 appdb。示例连接形式如下,密码不要直接写入公开配置:
mongodb://appuser:<密码>@127.0.0.1:27017/appdb?authSource=appdb
密码中如果包含 @、:、/、? 等特殊字符,放入 URI 前需要进行 URL 编码。使用 mongosh -p 交互输入密码,可以减少因特殊字符导致的连接问题。
有远程应用时调整监听地址
只有远程应用确实需要连接时,才修改 bindIp。先查看台湾服务器实际网卡地址:
ip -br addr
如果服务器有固定内网地址,例如 10.0.0.5,可以将配置调整为:

net:
port: 27017
bindIp: 127.0.0.1,10.0.0.5
修改前应确认该地址确实属于本机,否则 MongoDB 可能因无法绑定地址而启动失败。修改后重启并检查:
sudo systemctl restart mongod
systemctl is-active mongod
sudo ss -lntp | grep ':27017'
预期能够看到 127.0.0.1:27017 和 10.0.0.5:27017。同时还要在云平台安全组和 UFW 中仅允许应用服务器地址访问。不要为了省事将 bindIp 修改为 0.0.0.0,也不要只依靠账号密码代替网络访问控制。
五、按层次验证服务是否正常运行
验证 systemd 服务
systemctl is-active mongod
systemctl is-enabled mongod
两个结果分别应为:
active
enabled
active 只能说明进程当前处于运行状态,还不能证明数据库可以正常认证和执行命令,因此还需要继续检查。
验证端口监听
sudo ss -lntp | grep ':27017'
检查重点包括:
- 端口是否为预期的
27017; - 监听地址是否只有
127.0.0.1或指定内网地址; - 是否出现未知进程占用该端口;
- 是否意外监听在所有公网网卡上。
验证数据库命令
管理员账号执行:

mongosh \
--host 127.0.0.1 \
--port 27017 \
-u dbadmin \
-p \
--authenticationDatabase admin \
--quiet \
--eval 'db.adminCommand({ ping: 1 })'
如果需要查看当前认证连接信息,可以执行:
mongosh \
--host 127.0.0.1 \
--port 27017 \
-u dbadmin \
-p \
--authenticationDatabase admin
进入后运行:
db.runCommand({ connectionStatus: 1 })
db.serverStatus().connections
connectionStatus 应返回当前认证用户信息,serverStatus().connections 应能看到连接统计。具体数值会随着 Shell 退出而变化,不应把某个固定连接数作为验收标准。
验证业务账号读写权限
如果需要确认业务账号不只是能够建立连接,可以进行一次明确的测试写入。该操作会在 appdb 中产生真实文档,应只使用专门的测试标记:
mongosh \
--host 127.0.0.1 \
--port 27017 \
-u appuser \
-p \
--authenticationDatabase appdb
在 Shell 中执行:
use appdb
db.healthcheck.insertOne({
tag: "deployment-check",
createdAt: new Date()
})
db.healthcheck.findOne({ tag: "deployment-check" })
如果返回包含 _id、tag 和 createdAt 的文档,说明业务账号具备写入和读取权限。验证完成后删除该测试文档:
db.healthcheck.deleteOne({ tag: "deployment-check" })
如果业务库中不允许写入测试数据,可以只执行 ping,并通过应用自身的健康检查接口验证实际连接。
查看服务日志和磁盘空间
检查最近的 systemd 日志:
sudo journalctl -u mongod -n 80 --no-pager
查看 MongoDB 文件日志:
sudo tail -n 80 /var/log/mongodb/mongod.log
再确认数据目录所在磁盘仍有可用空间:
df -h /var/lib/mongodb
正常情况下,日志中不应持续出现 ERROR、FATAL、Permission denied、Address already in use 或无法打开数据目录等错误。单次历史告警不一定代表当前服务异常,应结合服务状态、端口和认证测试综合判断。
六、常见失败处理
软件源没有候选版本
如果 apt-cache policy mongodb-org 没有候选版本,重点检查:
cat /etc/os-release
dpkg --print-architecture
cat /etc/apt/sources.list.d/mongodb-org-8.0.list
sudo apt-get update
常见原因是把 jammy 写到了非 Ubuntu 22.04 系统上,或者服务器并非 amd64。不要通过修改成其他发行版代号来碰运气,错误的软件包可能导致依赖冲突或服务无法启动。
服务启动失败
先查看完整状态和日志:
sudo systemctl status mongod --no-pager -l
sudo journalctl -u mongod -n 100 --no-pager
重点排查以下问题:
mongod.conf的 YAML 缩进错误;security节点重复;bindIp写入了本机不存在的地址;27017已被其他进程占用;/var/lib/mongodb或日志目录权限不正确;- 数据目录所在磁盘已满。
如果是端口冲突,先确认占用进程的用途,再决定停止该进程或更换 MongoDB 端口。更换端口后,应用连接字符串、安全组和防火墙规则必须同步修改。
认证失败
Authentication failed 通常与以下原因有关:
- 管理员账号使用了错误的
authenticationDatabase; appuser实际创建在appdb以外的数据库;- 密码包含特殊字符,但连接 URI 未编码;
- 账号名称或密码大小写不一致;
- 应用仍在使用旧的无认证连接字符串。
可以先用管理员账号登录,再查看指定数据库的用户:
use appdb
db.getUser("appuser")
不要为了绕过认证错误而长期关闭认证,也不要把业务账号临时提升为 root。如果管理员密码丢失,应先限制网络访问、备份配置和数据,再按受控的本机维护流程临时恢复账号,完成后立即重新开启认证并验证。
远程连接超时或被拒绝
从现象上可以初步区分范围:

Connection refused:通常是服务未启动、端口错误或 MongoDB 没有监听目标地址;Connection timed out:通常与云安全组、UFW、路由或上游网络策略有关;- 能建立连接但认证失败:优先检查用户名、密码和
authSource。
在服务器上检查:
sudo ss -lntp | grep ':27017'
ip -br addr
sudo ufw status numbered
同时检查云平台安全组是否允许应用服务器地址访问 TCP 27017。如果 MongoDB 只监听 127.0.0.1,远程服务器即使防火墙放行也无法连接,此时应改用内网地址监听,并在修改后重启验证。
七、验收与回滚检查项
验收检查项
部署完成后,至少保留以下结果:
- 系统版本、架构和 MongoDB 版本已确认;
mongod服务状态为active;- 服务已设置为开机启动;
- 监听端口为预期端口,监听地址没有超出设计范围;
- 管理员账号可以通过
admin数据库认证; - 业务账号可以连接
appdb,权限范围符合预期; ping命令返回{ ok: 1 };- 如执行了读写测试,测试文档已清理;
- 云安全组和 UFW 仅允许指定来源访问;
- 数据目录和日志目录所在磁盘有足够可用空间;
- 最近的服务日志没有持续性启动、权限或磁盘错误。
配置回滚
如果只是修改监听地址或认证配置后启动异常,先停止服务并保留当前配置:
sudo systemctl stop mongod
sudo cp -a /etc/mongod.conf /etc/mongod.conf.failed
将配置恢复为部署前备份的文件。备份文件名以实际生成的时间戳为准,例如:
sudo cp -a /etc/mongod.conf.2025-01-01-120000.bak /etc/mongod.conf
sudo systemctl start mongod
systemctl is-active mongod
如果只需要暂时撤销远程访问,应删除对应的精确防火墙规则,而不是关闭整个防火墙:
sudo ufw delete allow from 203.0.113.10 to any port 27017 proto tcp
sudo ufw status numbered
如果决定撤销本次 MongoDB 安装,先停止并禁用服务:
sudo systemctl disable --now mongod
需要删除软件时,先列出已经安装的 MongoDB 包,确认包名后再执行卸载:
apt list --installed 'mongodb-org*' 2>/dev/null
卸载软件默认不等于删除数据。不要在没有备份、没有确认数据价值和没有明确批准的情况下执行递归删除 /var/lib/mongodb。如果需要彻底清理,应先在服务停止状态下备份数据目录、配置文件和日志,再单独处理软件包、软件源和数据目录。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7208.html



