Redis的安装和使用之三------redis.conf配置释义

Redis配置文件被分成几大块区域，分别是:
1.通用(general)
2.快照(snapshotting)
3.复制(replication)
4.安全(security)
5.限制(limits)
6.追加模式(append only mode)
7.LUA脚本(lua scripting)
8.Redis集群(redis cluster)
9.慢日志(slow log)
10.延迟监控(latency monitor)
11.事件通知(event notification)
12.高级配置(advanced config)

注: INCLUDES配置:当机器不只存在1个Redis实例时，可以实现每个Redis实例的"个性化"配置，此时，可以将这些实例的共有配置写到redis.conf中，而个性化的配置写到由include配置路径指定的文件中。

1. 通用(general):

############################  GENERAL  #################################
daemonize no                    ##是否以后台daemon方式运行(默认为no)
pidfile /var/run/redis/redis.pid     ##Pid文件位置
port 6379                         ##监听端口
tcp-backlog 511            ##客户端连接队列值, 在高并发的环境中，为避免慢客户端的连接问题，需要设置一个高速后台日志
bind 127.0.0.1                ##指定redis所响应的连接请求(默认响应本机所有网卡的连接请求)
timeout 0                                ##请求超时时间(0表示永不关闭)
tcp-keepalive 0                   ##TCP存活检测(单位为秒,0表示不进行检测)
loglevel notice           ##log信息级别(分四级，即debug、verbose、notice、warning)
logfile /var/log/redis/redis.log       ##log文件位置，如设置为[logfile ""]空字符串，则redis会将日志输出到标准输出，被写到/dev/null中
databases 16     ##开启数据库数量(默认数据库是编号为0的数据库,可使用select <DBid>来选择相应数据库)

2. 快照(snapshotting)----主要涉及的是redis的RDB持久化相关的配置
save * *: 保存快照的频率,第一个*表示多长时间,第二个*表示执行多少次写操作。在一定时间内执行一定数量的写操作时，自动保存快照，可设置多个条件。如想禁用RDB持久化策略，不设置任何save指令即以，或设置[save ""]

##########################  SNAPSHOTTING  #############################
save 900 1           ##每15分钟且至少有1个key改变，就触发一次持久化
save 300 10          ##每5分钟且至少有10个key改变，就触发一次持久化
save 60 10000        ##每60秒至少有10000个key改变，就触发一次持久化
stop-writes-on-bgsave-error yes        ##redis持久化数据到磁盘时如出现失败，默认redis会停止接受所有的写请求
rdbcompression yes              ##是否使用压缩
rdbchecksum yes                ##是否使用CRC64算法来进行数据校验
dbfilename dump.rdb           ##设置数据快照文件名(只是文件名,不包括目录)
dir /var/lib/redis/           ##设置数据快照的保存目录(这个是目录)

3. 复制(replication)
############################### REPLICATION ##########################
通过slaveof配置项可控制某一个redis作为另一个redis的从服务器，通过指定IP和端口来定位到主redis的位置

# slaveof <masterip> <masterport>

如主redis设置验证密码(使用requirepass设置)，则需在从redis的配置中使用masterauth来设置校验密码，否则主redis会拒绝从redis的访问请求

# masterauth <master-password>

从redis失去与主redis的连接，或者主从同步正在进行时，redis对外部发来的访问请求的两种处理选择:
选择1:设置为yes(默认)，从redis仍会继续响应客户端的读写请求
选择2:设置为no，从redis会对客户端的请求返回“SYNC with master in progress”(例外:当客户端发来INFO请求和SLAVEOF请求，从redis还是会进行处理)

slave-serve-stale-data yes
slave-read-only yes           ##设置从redis只读

复制同步策略：磁盘或者socket
新的从redis上线或主redis重新上线时应做数据全同步。需要将一个新的RDB文件dump出来，然后从主redis传到从redis。有两种情况：
1. 基于硬盘(disk-backed):主redis创建一个新进程dump RDB，之后由父进程(即主进程)增量传给从redis
2. 基于socket(diskless):主redis创建一个新进程直接dump RDB到从redis的socket，不经过主进程，不经过硬盘
如基于硬盘，RDB文件创建后，一旦创建完毕，可以同时服务更多从redis；如基于socket，新的从redis加入后，需进行排队(如超出repl-diskless-sync-delay设定时时)；当用diskless时，主redis等待repl-diskless-sync-delay设定的秒数后，如无新的从redis加入，就直接传，后来的需排队等待。(默认用disk-based)

repl-diskless-sync no
repl-diskless-sync-delay 5             ##每五秒传输一次(需开启diskless)
# repl-ping-slave-period 10             ##设置从redis向主redis发出PING包的周期(默认10秒)

在主从同步时，可能在这些情况下会有超时发生:
1. 以从redis的角度来看，当有大规模IO传输时。
2. 以从redis的角度来看，当数据传输或PING时，主redis超时
3. 以主redis的角度来看，在回复从redis的PING时，从redis超时
用户可以设置上述超时的时限，不过要确保这个时限比repl-ping-slave-period的值要大，否则每次主redis都会认为从redis超时。

# repl-timeout 60

设置主从同步时是否禁用TCP_NODELAY。如开启TCP_NODELAY，主redis会使用更少的TCP包和更少的带宽来向从redis传输数据，但可能会增加同步延迟(40ms)。如关闭TCP_NODELAY，那数据同步的延迟时间会降低，但会消耗更多的带宽

repl-disable-tcp-nodelay no

设置同步队列长度。队列长度（backlog)是主redis中的一个缓冲区，在与从redis断开连接期间，主redis会用这个缓冲区来缓存应该发给从redis的数据。这样，当从redis重新连接上后，就不必重新全量同步数据，只需要同步这部分增量数据即可

# repl-backlog-size 1mb

设置主redis清理缓冲队列等待的时间长度(设置为0表示永不清理,默认为1个小时)

# repl-backlog-ttl 3600
slave-priority 100   ##设置从redis优先级，编号越小，优先级越高(默认100)

如主redis发现有超过M个从redis的连接延时大于N秒，那么主redis就停止接受外来的写请求

# min-slaves-to-write 3
# min-slaves-max-lag 10

假如有大于等于3个从redis的连接延迟大于10秒，那么主redis就不再接受外部的写请求。上述两个配置中有一个被置为0，则这个特性将被关闭

4. 安全(security)

############################# SECURITY #################################
##设置redis客户端在向redis-server发送请求之前，先进行密码验证。
# requirepass foobared        ##设置密码为"foobared"
# rename-command CONFIG b840fc02d524045429941......     ##对redis指令进行更名
# rename-command CONFIG ""      ##禁用CONFIG命令

5. 限制(limits)

###############################   LIMITS  ################################
# maxclients 10000  ##设置redis可以同时与多少个客户端进行连接(默认为10000个客户端)
# maxmemory <bytes>

设置redis可使用的内存量。一旦到达内存使用上限，redis将会试图移除内部数据，移除规则可以通过maxmemory-policy来指定。如redis无法根据移除规则来移除内存中的数据，或者我们设置了“不允许移除”，那么redis则会针对那些需要申请内存的指令返回错误信息

如果你的redis是主redis，那么在设置内存使用上限时，需要在系统中留出一些内存空间给同步队列缓存，只有在设置的是“不移除”的情况下，才不用考虑这个因素。
对于内存移除规则来说，redis提供了多达6种的移除规则。他们是:
1. volatile-lru：使用LRU算法移除过期集合中的key
2. allkeys-lru：使用LRU算法移除key
3. volatile-random：在过期集合中移除随机的key
4. allkeys-random：移除随机的key
5. volatile-ttl：移除那些TTL值最小的key，即那些最近才过期的key。
6. noeviction：不进行移除。针对写操作，只是返回错误信息。(默认规则)
无论使用上述哪一种移除规则，如果没有合适的key可以移除的话，redis都会针对写请求返回错误信息。

# maxmemory-policy noeviction    ##不进行移除
# maxmemory-samples 5    ##设置LRU算法的样本数

6. 追加模式(append only mode)

########################## APPEND ONLY MODE ###########################
appendonly on                          ##打开AOF功能
appendfilename "appendonly.aof"        ##设置AOF文件的名称

AOF持久化策略，fsync()调用，用来告诉操作系统立即将缓存的指令写入磁盘，redis支持三种不同的模式:
1. always:每次写请求都强制调用fsync，该模式下，redis会相对较慢，但数据最安全
2. everysec:每秒调用一次fsync
3. on:不调用fsync等待系统自己同步[fsync是指把缓存中的写指令记录到磁盘中]

appendfsync everysec             ##每秒调用一次fsync

当BGSAVE或BGWRITEAOF运行时，fsync()在主进程中的调用会被阻止。这意味着当另一路进程正在对AOF文件进行重构时，redis的持久化功能就失效了，就像设置了“appendsync none”一样。 如果redis有时延问题， 那么将选项设置为yes。 否则请保持no，因为这是保证数据完整性的最安全的选择。

no-appendfsync-on-rewrite no

允许redis自动重写aof。当aof增长到一定规模时，redis会隐式调用BGREWRITEAOF来重写log文件，以缩减文件体积。redis是这样工作的:redis会记录上次重写时的aof大小。如redis自启动至今还没有进行过重写，那么启动时aof文件的大小会被作为基准值。该基准值会和当前的aof大小进行比较。如当前aof大小超出所设置的增长比例，则会触发重写。另外还需要设置一个最小大小，是为了防止在aof很小时就触发重写。如设置auto-aof-rewrite-percentage为0，则会关闭此重写功能。

auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb
aof-load-truncated yes       ##当aof文件被损坏时,redis将返回错误并退出

7. LUA脚本(lua scripting)

############################ LUA SCRIPTING  #########################
lua-time-limit 5000   ##设置lua脚本最大运行时间(默认毫秒，设置为0或负数，既不会报错也无时间限制)

8. Redis集群(redis cluster)

############################ REDIS CLUSTER  ##########################
# cluster-enabled yes                 ##开启redis集群
# cluster-config-file nodes-6379.conf    ##集群配置文件(启动自动生成)
# cluster-node-timeout 15000         ##节点互联超时的阀值
# cluster-slave-validity-factor 10  ##slave节点检测因素，开始failover的超时时限是通过factor与timeout的乘积来确定的
# cluster-migration-barrier 1  ##设置master只有在关联多少slave时才会触发迁移过程
# cluster-require-full-coverage yes
##集群各节点在检测到至少一个hash槽位遗漏的情况下将停止处理查询请求。如集群部分节点宕机(例如部分hash槽位没有被分配)会造成整个集群不可用，直到所有槽位均被分配时才会自动恢复为可用状态

9. 慢日志(slow log)

###############################  SLOW LOG  #############################
##redis慢日志是指一个系统进行日志查询超过了指定时长。这个时长不包括IO操作，如与客户端的交互、发送响应内容等，而仅包括实际执行查询命令的时间。针对慢日志，可设置两个参数，一个是执行时长，单位是微秒;另一个是慢日志的长度。当一个新的命令被写入日志时，最老的一条会从命令日志队列中被移除。
slowlog-log-slower-than 10000 ##设置执行时长为10000微秒(单位为微秒，负数表示禁用慢日志功能，而0则表示强制记录每一个命令)
slowlog-max-len 128       ##设置慢日志最大长度

10. 延迟监控(latency monitor)

#############################   LATENCY MONITOR  ####################
latency-monitor-threshold 0  ##用LATENCY打印redis实例在跑命令时的耗时图表，只记录大于等于所设置值的操作(0表示关闭监控)

11. 事件通知(event notification)----向客户端通知某些事件的发生

########################## EVENT NOTIFICATION #######################
notify-keyspace-events ""       ##通知pub/sub客户端关于key空间的变化(默认关闭)

12. 高级配置(advanced config)

############################# ADVANCED CONFIG ########################
##有关哈希数据结构的配置项
hash-max-ziplist-entries 512
hash-max-ziplist-value 64
##有关列表数据结构的配置项
list-max-ziplist-entries 512
list-max-ziplist-value 64
##有关集合数据结构的配置项
set-max-intset-entries 512
##有关有序集合数据结构的配置项
zset-max-ziplist-entries 128
zset-max-ziplist-value 64
##有关HyperLogLog字节限制的配置项
hll-sparse-max-bytes 3000
##关于是否需要再哈希的配置项
activerehashing yes
##关于客户端输出缓冲的控制项
client-output-buffer-limit normal 0 0 0
client-output-buffer-limit slave 256mb 64mb 60
client-output-buffer-limit pubsub 32mb 8mb 60
##有关频率的配置项
hz 10
##有关重写aof的配置项
aof-rewrite-incremental-fsync yes

本文出自 “记事本” 博客，请务必保留此出处http://wangzhijian.blog.51cto.com/6427016/1734868