Redis配置文件详解

UNITS单位

配置大小单位,开头定义了一些基本的度量单位，只支持bytes，不支持bit.单位大小写不敏感 1GB 1Gb 1gB 是一样的。

# 1g => 1000000000 bytes
# 1gb => 1024*1024*1024 bytes

INCLUDES包含

• 和Struts2配置文件类似，可以通过includes包含，redis.conf可以作为总闸，包含其他配置文件。

  Include文件可以加载其他额外配置文件，其他配置文件（other.conf）中如果含有与此文件重复的配置项，将不会被重写。

  换句话说，在此导入后，会被本文件(redis.conf)下面定义的同类配置重写，即使用最新的配置，各个配置文件形成互补配置。

# include /path/to/local.conf
# include /path/to/other.conf

GENERAL通用

• daemonize yes

  默认情况下，Redis不是在后台运行的，如果需要在后台运行，把该项的值更改为 yes。

• pidfile /var/run/redis_6379.pid

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

NETWORK网络

• port 6379

  监听端口，默认为 6379

• #bind 127.0.0.1

  指定Redis只接收来自于该IP地址的请求，如果不进行设置，那么将处理所有请求，在生产环境中为了安全最好设置该项。默认注释掉，不开启。

• tcp-backlog 511

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

• timeout 0

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

• Tcp-keepalive 300

  单位为秒，指定 TCP 连接是否为长连接,"侦探"信号有 server 端维护。默认为 0,表示禁用,则不会进行Keepalive检测

• loglevel notice

  log等级分为4级，debug,verbose, notice,和warning。生产环境下一般开启 notice

• logfile stdout

  配置log文件地址，默认使用标准输出，即打印在命令行终端的窗口上，修改为日志文件目录

• Syslog-enabled no

  是否把日志输出到syslog中

• Syslog-ident redis

  指定syslog里的日志标志

• Syslog-facility local0

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

• databases 16

  设置数据库的个数，可以使用SELECT命令来切换数据库。默认 16 个库

SNAPSHOTTING快照

• save 900 1
  save 300 10
  save 60 10000

  保存数据快照的频率，即将数据持久化到 dump.rdb 文件中的频度。用来描述"在多少秒期间至少多少个变更操作"触发 snapshot 数据保存动作。默认设置，意思是：

  if(在 60  秒之内有 10000 个 keys  发生变化时){
  进行镜像备份
  }else if(在 300  秒之内有 10 个 keys  发生了变化){
  进行镜像备份
  }else if(在 900  秒之内有 1 个 keys  发生了变化){
  进行镜像备份
  }
  

• stop-writes-on-bgsave-error yes

  当持久化出现错误时，是否依然继续进行工作，是否终止所有的客户端 write 请求。默认设置"yes"表示终止，一旦 snapshot 数据保存故障，那么此 server 为只读服务。如果为"no"，那么此次 snapshot 将失败，但下一次 snapshot 不会受到影响，不过如果出现故障,数据只能恢复到"最近一个成功点"

• rdbcompression yes

  对于存储到磁盘中的快照，可以设置是否进行压缩存储。如果是的话，redis会采用LZF算法进行压缩。在进行数据镜像备份时，是否启用 rdb 文件压缩手段，默认为 yes。

  压缩可能需要额外的cpu 开支，不过这能够有效的减小 rdb 文件的大，有利于存储/备份/传输/数据恢复，如果你不想消耗CPU来进行压缩的话，可以设置为关闭此功能。

• rdbchecksum yes

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

• dbfilename dump.rdb

  镜像备份文件的文件名，默认为 dump.rdb

• dir ./
  数据库镜像备份的文件 rdb/AOF 文件放置的路径。这里的路径跟文件名要分开配置是因为
  Redis 在进行备份时，先会将当前数据库的状态写入到一个临时文件中，等备份完成时，
  再把该临时文件替换为上面所指定的文件，而这里的临时文件和上面所配置的备份文件都会
  放在这个指定的路径当中。

REPLICATION复制

暂略

SECURITY安全

访问密码的查看、设置和取消

暂略

LIMITS限制

• maxclients 10000

设置redis同时可以与多少个客户端进行连接。默认情况下为10000个客户端。当你无法设置进程文件句柄限制，redis会设置为当前的文件句柄限制值减去32，因为redis会为自身内部处理逻辑留一些句柄出来。如果达到了此限制，redis则会拒绝新的连接请求，并且向这些连接请求方发出“max number of clients reached”以作回应。

• maxmemory

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

  但是对于无内存申请的指令，仍然会正常响应，比如GET等。如果你的redis是主redis（说明你的redis有从redis），那么在设置内存使用上限时，需要在系统中留出一些内存空间给同步队列缓存，只有在你设置的是“不移除”的情况下，才不用考虑这个因素。

• Maxmemory-policy noeviction

  （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：不进行移除。针对写操作，只是返回错误信息

• maxmemory-samples 5

  设置样本数量，LRU算法和最小TTL算法都并非是精确的算法，而是估算值，所以你可以设置样本的大小，
  redis默认会检查这么多个key并选择其中LRU的那个

APPEND ONLY MODE追加

暂略

总结：常见配置redis.conf介绍

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 命令在连接上指定数据库id

   databases 16
   

9. 指定在多长时间内，有多少次更新操作，就将数据同步到数据文件，可以多个条件配合
   save
   Redis默认配置文件中提供了三个条件：

   save 900 1
   save 300 10
   save 60 10000
   

分别表示900秒（15分钟）内有1个更改，300秒（5分钟）内有10个更改以及60秒内有10000个更改。

9. 指定存储至本地数据库时是否压缩数据，默认为yes，Redis采用LZF压缩，如果为了节省CPU时间，可以关闭该选项，但会导致数据库文件变的巨大

   rdbcompression yes
   

10. 指定本地数据库文件名，默认值为dump.rdb

    dbfilename dump.rdb
    

11. 指定本地数据库存放目录

    dir ./
    

12. 设置当本机为slav服务时，设置master服务的IP地址及端口，在Redis启动时，它会自动从master进行数据同步

    slaveof  
    

13. 当master服务设置了密码保护时，slav服务连接master的密码

    masterauth 
    

14. 设置Redis连接密码，如果配置了连接密码，客户端在连接Redis时需要通过AUTH 命令提供密码，默认关闭

    requirepass foobared
    

15. 设置同一时间最大客户端连接数，默认无限制，Redis可以同时打开的客户端连接数为Redis进程可以打开的最大文件描述符数，如果设置 maxclients 0，表示不作限制。当客户端连接数到达限制时，Redis会关闭新的连接并向客户端返回max number of clients reached错误信息

    maxclients 128
    

16. 指定Redis最大内存限制，Redis在启动时会把数据加载到内存中，达到最大内存后，Redis会先尝试清除已到期或即将到期的Key，当此方法处理 后，仍然到达最大内存设置，将无法再进行写入操作，但仍然可以进行读取操作。Redis新的vm机制，会把Key存放内存，Value会存放在swap区

    maxmemory 
    

17. 指定是否在每次更新操作后进行日志记录，Redis在默认情况下是异步的把数据写入磁盘，如果不开启，可能会在断电时导致一段时间内的数据丢失。因为 redis本身同步数据文件是按上面save条件来同步的，所以有的数据会在一段时间内只存在于内存中。默认为no

    appendonly no
    

18. 指定更新日志文件名，默认为appendonly.aof

    appendfilename appendonly.aof
    

19. 指定更新日志条件，共有3个可选值：
    no：表示等操作系统进行数据缓存同步到磁盘（快）
    always：表示每次更新操作后手动调用fsync()将数据写到磁盘（慢，安全）
    everysec：表示每秒同步一次（折衷，默认值）
    appendfsync everysec

20. 指定是否启用虚拟内存机制，默认值为no，简单的介绍一下，VM机制将数据分页存放，由Redis将访问量较少的页即冷数据swap到磁盘上，访问多的页面由磁盘自动换出到内存中（在后面的文章我会仔细分析Redis的VM机制）

    vm-enabled no
    

21. 虚拟内存文件路径，默认值为/tmp/redis.swap，不可多个Redis实例共享

    vm-swap-file /tmp/redis.swap
    

22. 将所有大于vm-max-memory的数据存入虚拟内存,无论vm-max-memory设置多小,所有索引数据都是内存存储的(Redis的索引数据 就是keys),也就是说,当vm-max-memory设置为0的时候,其实是所有value都存在于磁盘。默认值为0

    vm-max-memory 0
    

23. Redis swap文件分成了很多的page，一个对象可以保存在多个page上面，但一个page上不能被多个对象共享，vm-page-size是要根据存储的 数据大小来设定的，作者建议如果存储很多小对象，page大小最好设置为32或者64bytes；如果存储很大大对象，则可以使用更大的page，如果不 确定，就使用默认值

    vm-page-size 32
    

24. 设置swap文件中的page数量，由于页表（一种表示页面空闲或使用的bitmap）是在放在内存中的，，在磁盘上每8个pages将消耗1byte的内存。

    vm-pages 134217728
    

25. 设置访问swap文件的线程数,最好不要超过机器的核数,如果设置为0,那么所有对swap文件的操作都是串行的，可能会造成比较长时间的延迟。默认值为4

    vm-max-threads 4
    

26. 设置在向客户端应答时，是否把较小的包合并为一个包发送，默认为开启

    glueoutputbuf yes
    

27. 指定在超过一定的数量或者最大的元素超过某一临界值时，采用一种特殊的哈希算法

    hash-max-zipmap-entries 64
    hash-max-zipmap-value 512
    

28. 指定是否激活重置哈希，默认为开启（后面在介绍Redis的哈希算法时具体介绍）

    activerehashing yes
    

29. 指定包含其它的配置文件，可以在同一主机上多个Redis实例之间使用同一份配置文件，而同时各个实例又拥有自己的特定配置文件

    include /path/to/local.conf