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 环境。

bash
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

预期输出

text
<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。

bash
# 先确保 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

预期结果

text
命令成功时无标准输出;/etc/mongod.conf 已写入,数据与日志目录属主为 mongodb:mongodb。

dbPath 决定数据库文件位置,systemLog.path 决定诊断日志位置,port 默认使用 27017。这里把 bindIp 保持为 127.0.0.1,意味着只有本机客户端能够连接。

启动服务并做端到端验证

配置写好后交给 systemd 管理。enable --now 会同时设置开机启动并立即启动 mongod;随后使用 mongosh 连接本机 admin 数据库执行 ping,这样可以一次验证进程、监听端口、网络连接与 Shell。

bash
# 让 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())'

预期输出

text
active
{ ok: 1 }
8.0.<PATCH>

如果三行都符合预期,说明 mongod 已读取配置并接受本机连接,mongosh 也能完成命令往返。<PATCH> 是实际安装的 8.0 补丁版本。

典型失败按顺序定位

服务启动失败时不要反复重装。先看 systemd 状态,再看 journal 与 MongoDB 自己的日志,最后确认端口是否真的在监听;这四条命令能覆盖大多数“启动失败”和“连接被拒绝”问题。

bash
# 先看服务状态和最近日志,再确认实际监听端口。
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

预期结果

text
正常实例应显示 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 }。后续所有建模与索引实验都应建立在这组可重复验证的基础条件上。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搭建 MongoDB 8.0 实验环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通