Debian 上 MongoDB 版本选择与升级建议
一 版本选择建议
- 新部署优先选择最新的稳定主线版本。截至2025-11，MongoDB 主线为8.0，官方安装包已提供 Debian 11/12 的 APT 源，适合生产使用与长期支持周期内的特性获取。若已有 6.0/7.0 的稳定环境，也可在评估变更影响后规划升级至 8.0。对于需要新特性的场景（如可查询加密、自动合并等），8.0 具备明显优势。
- 若业务强依赖特定功能，按功能选型更稳妥：需要时间序列集合与可查询加密可选6.0+；需要自动合并 AutoMerger、采样分析分片键 analyzeShardKey等进阶能力可选7.0+；需要原生时间序列平台、在线数据重新分片可选5.0+。
- 旧版本与系统支持边界：如仍在 Debian 10（Buster），官方包通常仅覆盖到 MongoDB 4.4 系列；若希望使用 6.0/7.0/8.0，建议先升级到 Debian 11/12 后再部署或升级 MongoDB。
二 安装源与安装要点（Debian 11/12）
- 导入 GPG 公钥（推荐 keyring 方式）：
- curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor
- 添加 APT 源（Debian 12 Bookworm 示例）：
- echo “deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/debian bookworm/mongodb-org/8.0 main” | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
- 安装与启动：
- sudo apt update && sudo apt install -y mongodb-org
- sudo systemctl enable --now mongod
- mongosh（验证连接与版本）
- 说明：Debian 11（Bullseye）同样可用 8.0 源，仅替换发行代号即可。上述方式便于后续通过 APT 统一管理升级。
三 升级路径与操作步骤
- 通用安全升级流程
- 备份：mongodump --out /path/to/backup（必要时物理备份数据目录与配置）
- 检查版本：mongod --version 与 rs.status()/sh.status()（集群环境）
- 更新索引与变更：在升级前尽量避免创建/变更正在进行的索引；必要时在维护窗口执行
- 逐节点升级（副本集/分片）：先Secondary后Primary，每步完成后确认复制与业务正常
- 升级命令（保持组件版本一致）：sudo apt-get install -y mongodb-org=8.0.x mongodb-org-server=8.0.x mongodb-org-shell=8.0.x mongodb-org-mongos=8.0.x mongodb-org-tools=8.0.x
- 重启与验证：systemctl restart mongod；mongosh 检查版本与日志无异常
- 原地小版本升级示例（同系列内）
- 仅升级已安装包：sudo apt-get install --only-upgrade mongodb-org
- 重启并验证：systemctl restart mongod；mongod --version
- 回滚预案
- 保留上一版本包或在测试环境验证回滚包；必要时用备份执行 mongorestore 恢复
- 注意
- 不建议跨多主版本直接跳跃（如 5.0 直接到 8.0），应先在测试环境验证或按官方支持的升级路径分步进行
- 集群/分片务必逐节点执行并保持版本一致，升级窗口内控制写入或切换至维护模式
四 关键注意事项
- 内核与虚拟化参数：为降低抖动与性能劣化，建议在 /etc/default/grub 的 GRUB_CMDLINE_LINUX_DEFAULT 中加入numa=off与transparent_hugepage=never，执行 update-grub 后重启；或在系统运行时写入 sysfs 关闭透明大页。
- 版本锁定：若需防止意外升级，可对组件包执行 hold：echo “mongodb-org hold” | sudo dpkg --set-selections（以及 server/shell/mongos/tools）。
- 架构与源匹配：官方 APT 源同时提供 amd64/arm64；确保选择与硬件架构匹配的仓库与包。
- 连接工具：新环境建议使用mongosh替代已弃用的 mongo shell；安装包通常包含 shell 组件。
