MongoDB与Debian系统集成方案

一、系统兼容性说明

MongoDB官方为Debian提供了原生包管理支持，覆盖Debian 10（Buster）、11（Bullseye）及更高版本。集成前需确保系统版本符合要求，避免因版本不匹配导致的依赖冲突。

二、基础安装步骤

1. 准备工作

更新系统包列表并安装必要依赖，确保APT能正确处理MongoDB仓库：

sudo apt update && sudo apt upgrade -y
sudo apt install -y dirmngr gnupg apt-transport-https ca-certificates software-properties-common

2. 添加MongoDB官方仓库

导入GPG密钥：验证软件包完整性，防止篡改：

wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo apt-key add -

创建仓库列表文件：根据Debian版本调整URL（以Debian 11 Bullseye为例）：

echo "deb [arch=amd64,arm64] https://repo.mongodb.org/apt/debian bullseye/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list

更新APT索引：同步仓库信息：
```
sudo apt update
```

3. 安装与启动MongoDB

安装mongodb-org元包（包含数据库服务器、shell、工具等组件）：

sudo apt install -y mongodb-org

启动MongoDB服务并设置开机自启：

sudo systemctl start mongod
sudo systemctl enable mongod

验证安装状态：

sudo systemctl status mongod  # 应显示“active (running)”
mongo --eval 'db.runCommand({ connectionStatus: 1 })'  # 返回“ok: 1”表示连接成功

三、核心配置优化

1. 基础配置（/etc/mongod.conf）

修改配置文件以适配系统环境：

绑定IP：默认仅本地访问（bindIp: 127.0.0.1），若需远程访问可改为0.0.0.0（需配合防火墙限制）；
端口调整：默认27017，可根据需求修改（如27018）；
数据目录：默认/var/lib/mongodb，确保目录存在且权限正确（chown -R mongodb:mongodb /var/lib/mongodb）；
日志路径：默认/var/log/mongodb/mongod.log，建议单独挂载磁盘以避免空间不足。

2. 安全配置

启用身份验证：防止未授权访问，在security section添加：
```
security:
  authorization: enabled
```
重启服务使配置生效：sudo systemctl restart mongod。

创建管理员用户：通过shell创建具备管理权限的用户：

mongo
use admin
db.createUser({
  user: "admin",
  pwd: "StrongPassword123!",
  roles: [{ role: "root", db: "admin" }]
})

配置SSL/TLS（可选）：生成证书后，在net section添加：

net:
  ssl:
    mode: requireSSL
    PEMKeyFile: /path/to/mongodb.pem
    CAFile: /path/to/ca.pem

3. 性能配置

调整WiredTiger缓存：根据服务器内存大小设置缓存（建议为物理内存的50%）：

storage:
  wiredTiger:
    engineConfig:
      cacheSizeGB: 4  # 4GB缓存（根据实际情况调整）

启用日志分析：通过operationProfiling记录慢查询（阈值设为100ms）：
```
operationProfiling:
  mode: slowOp
  slowOpThresholdMs: 100
```

四、高可用性与扩展

1. 副本集部署（Replica Set）

副本集提供数据冗余和自动故障转移，适合生产环境：

启动多个实例：在不同端口启动多个MongoDB进程（如27017、27018、27019），指定数据目录：

mongod --port 27017 --dbpath /data/db1 --replSet rs0
mongod --port 27018 --dbpath /data/db2 --replSet rs0
mongod --port 27019 --dbpath /data/db3 --replSet rs0

初始化副本集：连接到主节点（默认第一个实例），执行初始化命令：

mongo --port 27017
rs.initiate({
  _id: "rs0",
  members: [
    { _id: 0, host: "localhost:27017" },
    { _id: 1, host: "localhost:27018" },
    { _id: 2, host: "localhost:27019" }
  ]
})

验证状态：通过rs.status()查看副本集成员状态。

2. 分片集群（Sharding）

针对大规模数据集，通过分片分散存储压力：

启用分片：在配置服务器（Config Server）和分片服务器上启动MongoD，配置sharding.clusterRole；
分配分片：使用sh.enableSharding("database_name")启用数据库分片，通过sh.shardCollection("database.collection", { shard_key: 1 })指定分片键。

五、常见问题排查

权限问题：若启动时报错“Permission denied”，需确保数据目录和日志目录属主为mongodb：
```
sudo chown -R mongodb:mongodb /var/lib/mongodb /var/log/mongodb
```
库文件缺失：若启动时报错“libcrypto.so.1.1 not found”，安装对应库文件：
```
sudo apt install libssl-dev
```
配置文件错误：检查/etc/mongod.conf语法（如缩进、参数拼写），可通过mongod --config /etc/mongod.conf --fork --logpath /var/log/mongodb/mongod.log测试配置有效性。

通过以上步骤，可实现MongoDB与Debian系统的稳定集成，并根据业务需求进行性能优化与高可用部署。集成过程中需注意版本兼容性及安全配置，确保数据库的可靠性和安全性。

MongoDB与Debian系统的集成方案