Redis——配置文件 redis.conf

常用配置

1. Redis默认不是以守护进程的方式运行，可以通过该配置项修改，使用yes启用守护进程
   daemonize no
   
2. 当Redis以守护进程方式运行时，Redis默认会把pid写入/var/run/redis.pid文件，可以通过pidfile指定
   pidfile /var/run/redis.pid
   
3. 指定Redis监听端口，默认端口为6379，作者在自己的一篇博文中解释了为什么选用6379作为默认端口，因为6379在手机按键上MERZ对应的号码，而MERZ取自意大利歌女Alessia Merz的名字
   port 6379
   
4. 绑定的主机地址
   bind 127.0.0.1
   
5. 当客户端闲置多长时间后关闭连接，如果指定为0，表示关闭该功能
   timeout 300
   
6. 指定日志记录级别，Redis总共支持四个级别：debug、verbose、notice、warning，默认为verbose
   loglevel verbose
   
7. 日志记录方式，默认为标准输出，如果配置Redis为守护进程方式运行，而这里又配置为日志记录方式为标准输出，则日志将会发送给/dev/null
   logfile stdout
   
8. 设置数据库的数量，默认数据库为0，可以使用SELECT <dbid>命令在连接上指定数据库id
   databases 16
   
9. 指定在多长时间内，有多少次更新操作，就将数据同步到数据文件，可以多个条件配合
	save <seconds> <changes>
	Redis默认配置文件中提供了三个条件：
	save 900 1
	save 300 10
	save 60 10000
	分别表示900秒（15分钟）内有1个更改，300秒（5分钟）内有10个更改以及60秒内有10000个更改。
 
10. 指定存储至本地数据库时是否压缩数据，默认为yes，Redis采用LZF压缩，如果为了节省CPU时间，可以关闭该选项，但会导致数据库文件变的巨大
    rdbcompression yes
	
11. 指定本地数据库文件名，默认值为dump.rdb
    dbfilename dump.rdb
	
12. 指定本地数据库存放目录
    dir ./
	
13. 设置当本机为slave服务时，设置master服务的IP地址及端口，在Redis启动时，它会自动从master进行数据同步
    slaveof <masterip> <masterport>
	
14. 当master服务设置了密码保护时，slave服务连接master的密码
    masterauth <master-password>
	
15. 设置Redis连接密码，如果配置了连接密码，客户端在连接Redis时需要通过AUTH <password>命令提供密码，默认关闭
    requirepass foobared
	
16. 设置同一时间最大客户端连接数，默认无限制，Redis可以同时打开的客户端连接数为Redis进程可以打开的最大文件描述符数，如果设置 maxclients 0，表示不作限制。当客户端连接数到达限制时，Redis会关闭新的连接并向客户端返回max number of clients reached错误信息
    maxclients 128
	
17. 指定Redis最大内存限制，Redis在启动时会把数据加载到内存中，达到最大内存后，Redis会先尝试清除已到期或即将到期的Key，当此方法处理 后，仍然到达最大内存设置，将无法再进行写入操作，但仍然可以进行读取操作。Redis新的vm机制，会把Key存放内存，Value会存放在swap区
    maxmemory <bytes>
	
18. 指定是否在每次更新操作后进行日志记录，Redis在默认情况下是异步的把数据写入磁盘，如果不开启，可能会在断电时导致一段时间内的数据丢失。因为 redis本身同步数据文件是按上面save条件来同步的，所以有的数据会在一段时间内只存在于内存中。默认为no
    appendonly no
	
19. 指定更新日志文件名，默认为appendonly.aof
    appendfilename appendonly.aof
	
20. 指定更新日志条件，共有3个可选值： 
	no：表示等操作系统进行数据缓存同步到磁盘（快） 
	always：表示每次更新操作后手动调用fsync()将数据写到磁盘（慢，安全） 
	everysec：表示每秒同步一次（折衷，默认值）
	appendfsync everysec
 
21. 指定是否启用虚拟内存机制，默认值为no，VM机制将数据分页存放，由Redis将访问量较少的页即冷数据swap到磁盘上，访问多的页面由磁盘自动换出到内存中。
	vm-enabled no
	
22. 虚拟内存文件路径，默认值为/tmp/redis.swap，不可多个Redis实例共享
	vm-swap-file /tmp/redis.swap
	
23. 将所有大于vm-max-memory的数据存入虚拟内存,无论vm-max-memory设置多小,所有索引数据都是内存存储的(Redis的索引数据 就是keys),也就是说,当vm-max-memory设置为0的时候,其实是所有value都存在于磁盘。默认值为0
	vm-max-memory 0
	
24. Redis swap文件分成了很多的page，一个对象可以保存在多个page上面，但一个page上不能被多个对象共享，vm-page-size是要根据存储的 数据大小来设定的，作者建议如果存储很多小对象，page大小最好设置为32或者64bytes；如果存储很大大对象，则可以使用更大的page，如果不 确定，就使用默认值
	vm-page-size 32
	
25. 设置swap文件中的page数量，由于页表（一种表示页面空闲或使用的bitmap）是在放在内存中的，，在磁盘上每8个pages将消耗1byte的内存。
	vm-pages 134217728
	
26. 设置访问swap文件的线程数,最好不要超过机器的核数,如果设置为0,那么所有对swap文件的操作都是串行的，可能会造成比较长时间的延迟。默认值为4
    vm-max-threads 4
	
27. 设置在向客户端应答时，是否把较小的包合并为一个包发送，默认为开启
    glueoutputbuf yes
	
28. 指定在超过一定的数量或者最大的元素超过某一临界值时，采用一种特殊的哈希算法
	hash-max-zipmap-entries 64
	hash-max-zipmap-value 512
	
29. 指定是否激活重置哈希，默认为开启
	activerehashing yes
	
30. 指定包含其它的配置文件，可以在同一主机上多个Redis实例之间使用同一份配置文件，而同时各个实例又拥有自己的特定配置文件
	include /path/to/local.conf

INCLUDES

通过includes包含，redis.conf可以作为总闸，包含其他配置文件

如果将此配置写在redis.conf 文件的开头，那么后面的配置会覆盖引入文件的配置，如果想以引入文件的配置为主，那么需要将 include 配置写在 redis.conf 文件的末尾。

 

NETWORK

bind

指定redis只接收来自于该IP地址的请求，如果不进行设置，那么将处理所有请求

port

默认值：port 6379。指定redis运行的端口，默认是6379。

tcp-backlog

默认值：tcp-backlog 511。设置tcp的backlog，backlog其实是一个连接队列，backlog队列总和=未完成三次握手队列 + 已经完成三次握手队列。在高并发环境下需要一个高backlog值来避免慢客户端连接问题。注意Linux内核会将这个值减小到 /proc/sys/net/core/somaxconn 的值，所以需要确认增大somaxconn和tcp_max_syn_backlog两个值来达到想要的效果。

timeout

默认值：timeout 0。设置客户端连接时的超时时间，单位为秒。当客户端在这段时间内没有发出任何指令，那么关闭该连接。0是关闭此设置。

tcp-keepalive

默认值：tcp-keepalive 300。单位为秒，如果设置为0，则不会进行Keepalive检测。

GENERAL

daemonize 

默认值 daemonize no ，redis不是在后台运行的，如果需要在后台运行，把该项的值更改为yes。

pidfile

默认值：pidfile /var/run/redis_6379.pid 。Redis 默认会把 pid 文件放在/var/run/redis.pid，也可以配置到其他地址。当运行多个redis 服务时，需要指定不同的 pid 文件和端口。

loglevel

默认值：loglevel notice。指定日志记录级别。Redis总共支持四个级别：debug、verbose、notice、warning

logfile

默认值：logfile ""。 配置log文件地址，默认值为stdout，标准输出，若后台模式会输出到/dev/null。

syslog-enabled

默认值：是否把日志输出到syslog中。

syslog-ident

指定syslog里的日志标志

syslog-facility

指定syslog设备，值可以是USER或LOCAL0-LOCAL7

databases

默认值：databases 16。可用数据库数。默认值为16，默认数据库为0，数据库范围在0-（database-1）之间。

SNAPSHOTTING快照

save

指出在多长时间内，有多少次更新操作，就将数据同步到数据文件rdb。

默认值：

save 900 1               900秒内至少有1个key被改变
save 300 10             300秒内至少有300个key被改变
save 60 10000         60秒内至少有10000个key被改变

如果想禁用RDB持久化的策略，只要不设置任何save指令，或者给save传入一个空字符串参数也可以。

stop-writes-on-bgsave-error

如果配置成 no，表示你不在乎数据不一致或者有其他的手段发现和控制。

rdbcompression：

对于存储到磁盘中的快照，可以设置是否进行压缩存储。如果是的话，redis会采用
LZF算法进行压缩。如果你不想消耗CPU来进行压缩的话，可以设置为关闭此功能

rdbchecksum

在存储快照后，还可以让redis使用CRC64算法来进行数据校验，但是这样做会增加大约10%的性能消耗，如果希望获取到最大的性能提升，可以关闭此功能。

dbfilename

默认值：dbfilename dump.rdb。本地持久化数据库文件名。

dir

默认值：dir ./ 。 数据库镜像备份的文件放置的路径。

REPLICATION复制

主从复制。设置该数据库为其他数据库的从数据库。设置当本机为slave服务时，设置master服务的IP地址及端口，在Redis启动时，它会自动从master进行数据同步

slaveof <masterip> <masterport>

当 master 服务设置了密码保护时(用requirepass制定的密码)slave服务连接master的密码。

masterauth <master-password>

当从属服务器失去与主服务器的连接或复制仍在进行时，从属服务器可以通过两种不同的方式进行操作：

1）如果slave-serve-stale-data设置为“ yes”（默认值），则slave仍会回复客户端请求，可能包含过期数据，或者如果这是第一次同步，则数据集可能为空 。

2）如果slave-serve-stale-data设置为“ no”，则从站将对所有类型的命令（信息和SLAVEOF）回复错误“与主机进行同步”。

slave-serve-stale-data yes

从库会按照一个时间间隔向主库发送PINGs.可以通过repl-ping-slave-period设置这个时间间隔，默认是10秒

repl-ping-slave-period 10

repl-timeout 设置主库批量数据传输时间或者ping回复时间间隔，默认值是60秒，一定要确保repl-timeout大于repl-ping-slave-period
repl-timeout 60

SECURITY安全

requirepass  设置密码、

客户端密码的查看、设置和取消：

LIMITS限制

maxclients

默认值：maxclients 10000。设置最大连接客户端数。

maxmemory

设置redis可以使用的内存量。一旦到达内存使用上限，redis将会试图移除内部数据，移除规则可以通过maxmemory-policy来指定。如果redis无法根据移除规则来移除内存中的数据，或者设置了“不允许移除”，那么redis则会针对那些需要申请内存的指令返回错误信息，比如SET、LPUSH等。但是对于无内存申请的指令，仍然会正常响应，比如GET等。如果你的redis是主redis（说明你的redis有从redis），那么在设置内存使用上限时，需要在系统中留出一些内存空间给同步队列缓存，只有在你设置的是“不移除”的情况下，才不用考虑这个因素。

maxmemory-policy：

默认值：noeviction。指定失效算法。

• volatile-lru：使用LRU算法移除key，只对设置了过期时间的键
• allkeys-lru：使用LRU算法移除key
• volatile-random：在过期集合中移除随机的key，只对设置了过期时间的键
• allkeys-random：移除随机的key
• volatile-ttl：移除那些TTL值最小的key，即那些最近要过期的key
• noeviction：不进行移除。针对写操作，只是返回错误信息

maxmemory-samples

默认值：maxmemory-samples 5。设置样本数量，LRU算法和最小TTL算法都并非是精确的算法，而是估算值，所以你可以设置样本的大小。

APPEND ONLY MODE

appendonly

默认值：appendonly no ，是否开启 AOF

appendfilename

默认值：appendfilename "appendonly.aof" ，指定AOF文件名。

appendfsync 

默认值：appendfsync everysec。设置向磁盘进行数据刷写的策略。

• always ：有新数据则马上刷写，速度慢但可靠性高
• everysec： 每秒钟刷写一次，折衷方法，所谓的redis可以只丢失1秒钟的数据就是源于此处
• no： 按照OS自身的刷写策略来进行

no-appendfsync-on-rewrite no 当主进程在进行向磁盘的写操作时，将会阻止其它的fsync调用
auto-aof-rewrite-percentage 100 aof文件触发自动rewrite的百分比，值为0则表示禁用自动rewrite
auto-aof-rewrite-min-size 64mb aof文件触发自动rewrite的最小文件size
aof-load-truncated yes 是否加载不完整的aof文件来进行启动

 

no-appendfsync-on-rewrite

在aof重写或者写入rdb文件的时候，会执行大量IO，此时对于everysec和always的aof模式来说，执行fsync会造成阻塞过长时间，no-appendfsync-on-rewrite字段设置为默认设置为no。如果对延迟要求很高的应用，这个字段可以设置为yes，否则还是设置为no，这样对持久化特性来说这是更安全的选择。   设置为yes表示rewrite期间对新写操作不fsync,暂时存在内存中,等rewrite完成后再写入，默认为no，建议yes。Linux的默认fsync策略是30秒。可能丢失30秒数据。默认值为no。

auto-aof-rewrite-percentage

默认值为100。aof自动重写配置，当目前aof文件大小超过上一次重写的aof文件大小的百分之多少进行重写，即当aof文件增长到一定大小的时候，Redis能够调用bgrewriteaof对日志文件进行重写。当前AOF文件大小是上次日志重写得到AOF文件大小的二倍（设置为100）时，自动启动新的日志重写过程。

auto-aof-rewrite-min-size

默认值：64mb。设置允许重写的最小aof文件大小，避免了达到约定百分比但尺寸仍然很小的情况还要重写。

aof-load-truncated

aof文件可能在尾部是不完整的，当redis启动的时候，aof文件的数据被载入内存。重启可能发生在redis所在的主机操作系统宕机后，尤其在ext4文件系统没有加上data=ordered选项，出现这种现象  redis宕机或者异常终止不会造成尾部不完整现象，可以选择让redis退出，或者导入尽可能多的数据。如果选择的是yes，当截断的aof文件被导入的时候，会自动发布一个log给客户端然后load。如果是no，用户必须手动redis-check-aof修复AOF文件才可以。默认值为 yes。

LUA SCRIPTING

lua-time-limit

一个lua脚本执行的最大时间，单位为ms。默认值为5000.

REDIS CLUSTER

cluster-enabled：集群开关，默认是不开启集群模式。

cluster-config-file：集群配置文件的名称，每个节点都有一个集群相关的配置文件，持久化保存集群的信息。 这个文件并不需要手动配置，这个配置文件有Redis生成并更新，每个Redis集群节点需要一个单独的配置文件。请确保与实例运行的系统中配置文件名称不冲突。默认配置为nodes-6379.conf。

cluster-node-timeout ：默认值15000。节点互连超时的阀值，集群节点超时毫秒数

cluster-slave-validity-factor ：默认值10。在进行故障转移的时候，全部slave都会请求申请为master，但是有些slave可能与master断开连接一段时间了，  导致数据过于陈旧，这样的slave不应该被提升为master。该参数就是用来判断slave节点与master断线的时间是否过长。判断方法是：比较slave断开连接的时间和(node-timeout * slave-validity-factor) + repl-ping-slave-period     如果节点超时时间为三十秒, 并且slave-validity-factor为10,假设默认的repl-ping-slave-period是10秒，即如果超过310秒slave将不会尝试进行故障转移

cluster-migration-barrier ：默认值1。master的slave数量大于该值，slave才能迁移到其他孤立master上，如这个参数若被设为2，那么只有当一个主节点拥有2 个可工作的从节点时，它的一个从节点会尝试迁移。

cluster-require-full-coverage：默认值 yes。默认情况下，集群全部的slot有节点负责，集群状态才为ok，才能提供服务。  设置为no，可以在slot没有全部分配的时候提供服务。