NoSQL 与搜索 / 系统课时
搭建 MongoDB 8.0 实验环境
搭建 MongoDB 8.0 实验环境
本篇在 Ubuntu LTS 上安装 MongoDB 8.0 Community 与 mongosh,配置数据目录、日志与本机监听地址,再用 systemd 和 ping 完成验收,得到可复用的本地实验实例。
学习目标
- 使用 MongoDB 官方 APT 仓库安装 MongoDB 8.0 Community 与
mongosh。 - 看懂并配置
storage.dbPath、systemLog、net.bindIp与net.port。 - 能启动服务、验证连接,并按固定顺序定位最常见的启动失败。
确认平台并安装官方包
本实验以 Ubuntu 24.04 LTS 为基线;MongoDB 8.0 也支持受支持的 Ubuntu LTS 版本。安装时使用 MongoDB 官方的 mongodb-org 软件包,不要混用 Ubuntu 仓库中的同名旧包。下面脚本会根据系统代号生成 8.0 仓库配置,并拒绝非 focal、jammy、noble 环境。
set -euo pipefail
# 读取 Ubuntu 版本代号,避免把 8.0 仓库写到不受支持的发行版。
source /etc/os-release
case "${VERSION_CODENAME}" in
focal|jammy|noble) ;;
*) echo "Unsupported Ubuntu codename: ${VERSION_CODENAME}"; exit 1 ;;
esac
sudo apt-get update
sudo apt-get install -y gnupg curl ca-certificates
# 导入 MongoDB 8.0 仓库签名密钥。
curl -fsSL https://pgp.mongodb.com/server-8.0.asc \
| sudo gpg --batch --yes --dearmor \
-o /usr/share/keyrings/mongodb-server-8.0.gpg
# 仓库路径跟随当前 Ubuntu LTS 代号。
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu ${VERSION_CODENAME}/mongodb-org/8.0 multiverse" \
| sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list >/dev/null
sudo apt-get update
sudo apt-get install -y mongodb-org
mongod --version | sed -n '1p'
mongosh --version预期输出
<APT_INSTALL_OUTPUT>
db version v8.0.<PATCH>
<MONGOSH_VERSION><APT_INSTALL_OUTPUT> 代表随镜像与网络状态变化的 APT 安装日志;<PATCH> 与 <MONGOSH_VERSION> 会随安装时仓库中的补丁版本变化。只要服务端主版本为 8.0,且 mongosh 能正常输出版本号,这一步就通过。
配置数据目录、日志与监听地址
官方 Debian/Ubuntu 软件包默认使用 /etc/mongod.conf,数据目录为 /var/lib/mongodb,日志目录为 /var/log/mongodb。实验环境先保留这些标准路径,避免 systemd、目录权限和自定义路径同时变化,降低排错成本。
下面配置明确写出最重要的四类参数,并确保运行用户 mongodb 对数据与日志目录有权限。配置文件使用 YAML,只能用空格缩进,不能用 Tab。
# 先确保 mongod 对数据与日志目录有写权限。
sudo install -d -o mongodb -g mongodb -m 0750 /var/lib/mongodb
sudo install -d -o mongodb -g mongodb -m 0750 /var/log/mongodb
# 覆盖实验配置前保留包管理器生成的原文件。
sudo cp /etc/mongod.conf /etc/mongod.conf.bak
sudo tee /etc/mongod.conf >/dev/null <<'YAML'
storage:
dbPath: /var/lib/mongodb
systemLog:
destination: file
path: /var/log/mongodb/mongod.log
logAppend: true
net:
bindIp: 127.0.0.1
port: 27017
YAML预期结果
命令成功时无标准输出;/etc/mongod.conf 已写入,数据与日志目录属主为 mongodb:mongodb。dbPath 决定数据库文件位置,systemLog.path 决定诊断日志位置,port 默认使用 27017。这里把 bindIp 保持为 127.0.0.1,意味着只有本机客户端能够连接。
启动服务并做端到端验证
配置写好后交给 systemd 管理。enable --now 会同时设置开机启动并立即启动 mongod;随后使用 mongosh 连接本机 admin 数据库执行 ping,这样可以一次验证进程、监听端口、网络连接与 Shell。
# 让 systemd 重新读取服务定义并立即启动 mongod。
sudo systemctl daemon-reload
sudo systemctl enable --now mongod >/dev/null 2>&1
systemctl is-active mongod
mongosh --quiet "mongodb://127.0.0.1:27017/admin" \
--eval 'printjson(db.runCommand({ ping: 1 })); print(db.version())'预期输出
active
{ ok: 1 }
8.0.<PATCH>如果三行都符合预期,说明 mongod 已读取配置并接受本机连接,mongosh 也能完成命令往返。<PATCH> 是实际安装的 8.0 补丁版本。
典型失败按顺序定位
服务启动失败时不要反复重装。先看 systemd 状态,再看 journal 与 MongoDB 自己的日志,最后确认端口是否真的在监听;这四条命令能覆盖大多数“启动失败”和“连接被拒绝”问题。
# 先看服务状态和最近日志,再确认实际监听端口。
sudo systemctl status mongod --no-pager
sudo journalctl -u mongod -n 50 --no-pager
sudo tail -n 50 /var/log/mongodb/mongod.log
sudo ss -lntp | grep 27017预期结果
正常实例应显示 mongod 为 active (running),日志中没有致命启动错误,并能看到 127.0.0.1:27017 的 LISTEN 记录;<TIME>、<PID> 等字段会因机器而异。遇到 Unit mongod.service not found,先确认 mongodb-org-server 已安装并执行 sudo systemctl daemon-reload。日志出现 Permission denied 时检查 /var/lib/mongodb、/var/log/mongodb 的属主与权限;出现 YAML 解析错误时检查缩进和 Tab。若服务是 active 但 mongosh 仍连接失败,则核对实际 bindIp、port 与连接 URI 是否一致。
本地实验环境的验收标准很简单:服务能由 systemd 稳定管理,日志有固定落点,数据目录权限正确,且 mongosh 的 ping 返回 { ok: 1 }。后续所有建模与索引实验都应建立在这组可重复验证的基础条件上。