在韩国服务器上部署MongoDB,如何配置应用账户与访问控制?
这次部署的目标是让 MongoDB 在韩国服务器上以独立服务运行,并让应用使用专属账户访问指定数据库,而不是共用管理员凭据。下面以 Ubuntu 22.04 LTS、MongoDB 8.0 为例;如果服务器使用其他发行版或版本,应改用对应的软件源和安装方法。应用与数据库在同一台服务器时,MongoDB 可只监听本机回环地址;如果应用在另一台主机上,则还要配置私网监听地址、防火墙来源限制,并根据网络环境启用 TLS。
如果这类 MongoDB 需要与应用在韩国区域协同运行,A5idc数据可提供韩国首尔的物理服务器资源,并按业务负载、数据规模与网络需求选择相应的处理器、内存、SSD或NVMe及线路配置;同时可配合域名和SSL证书,满足应用入口的域名解析与HTTPS加密连接,企业网络专线也可用于企业站点与业务系统之间的连接。
先确定监听方式与账户边界
MongoDB 的身份认证和网络访问控制是两层不同的限制:账户角色决定已登录用户能操作哪些数据库和集合;监听地址与防火墙决定哪些主机能尝试连接。只启用密码认证,不代表应该把数据库端口开放给任意来源。
| 应用位置 | MongoDB 监听方式 | 网络限制 |
|---|---|---|
| 与 MongoDB 同机的普通进程 | 监听 127.0.0.1 | 只允许本机连接 |
| 运行在另一台服务器 | 监听回环地址和数据库服务器的私网地址 | 防火墙仅放行应用服务器的来源地址 |
| 运行在容器内 | 监听容器能够到达的服务器地址 | 按容器网络和实际来源范围设置规则;容器内的 127.0.0.1 指向容器自身 |
应用账户也应遵循最小权限原则。普通业务服务通常只需要访问自己的数据库;只读报表服务可使用只读角色;管理员账户仅用于维护和账户管理。不要把 root 账户或其他广泛授权的维护账户配置在应用中。
安装并启动 MongoDB
先核对系统版本和处理器架构,确认软件源与系统相匹配:
lsb_release -a
dpkg --print-architecture
以下命令使用 Ubuntu 22.04 的 jammy 软件源。不要将其他 Ubuntu 版本的代号直接替换进来,除非确认 MongoDB 对应版本支持该系统。
sudo apt-get update
sudo apt-get install -y curl gnupg
curl -fsSL https://pgp.mongodb.com/server-8.0.asc -o /tmp/server-8.0.asc
sudo gpg --dearmor --yes \
-o /usr/share/keyrings/mongodb-server-8.0.gpg \
/tmp/server-8.0.asc
rm /tmp/server-8.0.asc
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
sudo apt-get update
sudo apt-get install -y mongodb-org
安装完成后启用并启动服务:
sudo systemctl enable --now mongod
sudo systemctl status mongod --no-pager
mongod --version
服务状态应显示为 active (running)。再从本机发起一次不带凭据的连接,确认服务能够响应:
mongosh --host 127.0.0.1 --eval 'db.runCommand({ ping: 1 })'
正常时命令结果中会包含 ok: 1。如果服务未启动,先查看服务事件和 MongoDB 日志,不要通过开放数据库端口来绕过本机连接问题:
sudo journalctl -u mongod -n 80 --no-pager
sudo tail -n 80 /var/log/mongodb/mongod.log
Ubuntu 软件包通常将配置文件放在 /etc/mongod.conf,数据目录为 /var/lib/mongodb,日志文件为 /var/log/mongodb/mongod.log。调整配置前先查看现有文件,后续只编辑相关配置项,不要重复添加同名的 YAML 顶层键。
创建维护账户并启用认证
首次配置时,MongoDB 默认配置一般只监听本机。确认数据库没有对公网开放后,先连接本机服务并创建一个专用于维护的高权限账户:
mongosh --host 127.0.0.1
在 mongosh 交互界面执行:
use admin
db.createUser({
user: "dbAdmin",
pwd: passwordPrompt(),
roles: [{ role: "root", db: "admin" }]
})
passwordPrompt() 会提示输入密码,避免把明文密码直接写进命令行或 shell 历史。root 权限范围很大,这个账户只用于维护;不要将其连接字符串提供给应用,也不要复用应用账户的密码。
创建账户后,编辑 /etc/mongod.conf。同一配置文件中如果已经存在 net 或 security 段,应修改原段,不要再添加第二个同名段。应用与数据库同机时,相关配置可保持为:
net:
port: 27017
bindIp: "127.0.0.1"
security:
authorization: enabled
authorization: enabled 开启 MongoDB 身份认证;bindIp 限制服务接受连接的本地地址。完成编辑后重启服务:
sudo systemctl restart mongod
sudo systemctl is-active mongod
重启会断开当前连接,首次部署时通常没有业务连接需要保留。之后用维护账户重新登录:
mongosh --host 127.0.0.1 \
--username dbAdmin \
--authenticationDatabase admin \
--password
命令会提示输入密码。登录后可检查认证状态:
db.runCommand({ connectionStatus: 1 })
结果中的 authInfo.authenticatedUsers 应显示 admin 数据库中的 dbAdmin。如果重启后服务无法启动,先检查配置缩进、是否存在重复键,以及 bindIp 是否填写了服务器实际持有的地址;日志中的配置解析错误通常会指出相关文件和行号。
创建应用账户并限定数据库权限
维护账户登录后,在应用将使用的数据库中创建专属用户。下面以数据库 appdb 和应用账户 app_rw 为例:
use appdb
db.createUser({
user: "app_rw",
pwd: passwordPrompt(),
roles: [{ role: "readWrite", db: "appdb" }]
})
此处的 readWrite 只授予 appdb,不会因为用户名称看起来像应用账户就自动获得其他数据库的权限。这个内置角色适合常规业务读写,但比只针对某个集合的 CRUD 权限更宽;如果应用只允许操作特定集合,可改用自定义角色。
例如,订单服务只需要读写 appdb.orders,并且集合由部署或迁移过程预先创建时,可创建集合级角色:
use appdb
db.createRole({
role: "ordersCrud",
privileges: [
{
resource: { db: "appdb", collection: "orders" },
actions: ["find", "insert", "update", "remove"]
}
],
roles: []
})
db.createUser({
user: "orders_api",
pwd: passwordPrompt(),
roles: [{ role: "ordersCrud", db: "appdb" }]
})
这种角色只涵盖列出的集合和操作。应用若还需要创建集合、建立索引或访问其他集合,应按实际需求补充权限,或由单独的部署流程完成这些管理操作;不要为了省事直接授予 root。
应用连接字符串需要同时指定数据库和用户的认证数据库。由于上面的用户创建在 appdb 中,连接示例为:
mongodb://app_rw:<URL编码后的密码>@127.0.0.1:27017/appdb?authSource=appdb
将示例中的用户名、密码和地址替换为实际值。密码中若包含 @、:、/、?、# 等 URI 保留字符,应先进行 URL 编码。应用应从受保护的配置文件或密钥管理机制读取凭据,不要将真实密码提交到代码仓库、日志或公开工单中。
authSource 表示用户账户存储在哪个数据库,并不等同于应用要操作的数据库。如果用户创建在 admin,就应将 authSource 设为 admin;如果像示例这样创建在 appdb,则设为 appdb。认证数据库写错时,即使用户名和密码正确,也可能出现认证失败。
应用位于另一台服务器时限制网络访问
如果应用不在数据库服务器上,先找出数据库服务器实际使用的私网地址:
ip -br addr
假设数据库服务器的私网地址为 10.20.0.10,应用服务器来源地址为 10.20.0.20,可将 MongoDB 的监听项改为:
net:
port: 27017
bindIp: "127.0.0.1,10.20.0.10"
security:
authorization: enabled
地址必须确实配置在数据库服务器网卡上。不要为了让远程应用“能连上”就直接设置成 0.0.0.0,那会让服务监听所有网卡。保存后重启服务,并只对应用服务器来源地址开放 TCP 27017:
sudo systemctl restart mongod
sudo ufw allow from 10.20.0.20 to any port 27017 proto tcp
sudo ufw status
将示例地址替换为实际地址。调整 UFW 规则前先检查现有防火墙策略,避免误改 SSH 等管理连接的访问规则;如果云平台或机房网络另有访问控制,也要同步限制来源。应用连接字符串中的主机地址改为数据库私网地址:
mongodb://app_rw:<URL编码后的密码>@10.20.0.10:27017/appdb?authSource=appdb
跨主机连接时,账户密码并不能替代传输加密。应根据服务器与应用之间的网络环境为 MongoDB 配置 TLS,并让客户端校验证书;不要在未加密且不可信的网络上发送认证信息。若应用与数据库同机,使用 127.0.0.1 可避免把数据库端口开放给外部网络。

验证认证与实际权限
先用应用账户连接本机服务。下面的命令会提示输入密码:
mongosh --host 127.0.0.1 \
--username app_rw \
--authenticationDatabase appdb \
--password
登录后检查身份信息:
db.runCommand({ connectionStatus: 1 })
确认认证用户是 appdb 中的 app_rw,并且角色只包括预期的数据库授权。仅执行 ping 只能证明服务能够响应,不能证明应用账户具有需要的读写权限。可以在测试环境,或确认不会影响业务数据的前提下,写入并删除一条唯一的检查记录:
const target = db.getSiblingDB("appdb")
const testId = new ObjectId()
target._access_check.insertOne({
_id: testId,
checkedAt: new Date()
})
target._access_check.findOne({ _id: testId })
target._access_check.deleteOne({ _id: testId })
预期是插入返回一条记录,查询能找到相同 _id,删除结果显示删除一条记录。检查后文档会被删除,但 _access_check 集合可能仍然存在。生产库中执行写入前,应确认该检查集合不会与应用数据冲突;也可在隔离的测试数据库中验证。
若要确认账号没有被误授予其他数据库的读权限,可以尝试对另一个数据库执行只读查询:

db.getSiblingDB("otherdb").runCommand({
find: "_access_check",
filter: {}
})
如果该用户没有 otherdb 的授权,预期会返回 Unauthorized。不要将这个结果误认为服务故障:它表示请求到达了数据库,但当前账户没有相应权限。
常见连接结果如何判断
Connection refused:目标地址可达,但端口没有服务监听,或服务未运行。检查systemctl is-active mongod和监听地址。- 连接超时:常见原因是监听地址不包含目标网卡、路由不通或防火墙未放行。先确认
bindIp、防火墙规则和应用服务器实际来源地址。 - 认证失败:核对用户名、密码、用户创建所在数据库及 URI 中的
authSource;检查密码是否正确进行 URI 编码。 Unauthorized:通常说明连接已经建立,但该用户缺少目标数据库或操作所需的角色。使用维护账户检查对应数据库中的用户授权,不要直接给应用账户提升为全局权限。- 服务重启失败:检查
/etc/mongod.conf的 YAML 缩进、重复配置项和监听地址是否有效,并查看journalctl与 MongoDB 日志中的具体错误。
完成后,MongoDB 应处于服务运行、认证已启用、应用使用独立账户且权限限定在目标数据库的状态。应用与数据库同机时,保留本机监听即可;跨主机访问则应同时确认私网监听、来源地址限制和传输加密,避免仅凭“用户名和密码已设置”就认为访问控制已经完整。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9993.html



