您现在的位置是：网站首页> 编程资料编程资料
redis2.8配置文件中文翻译版_Redis_
2023-05-27
330人已围观
简介 redis2.8配置文件中文翻译版_Redis_
# Redis 配置案例 #关于单位，当你需要指定内存的大小时，可以使用如下的单位来指定 #（译者注，为什么会存在1000为单位，我认为是考虑到硬盘的容量单位是以1000来进行计算而非程序中的1024） #（因此 使用 1000为单位可以进一步地精确估算出所需的实际硬盘容量） # # 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 ################################### # #如果你拥有一个标准的配置模板，并且希望在该模板之上坐一些个性化的修改，你可以 #使用include 指令来引入其他的配置文件。 # #注意："include" 不会被 admin 或者 Redis Sentinel "CONFIG REWRITE" 命令覆盖。 #（译者注："CONFIG REWRITE" 是redis 2.8 引入的新命令，用来重写配置） #由于redis以最终的配置作为实际配置，因此我们希望你将include命令放置在配置文件的最前面 #以防配置被覆盖 #如果你打算使用另外的 conf文件来覆盖当前文件的配置，那么最好将include指令放置到该文件的末尾 # # 即最后生效原则，最后被解析的配置将作为最后的配置 # # include /path/to/local.conf # include /path/to/other.conf ################################ GENERAL ##################################### # redis 默认不是以一个守护进程来运行的，使用 yes，可以让redis作为守护进程来运行 # 注意：当redis作为守护进程的时候 /var/run/redis.pid 作为 pid 文件 # daemonize no # 当redis以守护进程运行时，将会使用/var/run/redis.pid作为 pid文件的位置，也就是 #上一个指令所说的默认，你可以根据自己的需要修改它 # pidfile /var/run/redis.pid # 在指定的端口上进行监听，默认是 6379 # 如果端口设置为0，那么redis就不会在TCP socket上进行监听 # (译者注：不在tcp socket上进行监听，不代表没法连接，只是无法使用网络连接而已) port 6379 # TCP listen() backlog值 #（译者注：backlog值是指目前最大的连接队列，因为TCP连接是三次握手） #（没有完成三次握手和尚未被accept的connect都会处于连接队列中，但是backlog的实际值与操作系统相关） #（并非设置多少就是多少，只能说调整得大一些可以在同一时间应对更多的连接请求） # #在一个并发量高的环境中，你需要指定一个比较大的backlog值来避免慢连接（由于网络原因握手速度慢）的情况 #注意，linux内核会默认 使用/proc/sys/net/core/somaxconn 的值来削减 backlog的实际值， #因此你需要确保提升 somaxconn 和 tcp_max_syn_backlog 这两个值来确保此处的backlog生效 #（译者注：只有 当每一个请求都重新发起一个连接的时候，backlog值的增大才能影响到并发量） #（在tcp稳定连接的时候，或连接复用(连接池的使用)，backlog值对并发没有任何影响） # tcp-backlog 511 # #默认情况下redis会在所有的可用网络接口中进行监听，如果你想让redis在指定的网络接口中 #监听，那么可以使用bind 命令来指定redis的监听接口 #（译者科普：网络的中的服务是通过 ip+进程 来进行区分的，当一个服务器拥有两个ip时 ） #（自然就在网络中拥有两个人身份，如 内网，外网，当你只想让redis在一个网络上监听时，就可以使用如下的配置） # (127.0.0.1 就是指定只能本机进行网络访问) # 例如: # # bind 192.168.1.100 10.0.0.1 # bind 127.0.0.1 # #指定unix sock的路径来进行连接监听，默认是不指定，因此redis不会在unix socket上进行监听 #（译者注：这个是用来进行进程间通信的时候指定的） # unixsocket /tmp/redis.sock # unixsocketperm 755 # 关闭掉空闲N秒的连接（0则是不处理空闲连接） timeout 0 # TCP keepalive. # # #如果该值不为0，将使用 SO_KEEPALIVE 这一默认的做法来向客户端连接发送TCP ACKs # #这样的好处有以下两个原因 # 1）检测已经死亡的对端（译者注：TCP的关闭会存在无法完成4次握手的情况，如断电，断网，数据丢失等等） # 2）保持连接在网络环境中的存活 # # tcp-keepalive 0 # 指定日志的记录级别的 # 可以是如下的几个值之一 # debug (尽可能多的日志信息，用于开发和测试之中) # verbose (少但是有用的信息, 没有debug级别那么混乱) # notice (适量的信息，用于生产环境) # warning (只有非常重要和关键的信息会被记录) loglevel notice # 指定日志文件的位置. 为空时将输出到标准输出设备 # 如果你在demo模式下使用标准输出的日志，日志将会输出到 /dev/null logfile "" # 当设置 'syslog-enabled'为 yes时， 允许记录日志到系统日志中。 # 以及你可以使用更多的日志参数来满足你的要求 # syslog-enabled no # 指定在系统日志中的身份 # syslog-ident redis # 指定系统日志的能力. 必须是 LOCAL0 到 LOCAL7 之间（闭区间）. # syslog-facility local0 #设置数据库的编号. 默认的数据库是DB 0 #使得你可以在每一个连接的基础之上使用 SELECT来指定另外的数据库，但是这个值必须在 0到 'database'-1之间 databases 16 ################################ SNAPSHOTTING ################################ # # 保存 DB 到硬盘: # # save # # 将会在 和 两个值同时满足时，将DB数据保存到硬盘中 # 其中 每多少秒， 是改变的key的数量 # # 在以下的例子中，将会存在如下的行为 # 当存在最少一个key 变更时，900秒(15分钟)后保存到硬盘 # 当存在最少10个key变更时，300秒后保存到硬盘 # 当存在最少1000个key变更时，60秒后保存到硬盘 # # 提示: 你可以禁用如下的所有 save 行 # # 你可以删除所有的save然后设置成如下这样的情况 # # # # save "" save 900 1 save 300 10 save 60 10000 # # 作为默认，redis会在RDB快照开启和最近后台保存失败的时候停止接受写入(最少一个保存点) #这会使得用户察觉（通常比较困难）到数据不会保持在硬盘上的正确性，否则很难发现 #这些灾难会发生 # # 如果后台保存程序再次开始工作，reidis会再次自动允许写入 # #然而如果对redis服务器设置了合理持续的监控，那么你可以关闭掉这个选项。 #这会导致redis将继续进行工作，无论硬盘，权限或者其他的是否有问题 # # stop-writes-on-bgsave-error yes # 是否在dump到 rdb 数据库的时候使用LZF来压缩字符串 # 默认是 yes，因为这是一个优良的做法 # # 如果你不想耗费你的CPU处理能力，你可以设置为 no，但是这会导致你的数据会很大 rdbcompression yes # 从RDB的版本5开始，CRC64校验值会写入到文件的末尾 #这会使得格式化过程中，使得文件的完整性更有保障，但是这会在保存和加载的时候损失不少的性能(大概在10%) #你可以关闭这个功能来获得最高的性能 # #RDB文件会在校验功能关闭的时候，使用0来作为校验值，这将告诉加载代码来跳过校验步骤 rdbchecksum yes # DB的文件名称 dbfilename dump.rdb # 工作目录. # # DB将会使用上述 'dbfilename'指定的文件名写入到该目录中 # # 追加的文件也会在该目录中创建 # # 注意，你应该在这里输入的是一个目录而不是一个文件名 dir ./ ################################# REPLICATION ################################# # 主从复制。使用 slaveof 命令来 指导redis从另一个redis服务的拷贝中来创建一个实例 # #注意：这个配置是主从结构的从（主从结构的从，怎么那么拗口呢）redis的本地配置 # #如下例子，这个配置指导 slave (从redis) 通过另一个redis的实例的ip和端口号来获取DB数据 # # # # slaveof # # 如果主服务器开启了密码保护(使用下面的"requirepass"配置) # 这个配置就是告诉从服务在发起向主服务器的异步复制的请求之前使用如下的密码进行认证， #否则主服务器会拒绝这个请求 # # # # masterauth # # 如果从服务器失去了和主服务器之间的连接，或者当复制仍然处于处理状态的时候 # 从服务器做出如下的两个行为 # # 1）如果 slave-serve-stale-data 被设置为 yes(默认值)，从服务器将会持续 # 回复来自客户端的请求，可能会回复已经过期的数据，或者返回空的数据，当从服务器第一次异步请求数据时。 # # 2）如果 slave-serve-stale-data 被设置为 no ，从服务器就会返回"SYNC with master in progress" # 这个错误，来应答所有命令除了 INFO 和 SLAVEOF # slave-serve-stale-data yes # # # 你可以配置一个从服务器的实例是否接受写请求， # 从服务器在存储一些短暂的数据的的时候，接收写请求是一件非常正确的事情 # （因为数据在向主服务器同步之后非常容易擦除）但是会因为配置不正确而导致一些问题 # # 从redis 2.6开始默认从服务器是只读的服务器 # # # #提示：只读的从服务器并不是设计用来公开给不受信任的互联网客户端的，它 #仅仅是一个用来防止对实例进行误操作的保护层。只读从服务器默认用来输出管理命令 #例如 CONFIG, DEBUG 和其他。如果你想限制它的规模，你可以使用'rename-command'来 #提高它的安全性，使得她作为一个影子来执行管理或者危险的命令 # # slave-read-only yes # 从服务器在预设的间隔中发送送一个ping到目标服务器。你可以通过修改repl-ping-slave-period #的值来修改它，默认是10秒钟 # # # repl-ping-slave-period 10 # repl-timeout设置了以下的复制超时值: # # 1) 在从服务器中，使用同步IO进行大规模传输. # 2) 在从服务器中，主服务器的超时(ping，数据) # 3) 在主服务器中. 从服务器的超时(对pings的响应) # # # 确保这个值大于 指定的repl-ping-slave-period 值，否则当主从之间是低流量时 # 会检测到超时的情况 # # repl-timeout 60 # 在从服务器同步之后是否关闭TCP_NODELAY? # # # 如果你选择 "yes"，redis将会使用一个很小的TCP包和很小的带宽来向从服务器发送数据。 # 如果使用默认的设置这会增加数据复制到从服务器之间的延迟。如果使用默认配置的linux内核 # 这个延迟会高达到40毫秒 # # #如果你选择 "no"，数据复制到从服务器将会减少延迟，但是会使用更多的带宽。 # #作为默认我们为低延迟进行优化，但是在一个高流量的情况下或者当主服务器和从服务器 #有很多hops的时候，将该值设置为yes会更好 # (译者注：这就是一个网络调优的问题，默认的TCP内核会使用Nagle，即将小的数据包合并成大的数据包(及yes的情况)) # (在等待合并的过程种，肯定会存在等待后续数据的步骤，因此这会导致数据的延迟) # (yes，就是使用TCP的默认情况开启Nagle算法，no就是关闭Nagle算法) repl-disable-tcp-nodelay no # # #设置复制的backlog值。(这个backlog和tcp中的backlog不一样) # #这个backlog值是一个缓冲区，当从服务器断开连接之后，主服务器将更新的数据放置 #在这个缓冲区中，因为当从服务重新连接上来时候不是所有的数据都需要同步，因此从这个 #缓冲区中取数据就可以同步到和主服务器一样的状态 # # #这个值设置得越大，从服务器的掉线时间就可以越长，上线后就可以进行局部更新 #（译者注：当掉线时间过长而无法进行局部更新，那么从服务器就会再一次进行同步所有的数据，耗时和当时的数据量成正比） #当且仅当第一个从服务器连接到服务器之后这个缓存才会被分配 # # repl-backlog-size 1mb # # # 当从服务器在长时间内没有连接到主服务器时，backlog的缓存将会被释放。 # 以下的选项就是自 从服务器最后一次断掉和主服务器之间的 # 连接开始N秒后清空backlog的缓存 # # 设置为0意味着永远不会清空backlog # # repl-backlog-ttl 3600 # # # 在redis的信息输出中我们使用一个整型值来表示从服务器的优先值 # #这个优先级的作用是，在主从结构种，当主服务器不能正常工作的时候时候， #将一个从服务器提升为主服务器，提升的依据就是这个值。 # # 假设又三个 优先级分别为 25 10 100 的服务器，将优先将数值最少的提升为主服务器 # 即最小值优先 # 如果优先级设置为0，意味着将不会又机会成为主服务器 # 默认优先级是100 slave-priority 100 # # 下面的值用来设置主服务器停止接受写入事件的情况。 # 如果从服务器的连接小于N # 从服务器的数据落后 小于等于M秒 # # N个从服务器必须是在线的状态 # # lag的单位是秒，它必须 <=指定的值，它从最后一次收到ping包的时间开始计算。 # 通常ping包都是每秒发送一次 # # # 这个选项并不担保N个副本都会接受写入，但是会确保在指定的时间没有足够的从服务可用的时候 # 窗口上显示丢失写入 # # # 例如要求最少三个从服务器在lag<=10秒 # # min-slaves-to-write 3 # min-slaves-max-lag 10 # # 设置任意一个为0都会导致关闭这项特性 # # 默认min-slaves-to-write 设置为0(关闭这个特性) # min-slaves-max-lag 设置为10 ################################## SECURITY ################################### # # 要求客户端在处理其他指令之前先发起AUTH # # 这在你不信任其他的接入主机上的redis-server是比较有用 # # 这个选项应当注释掉来保证向后的兼容性，毕竟大部分的人都不需要鉴权验证(因为他们都运行自己的sever) # # #注意，由于redis太快，所以每秒钟可以尝试150K次密码，因此你应该设置一个 #非常强壮的密码来防止别人的破解 # # requirepass foobared # 命令重命名. # # # 它用来改变共享环境中危险命令的名字，在这个例子中 # CONFIG 命令被重命名为一个难以猜解的名字。 # 这会对内部用户的工具有效，但是对一般的客户端无效。 # # Example: # # rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52 # # # 可以使用一个空字符串来抹杀这个命令 # # rename-command CONFIG "" # # 请注意，改变记录在AOF文件中的命令名称或者传输到从服务会导致问题 # AOF file or transmitted to slaves may cause problems. ################################### LIMITS #################################### # # 设置同一时间的客户端最大连接数，默认的限制是10000个客户端。 #然而如果redis服务不设置这个限制值那么最大的用户数就是最大文件描述符数-32. # # #一旦连接的用户数超出了限制值，redis将会关闭新的连接并且发送 'max number of client reached' # # maxclients 10000 # 不使用超出指定大小的内存， #当redis使用到的内存达到限定值的时候，将会根据淘汰策略试图移除一部分key # # # 如果根据相关策略无法移除key，或者策略被设置为 'noeviction'，redis将会对 #使用到内存的命令返回错误，比如 SET LPUSH等，并且进入只读模式仅仅响应只读的命令如GET # # 这个选项在你将redis当做一个LRU缓存和设置一个内存大小限制的时候十分有用。 # # # # 警告：如果你的从服务器关联到一个有最大内存限制的redis实例上， # # 主服务器向从服务器输出的缓存属于被该服务器使用的内存的一部分。 #因此 网络问题和重新同步引发的复制，不会触发淘汰key的循环， # #反过来，从服务器的输出缓存将会被触发淘汰的DEL key，直到数据库清空 # # # #简单来说，如果你拥有一个从服务器，我们建议你将这个值 #设置为少于系统可用的最大内存，以便系统可以腾出空间来安放 #从服务器的输出缓存（但是如果策略是noeviction 那就没这个必要） # # maxmemory # 最大内存策略: 当redis使用的内存达到指定的最大值时，你可以使用如下的5种 # 策略来应对这种情况 # # volatile-lru -> 使用LRU算法依据过期时间来移除key # allkeys-lru -> 使用LRU算法来移除任何key # volatile-random -> 根据过期时间设置随即移除key # allkeys-random -> 随即移除任何一个key # volatile-ttl -> 移除一个最近过期时间的key # noeviction -> 所有key用不过期(即不移除任何key)，对于任何写操作都返回一个错误信息 # # 提示: 在以上的所有策略中，当不存在一个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，并且挑选其中之一作为最近最少的Key，你可以使用如下参数修改例子的数量大小 # # # maxmemory-samples 3 ############################## APPEND ONLY MODE ############################### # Redis默认使用异步存储数据到硬盘上. # # 这个模式非常合适一些应用，但是当redis的进程出现问题 # 或者停电的时候，会丢失一些写入的数据(丢失的多少根据保存点的设置) # # # Append Only 文件(Append Only file)，是一个备选的持久化模型， # 它提供了更好的续航能力，对于一个使用默认数据同步文件策略的实例 #redis可能会因为一个戏剧性的灾难比如停电等丢失一秒钟的数据 # #或者由于redis进程本身的错误仅仅写入一个数据，但操作系统一直运行 # # # # AOF和RDB可以毫无问题地共存，因此你可以同时开启他们， # # 如果你开启了AOF,redis会在启动时加载AOF，因为AOF有更好的鲁棒性 # # 你可以从 http://redis.io/topics/persistence 获取更多的信息 appendonly no # append only file 的名称 (默认是: "appendonly.aof") appendfilename "appendonly.aof" # fsync() 调用告诉操作系统立即将数据写入到硬盘中，而不是写入到输出缓冲区 # 等待足够的数据再写入。一些操作系统会立即将数据写入到硬盘中，一些其他的 #操作系统则只是尽可能快地将数据写入硬盘中 # # # Redis支持三种不同的模式: # # no:不进行强制同步，仅仅让操作系统根据自身的决策写入到硬盘中。这种速度更快 # always:在每一次追加写入操作都采用强制同步，特点是慢，安全。 # everysec：每间隔一秒钟强制同步数据。折中的方案 # # # 默认采用 "everysec"作为速度和安全性之间的平衡方案 # 你将根据自己的需求决定采用更快的方案或者更安全的方案。 # 选择no，何时写入数据将由操作系统决定，你可以由此获取最快的速度 # 选择always，数据将立即写入到硬盘中，你可以获得更高的数据安全性 # # 更多的信息可以从以下地址中获取: # http://antirez.com/post/redis-persistence-demystified.html # # 如果不开启该选项默认使
点击排行
本栏推荐
