在ubuntu 18上安装MongoDB
本文介绍 MongoDB Community Edition 在 Ubuntu 下的安装和常见配置方法。文中操作基于 MongoDB Community Edition 4.2.2 和 Ubuntu 18.04 。对于不同的系统和版本,操作方式和方法可能会有不同。
基础安装
本节简单讲解在Ubuntu下 MongoDB 基本的安装步骤。
- 安装GPG公钥
wget -qO - https://www.mongodb.org/static/pgp/server-4.2.asc | sudo apt-key add -
- 添加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
- 重载本地包数据库
sudo apt-get update
- 安装mongoDB
sudo apt-get install -y mongodb-org
- 检查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]
- 启动系统服务
sudo systemctl enable mongod.service sudo systemctl start mongod.service
- 检查服务状态
如果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 是没有开启访问控制的。此时,用户访问数据库不需要做验证,并且拥有所有的权限。所以在安装完成后,应当立刻开启数据库的访问控制。
- 连接到本地数据库后,在客户端执行以下命令
此命令用在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
是对所有数据库的读写权限。 - 在Ubuntu终端中关闭 MongoDB 服务:
sudo systemctl stop mongod.service
- 在配置文件将
security.authorization
配置顶设置为true
来开启访问控制:security: authorization: enabled
- 启动 MongoDB 服务来使配置生效:
sudo systemctl start mongod.service
- 使用
admin
登录mongo -u admin -p
- 给应用数据库创建账号,比如
app_db
下创建账号app_admin
:use app_db db.createUser( { user: "app_admin", pwd: passwordPrompt(), roles: [ "readWrite" ] } )
这里创建的账号是有app_db
下的读写权限readWrite
的。如果想创建只读账号,则需要指定权限为read
。
- 使用普通账号登录
和之前使用mongo --authenticationDatabase app_db -u app_admin -p
admin
账号登录不同,这里指定了authenticationDatabase
参数值为app_db
,因为app_admin
是在app_db
下创建的账号。