redis的配置

redis的配置

# Redis configuration file example

# 內存單位
# Note on units: when memory size is needed, it is possible to specifiy
# it in the usual form of 1k 5GB 4M and so forth:
#
# 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.

# 後臺運行，默認no
daemonize no

# 後臺運行時，pid的存放位置
pidfile /var/run/redis.pid

# 端口爲6379
port 6379

# If you want you can bind a single interface, if the bind option is not
# specified all the interfaces will listen for incoming connections.
#
# 若是你想綁定單一的接口，若是綁定選項不是定義的全部的監聽接口。
# bind 127.0.0.1

# 定義用於監聽請求鏈接的unix sock文件。這不是默認的，因此Redis不會監聽一個沒有
# 定義的unix socket。
# unixsocket /tmp/redis.sock
# unixsocketperm 755


# Close the connection after a client is idle for N seconds (0 to disable)
# 當客服端鏈接空閒，多少秒端口（0s 不斷開）
timeout 0


########################### 日誌 ####################################

# 設置日誌級別
# debug(用於開發、測試)
# verbose(不少有用的信息，可是比debug少不少)
# notice(生產環境的使用)
# warning（很重要的日誌信息）
loglevel verbose

#  日誌文件默認爲console輸出。若是是後臺運行，則什麼都不輸出
logfile stdout

# 確實使用系統的日誌系統。默認爲no
# syslog-enabled no

# 給系統日誌設置身份
# syslog-ident redis

# 定義系統設備，默認爲LOCAL0
# syslog-facility local0

# 設置database的數量,默認是DB 0,你能夠選擇不一樣的數據庫鏈接
databases 16

################################ SNAPSHOTTING（快照）  #################################
#
# Save the DB on disk:
#
#   save <時間> <改變次數>
#
#   Will save the DB if both the given number of seconds and the given
#   number of write operations against the DB occurred.
#
#   In the example below the behaviour will be to save:
#   after 900 sec (15 min) if at least 1 key changed
#   after 300 sec (5 min) if at least 10 keys changed
#   after 60 sec if at least 10000 keys changed
#
#   Note: you can disable saving at all commenting all the "save" lines.
# 保存到磁盤的時候設置（將在時間或者修改次數達到後保存到磁盤）
# save 時間 改變次數
save 900 1	（900s《15分鐘》、若是值修改1個key）
save 300 10	（300s《15分鐘》、若是值修改10個key）
save 60 10000	（60s《1分鐘》、若是值修改10000個key）

# 在備份的時候使用LZF方式壓縮string對象？
# 默認是yes,大部分狀況適用
rdbcompression yes

# The filename where to dump the DB
# 備份的數庫的文件
dbfilename dump.rdb

# 工做目錄，DB將被寫在這個目錄。默認目錄，全部的數據都是以次爲相對地址
dir ./

################################# REPLICATION（主從） #################################

# 主從複製,使用slaveof去從起來的Redis服務器複製Redis實例。這個配置對從庫起做用。
# 例如，它能夠配置從庫定時去複製、監聽、等操做
# slaveof <masterip> <masterport>

# 從庫鏈接主庫的密碼
# masterauth <master-password>

# 若是從庫丟失了鏈接，或者複製功能還在啓動，有下面兩種處理方式
# 一、若是該參數爲yes（默認）,從庫仍是響應客服端的請求，可能須要輸出數據，或者數據
	設置爲null
# 二、若是爲no，則給客服端一個 SYNC with master in progress 的信息
slave-serve-stale-data yes

# 定時發送PINGS給master
# repl-ping-slave-period 10

# 主從的鏈接超時（很重要）
# repl-timeout 60

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

# 須要client登陸，一般使用在不一樣的主機上
# 通常都是跑在同一主機上，不須要使用帳戶密碼
# 須要很難破解的密碼
requirepass root

# Command renaming.
#
# It is possilbe to change the name of dangerous commands in a shared
# environment. For instance the CONFIG command may be renamed into something
# of hard to guess so that it will be still available for internal-use
# tools but not available for general clients.
#
# Example:
#
# rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52
#
# It is also possilbe to completely kill a command renaming it into
# an empty string:
#
# rename-command CONFIG ""

################################### LIMITS（限制） ####################################
# 客服端鏈接數
# maxclients 128

# 使用打得bytes比大內存靠譜。當內存到上限，Redis會嘗試刪除定時的set。它就會
# 優先刪除快要到時的keys和長時間保留的keys。Redis也會釋放的lists中刪除數據
# 若是都失敗了，Redis將使用錯誤命來返回用戶的寫指令，只有讀指令能正確使用
# 提醒：若是你把Redis看成一個cache，則設置maxmemory是一個好的習慣。看成一個
# 數據庫，內存佔用每週都會增長。很明顯，當你長時間的使用後，Redis將會使用不少
# 的內存，你須要花時間提高。當最大的內存使用完以後，你會獲取一個錯誤的寫操做。
# maxmemory <bytes>

# MAXMEMORY POLICY: how Redis will select what to remove when maxmemory
# is reached? You can select among five behavior:
# 內存策略
# volatile-lru -> remove the key with an expire set using an LRU algorithm
#  					使用LRU的算法來設置刪除過時鍵
# allkeys-lru -> remove any key accordingly to the LRU algorithm
# 					全部的key都根據LRU算法來刪除
# volatile-random -> remove a random key with an expire set
#					隨機刪除過期的key
# allkeys->random -> remove a random key, any key
# 					 隨機刪除任意key
# volatile-ttl -> remove the key with the nearest expire time (minor TTL)
#					刪除最近的過期key
# noeviction -> don't expire at all, just return an error on write operations
# 					不刪除過期key，只返回寫錯誤提示
# Note: with all the kind of policies, Redis will return an error on write
#       operations, when there are not suitable keys for eviction.
#
#       At the date of writing this commands are: 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
#	
# The default is:
#	
# maxmemory-policy volatile-lru

# LRU and minimal TTL algorithms are not precise algorithms but approximated
# algorithms (in order to save memory), so you can select as well the sample
# size to check. For instance for default Redis will check three keys and
# pick the one that was used less recently, you can change the sample size
# using the following configuration directive.
# LRU 和 TTL 算法都不是精準的算法而是近似算法（爲了保存數據到內存），因此你能選擇
# 簡單的數字選項。默認值爲3，你能改變這個配置
# maxmemory-samples 3

############################## APPEND ONLY MODE（內存數據存放到磁盤） ###############################

# Redis默認使用異步份方法來備份數據。若是你能用的想法，新的記錄將若是像發生車禍失去生活是運行Redis的
# 首選方式。若是你很在意你的數據，不想，一個記錄能夠失去你應使附加模式：
# 在該模式下啓用Redis會將每個寫操做的文件appendonly.aof收到。此文件將在啓動時讀取，
# 以便在內存中重建完整的數據集。
# 注意，你能同時異步備份和單個文件追加數據,若是隻加模式啓用Redis會加載數據從日誌文件並且在啓動時忽略了dump.rdb文件
# IMPORTANT: Check the BGREWRITEAOF to check how to rewrite the append
# log file in background when it gets too big.

appendonly no

# The name of the append only file (default: "appendonly.aof")
# 備份文件的名稱
# appendfilename appendonly.aof

# The fsync() call tells the Operating System to actually write data on disk
# instead to wait for more data in the output buffer. Some OS will really flush 
# data on disk, some other OS will just try to do it ASAP.
# fsync()告訴操做系統當即寫數據到磁盤而不是等待更多的數據在輸出緩存中，一些操做系統將寫在磁盤，
# 有些嘗試等待在些
# Redis supports three different modes:
#
# no: don't fsync, just let the OS flush the data when it wants. Faster.
# always: fsync after every write to the append only log . Slow, Safest.
# everysec: fsync only if one second passed since the last fsync. Compromise.
# 選擇no：不使用fsync，使用OS本身的刷新方式（快）。
# always：fsync將全部的都記錄下拉（慢，安全）
# everysec：fsync會在上次的fsync是執行（妥協）
# The default is "everysec" that's usually the right compromise between
# speed and data safety. It's up to you to understand if you can relax this to
# "no" that will will let the operating system flush the output buffer when
# it wants, for better performances (but if you can live with the idea of
# some data loss consider the default persistence mode that's snapshotting),
# or on the contrary, use "always" that's very slow but a bit safer than
# everysec.
# 默認爲everysec,這經常是在快速和安全之間妥協。
# If unsure, use "everysec".

# appendfsync always
appendfsync everysec
# appendfsync no

# When the AOF fsync policy is set to always or everysec, and a background
# saving process (a background save or AOF log background rewriting) is
# performing a lot of I/O against the disk, in some Linux configurations
# Redis may block too long on the fsync() call. Note that there is no fix for
# this currently, as even performing fsync in a different thread will block
# our synchronous write(2) call.
# 當AOF fsync策略被設置爲always和everysec,並且有一個後臺進程來保存數據。在一些linux
# 的配置中Redis可能在fsync()阻塞。注意如今還無法修復，甚至將使得安全寫入模塊阻塞
# In order to mitigate this problem it's possible to use the following option
# that will prevent fsync() from being called in the main process while a
# BGSAVE or BGREWRITEAOF is in progress.
# 爲了減輕這個問題，下面的選項方式防止fsync()在主要線程中做爲一個BGSAVE或者BGREWRITEAOF
# This means that while another child is saving the durability of Redis is
# the same as "appendfsync none", that in pratical terms means that it is
# possible to lost up to 30 seconds of log in the worst scenario (with the
# default Linux settings).
# 
# If you have latency problems turn this to "yes". Otherwise leave it as
# "no" that is the safest pick from the point of view of durability.
# 有潛在問題使用yes。另外no的持久安全性好
no-appendfsync-on-rewrite no

# Automatic rewrite of the append only file.
# Redis is able to automatically rewrite the log file implicitly calling
# BGREWRITEAOF when the AOF log size will growth by the specified percentage.
# 自動添加到文件
# This is how it works: Redis remembers the size of the AOF file after the
# latest rewrite (or if no rewrite happened since the restart, the size of
# the AOF at startup is used).
#
# This base size is compared to the current size. If the current size is
# bigger than the specified percentage, the rewrite is triggered. Also
# you need to specify a minimal size for the AOF file to be rewritten, this
# is useful to avoid rewriting the AOF file even if the percentage increase
# is reached but it is still pretty small.
#
# Specify a precentage of zero in order to disable the automatic AOF
# rewrite feature.

auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb

################################## SLOW LOG（慢日誌） ###################################

# The Redis Slow Log is a system to log queries that exceeded a specified
# execution time. The execution time does not include the I/O operations
# like talking with the client, sending the reply and so forth,
# but just the time needed to actually execute the command (this is the only
# stage of command execution where the thread is blocked and can not serve
# other requests in the meantime).
# Redis的盡是日是系統記錄的查詢日誌。
# You can configure the slow log with two parameters: one tells Redis
# what is the execution time, in microseconds, to exceed in order for the
# command to get logged, and the other parameter is the length of the
# slow log. When a new command is logged the oldest one is removed from the
# queue of logged commands.

# The following time is expressed in microseconds, so 1000000 is equivalent
# to one second. Note that a negative number disables the slow log, while
# a value of zero forces the logging of every command.
# 下面的數字單位是毫秒，若是是負數則禁用日誌
slowlog-log-slower-than 10000

# There is no limit to this length. Just be aware that it will consume memory.
# You can reclaim memory used by the slow log with SLOWLOG RESET.
# 日誌長度能夠不設限。可是爲了內存消耗，你重設slow log的內存消耗
slowlog-max-len 1024

################################ VIRTUAL MEMORY（虛擬內存） ###############################

### WARNING! Virtual Memory is deprecated in Redis 2.4
### The use of Virtual Memory is strongly discouraged.

### WARNING! Virtual Memory is deprecated in Redis 2.4
### The use of Virtual Memory is strongly discouraged.

# Virtual Memory allows Redis to work with datasets bigger than the actual
# amount of RAM needed to hold the whole dataset in memory.
# In order to do so very used keys are taken in memory while the other keys
# are swapped into a swap file, similarly to what operating systems do
# with memory pages.
#
# To enable VM just set 'vm-enabled' to yes, and set the following three
# VM parameters accordingly to your needs.

vm-enabled no
# vm-enabled yes

# This is the path of the Redis swap file. As you can guess, swap files
# can't be shared by different Redis instances, so make sure to use a swap
# file for every redis process you are running. Redis will complain if the
# swap file is already in use.
#
# The best kind of storage for the Redis swap file (that's accessed at random) 
# is a Solid State Disk (SSD).
#
# *** WARNING *** if you are using a shared hosting the default of putting
# the swap file under /tmp is not secure. Create a dir with access granted
# only to Redis user and configure Redis to create the swap file there.
vm-swap-file /tmp/redis.swap

# vm-max-memory configures the VM to use at max the specified amount of
# RAM. Everything that deos not fit will be swapped on disk *if* possible, that
# is, if there is still enough contiguous space in the swap file.
#
# With vm-max-memory 0 the system will swap everything it can. Not a good
# default, just specify the max amount of RAM you can in bytes, but it's
# better to leave some margin. For instance specify an amount of RAM
# that's more or less between 60 and 80% of your free RAM.
vm-max-memory 0

# Redis swap files is split into pages. An object can be saved using multiple
# contiguous pages, but pages can't be shared between different objects.
# So if your page is too big, small objects swapped out on disk will waste
# a lot of space. If you page is too small, there is less space in the swap
# file (assuming you configured the same number of total swap file pages).
#
# If you use a lot of small objects, use a page size of 64 or 32 bytes.
# If you use a lot of big objects, use a bigger page size.
# If unsure, use the default :)
vm-page-size 32

# Number of total memory pages in the swap file.
# Given that the page table (a bitmap of free/used pages) is taken in memory,
# every 8 pages on disk will consume 1 byte of RAM.
#
# The total swap size is vm-page-size * vm-pages
#
# With the default of 32-bytes memory pages and 134217728 pages Redis will
# use a 4 GB swap file, that will use 16 MB of RAM for the page table.
#
# It's better to use the smallest acceptable value for your application,
# but the default is large in order to work in most conditions.
vm-pages 134217728

# Max number of VM I/O threads running at the same time.
# This threads are used to read/write data from/to swap file, since they
# also encode and decode objects from disk to memory or the reverse, a bigger
# number of threads can help with big objects even if they can't help with
# I/O itself as the physical device may not be able to couple with many
# reads/writes operations at the same time.
#
# The special value of 0 turn off threaded I/O and enables the blocking
# Virtual Memory implementation.
vm-max-threads 4

############################### ADVANCED CONFIG（高級配置） ###############################

# Hashes are encoded in a special way (much more memory efficient) when they
# have at max a given numer of elements, and the biggest element does not
# exceed a given threshold. You can configure this limits with the following
# configuration directives.
# 
hash-max-zipmap-entries 512
hash-max-zipmap-value 64

# Similarly to hashes, small lists are also encoded in a special way in order
# to save a lot of space. The special representation is only used when
# you are under the following limits:
list-max-ziplist-entries 512
list-max-ziplist-value 64

# Sets have a special encoding in just one case: when a set is composed
# of just strings that happens to be integers in radix 10 in the range
# of 64 bit signed integers.
# The following configuration setting sets the limit in the size of the
# set in order to use this special memory saving encoding.
set-max-intset-entries 512

# Similarly to hashes and lists, sorted sets are also specially encoded in
# order to save a lot of space. This encoding is only used when the length and
# elements of a sorted set are below the following limits:
zset-max-ziplist-entries 128
zset-max-ziplist-value 64

# Active rehashing uses 1 millisecond every 100 milliseconds of CPU time in
# order to help rehashing the main Redis hash table (the one mapping top-level
# keys to values). The hash table implementation redis uses (see dict.c)
# performs a lazy rehashing: the more operation you run into an hash table
# that is rhashing, the more rehashing "steps" are performed, so if the
# server is idle the rehashing is never complete and some more memory is used
# by the hash table.
# 
# The default is to use this millisecond 10 times every second in order to
# active rehashing the main dictionaries, freeing memory when possible.
#
# If unsure:
# use "activerehashing no" if you have hard latency requirements and it is
# not a good thing in your environment that Redis can reply form time to time
# to queries with 2 milliseconds delay.
#
# use "activerehashing yes" if you don't have such hard requirements but
# want to free memory asap when possible.
activerehashing yes

################################## INCLUDES ###################################

# Include one or more other config files here.  This is useful if you
# have a standard template that goes to all redis server but also need
# to customize a few per-server settings.  Include files can include
# other files, so use this wisely.
# 包括其它的配置文件。這在整個redis服務器中的標準化模版化頗有用，可是同時
# 每個服務器自定義一些設置。將配置文件分部分設置，很明智
# include /path/to/local.conf
# include /path/to/other.conf