readis 配置文件详解

1、include

解释：引入其它配置文件。比如说当你有多个server，而有一些配置项是它们公用的，那么你可以将这些公用的配置项写进一个配置文件common.conf里，然后这些server再include这个配置文件，这些server自己的配置项则分别写在自己的配置文件里。

示例：include /path/to/common.conf

2、loadmodule

解释：此配置项尚未了解。注释是这样的：启动时加载模块，如果server无法加载模块，则此配置会被忽略。可以使用多个loadmodule。
示例：loadmodule /path/to/my_module.so

3、bind

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

示例： bind 192.168.1.100 10.0.0.1
bind 127.0.0.1 ::1

4、protected-mode

解释：当开启后，禁止公网访问redis。它启用的条件有两个，第一是没有使用bind，第二是没有设置访问密码。

示例：protected-mode yes

5、port

解释：指定该redis server监听的端口号。默认是6379，如果指定0则不监听。

示例：port 6379

6、tcp-backlog

解释：此参数确定了TCP连接中已完成队列(完成三次握手之后)的长度， 当然此值必须不大于Linux系统定义的/proc/sys/net/core/somaxconn值，默认是511，而Linux的默认参数值是128。当系统并发量大并且客户端速度缓慢的时候，可以将这二个参数一起参考设定。
示例：tcp-backlog 511
7、unixsocket
解释：指定 unix socket 的路径。
示例：unixsocket /tmp/redis.sock
8、unixsocketperm
解释：指定 unix socket file 的权限。

示例：unixsocketperm 755
9、timeout

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

示例：timeout 30
10、tcp-keepalive
解释：单位是秒，表示将周期性的使用SO_KEEPALIVE检测客户端是否还处于健康状态，避免服务器一直阻塞，官方给出的建议值是300S
示例：tcp-keepalive 300

11、daemonize

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

示例：daemonize yes

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

示例：supervised no

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

14、loglevel

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

示例：loglevel notice

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

示例：logfile ""

16、syslog-enabled

解释：是否把日志记录到系统日志。（何意？）
示例：syslog-enabled no
17、syslog-ident

解释：设置系统日志的id

示例：syslog-ident redis
18、syslog-facility
解释：指定syslog设备(facility)，必须是user或则local0到local7。

示例：syslog-facility local0

19、databases

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

&nbsp;

20、save

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

示例：
save 900 1
save 300 10
save 60 10000

21、stop-writes-on-bgsave-error

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

22、rdbcompression

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

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

示例：rdbchecksum yes

24、dbfilename

解释：rdb文件的名字。

示例：dbfilename dump.rdb
25、dir
解释：数据库存放目录。必须是一个目录，aof文件也会保存到该目录下。

示例：dir ./
26、slaveof

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

示例：slaveof 192.168.0.1 6379

27、masterauth
解释：当master服务设置了密码保护时，slav服务连接master的密码。

示例：masterauth 123456
28、slave-serve-stale-data

解释：当一个slave与master失去联系时，或者复制正在进行的时候，slave应对请求的行为：1) 如果为 yes（默认值） ，slave 仍然会应答客户端请求，但返回的数据可能是过时，或者数据可能是空的在第一次同步的时候；2) 如果为 no ，在你执行除了 info 和 salveof 之外的其他命令时，slave 都将返回一个 "SYNC with master in progress" 的错误。
示例：slave-serve-stale-data yes
29、slave-read-only

解释：设置slave是否是只读的。从2.6版起，slave默认是只读的。

示例：slave-read-only yes

30、repl-diskless-sync
解释：主从数据复制是否使用无硬盘复制功能。

示例：repl-diskless-sync no

31、repl-ping-slave-period

解释：指定slave定期ping master的周期，默认10秒钟。

示例：repl-ping-slave-period 10

32、repl-timeout

解释：设置主库批量数据传输时间或者ping回复时间间隔，默认值是60秒 。
示例：repl-timeout 60

33、repl-disable-tcp-nodelay
解释：指定向slave同步数据时，是否禁用socket的NO_DELAY选 项。若配置为“yes”，则禁用NO_DELAY，则TCP协议栈会合并小包统一发送，这样可以减少主从节点间的包数量并节省带宽，但会增加数据同步到 slave的时间。若配置为“no”，表明启用NO_DELAY，则TCP协议栈不会延迟小包的发送时机，这样数据同步的延时会减少，但需要更大的带宽。 通常情况下，应该配置为no以降低同步延时，但在主从节点间网络负载已经很高的情况下，可以配置为yes。

示例：repl-disable-tcp-nodelay no
34、repl-backlog-size

解释：设置主从复制backlog容量大小。这个 backlog 是一个用来在 slaves 被断开连接时存放 slave 数据的 buffer，所以当一个 slave 想要重新连接，通常不希望全部重新同步，只是部分同步就够了，仅仅传递 slave 在断开连接时丢失的这部分数据。这个值越大，salve 可以断开连接的时间就越长。

示例：repl-backlog-size 1mb

35、repl-backlog-ttl
解释：配置当master和slave失去联系多少秒之后，清空backlog释放空间。当配置成0时，表示永远不清空。

示例：repl-backlog-ttl 3600

36、slave-priority
解释：当 master 不能正常工作的时候，Redis Sentinel 会从 slaves 中选出一个新的 master，这个值越小，就越会被优先选中，但是如果是 0 ， 那是意味着这个 slave 不可能被选中。 默认优先级为 100。

示例：slave-priority 100
37、requirepass

解释：设置redis连接密码。

示例：requirepass foobared
38、rename-command
解释：将命令重命名。为了安全考虑，可以将某些重要的、危险的命令重命名。当你把某个命令重命名成空字符串的时候就等于取消了这个命令。

示例：rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52

rename-command CONFIG ""
39、maxclients

解释：设置客户端最大并发连接数，默认无限制，Redis可以同时打开的客户端连接数为Redis进程可以打开的最大文件描述符数-32（redis server自身会使用一些），如果设置 maxclients 0，表示不作限制。当客户端连接数到达限制时，Redis会关闭新的连接并向客户端返回max number of clients reached错误信息。

示例：maxclients 10000
40、maxmemory
解释： 指定Redis最大内存限制，Redis在启动时会把数据加载到内存中，达到最大内存后，Redis会先尝试清除已到期或即将到期的Key，当此方法处理 后，仍然到达最大内存设置，将无法再进行写入操作，但仍然可以进行读取操作。Redis新的vm机制，会把Key存放内存，Value会存放在swap区，格式：maxmemory &lt;bytes&gt;　。

示例：maxmemory　1024000

41、maxmemory-policy
解释：当内存使用达到最大值时，redis使用的清楚策略。有以下几种可以选择（明明有6种，官方配置文件里却说有5种可以选择？）：

1）volatile-lru 利用LRU算法移除设置过过期时间的key (LRU:最近使用 Least Recently Used )
2）allkeys-lru 利用LRU算法移除任何key

3）volatile-random 移除设置过过期时间的随机key

4）allkeys-random 移除随机key
5）volatile-ttl 移除即将过期的key(minor TTL)

6）noeviction noeviction 不移除任何key，只是返回一个写错误 。默认选项
示例：maxmemory-policy noeviction

42、maxmemory-samples
解释：LRU 和 minimal TTL 算法都不是精准的算法，但是相对精确的算法(为了节省内存)，随意你可以选择样本大小进行检测。redis默认选择3个样本进行检测，你可以通过maxmemory-samples进行设置 样本数。

示例：maxmemory-samples 5
43、appendonly

解释：是否启用aof持久化方式 。即是否在每次更新操作后进行日志记录，默认配置是no，即在采用异步方式把数据写入到磁盘，如果不开启，可能会在断电时导致部分数据丢失。

示例：appendonly no

44、appendfilename

解释：更新日志文件名，默认值为appendonly.aof 。

示例：appendfilename "appendonly.aof"
45、appendfsync

解释：aof文件刷新的频率。有三种：

1）no 依靠OS进行刷新，redis不主动刷新AOF，这样最快，但安全性就差。
2) always 每提交一个修改命令都调用fsync刷新到AOF文件，非常非常慢，但也非常安全。
3) everysec 每秒钟都调用fsync刷新到AOF文件，很快，但可能会丢失一秒以内的数据。
示例：appendfsync everysec
46、no-appendfsync-on-rewrite
解释：指定是否在后台aof文件rewrite期间调用fsync，默认为no，表示要调用fsync（无论后台是否有子进程在刷盘）。Redis在后台写RDB文件或重写AOF文件期间会存在大量磁盘IO，此时，在某些linux系统中，调用fsync可能会阻塞。

示例：no-appendfsync-on-rewrite no

47、auto-aof-rewrite-percentage

解释：当AOF文件增长到一定大小的时候Redis能够调用 BGREWRITEAOF 对日志文件进行重写 。当AOF文件大小的增长率大于该配置项时自动开启重写。

示例：auto-aof-rewrite-percentage 100

48、auto-aof-rewrite-min-size

&nbsp;

解释：当AOF文件增长到一定大小的时候Redis能够调用 BGREWRITEAOF 对日志文件进行重写 。当AOF文件大小大于该配置项时自动开启重写。

示例：auto-aof-rewrite-min-size 64mb

49、aof-load-truncated
解释：redis在启动时可以加载被截断的AOF文件，而不需要先执行 redis-check-aof 工具。

示例：aof-load-truncated yes

50、lua-time-limit

解释：一个Lua脚本最长的执行时间，单位为毫秒，如果为0或负数表示无限执行时间，默认为5000。

示例：lua-time-limit 5000


Redis 的 master/slave 复制：

Redis 的 master/slave 数据复制方式可以是一主一从或者是一主多从的方式，Redis 在
master 是非阻塞模式，也就是说在 slave 执行数据同步的时候，master 是可以接受客户端的
请求的，并不影响同步数据的一致性，然而在 slave 端是阻塞模式的，slave 在同步 master
数据时，并不能够响应客户端的查询
Redis 的 master/slave 模式下，master 提供数据读写服务，而 slave 只提供读服务

Redis 的 master/slave 的配置方式是在 slave 主机的 Redis 目录下的 redis.conf 配置文件中
添加：
slaveof master_ip master_port

例如：
我们配置我们的 slave 为：redis-slave.conf
daemonize yes
pidfile redis-slave.pid
port 6380
timeout 300
loglevel verbose
logfile stdout
databases 16
save 900 1
save 300 10
save 60 10000
rdbcompression yes
dbfilename dump-slave.rd

dir /home/falcon/redis-2.0.0/
slaveof 127.0.0.1 6379
appendonly no
appendfsync everysec
vm-enabled no
vm-swap-file logs/redis-slave.swap
vm-max-memory 0
vm-page-size 32

m-pages 134217728
vm-max-threads 4
glueoutputbuf yes
hash-max-zipmap-entries 64
hash-max-zipmap-value 512
activerehashing yes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316