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

gdx

　　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 来选择相应数据库)
　　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  　　如主redis设置验证密码(使用requirepass设置)，则需在从redis的配置中使用masterauth来设置校验密码，否则主redis会拒绝从redis的访问请求
# masterauth 　　从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
　　设置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