Redis参考手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
directory search
Redis 基础教程 Redis 教程 Redis 安装 Redis 配置 Redis 数据类型 Redis 命令 Redis 命令 Redis 键(key) Redis DEL 命令 Redis Dump 命令 Redis EXISTS 命令 Redis Expire 命令 Redis Expireat 命令 Redis PEXPIREAT 命令 Redis PEXPIREAT 命令 Redis Keys 命令 Redis Move 命令 Redis PERSIST 命令 Redis Pttl 命令 Redis TTL 命令 Redis RANDOMKEY 命令 Redis Rename 命令 Redis Renamenx 命令 Redis Type 命令 Redis 字符串(String) Redis SET 命令 Redis Get 命令 Redis Getrange 命令 Redis Getset 命令 Redis Getbit 命令 Redis Mget 命令 Redis Setbit 命令 Redis Setex 命令 Redis Setnx 命令 Redis Setrange 命令 Redis Strlen 命令 Redis Mset 命令 Redis Msetnx 命令 Redis Psetex 命令 Redis Incr 命令 Redis Incrby 命令 Redis Incrbyfloat 命令 Redis Decr 命令 Redis Decrby 命令 Redis Append 命令 Redis 哈希(Hash) Redis Hdel 命令 Redis Hexists 命令 Redis Hget 命令 Redis Hgetall 命令 Redis Hincrby 命令 Redis Hincrbyfloat 命令 Redis Hkeys 命令 Redis Hlen 命令 Redis Hmget 命令 Redis Hmset 命令 Redis Hset 命令 Redis Hsetnx 命令 Redis Hvals 命令 Redis 列表(List) Redis Blpop 命令 Redis Brpop 命令 Redis Brpoplpush 命令 Redis Lindex 命令 Redis Linsert 命令 Redis Llen 命令 Redis Lpop 命令 Redis Lpush 命令 Redis Lpushx 命令 Redis Lrange 命令 Redis Lrem 命令 Redis Lset 命令 Redis Ltrim 命令 Redis Rpop 命令 Redis Rpoplpush 命令 Redis Rpush 命令 Redis Rpushx 命令 Redis 集合(Set) Redis Sadd 命令 Redis Scard 命令 Redis Sdiff 命令 Redis Sdiffstore 命令 Redis Sinter 命令 Redis Sinterstore 命令 Redis Sismember 命令 Redis Smembers 命令 Redis Smove 命令 Redis Spop 命令 Redis Srandmember 命令 Redis Srem 命令 Redis Sunion 命令 Redis Sunionstore 命令 Redis Sscan 命令 Redis 有序集合(sorted set) Redis Zadd 命令 Redis Zcard 命令 Redis Zcount 命令 Redis Zincrby 命令 Redis Zinterstore 命令 Redis Zlexcount 命令 Redis Zrange 命令 Redis Zrangebylex 命令 Redis Zrangebyscore 命令 Redis Zrank 命令 Redis Zrem 命令 Redis Zremrangebylex 命令 Redis Zremrangebyrank 命令 Redis Zremrangebyscore 命令 Redis Zrevrange 命令 Redis Zrevrangebyscore 命令 Redis Zrevrank 命令 Redis Zscore 命令 Redis Zunionstore 命令 Redis Zscan 命令 Redis HyperLogLog Redis Pfadd 命令 Redis Pfcount 命令 Redis Pgmerge 命令 Redis 发布订阅 Redis Psubscribe 命令 Redis Pubsub 命令 Redis Publish 命令 Redis Punsubscribe 命令 Redis Subscribe 命令 Redis Unsubscribe 命令 Redis 事务 Redis Discard 命令 Redis Exec 命令 Redis Multi 命令 Redis Unwatch 命令 Redis Watch 命令 Redis 脚本 Redis Eval 命令 Redis Evalsha 命令 Redis Script Exists 命令 Redis Script Flush 命令 Redis Script kill 命令 Redis Script Load 命令 Redis 连接 Redis Auth 命令 Redis Echo 命令 Redis Ping 命令 Redis Quit 命令 Redis Select 命令 Redis 服务器 Redis Bgrewriteaof 命令 Redis Bgsave 命令 Redis Client Kill 命令 Redis Client List 命令 Redis Client Getname 命令 Redis Client Pause 命令 Redis Client Setname 命令 Redis Cluster Slots 命令 Redis Command 命令 Redis Command Count 命令 Redis Command Getkeys 命令 Redis Time 命令 Redis Command Info 命令 Redis Config Get 命令 Redis Config rewrite 命令 Redis Config Set 命令 Redis Config Resetstat 命令 Redis Dbsize 命令 Redis Debug Object 命令 Redis Debug Segfault 命令 Redis Flushall 命令 Redis Flushdb 命令 Redis Info 命令 Redis Lastsave 命令 Redis Monitor 命令 Redis Role 命令 Redis Save 命令 Redis Shutdown 命令 Redis Slaveof 命令 Redis Showlog 命令 Redis Sync 命令 Redis 高级教程 Redis 数据备份与恢复 Redis 安全 Redis 性能测试 Redis 客户端连接 Redis 管道技术 Redis 分区 Java 使用 Redis PHP 使用 Redis

©
This document usesPHP Chinese website manualRelease

characters

Redis 配置

Redis 的配置文件位于 Redis 安装目录下，文件名为 redis.conf。

你可以通过CONFIG命令查看或设置配置项。

语法3>

Redis CONFIG 命令格式如下：

redis 127.0.0.1:6379> CONFIG GET CONFIG_SETTING_NAME

实例

redis 127.0.0.1:6379> CONFIG GET loglevel 1) "loglevel" 2) "notice"

使用*号获取所有配置项：

实例

redis 127.0.0.1:6379> CONFIG GET * 1) "dbfilename" 2) "dump.rdb" 3) "requirepass" 4) "" 5) "masterauth" 6) "" 7) "unixsocket" 8) "" 9) "logfile" 10) "" 11) "pidfile" 12) "/var/run/redis.pid" 13) "maxmemory" 14) "0" 15) "maxmemory-samples" 16) "3" 17) "timeout" 18) "0" 19) "tcp-keepalive" 20) "0" 21) "auto-aof-rewrite-percentage" 22) "100" 23) "auto-aof-rewrite-min-size" 24) "67108864" 25) "hash-max-ziplist-entries" 26) "512" 27) "hash-max-ziplist-value" 28) "64" 29) "list-max-ziplist-entries" 30) "512" 31) "list-max-ziplist-value" 32) "64" 33) "set-max-intset-entries" 34) "512" 35) "zset-max-ziplist-entries" 36) "128" 37) "zset-max-ziplist-value" 38) "64" 39) "hll-sparse-max-bytes" 40) "3000" 41) "lua-time-limit" 42) "5000" 43) "slowlog-log-slower-than" 44) "10000" 45) "latency-monitor-threshold" 46) "0" 47) "slowlog-max-len" 48) "128" 49) "port" 50) "6379" 51) "tcp-backlog" 52) "511" 53) "databases" 54) "16" 55) "repl-ping-slave-period" 56) "10" 57) "repl-timeout" 58) "60" 59) "repl-backlog-size" 60) "1048576" 61) "repl-backlog-ttl" 62) "3600" 63) "maxclients" 64) "4064" 65) "watchdog-period" 66) "0" 67) "slave-priority" 68) "100" 69) "min-slaves-to-write" 70) "0" 71) "min-slaves-max-lag" 72) "10" 73) "hz" 74) "10" 75) "no-appendfsync-on-rewrite" 76) "no" 77) "slave-serve-stale-data" 78) "yes" 79) "slave-read-only" 80) "yes" 81) "stop-writes-on-bgsave-error" 82) "yes" 83) "daemonize" 84) "no" 85) "rdbcompression" 86) "yes" 87) "rdbchecksum" 88) "yes" 89) "activerehashing" 90) "yes" 91) "repl-disable-tcp-nodelay" 92) "no" 93) "aof-rewrite-incremental-fsync" 94) "yes" 95) "appendonly" 96) "no" 97) "dir" 98) "/home/deepak/Downloads/redis-2.8.13/src" 99) "maxmemory-policy" 100) "volatile-lru" 101) "appendfsync" 102) "everysec" 103) "save" 104) "3600 1 300 100 60 10000" 105) "loglevel" 106) "notice" 107) "client-output-buffer-limit" 108) "normal 0 0 0 slave 268435456 67108864 60 pubsub 33554432 8388608 60" 109) "unixsocketperm" 110) "0" 111) "slaveof" 112) "" 113) "notify-keyspace-events" 114) "" 115) "bind" 116) ""

编辑配置

你可以通过修改 redis.conf 文件或使用CONFIG set命令来修改配置。

语法

CONFIG SET命令基本语法：

redis 127.0.0.1:6379> CONFIG SET CONFIG_SETTING_NAME NEW_CONFIG_VALUE

实例

redis 127.0.0.1:6379> CONFIG SET loglevel "notice" OK redis 127.0.0.1:6379> CONFIG GET loglevel 1) "loglevel" 2) "notice"

参数说明

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

Redis默认配置文件中提供了三个条件：

save 900 1

save 300 10

save 60 10000

分别表示900秒（15分钟）内有1个更改，300秒（5分钟）内有10个更改以及60秒内有10000个更改。

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

rdbcompression yes

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

dbfilename dump.rdb

12. 指定本地数据库存放目录

dir ./

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

slaveof

14. 当master服务设置了密码保护时，slav服务连接master的密码

masterauth

15. 设置Redis连接密码，如果配置了连接密码，客户端在连接Redis时需要通过AUTH 命令提供密码，默认关闭

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

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

appendonly no

19. 指定更新日志文件名，默认为appendonly.aof

appendfilename appendonly.aof

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

appendfsync 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. 指定是否激活重置哈希，默认为开启（后面在介绍Redis的哈希算法时具体介绍）

activerehashing yes

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

include /path/to/local.conf

Previous article： Next article：