Redis的配置

Redis基本配置说明

Redis的配置文件为redis.conf，以下为Redis的常用配置，当修改了配置文件后，需要重启Redis生效。

daemonize：如需要在后台运行，把该项的值改为yes
pdifile：把pid文件放在/var/run/redis.pid，可以配置到其他地址
bind：指定redis只接收来自该IP的请求，如果不设置，那么将处理所有请求，在生产环节中最好设置该项
port：监听端口，默认为6379
timeout：设置客户端连接时的超时时间，单位为秒
loglevel：等级分为4级，debug，revbose，notice和warning。生产环境下一般开启notice
logfile：配置log文件地址，默认使用标准输出，即打印在命令行终端的端口上
database：设置数据库的个数，默认使用的数据库是0
save：设置redis进行数据库镜像的频率
rdbcompression：在进行镜像备份时，是否进行压缩
dbfilename：镜像备份文件的文件名
dir：数据库镜像备份的文件放置的路径
slaveof：设置该数据库为其他数据库的从数据库
masterauth：当主数据库连接需要密码验证时，在这里设定
requirepass：设置客户端连接后进行任何其他指定前需要使用的密码
maxclients：限制同时连接的客户端数量
maxmemory：设置redis能够使用的最大内存
appendonly：开启appendonly模式后，redis会把每一次所接收到的写操作都追加到appendonly.aof文件中，当redis重新启动时，会从该文件恢复出之前的状态
appendfsync：设置appendonly.aof文件进行同步的频率
vm_enabled：是否开启虚拟内存支持
vm_swap_file：设置虚拟内存的交换文件的路径
vm_max_momery：设置开启虚拟内存后，redis将使用的最大物理内存的大小，默认为0
vm_page_size：设置虚拟内存页的大小
vm_pages：设置交换文件的总的page数量
vm_max_thrrads：设置vm IO同时使用的线程数量

常用配置

1、Redis默认不是以守护进程的方式运行，可以通过该配置项修改，使用yes启用守护进程daemonize no。

2、当Redis以守护进程方式运行时，Redis默认会把pid写入/var/run/redis.pid文件，可以通过pidfile指定。pidfile /var/run/redis.pid。

3、指定Redis监听端口，默认端口为6379。 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。

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

11、指定本地数据库文件名，默认值为dump.rdb。dbfilename dump.rdb。

12、指定本地数据库存放目录。dir ./。

13 设置当本机为slav服务时，设置master服务的IP地址及端口，在Redis启动时，它会自动从master进行数据同步。slaveof <masterip> <masterport>。

14、当master服务设置了密码保护时，slav服务连接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、指定更新日志条件，appendfsync everysec，共有3个可选值：

• no：表示等操作系统进行数据缓存同步到磁盘（快）

• always：表示每次更新操作后手动调用fsync()将数据写到磁盘（慢，安全）

• everysec：表示每秒同步一次（折衷，默认值）

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

Units（单位）

# Redis configuration file example.
#
# Note that in order to read the configuration file, Redis must be
# started with the file path as first argument:
#（请注意：为了读取配置文件，Redis必须以文件路径作为第一个参数启动）
# ./redis-server /path/to/redis.conf

# Note on units: when memory size is needed, it is possible to specify
# it in the usual form of 1k 5GB 4M and so forth:
#（关于单位的说明：当需要内存大小时，可以指定，通常的形式是1k 5GB 4M等等）
#
# 1k => 1000 bytes
# 1kb => 1024 bytes
# 1m => 1000000 bytes
# 1mb => 1024*1024 bytes
# 1g => 1000000000 bytes
# 1gb => 1024*1024*1024 bytes
#
# units are case insensitive so 1GB 1Gb 1gB are all the same.
#（单元不区分大小写，因此1GB 1GB 1GB都是相同的。）

INCLUDES（包含）

和我们的spring配置文件类似，可以通过includes包含，redis.conf可以作为主配置文件，包含其他。

##################### INCLUDES（包括） ################################

# Include one or more other config files here.  This is useful if you
# have a standard template that goes to all Redis servers but also need
# to customize a few per-server settings.  Include files can include
# other files, so use this wisely.
#（在此包含一个或多个其他配置文件。如果你有一个标准的模板配置所有的Redis服务器，
#但也需要为每个服务器自定义一些设置。包含文件可以包括其他文件，所以要明智地使用它。）

# Notice option "include" won't be rewritten by command "CONFIG REWRITE"
# from admin or Redis Sentinel. Since Redis always uses the last processed
# line as value of a configuration directive, you'd better put includes
# at the beginning of this file to avoid overwriting config change at runtime.
#（注意选项“include”从管理员或Redis Sentinel不会被命令“CONFIG REWRITE”重写。
#因为Redis总是使用最后处理的行作为配置指令的值，最好将includes放入，以避免在运行时覆盖配置更改。）

# If instead you are interested in using includes to override configuration
# options, it is better to use include as the last line.
#（如果您对使用include重写配置感兴趣，选择最好使用include作为最后一行。）

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

MODULES（模块）

######################### MODULES（模块） #############################

# Load modules at startup. If the server is not able to load modules
# it will abort. It is possible to use multiple loadmodule directives.
#（启动时加载模块。如果服务器无法加载模块，它将中止。可以使用多个loadmodule指令。）

# loadmodule /path/to/my_module.so
# loadmodule /path/to/other_module.so

NETWORK（网络）

默认情况下，如果没有指定bind配置指令，则Redis侦听用于连接服务器上所有可用的网络接口。

可以只监听一个或多个选择的接口bind配置指令，后面跟着一个或多个IP地址。

1、bind：默认情况下，redis 在 server 上所有有效的网络接口上监听客户端连接。如果只想让它在一个或多个网络接口上监听，那就绑定一个IP或者多个IP。多个ip空格分隔即可。

bind 127.0.0.1

2、prot：运行端口

port 6379

3、tcp-backlog：设置tcp的backlog，backlog其实是一个连接队列，backlog队列总和=未完成三次握手队列 + 已经完成三次握手队列。

在高并发环境下需要一个高backlog值来避免慢客户端连接问题。注意Linux内核会将这个值减小到/proc/sys/net/core/somaxconn的值，所以需要确认增大somaxconn和tcp_max_syn_backlog两个值来达到想要的效果。

tcp-backlog 511

4、timeout：当客户端闲置多少秒后关闭连接，如果设置为0表示关闭该功能。如：timeout 0。

5、tcp-keepalive 300：单位是秒，表示将周期性的使用SO_KEEPALIVE检测客户端是否还处于健康状态，避免服务器一直阻塞，官方给出的建议值是300秒，建议设置成60。

GENERAL（总则）

daemonize no：是否以守护模式启动，默认为no，配置为yes时以守护模式启动，这时redis instance会将进程号pid写入默认文件/var/run/redis.pid。

supervised no：可以通过upstart和systemd管理Redis守护进程，这个参数是和具体的操作系统相关的。

pidfile /var/run/redis_6379.pid ：配置pid文件路径。当redis以守护模式启动时，如果没有配置pidfile，pidfile默认值是/var/run/redis.pid 。

loglevel notice ：日志级别。可选项有：debug（记录大量日志信息，适用于开发、测试阶段）； verbose（较多日志信息）； notice（适量日志信息，使用于生产环境）；warning（仅有部分重要、关键信息才会被记录）。

logfile ""：日志文件的位置，当指定为空字符串时，为标准输出，如果redis已守护进程模式运行，那么日志将会输出到 /dev/null 。

syslog-enabled no：是否把日志记录到系统日志。

syslog-ident：设置系统日志的id， 如 ：syslog-ident redis。

databases 16：设置数据库的数目。默认的数据库是DB 0 ，可以在每个连接上使用select 命令选择一个不同的数据库，dbid是一个介于0到databases - 1 之间的数值。

always-show-logo yes：是否一直显示日志。

SNAPSHOTTING（快照）

save ：保存数据到磁盘。格式是：save <seconds> <changes>，含义是在 seconds 秒之后至少有 changes个keys发生改变则保存一次。如：

save 900 1    	#900秒有一条数据改变就保存
save 300 10    	#300秒有10条数据改变就保存
save 60 10000  	#600秒有10000条数据改变就保存

stop-writes-on-bgsave-error yes，默认情况下，如果 redis 最后一次的后台保存失败，redis 将停止接受写操作，这样以一种强硬的方式让用户知道数据不能正确的持久化到磁盘， 否则就会没人注意到灾难的发生。 如果后台保存进程重新启动工作了，redis 也将自动的允许写操作。然而你要是安装了靠谱的监控，你可能不希望 redis 这样做，那你就改成 no 好了。

rdbcompression yes：是否在dump.rdb数据库的时候压缩字符串，默认设置为yes。如果你想节约一些cpu资源的话，可以把它设置为no，这样的话数据集就可能会比较大。

rdbchecksum yes：是否CRC64校验rdb文件，会有一定的性能损失（大概10%）。

dbfilename dump.rdb：rdb文件的名字。

SECURITY（安全）

################################## SECURITY （安全）########################

#（要求客户端在处理任何其他文件之前发出AUTH<PASSWORD> 命令。这在您不信任的环境中可能很有用
#其他人可以访问运行redis服务器的主机。）
#（为了向后兼容，这应该保持注释，因为大多数人们不需要auth（例如，他们运行自己的服务器）。）
#（警告：由于Redis速度很快，外部用户可以尝试每秒15万个密码。
#这意味着你应该使用一个非常强的密码，否则很容易被破解。）

# requirepass foobared

# Command renaming.（命令重命名。）
#可以更改共享中危险命令的名称环境。例如，CONFIG命令可能被重命名为xx
#很难猜测，所以它仍然可以用于内部使用的工具但不适用于一般客户端。
# Example:
# rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52
#（也可以通过将命令重命名为空字符串）
# rename-command CONFIG ""
#（请注意，更改登录到AOF文件或传输到副本可能会导致问题。）

主要用于访问密码和查看，设置和取消。

CLIENTS（客户端）

maxclients 10000

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

################################### CLIENTS （客户端）#########################
#设置同时连接的客户端的最大数量。默认情况下10000个客户端。
#但是，如果Redis服务器没有能够配置进程文件限制以允许指定的限制
#允许的最大客户端数设置为当前文件限制减32（因为Redis保留了一些文件描述符供内部使用）。
# 一旦达到限制，Redis将关闭所有的新连接并发送错误：“已达到最大客户端数”。

# maxclients 10000

MEMORY MANAGEMENT（内存管理）

maxmemory <bytes>

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

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

maxmemory-policy

1、volatile-lru：使用LRU算法移除key，只对设置了过期时间的键。

2、allkeys-lru：使用LRU算法移除key。

3、volatile-lfu：在具有expire集的密钥中使用近似的LFU进行逐出。

4、allkeys-lfu：使用近似的LFU逐出任何密钥。

5、volatile-random：在过期集合中移除随机的key，只对设置了过期时间的键。

6、allkeys-random：移除随机的key。

7、volatile-ttl：移除那些TTL值最小的key，即那些最近要过期的key。

8、noeviction：不进行移除。针对写操作，只是返回错误信息。

maxmemory-samples

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

其它配置说明

• REPLICATION（复制）：主从复制相关。

• APPEND ONLY MODE（仅附加模式）：表示追加，与持久化配置相关。

• LAZY FREEING（懒释放）

• LUA SCRIPTING（LUA脚本）

• REDIS CLUSTER（redis集群）

• CLUSTER DOCKER/NAT support （集群docker/nat支持）

• SLOW LOG （慢日志）

• LATENCY MONITOR （延迟监视器）

• EVENT NOTIFICATION（事件通知）

• ADVANCED CONFIG（高级配置）

• ACTIVE DEFRAGMENTATION （活动碎片整理）