3. 安装 MongoDB

本节目标：在 Windows、macOS、Linux 上装好 MongoDB 8.3，或用一条 Docker 命令跑起来，并选对版本。

3.1 版本怎么选

MongoDB 有两个服务端版本：

Community（社区版）：免费，包含核心功能，学习足够用。
Enterprise（企业版）：在社区版基础上增加安全、监控等高级能力，需商业授权。

Note

据 MongoDB 8.3 官方文档，8.3 同时提供 Community 与 Enterprise 两个版本；本教程统一用 Community 版。

apt/dnf 安装的 mongodb-org 包会自动带上服务端 mongod、新版命令行 mongosh 和管理工具（如 mongodump、mongorestore）。

3.2 Windows 安装

打开官方文档的 Windows 安装页，下载 8.3 的 MSI 安装包。
双击运行，选「Complete（完整）」安装。
安装向导会创建数据目录 C:\data\db 与日志目录，并默认把 mongod 装成 Windows 服务。
安装完成后，在命令行验证：

mongod --version
mongosh --version

Tip

如果没勾选「Install MongoDB as a Service」，需要自己建 C:\data\db 目录，再手动 mongod 启动。我踩过这个坑，第一次装忘了建目录，启动直接报错。

3.3 macOS 安装

推荐用 Homebrew，最省心：

# 添加官方 tap
brew tap mongodb/brew

# 安装 8.3 社区版
brew install mongodb-community@8.3

# 以后台服务方式启动，并开机自启
brew services start mongodb/brew/mongodb-community

想临时跑一次、不开机自启，可以直接：

mongod --config /opt/homebrew/etc/mongod.conf --fork

3.4 Linux（Ubuntu 22.04）安装

先导入官方 GPG 公钥，再添加 8.3 的 apt 源：

# 1. 导入公钥
curl -fsSL https://pgp.mongodb.com/server-8.0.asc | \
  sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor

# 2. 添加 8.3 源（jammy 是 Ubuntu 22.04 的代号）
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.3 multiverse" | \
  sudo tee /etc/apt/sources.list.d/mongodb-org-8.3.list

# 3. 更新并安装
sudo apt update
sudo apt install -y mongodb-org

# 4. 启动并设开机自启
sudo systemctl start mongod
sudo systemctl enable mongod

Note

据 MongoDB 8.3 官方文档，Ubuntu 源路径形如 jammy/mongodb-org/8.3 multiverse；Ubuntu 24.04 把代号换成 noble 即可。

其他发行版（RHEL 系用 dnf，Debian 用 apt）步骤类似，只是源地址不同，照官方文档改一下即可。

3.5 Docker 方式（最快验证）

不想折腾本机环境，用 Docker 一条命令就能跑：

docker run -d \
  --name mongo83 \
  -p 27017:27017 \
  -v mongo-data:/data/db \
  mongodb/mongodb-community:8.3-ubuntu2204

跑起来后进容器里连 shell：

docker exec -it mongo83 mongosh

Warning

上面镜像 tag 会随版本更新变化，拉取前请到 Docker Hub 的 mongodb/mongodb-community 页面确认 8.3 对应的可用 tag。数据卷 mongo-data 用来持久化，删容器不会丢数据。

3.6 验证安装

无论哪种方式，连上 shell 后看一眼版本号就放心了：

// 在 mongosh 里执行
db.version()

test> db.version()
8.3.7

看到 8.3.x 就说明装对了。这里的 8.3.7 只是本文撰写时的最新补丁号，你安装时可能已是更高的补丁（如 8.3.8），只要大版本是 8.3 即可，不必纠结最后一位。下一章讲怎么启动和连接。