Redis 的配置文件

一、Units 单位

1. 配置大小单位,开头定义了一些基本的度量单位，只支持bytes，不支持 bit
2. 对大小写不敏感，eg：

   1k = 1000 bytes
   1kb = 1024 bytes
   1m = 1000000 bytes
   1mb = 1024 * 1024 bytes
   1g = 1000000000 bytes
   1gb = 1024 * 1024 * 1024 bytes
   

二、INCLUDES（包含）

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

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

三、GENERAL（通用）

1. daemonize：默认值 no，该参数用于定制 Redis 服务是否以守护模式运行
2. pidfile：默认值 /var/run/redis.pid，指定 Redis 服务的进程号文件路径，以守护模式运行时需要配置本参数
3. port：默认值 6379，指定 Redis 服务的端口
4. tcp-backlog：设置 tcp 的 backlog，backlog 其实是一个连接队列，backlog 队列总和 = 未完成三次握手队列 + 已经完成三次握手队列；在高并发环境下你需要一个高 backlog 值来避免慢客户端连接问题，新手学习暂保持默认值 511 即可来达到想要的效果
5. timeout：客户端空闲 n 秒后断开连接；默认是 0 表示不断开
6. bind：绑定 ip，默认是本机所有网络设备
7. tcp-keepalive：单位为秒，如果设置为 0，则不会进行 Keepalive 检测，建议设置成 60
8. loglevel：设置服务端的日志级别，有下列几种选择：
   (1) debug：记录详细信息，用于开发或调试
   (2) verbose：提供很多有用的信息，但是又不像 debug 那么详尽，默认就是这一选项
   (3) notice：适度提醒，多用于产品环境
   (4) warning：仅显示重要的警告信息
9. logfile：指定日志的输出路径，默认值 stdout，表示输出到屏幕，守护模式时则输出到 /dev/null
10. syslog-enabled：是否把日志输出到 syslog 中，默认该选项值为 no
11. syslog-ident：指定 syslog 里的日志标识，默认为 redis
12. syslog-facility：指定 syslog 设备，值可以是 USER 或 LOCAL0-LOCAL7，默认是 LOCAL10
13. databases：指定数据库的数量，默认为 16 个，默认使用的数据库是零号库

四、SNAPSHOTTING（快照）

1. save <seconds> <changes>：指定多长时间刷新快照至磁盘，这个选项有两个属性值，只有当两个属性值均满足时才会触发，也可以手动直接 save 一下，立即就会保存；可以设置多种级别，例如默认的参数文件中就设置了：
   save 900 1：每 900 秒 (15 分钟 ) 至少一次键值变更时被触发；
   save 300 10：每300秒(5分钟)至少10次键值变更时被触发；
   save 60 10000：每60秒至少10000次键值变更时被触发；
   save 900 1
save 300 10
save 60 10000
2. Stop-writes-on-bgsave-error：如果配置 no，表示你不在乎数据不一致或者有其他的手段发现和控制
3. rdbcompression yes：默认值 yes，当 dump 数据库时是否进行压缩存储。如果是的话，Redis 会采用 LZF 算法进行压缩；如果 CPU 资源比较紧张，可以设置为 no，选择不压缩
4. rdbchecksum yes：在存储快照后，还可以让 Redis 使用 CRC64 算法来进行数据校验，但是这样做会增加大约 10% 的性能消耗，如果希望获取到最大的性能提升，可以关闭此功能
5. dbfilename dump.rdb：默认值 dump.rdb，dump 到文件系统中的文件名
6. dir /usr/local/redis/db：默认值 ./，即当前目录，dump 出的数据文件的存储路径

五、REPLICATION（复制）

# slaveof <masterip> <masterport>  ##指定主端ip和端口，用于创建一个镜像服务
# masterauth <master-password>  ##如果master配置了密码的话，此处也需做设置；
slave-serve-stale-data yes  ##默认值yes。当slave丢失与master端的连接，或者复制仍在处理，那么slave会有下列两种表现：
# 当本参数值为yes时，slave为继续响应客户端请求，尽管数据已不同步甚至没有数据(出现在初次同步的情况下)；
# 当本参数值为no时，slave会返回"SYNC with master in progreee"的错误信息；
slave-read-only yes  ##默认从Redis是只读模式
# repl-ping-slave-period 10  ###默认值10，指定slave定期ping master的周期；
# repl-timeout 60  ##默认值60，指定超时时间。注意本参数包括批量传输数据和ping响应的时间

六、SECURITY（安全）

1. requirepass foobared：指定一个密码，客户端连接时也需要通过密码才能成功连接
   (1) 获取密码：config get requiredpass
   (2) 设置密码：config set requiredpass pass；设置密码之后，每次操作之前都要输一次密码：auth pass
2. rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52：重定义命令，例如将 CONFIG 命令更名为一个很复杂的名字
3. rename-command CONFIG “"：取消这个命令

七、LIMITS（限制）

1. maxclients 10000：指定客户端的最大并发连接数，默认是没有限制，直到 Redis 无法创建新的进程为止，设置该参数值为 0 也表示不限制，如果该参数指定了值，当并发连接达到指定值时，Redis 会关闭所有新连接，并返回 max number of clients reached 的错误信息
2. maxmemory <bytes>：设置 Redis 最大可使用内存。当达到最大内存后，Redis 会尝试按照设置的回收策略删除键值。如果无法删除键值，或者保留策略设置为不清除，那么 Redis 就会向发出内存的请求返回错误信息。当把 Redis 做为一级 LRU 的缓存时本参数较为有用
3. maxmemory-policy volatile-lru：默认值 volatile-lru，指定清除策略，有下列几种方法：
   (1) volatile-lru -> remove the key with an expire set using an LRU algorithm：使用 LRU 算法移除 key，只对设置了过期时间的键
   (2) allkeys-lru -> remove any key accordingly to the LRU algorithm：使用 LRU 算法移除 key
   (3) volatile-random -> remove a random key with an expire set：在过期集合中移除随机的 key，只对设置了过期时间的键
   (4) allkeys->random -> remove a random key, any key：移除随机的 key
   (5) volatile-ttl -> remove the key with the nearest expire time (minor TTL)：移除那些 TTL 值最小的 key，即那些最近要过期的 key
   (6) noeviction -> don’t expire at all, just return an error on write operations：不进行移除。针对写操作，只是返回错误信息
4. maxmemory-samples 3：默认值 3，设置样本数量，LRU 和最小 TTL 策略并非严谨的策略，而是大约估算的方式，因此可以选择取样值以便检查

八、APPEND ONLY MODE（追加）

1. appendonly no：默认值 no，指定是否启用直写模式
2. appendfilename appendonly.aof：直写模式的默认文件名 appendonly.aof
3. appendfsync：调用 fsync() 方式让操作系统写数据到磁盘上，数据同步方式，有下列几种模式：
   (1) always：同步持久化，每次发生数据变更会被立即记录到磁盘，性能较差但数据完整性比较好
   (2) everysec：出厂默认推荐，异步操作，每秒记录；如果一秒内宕机，有数据丢失
   (3) no：不调用 fsync，由操作系统决定何时同步，比如快照模式
   no-appendfsync-on-rewrite：重写时是否可以运用 appendfsync，用默认 no 即可，保证数据安全性
   auto-aof-rewrite-percentage：默认值 100，设置重写的基准值
   auto-aof-rewrite-min-size：默认值 64mb，设置重写的基准值，一般市场 3G 起步

九、ADVANCED CONFIG

1. hash-max-zipmap-entries：默认值 512，当某个 map 的元素个数达到最大值，但是其中最大元素的长度没有达到设定阀值时，其 HASH 的编码采用一种特殊的方式（更有效利用内存）。本参数与下面的参数组合使用来设置这两项阀值。设置元素个数
2. hash-max-zipmap-value：默认值 64，设置 map 中元素的值的最大长度
3. list-max-ziplist-entries：默认值 512，与 hash 类似，满足条件的 list 数组也会采用特殊的方式以节省空间
4. list-max-ziplist-value：默认值 64
5. set-max-intset-entries：默认值 512，当set类型中的数据都是数值类型，并且 set 中整型元素的数量不超过指定值时，使用特殊的编码方式
6. zset-max-ziplist-entries：默认值 128，与 hash 和 list 类似
7. zset-max-ziplist-value：默认值 64
8. activerehashing：默认值 yes，用来控制是否自动重建 hash。Active rehashing 每 100 微秒使用 1 微秒 cpu 时间排序，以重组 Redis 的 hash 表。重建是通过一种 lazy 方式，写入 hash 表的操作越多，需要执行 rehashing 的步骤也越多，如果服务器当前空闲，那么 rehashing 操作会一直执行。如果对实时性要求较高，难以接受 Redis 时不时出现的 2 微秒的延迟，则可以设置 activerehashing 为 no，否则建议设置为 yes，以节省内存空间

十、参数说明：redis.conf 配置项说明如下：

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