[TOC]
## 一 配置文件说明
MongoDB有两种配置文件格式,分别是:
[3.2版官方yaml配置文件选项参考](https://docs.mongodb.com/v3.2/reference/configuration-options)
1. 用`=`号的常规格式
类似my.conf等常规配置的文件
2. yaml语法的新格式
mongodb3.x版本后就是要yaml语法格式的配置文件,下面是yaml配置文件格式如下:
切记yaml只能使用空格,不支持tab键,切记
### 配置举例
**配置文件**
```yaml
systemLog:
destination: file
path: "/var/log/mongodb/mongod.log"
logAppend: true
storage:
journal:
enabled: true
processManagement:
fork: true
net:
bindIp: 127.0.0.1
port: 27017
setParameter:
enableLocalhostAuthBypass: false
```
**指定配置启动**
```sh
mongod --config  /etc/mongod.conf
# 或者
mongod -f /etc/mongod.conf
```
### 配置文件模块
mongod.conf配置文件分为如下几块内容:
```
systemLog: #日志模块相关参数
storage: #存储引擎相关参数
processManagement: #进程管理
net: #网络
security: #安全
operationProfiling: #性能分析器
replication: #主从复制配置
sharding: #分片集群配置
setParameter: #自定义变量
auditLog: #检测日志
snmp: #
```
## 二 详细配置部分
### A `systemLog`日志相关参数
~~~yaml
systemLog:
verbosity: #日志级别,默认0,1-5均会包含debug信息
quiet: #安静,true时将会减少日志的输出量
traceAllExceptions: #打印异常详细信息
syslogFacility: #启用syslog指定用于登录时信息到syslog Facility水平,前提是
path: #日志路径
logAppend: #追加日志还是新建日志
logRotate: rename|reopen #日志轮询。默认值rename;reopen前提为 logAppend: true
destination: #日志输出目的地,可为file或syslog,不指定会输出到标准输出
timeStampFormat: #日志时间戳格式,有 ctime,Iso869-utc,iso8691-local
component: #为不同的组件指定各自的日志信息级别
accessControl:
verbosity: 
command:
verbosity: 
~~~
### B `storage`存储引擎相关参数
~~~yaml
storage:
dbPath: #数据存储目录
indexBuildRetry: #构件索引时mongod意外关闭,启动是否重建索引,默认true
repairPath: #在repair期间临时数据目录
journal:
enabled: #journal日志是否持久存储,通常用于数据故障恢复,建议开启
commitIntervalMs: #mongod日志刷新值,范围1-500毫秒,默认100,不建议修改
directoryPerDB: #是否将不同的数据存储在不同的目录中,需为dbPath子目录
syncPeriodSecs: #fsync操作将数据flush到磁盘的时间间隔,默认为60秒,不建议修改
engine: #存储引擎类型,3.2前默认 mmapv1,3.2后默认WiredTiger
wiredTiger: #存储引擎配置
engineConfig:
cacheSizeGB: #最大缓存大小
journalCompressor: #日志压缩算法,可选值有 none,snappy(默认),zlib
directoryForIndexes: #是否将索引和集合数据分别存储在dbPath单独的目录中
collectionConfig:
blockCompressor: #collection数据压缩算法,可选none, snappy,zlib
indexConfig:
prefixCompression: #是否对索引数据使用前缀压缩。可有效减少索引数据的内存使用量。
~~~
### C `processManagement`进程相关参数
~~~yaml
processManagement:
fork: #是否以守护进程运行,默认false
pidFilePath: #将mongod进程ID写入指定文件,默认不会创建
~~~
### D `net`网络相关参数
~~~xml
net:
prot: #监听端口,默认27017
bindIp: #绑定IP,如果此值是“0.0.0.0”则绑定所有接口
maxIncomingConnections: #进程允许的最大连接数,上限是系统阈值(ulimit)
wireObjectCheck: #当客户端写入数据时,是否检查数据的有效性(BSON),有效的数据才执行
ipv6: #是否支持多实例之间使用ipv6
http: #http配置
enabled: 
JSONEnabled: 
RESTInterfaceEnabled: 
ssl: #https配置
sslOnNormalPorts: 
mode: 
PEMKeyFile: 
PEMKeyPassword: 
clusterFile: 
clusterPassword: 
CAFile: 
CRLFile: 
allowConnectionsWithoutCertificates: 
allowInvalidCertificates: 
allowInvalidHostnames: 
disabledProtocols: 
FIPSMode: 
compression:
compressors: 
~~~
### E `security`安全相关参数
~~~yaml
security:
authorization: enabled #MondoDB认证功能
keyFile: /path/mongo.key #MongoDB副本集节点身份验证密钥文件
clusterAuthMode: #集群members间的认证模式
transitionToAuth: 
javascriptEnabled: #是否允许执行JavaScript脚本
redactClientLogData: 
sasl:
hostName: 
serviceName: 
saslauthdSocketPath: 
enableEncryption: 
encryptionCipherMode: 
encryptionKeyFile: 
kmip:
keyIdentifier: 
rotateMasterKey: 
serverName: 
port: 
clientCertificateFile: 
clientCertificatePassword: 
serverCAFile: 
ldap:
servers: 
bind:
method: 
saslMechanism: 
queryUser: 
queryPassword: 
useOSDefaults: 
transportSecurity: 
timeoutMS: 
userToDNMapping: 
authz:
queryTemplate: 
~~~
### F `operationProfiling`慢查询相关参数:
~~~yaml
operationProfiling:
slowOpThresholdMs: #“慢查询”的时间阈值,单位毫秒(默认100ms)
mode: #数据库profiler级别,可选值“off|slowOp|all”
#数据库profiling会影响性能,建议只在性能调试阶段开启,mongod会把慢查询记录到日志中
~~~
### G `replication`副本集相关参数:
~~~yaml
replication:
oplogSizeMB: #replication操作日志的最大尺寸,如果太小则全量同步
replSetName: #副本集名称,副本集中所有的mongod实例都必须有相同的名字
secondaryIndexPrefetch: #副本集中的secondary,从oplog中应用变更操作前,会先把索引加载到内存
enalbeMajorityReadConcern: #允许readConcern的级别为“majority”
~~~
### H `sharding`分片相关参数:
~~~yaml
sharding:
clusterRole: #在sharding集群中的角色。configsvr(27019)|shardsvr(27018)
archiveMovedChunks: #当chunks迁移后,是否归档并保存这些chunks在dbPath/movechunk目录下
~~~
### I `setParameter`自定义变量:
~~~yaml
setParameter:
: 
: 
enableLocalhostAuthBypass: false #栗子
~~~
### J `auditLog`审计相关参数:
~~~yaml
auditLog:
destination: #指定审计记录的输出方式,有syslog|console|file
format: #输出格式,有JSON 和 BSON
path: #如果输入为文件,那么指定文件完整路径及文件名
filter: #过滤器,可限制审计系统记录的操作类型
~~~