redis2.8配置文件中文翻译版

# 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 <dbid> 来指定另外的数据库，但是这个值必须在 0到 'database'-1之间

databases 16

################################ SNAPSHOTTING ################################
#
# 保存 DB 到硬盘:
#
#  save <seconds> <changes>
#
#  将会在<seconds> 和 <changes>两个值同时满足时，将DB数据保存到硬盘中
#  其中<seconds> 每多少秒，<changes>是改变的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 <masterip> <masterport>


#
# 如果主服务器开启了密码保护(使用下面的"requirepass"配置)
# 这个配置就是告诉从服务在发起向主服务器的异步复制的请求之前使用如下的密码进行认证，
#否则主服务器会拒绝这个请求
#
#
#
# masterauth <master-password>


#
# 如果从服务器失去了和主服务器之间的连接，或者当复制仍然处于处理状态的时候
# 从服务器做出如下的两个行为
#
# 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-peri