总配置redis.conf 详解

# Redis 配置文件示例

# 注意单位: 当需要配置内存大小时, 可能需要指定像1k,5GB,4M等常见格式

#

# 1k => 1000 bytes

# 1kb => 1024 bytes

# 1m => 1000000 bytes

# 1mb => 1024*1024 bytes

# 1g => 1000000000 bytes

# 1gb => 1024*1024*1024 bytes

#

# 单位是对大小写不敏感的 1GB 1Gb 1gB 是相同的。

################################## INCLUDES 包含文件相关

###################################

# 可以在这里包含一个或多个其他的配置文件。如果你有一个适用于所有Redis服务器的标准配置模板

# 但也需要一些每个服务器自定义的设置，这个功能将很有用。被包含的配置文件也可以包含其他配置文

件，

# 所以需要谨慎的使用这个功能。

#

# 注意“inclue”选项不能被admin或Redis哨兵的"CONFIG REWRITE"命令重写。

# 因为Redis总是使用最后解析的配置行最为配置指令的值, 你最好在这个文件的开头配置includes来

# 避免它在运行时重写配置。

# 如果相反你想用includes的配置覆盖原来的配置，你最好在该文件的最后使用include

#

# include /path/to/local.conf

# include /path/to/other.conf

################################ GENERAL 综合配置

#####################################

# 默认Rdis不会作为守护进程运行。如果需要的话配置成'yes'

# 注意配置成守护进程后Redis会将进程号写入文件/var/run/redis.pid

daemonize no

# 当以守护进程方式运行时，默认Redis会把进程ID写到 /var/run/redis.pid。你可以在这里修改路

径。

pidfile /var/run/redis.pid

# 接受连接的特定端口，默认是6379

# 如果端口设置为0，Redis就不会监听TCP套接字。

port 6379

# TCP listen() backlog.

# server在与客户端建立tcp连接的过程中，SYN队列的大小

# 在高并发环境下你需要一个高backlog值来避免慢客户端连接问题。注意Linux内核默默地将这个值减小

# 到/proc/sys/net/core/somaxconn的值，所以需要确认增大somaxconn和tcp_max_syn_backlog

# 两个值来达到想要的效果。

tcp-backlog 511

# 默认Redis监听服务器上所有可用网络接口的连接。可以用"bind"配置指令跟一个或多个ip地址来实现

# 监听一个或多个网络接口

#

# 示例:

#

# bind 192.168.1.100 10.0.0.1

# bind 127.0.0.1

# 指定用来监听Unix套套接字的路径。没有默认值， 所以在没有指定的情况下Redis不会监听Unix套接

字

#

# unixsocket /tmp/redis.sock

# unixsocketperm 755

# 一个客户端空闲多少秒后关闭连接。(0代表禁用，永不关闭)

timeout 0

# TCP keepalive.

#

# 如果非零，则设置SO_KEEPALIVE选项来向空闲连接的客户端发送ACK，由于以下两个原因这是很有用

的：

#

# 1）能够检测无响应的对端

# 2）让该连接中间的网络设备知道这个连接还存活

#

# 在Linux上，这个指定的值(单位：秒)就是发送ACK的时间间隔。

# 注意：要关闭这个连接需要两倍的这个时间值。

# 在其他内核上这个时间间隔由内核配置决定

#

# 这个选项的一个合理值是60秒

tcp-keepalive 0

# 指定服务器调试等级

# 可能值：

# debug （大量信息，对开发/测试有用）

# verbose （很多精简的有用信息，但是不像debug等级那么多）

# notice （适量的信息，基本上是你生产环境中需要的）

# warning （只有很重要/严重的信息会记录下来）

loglevel notice

# 指明日志文件名。也可以使用"stdout"来强制让Redis把日志信息写到标准输出上。

# 注意:如果Redis以守护进程方式运行，而设置日志显示到标准输出的话，日志会发送到/dev/null

logfile ""

# 要使用系统日志记录器，只要设置 "syslog-enabled" 为 "yes" 就可以了。

# 然后根据需要设置其他一些syslog参数就可以了。

# syslog-enabled no

# 指明syslog身份

# syslog-ident redis

# 指明syslog的设备。必须是user或LOCAL0 ~ LOCAL7之一。

# syslog-facility local0

# 设置数据库个数。默认数据库是 DB 0，

# 可以通过select <dbid> (0 <= dbid <= 'databases' - 1 ）来为每个连接使用不同的数据

库。

databases 16

################################ SNAPSHOTTING 快照，持久化操作配置

################################

#

# 把数据库存到磁盘上:

#

# save <seconds> <changes>

#

# 会在指定秒数和数据变化次数之后把数据库写到磁盘上。

#

# 下面的例子将会进行把数据写入磁盘的操作:

# 900秒（15分钟）之后，且至少1次变更

# 300秒（5分钟）之后，且至少10次变更

# 60秒之后，且至少10000次变更

#

# 注意：你要想不写磁盘的话就把所有 "save" 设置注释掉就行了。

#

# 通过添加一条带空字符串参数的save指令也能移除之前所有配置的save指令

# 像下面的例子：

# save ""

save 900 1

save 300 10

save 60 10000

# 默认如果开启RDB快照(至少一条save指令)并且最新的后台保存失败，Redis将会停止接受写操作

# 这将使用户知道数据没有正确的持久化到硬盘，否则可能没人注意到并且造成一些灾难。

#

# 如果后台保存进程能重新开始工作，Redis将自动允许写操作

#

# 然而如果你已经部署了适当的Redis服务器和持久化的监控，你可能想关掉这个功能以便于即使是

# 硬盘，权限等出问题了Redis也能够像平时一样正常工作，

stop-writes-on-bgsave-error yes

# 当导出到 .rdb 数据库时是否用LZF压缩字符串对象？

# 默认设置为 "yes"，因为几乎在任何情况下它都是不错的。

# 如果你想节省CPU的话你可以把这个设置为 "no"，但是如果你有可压缩的key和value的话，

# 那数据文件就会更大了。

rdbcompression yes

# 因为版本5的RDB有一个CRC64算法的校验和放在了文件的最后。这将使文件格式更加可靠但在

# 生产和加载RDB文件时，这有一个性能消耗(大约10%)，所以你可以关掉它来获取最好的性能。

#

# 生成的关闭校验的RDB文件有一个0的校验和，它将告诉加载代码跳过检查

rdbchecksum yes

# 持久化数据库的文件名

dbfilename dump.rdb

# 工作目录

#

# 数据库会写到这个目录下，文件名就是上面的 "dbfilename" 的值。

#

# 累加文件也放这里。

#

# 注意你这里指定的必须是目录，不是文件名。

dir ./

################################# REPLICATION 主从复制的配置

#################################

# 主从同步。通过 slaveof 指令来实现Redis实例的备份。

# 注意，这里是本地从远端复制数据。也就是说，本地可以有不同的数据库文件、绑定不同的IP、监听

# 不同的端口。

#

# slaveof <masterip> <masterport>

# 如果master设置了密码保护（通过 "requirepass" 选项来配置），那么slave在开始同步之前必须

# 进行身份验证，否则它的同步请求会被拒绝。

#

# masterauth <master-password>

# 当一个slave失去和master的连接，或者同步正在进行中，slave的行为有两种可能：

#

# 1) 如果 slave-serve-stale-data 设置为 "yes" (默认值)，slave会继续响应客户端请求，

# 可能是正常数据，也可能是还没获得值的空数据。

# 2) 如果 slave-serve-stale-data 设置为 "no"，slave会回复"正在从master同步

# （SYNC with master in progress）"来处理各种请求，除了 INFO 和 SLAVEOF 命令。

#

slave-serve-stale-data yes

# 你可以配置salve实例是否接受写操作。可写的slave实例可能对存储临时数据比较有用(因为写入

salve

# 的数据在同master同步之后将很容被删除)，但是如果客户端由于配置错误在写入时也可能产生一些问

题。

#

# 从Redis2.6默认所有的slave为只读

#

# 注意:只读的slave不是为了暴露给互联网上不可信的客户端而设计的。它只是一个防止实例误用的保护

层。

# 一个只读的slave支持所有的管理命令比如config,debug等。为了限制你可以用'rename-

command'来

# 隐藏所有的管理和危险命令来增强只读slave的安全性

slave-read-only yes

# slave根据指定的时间间隔向master发送ping请求。

# 时间间隔可以通过 repl_ping_slave_period 来设置。

# 默认10秒。

#

# repl-ping-slave-period 10

# 以下选项设置同步的超时时间

#

# 1）slave在与master SYNC期间有大量数据传输，造成超时

# 2）在slave角度，master超时，包括数据、ping等

# 3）在master角度，slave超时，当master发送REPLCONF ACK pings

#

# 确保这个值大于指定的repl-ping-slave-period，否则在主从间流量不高时每次都会检测到超时

#

# repl-timeout 60

# 是否在slave套接字发送SYNC之后禁用 TCP_NODELAY ？

#

# 如果你选择“yes”Redis将使用更少的TCP包和带宽来向slaves发送数据。但是这将使数据传输到

slave

# 上有延迟，Linux内核的默认配置会达到40毫秒

#

# 如果你选择了 "no" 数据传输到salve的延迟将会减少但要使用更多的带宽

#

# 默认我们会为低延迟做优化，但高流量情况或主从之间的跳数过多时，把这个选项设置为“yes”

# 是个不错的选择。

repl-disable-tcp-nodelay no

# 设置数据备份的backlog大小。backlog是一个slave在一段时间内断开连接时记录salve数据的缓

冲，

# 所以一个slave在重新连接时，不必要全量的同步，而是一个增量同步就足够了，将在断开连接的这段

# 时间内slave丢失的部分数据传送给它。

#

# 同步的backlog越大，slave能够进行增量同步并且允许断开连接的时间就越长。

#

# backlog只分配一次并且至少需要一个slave连接

#

# repl-backlog-size 1mb

# 当master在一段时间内不再与任何slave连接，backlog将会释放。以下选项配置了从最后一个

# slave断开开始计时多少秒后，backlog缓冲将会释放。

#

# 0表示永不释放backlog

#

# repl-backlog-ttl 3600

# slave的优先级是一个整数展示在Redis的Info输出中。如果master不再正常工作了，哨兵将用它来

# 选择一个slave提升=升为master。

#

# 优先级数字小的salve会优先考虑提升为master，所以例如有三个slave优先级分别为10，100，25，

# 哨兵将挑选优先级最小数字为10的slave。

#

# 0作为一个特殊的优先级，标识这个slave不能作为master，所以一个优先级为0的slave永远不会被

# 哨兵挑选提升为master

#

# 默认优先级为100

slave-priority 100

# 如果master少于N个延时小于等于M秒的已连接slave，就可以停止接收写操作。

#

# N个slave需要是“oneline”状态

#

# 延时是以秒为单位，并且必须小于等于指定值，是从最后一个从slave接收到的ping（通常每秒发送）

# 开始计数。

#

# This option does not GUARANTEES that N replicas will accept the write, but

# will limit the window of exposure for lost writes in case not enough slaves

# are available, to the specified number of seconds.

#

# 例如至少需要3个延时小于等于10秒的slave用下面的指令：

#

# min-slaves-to-write 3

# min-slaves-max-lag 10

#

# 两者之一设置为0将禁用这个功能。

#

# 默认 min-slaves-to-write 值是0（该功能禁用）并且 min-slaves-max-lag 值是10。

################################## SECURITY 安全相关配置

###################################

# 要求客户端在处理任何命令时都要验证身份和密码。

# 这个功能在有你不信任的其它客户端能够访问redis服务器的环境里非常有用。

#

# 为了向后兼容的话这段应该注释掉。而且大多数人不需要身份验证(例如:它们运行在自己的服务器上)

#

# 警告：因为Redis太快了，所以外面的人可以尝试每秒150k的密码来试图破解密码。这意味着你需要

# 一个高强度的密码，否则破解太容易了。

#

# requirepass foobared

# 命令重命名

#

# 在共享环境下，可以为危险命令改变名字。比如，你可以为 CONFIG 改个其他不太容易猜到的名字，

# 这样内部的工具仍然可以使用，而普通的客户端将不行。

#

# 例如：

#

# rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52

#

# 也可以通过改名为空字符串来完全禁用一个命令

#

# rename-command CONFIG ""

#

# 请注意：改变命令名字被记录到AOF文件或被传送到从服务器可能产生问题。

################################### LIMITS 范围配置

####################################

# 设置最多同时连接的客户端数量。默认这个限制是10000个客户端，然而如果Redis服务器不能配置

# 处理文件的限制数来满足指定的值，那么最大的客户端连接数就被设置成当前文件限制数减32（因

# 为Redis服务器保留了一些文件描述符作为内部使用）

#

# 一旦达到这个限制，Redis会关闭所有新连接并发送错误'max number of clients reached'

#

# maxclients 10000

# 不要用比设置的上限更多的内存。一旦内存使用达到上限，Redis会根据选定的回收策略（参见：

# maxmemmory-policy）删除key

#

# 如果因为删除策略Redis无法删除key，或者策略设置为 "noeviction"，Redis会回复需要更

# 多内存的错误信息给命令。例如，SET,LPUSH等等，但是会继续响应像Get这样的只读命令。

#

# 在使用Redis作为LRU缓存，或者为实例设置了硬性内存限制的时候（使用 "noeviction" 策略）

# 的时候，这个选项通常事很有用的。

#

# 警告：当有多个slave连上达到内存上限的实例时，master为同步slave的输出缓冲区所需

# 内存不计算在使用内存中。这样当驱逐key时，就不会因网络问题 / 重新同步事件触发驱逐key

# 的循环，反过来slaves的输出缓冲区充满了key被驱逐的DEL命令，这将触发删除更多的key，

# 直到这个数据库完全被清空为止

#

# 总之...如果你需要附加多个slave，建议你设置一个稍小maxmemory限制，这样系统就会有空闲

# 的内存作为slave的输出缓存区(但是如果最大内存策略设置为"noeviction"的话就没必要了)

#

# maxmemory <bytes>

# 最大内存策略：如果达到内存限制了，Redis如何选择删除key。你可以在下面五个行为里选：

#

# volatile-lru -> 根据LRU算法生成的过期时间来删除。

# allkeys-lru -> 根据LRU算法删除任何key。

# volatile-random -> 根据过期设置来随机删除key。

# allkeys->random -> 无差别随机删。

# volatile-ttl -> 根据最近过期时间来删除（辅以TTL）

# noeviction -> 谁也不删，直接在写操作时返回错误。

#

# 注意：对所有策略来说，如果Redis找不到合适的可以删除的key都会在写操作时返回一个错误。

#

# 目前为止涉及的命令：set setnx setex append

# incr decr rpush lpush rpushx lpushx linsert lset rpoplpush sadd

# sinter sinterstore sunion sunionstore sdiff sdiffstore zadd zincrby

# zunionstore zinterstore hset hsetnx hmset hincrby incrby decrby

# getset mset msetnx exec sort

#

# 默认值如下：

#

# maxmemory-policy volatile-lru

# LRU和最小TTL算法的实现都不是很精确，但是很接近（为了省内存），所以你可以用样本量做检测。

# 例如：默认Redis会检查3个key然后取最旧的那个，你可以通过下面的配置指令来设置样本的个数。

#

# maxmemory-samples 3

############################## APPEND ONLY MODE AOF模式配置

###############################

# 默认情况下，Redis是异步的把数据导出到磁盘上。这种模式在很多应用里已经足够好，但Redis进程

# 出问题或断电时可能造成一段时间的写操作丢失(这取决于配置的save指令)。

#

# AOF是一种提供了更可靠的替代持久化模式，例如使用默认的数据写入文件策略（参见后面的配置）

# 在遇到像服务器断电或单写情况下Redis自身进程出问题但操作系统仍正常运行等突发事件时，Redis

# 能只丢失1秒的写操作。

#

# AOF和RDB持久化能同时启动并且不会有问题。

# 如果AOF开启，那么在启动时Redis将加载AOF文件，它更能保证数据的可靠性。

#

# 请查看 http://redis.io/topics/persistence 来获取更多信息.

appendonly no

# 纯累加文件名字（默认："appendonly.aof"）

appendfilename "appendonly.aof"

# fsync() 系统调用告诉操作系统把数据写到磁盘上，而不是等更多的数据进入输出缓冲区。

# 有些操作系统会真的把数据马上刷到磁盘上；有些则会尽快去尝试这么做。

#

# Redis支持三种不同的模式：

#

# no：不要立刻刷，只有在操作系统需要刷的时候再刷。比较快。

 

# always：每次写操作都立刻写入到aof文件。慢，但是最安全。

# everysec：每秒写一次。折中方案。

#

# 默认的 "everysec" 通常来说能在速度和数据安全性之间取得比较好的平衡。根据你的理解来

# 决定，如果你能放宽该配置为"no" 来获取更好的性能(但如果你能忍受一些数据丢失，可以考虑使用

# 默认的快照持久化模式)，或者相反，用“always”会比较慢但比everysec要更安全。

#

# 请查看下面的文章来获取更多的细节

# http://antirez.com/post/redis-persistence-demystified.html

#

# 如果不能确定，就用 "everysec"

# appendfsync always

appendfsync everysec

# appendfsync no

# 如果AOF的同步策略设置成 "always" 或者 "everysec"，并且后台的存储进程（后台存储或写入AOF

# 日志）会产生很多磁盘I/O开销。某些Linux的配置下会使Redis因为 fsync()系统调用而阻塞很久。

# 注意，目前对这个情况还没有完美修正，甚至不同线程的 fsync() 会阻塞我们同步的write(2)调用。

#

# 为了缓解这个问题，可以用下面这个选项。它可以在 BGSAVE 或 BGREWRITEAOF 处理时阻止

fsync()。

#

# 这就意味着如果有子进程在进行保存操作，那么Redis就处于"不可同步"的状态。

# 这实际上是说，在最差的情况下可能会丢掉30秒钟的日志数据。（默认Linux设定）

#

# 如果把这个设置成"yes"带来了延迟问题，就保持"no"，这是保存持久数据的最安全的方式。

no-appendfsync-on-rewrite no

# 自动重写AOF文件

# 如果AOF日志文件增大到指定百分比，Redis能够通过 BGREWRITEAOF 自动重写AOF日志文件。

#

# 工作原理：Redis记住上次重写时AOF文件的大小（如果重启后还没有写操作，就直接用启动时的AOF大

小）

#

# 这个基准大小和当前大小做比较。如果当前大小超过指定比例，就会触发重写操作。你还需要指定被重写

# 日志的最小尺寸，这样避免了达到指定百分比但尺寸仍然很小的情况还要重写。

#

# 指定百分比为0会禁用AOF自动重写特性。

auto-aof-rewrite-percentage 100

auto-aof-rewrite-min-size 64mb

################################ LUA SCRIPTING ###############################

# 设置lua脚本的最大运行时间，单位为毫秒，redis会记个log，然后返回error。当一个脚本超过了最

大时限。只有SCRIPT KILL和SHUTDOWN NOSAVE可以用。第一个可以杀没有调write命令的东西。要是已

经调用了write，只能用第二个命令杀。

lua-time-limit 5000

################################## SLOW LOG ###################################

# 是redis用于记录慢查询执行时间的日志系统。由于slowlog只保存在内存中，因此slowlog的效率很

高，完全不用担心会影响到redis的性能。

# 只有query执行时间大于slowlog-log-slower-than的才会定义成慢查询，才会被slowlog进行记

录。

# 单位是微妙

slowlog-log-slower-than 10000

# slowlog-max-len表示慢查询最大的条数

slowlog-max-len 128

############################ EVENT NOTIFICATION ##############################

# 这个功能可以让客户端通过订阅给定的频道或者模式，来获知数据库中键的变化，以及数据库中命令的执

行情况，所以在默认配置下，该功能处于关闭状态。

# notify-keyspace-events 的参数可以是以下字符的任意组合，它指定了服务器该发送哪些类型的通

知：

# K 键空间通知，所有通知以 __keyspace@__ 为前缀

# E 键事件通知，所有通知以 __keyevent@__ 为前缀

# g DEL 、 EXPIRE 、 RENAME 等类型无关的通用命令的通知

# $ 字符串命令的通知

# l 列表命令的通知

# s 集合命令的通知

# h 哈希命令的通知

# z 有序集合命令的通知

# x 过期事件：每当有过期键被删除时发送

# e 驱逐(evict)事件：每当有键因为 maxmemory 政策而被删除时发送

# A 参数 g$lshzxe 的别名

# 输入的参数中至少要有一个 K 或者 E，否则的话，不管其余的参数是什么，都不会有任何 通知被分

发。详细使用可以参考http://redis.io/topics/notifications

notify-keyspace-events ""

############################### ADVANCED CONFIG ###############################

# 单位字节:数据量小于等于hash-max-ziplist-entries的用ziplist，大于hash-max-ziplist-

entries用hash

hash-max-ziplist-entries 512

# value大小小于等于hash-max-ziplist-value的用ziplist，大于hash-max-ziplist-value用

hash。

hash-max-ziplist-value 64

# 数据量小于等于list-max-ziplist-entries用ziplist(压缩列表)，大于list-max-ziplist-

entries用list。

list-max-ziplist-entries 512

# value大小小于等于list-max-ziplist-value的用ziplist，大于list-max-ziplist-value用

list。

list-max-ziplist-value 64

# 数据量小于等于set-max-intset-entries用iniset，大于set-max-intset-entries用set。

set-max-intset-entries 512

# 数据量小于等于zset-max-ziplist-entries用ziplist，大于zset-max-ziplist-entries用

zset。

zset-max-ziplist-entries 128

# value大小小于等于zset-max-ziplist-value用ziplist，大于zset-max-ziplist-value用

zset。

zset-max-ziplist-value 64

# 基数统计的算法 HyperLogLog 键只需要花费 12 KB 内存，就可以计算接近 2^64 个不同元素的基

数

# 设置HyeperLogLog的字节数限制，这个值通常在0~15000之间，默认为3000，基本不超过16000。

value大小小于等于hll-sparse-max-bytes使用稀疏数据结构（sparse），大于hll-sparse-max-

bytes使用稠密的数据结构（dense）。一个比16000大的value是几乎没用的，建议的value大概为

3000。如果对CPU要求不高，对空间要求较高的，建议设置到10000左右。

hll-sparse-max-bytes 3000

# 重置hash。 Redis将在每100毫秒时使用1毫秒的CPU时间来对redis的hash表进行重新hash，可以降

低内存的使用。当你的使用场景中，有非常严格的实时性需要，不能够接受Redis时不时的对请求有2毫秒

的延迟的话，把这项配置为no。如果没有这么严格的实时性要求，可以设置为yes，以便能够尽可能快的释

放内存。

activerehashing yes

# 对于Redis服务器的输出（也就是命令的返回值）来说，其大小通常是不可控制的。有可能一个简单的命

令，能够产生体积庞大的返回数据。另外也有可能因为执行了太多命令，导致产生返回数据的速率超过了往

客户端发送的速率，这是也会导致服务器堆积大量消息，从而导致输出缓冲区越来越大，占用过多内存，甚

至导致系统崩溃。

# 用于强制断开出于某些原因而无法以足够快的速度从服务器读取数据的客户端的连接。

#对于normal client，包括monitor。第一个0表示取消hard limit，第二个0和第三个0表示取消

soft limit，normal client默认取消限制，因为如果没有寻问，他们是不会接收数据的。

client-output-buffer-limit normal 0 0 0

#对于slave client和MONITER client，如果client-output-buffer一旦超过256mb，又或者超过

64mb持续60秒，那么服务器就会立即断开客户端连接。

client-output-buffer-limit slave 256mb 64mb 60

#对于pubsub client，如果client-output-buffer一旦超过32mb，又或者超过8mb持续60秒，那么

服务器就会立即断开客户端连接。

client-output-buffer-limit pubsub 32mb 8mb 60

# redis执行任务的频率

hz 10

# aof rewrite过程中,是否采取增量"文件同步"策略,默认为"yes",而且必须为yes.

# rewrite过程中,每32M数据进行一次文件同步,这样可以减少"aof大文件"写入对磁盘的操作次数.

aof-rewrite-incremental-fsync yes

 

通常情况下，默认的配置足够你解决问题！

没有极特殊的要求，不要乱改配置！