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的值,所以需要确认增大somaxconntcp_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 <bytes>

    设置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 <seconds> <changes>
    Redis默认配置文件中提供了三个条件:

    save 900 1
    save 300 10
    save 60 10000
    

分别表示900秒(15分钟)内有1个更改,300秒(5分钟)内有10个更改以及60秒内有10000个更改。

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

    rdbcompression yes
    
  2. 指定本地数据库文件名,默认值为dump.rdb

    dbfilename dump.rdb
    
  3. 指定本地数据库存放目录

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

    slaveof <masterip> <masterport>
    
  5. 当master服务设置了密码保护时,slav服务连接master的密码

    masterauth <master-password>
    
  6. 设置Redis连接密码,如果配置了连接密码,客户端在连接Redis时需要通过AUTH 命令提供密码,默认关闭

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

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

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

    appendonly no
    
  10. 指定更新日志文件名,默认为appendonly.aof

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

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

    vm-enabled no
    
  13. 虚拟内存文件路径,默认值为/tmp/redis.swap,不可多个Redis实例共享

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

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

    vm-page-size 32
    
  16. 设置swap文件中的page数量,由于页表(一种表示页面空闲或使用的bitmap)是在放在内存中的,,在磁盘上每8个pages将消耗1byte的内存。

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

    vm-max-threads 4
    
  18. 设置在向客户端应答时,是否把较小的包合并为一个包发送,默认为开启

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

    hash-max-zipmap-entries 64
    hash-max-zipmap-value 512
    
  20. 指定是否激活重置哈希,默认为开启(后面在介绍Redis的哈希算法时具体介绍)

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

    include /path/to/local.conf
    
posted @ 2020-03-21 23:58  雲無月  阅读(334)  评论(0编辑  收藏  举报