在ubuntu 18上安装MongoDB

本文介绍 MongoDB Community Edition 在 Ubuntu 下的安装和常见配置方法。文中操作基于 MongoDB Community Edition 4.2.2 和 Ubuntu 18.04 。对于不同的系统和版本，操作方式和方法可能会有不同。

基础安装

本节简单讲解在Ubuntu下 MongoDB 基本的安装步骤。

1. 安装GPG公钥

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

2. 添加APT源

   echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list
   

3. 重载本地包数据库

   sudo apt-get update
   

4. 安装mongoDB

   sudo apt-get install -y mongodb-org
   

5. 检查mongoDB包安装信息

   apt list --installed mongodb*
   

   正常情况下，可以看到以下信息

   mongodb-org/bionic,now 4.2.2 amd64 [installed]
   mongodb-org-mongos/bionic,now 4.2.2 amd64 [installed]
   mongodb-org-server/bionic,now 4.2.2 amd64 [installed]
   mongodb-org-shell/bionic,now 4.2.2 amd64 [installed]
   mongodb-org-tools/bionic,now 4.2.2 amd64 [installed]
   

6. 启动系统服务

   sudo systemctl enable mongod.service
   sudo systemctl start mongod.service
   

7. 检查服务状态

   systemctl status -l mongod.service
   

   如果 mongod.service 的状态不是 active(running) ，可以根据 systemctl status 命令的输出和日志文件 /var/log/mongodb/mongod.log 来排查问题原因。

客户端连接

当 MongoDB 服务启动成功后，可以使用 MongoDB JavaScript Shell 客户端来访问数据库了:

mongo --host 127.0.0.1 --port 27017

默认配置下，MongoDB 监听本地localhost的27017端口。此时，启动 MongoDB JavaScript Shell 时也可以省略地址和端口参数。连接成功后就可以操作数据库了。比如查看现有的database：

> show dbs;
admin   0.000GB
config  0.000GB
local   0.000GB

安装操作详解

接下来会对安装过程做进一步讲解，基于这部分内容，可以对 MongoDB 的安装和基本配置进行部分自定义。

安装指定组件和版本

在一节内容中，可以看到当 MongoDB 的包安装完成后，可以看到多个组件被安装。这些组件分别是

包名	描述
mongodb-org	包含所有组件包的元包，安装此包会包含以下所有组件
mongodb-org-server	MongoDB 服务器，主要是 mongod 进程程序和相关资源和脚本
mongodb-org-mongos	mongos 进程，用于在 MongoDB 分片集群中将客户端请求分发到各服务节点
mongodb-org-shell	MongoDB JavaScript Shell 客户端
mongodb-org-tools	其他 MongoDB 工具， mongoimport， bsondump， mongodump， mongoexport，mongofiles，mongorestore，mongostat，和mongotop

可以根据需要安装指定的组件，比如只安装 MongoDB JavaScript Shell 来访问远程服务：

sudo apt install mongodb-org-shell

系统服务配置

当 MongoDB 服务安装完成后，会创建系统服务文件 /lib/systemd/system/mongod.service。可以根据需要修改此文件。

比如，服务文件里包含以下一些配置：

[Service]
User=mongodb
Group=mongodb
ExecStart=/usr/bin/mongod --config /etc/mongod.conf

User和Group指定了启动 MongoDB 服务进程所使用的用户mongodb和同名用户组mongodb。这个用户和用户组是在安装 MongoDB 时自动创建的。可以在必要时指定为期望的值。当修改后，要注意同时修改相关目录和文件的权限。

ExecStart指定了启动服务进程的命令，可以看到这里显示指定了使用配置文件/etc/mongod.conf。可以修改这条配置项让数据库使用其他配置文件，也可以添加其他启动参数。

如果希望在同一台服务器上启动多个 MongoDB 服务，可以复制服务文件，并修改后启用。

如果是在启用服务之后对服务文件做了修改，需要重载配置再重启服务:

sudo systemctl daemon-reload
sudo systemctl restart mongod.service

基础配置

本节介绍一些 MongoDB 配置文件中常用的配置项。默认情况下，这些配置保存在文件/etc/mongod.conf中。当配置项修改后，需要重启服务才能生效。

指定监听地址和端口

默认情况下，非分片集群下的 MongoDB 监听 localhost 上的 27017端口。在没有显示指定配置文件时，这个是由配置文件中的 net.port和net.bindIp配置顶控制:

# network interfaces
net:
    port: 27017
    bindIp: 127.0.0.1

这时， MongoDB 只接受来自于同一台服务器上的本地连接，所以通常都会需要修改监听的地址。比如希望监听所有的IPv4地址，就可以将 net.bindIp 项的值由 127.0.0.1 修改为 0.0.0.0。如果需要调整监听的端口，则将 net.port 配置顶的值由 27017 修改为期望值。

修改数据存储

MongoDB 的数据存储目录是由配置文件中的 storage.dbPath 配置项来控制的。默认情况下数据保存在 /var/lib/mongodb 目录下：

# Where and how to store data.
storage:
  dbPath: /var/lib/mongodb

可以根据自己的需要修改数据目录。在修改之前要确保目录已经存在，并且权限设置正确。目录的所有者应当为 mongodb:mongodb，或者启动进程的用户有读写权限。

如果数据库之前已经有数据了，需要把之前数据目录下的文件都复制到新目录下，否则 MongoDB 会新建空的数据文件结构。

修改日志配置

默认情况下 MongoDB 日志记录在文件 /var/log/mongodb/mongod.log 中。这个是由 systemLog 相关配置项决定的：

# where to write logging data.
systemLog:
  destination: file
  logAppend: true
  path: /var/log/mongodb/mongod.log

如果要修改日志文件位置，就根据需要修改 systemLog.path 配置项的值。不过要注意日志文件所在目录的权限。运行 MongoDB 进程的用户需要有日志目录的读写权限。默认情况下使用的用户是 mongodb:mongodb。

如果希望日志文件可以轮转(log rotate)，则需要添加配项 systemLog.logRotate:

    # where to write logging data.
    systemLog:
      destination: file
      logAppend: true
      logRotate: true
      path: /var/log/mongodb/mongod.log

访问控制

默认配置下，MongoDB 是没有开启访问控制的。此时，用户访问数据库不需要做验证，并且拥有所有的权限。所以在安装完成后，应当立刻开启数据库的访问控制。

1. 连接到本地数据库后，在客户端执行以下命令

   use admin
   db.createUser(
     {
       user: "admin",
       pwd: passwordPrompt(),
       roles: [
         { role: "userAdminAnyDatabase", db: "admin" },
         "readWriteAnyDatabase"
       ]
     }
   )
   

   此命令用在 admin 数据库下创建一个名为 admin 的账号。createUser方法参数JSON中的 pwd 字段用来指定账号的密码。这里指定的是另一个方法 passwordPrompt。这个方法在执行createUser命令时，会提示并等待用户在客户端输入密码。roles指定用户的角色和权限。这里给 admin 授权的第一个权限是 admin 数据库的管理权限。admin数据库是 MongoDB 用来管理用户的，所以有了这个权限，就可以用来管理数据库的其他账号了。第二个权限 readWriteAnyDatabase 是对所有数据库的读写权限。

2. 在Ubuntu终端中关闭 MongoDB 服务：

   sudo systemctl stop mongod.service
   

3. 在配置文件将security.authorization配置顶设置为true来开启访问控制：

   security:
     authorization: enabled
   

4. 启动 MongoDB 服务来使配置生效：

   sudo systemctl start mongod.service
   

5. 使用admin登录

   mongo -u admin -p
   

6. 给应用数据库创建账号，比如app_db下创建账号app_admin:

   use app_db
   db.createUser(
     {
       user: "app_admin",
       pwd: passwordPrompt(),
       roles: [ "readWrite" ]
     }
   )
   

这里创建的账号是有app_db下的读写权限readWrite的。如果想创建只读账号，则需要指定权限为read。

1. 使用普通账号登录

   mongo --authenticationDatabase app_db -u app_admin -p
   

   和之前使用admin账号登录不同，这里指定了authenticationDatabase参数值为app_db，因为app_admin是在app_db下创建的账号。

参考资料

• Install MongoDB Community Edition on Ubuntu
• MongoDB Reference: Configuration File Options
• MongoDB Security: Enable Access Control
• Red Hat Enterprise Linux - System Administrator's Guid - Creating and Modifying systemd Unit Files