redis配置檔案詳解

# Redis 配置檔案

# 當配置中需要配置記憶體大小時，可以使用 1k, 5GB, 4M 等類似的格式，其轉換方式如下(不區分大小寫)

#

# 1k => 1000 bytes

# 1kb => 1024 bytes

# 1m => 1000000 bytes

# 1mb => 1024*1024 bytes

# 1g => 1000000000 bytes

# 1gb => 1024*1024*1024 bytes

# 記憶體配置大小寫是一樣的.比如 1gb 1Gb 1GB 1gB

# daemonize no 預設情況下，redis不是在背景運作的，如果需要在背景運作，把該項的值更改為yes

daemonize yes

# 當redis在背景運作的時候，Redis預設會把pid檔案放在/var/run/redis.pid，你可以配置到其他位址。

# 當運作多個redis服務時，需要指定不同的pid檔案和端口

pidfile /var/run/redis.pid

# 指定redis運作的端口，預設是6379

port 6379

# 指定redis隻接收來自于該IP位址的請求，如果不進行設定，那麼将處理所有請求，

# 在生産環境中最好設定該項

# bind 127.0.0.1

# Specify the path for the unix socket that will be used to listen for

# incoming connections. There is no default, so Redis will not listen

# on a unix socket when not specified.

# unixsocket /tmp/redis.sock

# unixsocketperm 755

# 設定用戶端連接配接時的逾時時間，機關為秒。當用戶端在這段時間内沒有發出任何指令，那麼關閉該連接配接

# 0是關閉此設定

timeout 0

# 指定日志記錄級别

# Redis總共支援四個級别：debug、verbose、notice、warning，預設為verbose

# debug 記錄很多資訊，用于開發和測試

# varbose 有用的資訊，不像debug會記錄那麼多

# notice 普通的verbose，常用于生産環境

# warning 隻有非常重要或者嚴重的資訊會記錄到日志

loglevel debug

# 配置log檔案位址

# 預設值為stdout，标準輸出，若背景模式會輸出到/dev/null

#logfile stdout

logfile /var/log/redis/redis.log

# To enable logging to the system logger, just set 'syslog-enabled' to yes,

# and optionally update the other syslog parameters to suit your needs.

# syslog-enabled no

# Specify the syslog identity.

# syslog-ident redis

# Specify the syslog facility. Must be USER or between LOCAL0-LOCAL7.

# syslog-facility local0

# 可用資料庫數

# 預設值為16，預設資料庫為0，資料庫範圍在0-（database-1）之間

databases 16

################################ 快照 #################################

# 儲存資料到磁盤，格式如下:

# save <seconds> <changes>

# 指出在多長時間内，有多少次更新操作，就将資料同步到資料檔案rdb。

# 相當于條件觸發抓取快照，這個可以多個條件配合

#

# 比如預設配置檔案中的設定，就設定了三個條件

# save 900 1 900秒内至少有1個key被改變

# save 300 10 300秒内至少有300個key被改變

# save 60 10000 60秒内至少有10000個key被改變

save 900 1

save 300 10

save 60 10000

# 存儲至本地資料庫時（持久化到rdb檔案）是否壓縮資料，預設為yes

rdbcompression yes

# 本地持久化資料庫檔案名，預設值為dump.rdb

dbfilename dump.rdb

# 工作目錄

# 資料庫鏡像備份的檔案放置的路徑。

# 這裡的路徑跟檔案名要分開配置是因為redis在進行備份時，先會将目前資料庫的狀态寫入到一個臨時檔案中，等備份完成時，

# 再把該該臨時檔案替換為上面所指定的檔案，而這裡的臨時檔案和上面所配置的備份檔案都會放在這個指定的路徑當中。

#

# AOF檔案也會存放在這個目錄下面

# 注意這裡必須制定一個目錄而不是檔案

dir ./

################################# 複制 #################################

# 主從複制. 設定該資料庫為其他資料庫的從資料庫.

# 設定當本機為slav服務時，設定master服務的IP位址及端口，在Redis啟動時，它會自動從master進行資料同步

# slaveof <masterip> <masterport>

# 當master服務設定了密碼保護時(用requirepass制定的密碼)

# slav服務連接配接master的密碼

# masterauth <master-password>

# 當從庫同主機失去連接配接或者複制正在進行，從機庫有兩種運作方式：

# 1) 如果slave-serve-stale-data設定為yes(預設設定)，從庫會繼續相應用戶端的請求

# 2) 如果slave-serve-stale-data是指為no，出去INFO和SLAVOF指令之外的任何請求都會傳回一個

# 錯誤"SYNC with master in progress"

slave-serve-stale-data yes

# 從庫會按照一個時間間隔向主庫發送PINGs.可以通過repl-ping-slave-period設定這個時間間隔，預設是10秒

# repl-ping-slave-period 10

# repl-timeout 設定主庫批量資料傳輸時間或者ping回複時間間隔，預設值是60秒

# 一定要確定repl-timeout大于repl-ping-slave-period

# repl-timeout 60

################################## 安全 ###################################

# 設定用戶端連接配接後進行任何其他指定前需要使用的密碼。

# 警告：因為redis速度相當快，是以在一台比較好的伺服器下，一個外部的使用者可以在一秒鐘進行150K次的密碼嘗試，這意味着你需要指定非常非常強大的密碼來防止暴力破解

# requirepass foobared

# 指令重命名.

# 在一個共享環境下可以重命名相對危險的指令。比如把CONFIG重名為一個不容易猜測的字元。

# 舉例:

# rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52

# 如果想删除一個指令，直接把它重命名為一個空字元""即可，如下：

# rename-command CONFIG ""

################################### 限制 ####################################

# 設定同一時間最大用戶端連接配接數，預設無限制，Redis可以同時打開的用戶端連接配接數為Redis程序可以打開的最大檔案描述符數，

# 如果設定 maxclients 0，表示不作限制。

# 當用戶端連接配接數到達限制時，Redis會關閉新的連接配接并向用戶端傳回max number of clients reached錯誤資訊

# maxclients 128

# 指定Redis最大記憶體限制，Redis在啟動時會把資料加載到記憶體中，達到最大記憶體後，Redis會先嘗試清除已到期或即将到期的Key

# Redis同時也會移除空的list對象

# 當此方法處理後，仍然到達最大記憶體設定，将無法再進行寫入操作，但仍然可以進行讀取操作

# 注意：Redis新的vm機制，會把Key存放記憶體，Value會存放在swap區

# maxmemory的設定比較适合于把redis當作于類似memcached的緩存來使用，而不适合當做一個真實的DB。

# 當把Redis當做一個真實的資料庫使用的時候，記憶體使用将是一個很大的開銷

# maxmemory <bytes>

# 當記憶體達到最大值的時候Redis會選擇删除哪些資料？有五種方式可供選擇

# volatile-lru -> 利用LRU算法移除設定過過期時間的key (LRU:最近使用 Least Recently Used )

# allkeys-lru -> 利用LRU算法移除任何key

# volatile-random -> 移除設定過過期時間的随機key

# allkeys->random -> remove a random key, any key

# volatile-ttl -> 移除即将過期的key(minor TTL)

# noeviction -> 不移除任何可以，隻是傳回一個寫錯誤

# 注意：對于上面的政策，如果沒有合适的key可以移除，當寫的時候Redis會傳回一個錯誤

# 寫指令包括: 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 和 minimal TTL 算法都不是精準的算法，但是相對精确的算法(為了節省記憶體)，随意你可以選擇樣本大小進行檢測。

# Redis預設的灰選擇3個樣本進行檢測，你可以通過maxmemory-samples進行設定

# maxmemory-samples 3

############################## AOF ###############################

# 預設情況下，redis會在背景異步的把資料庫鏡像備份到磁盤，但是該備份是非常耗時的，而且備份也不能很頻繁，如果發生諸如拉閘限電、拔插頭等狀況，那麼将造成比較大範圍的資料丢失。

# 是以redis提供了另外一種更加高效的資料庫備份及災難恢複方式。

# 開啟append only模式之後，redis會把所接收到的每一次寫操作請求都追加到appendonly.aof檔案中，當redis重新啟動時，會從該檔案恢複出之前的狀态。

# 但是這樣會造成appendonly.aof檔案過大，是以redis還支援了BGREWRITEAOF指令，對appendonly.aof 進行重新整理。

# 你可以同時開啟asynchronous dumps 和 AOF

appendonly no

# AOF檔案名稱 (預設: "appendonly.aof")

# appendfilename appendonly.aof

# Redis支援三種同步AOF檔案的政策:

# no: 不進行同步，系統去操作 . Faster.

# always: always表示每次有寫操作都進行同步. Slow, Safest.

# everysec: 表示對寫操作進行累積，每秒同步一次. Compromise.

# 預設是"everysec"，按照速度和安全折中這是最好的。

# 如果想讓Redis能更高效的運作，你也可以設定為"no"，讓作業系統決定什麼時候去執行

# 或者相反想讓資料更安全你也可以設定為"always"

# 如果不确定就用 "everysec".

# appendfsync always

appendfsync everysec

# appendfsync no

# AOF政策設定為always或者everysec時，背景處理程序(背景儲存或者AOF日志重寫)會執行大量的I/O操作

# 在某些Linux配置中會阻止過長的fsync()請求。注意現在沒有任何修複，即使fsync在另外一個線程進行處理

# 為了減緩這個問題，可以設定下面這個參數no-appendfsync-on-rewrite

# 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.

no-appendfsync-on-rewrite no

# Automatic rewrite of the append only file.

# AOF 自動重寫

# 當AOF檔案增長到一定大小的時候Redis能夠調用 BGREWRITEAOF 對日志檔案進行重寫

# 它是這樣工作的：Redis會記住上次進行些日志後檔案的大小(如果從開機以來還沒進行過重寫，那日子大小在開機的時候确定)

# 基礎大小會同現在的大小進行比較。如果現在的大小比基礎大小大制定的百分比，重寫功能将啟動

# 同時需要指定一個最小大小用于AOF重寫，這個用于阻止即使檔案很小但是增長幅度很大也去重寫AOF檔案的情況

# 設定 percentage 為0就關閉這個特性

auto-aof-rewrite-percentage 100

auto-aof-rewrite-min-size 64mb

################################## SLOW LOG ###################################

# Redis Slow Log 記錄超過特定執行時間的指令。執行時間不包括I/O計算比如連接配接用戶端，傳回結果等，隻是指令執行時間

# 可以通過兩個參數設定slow log：一個是告訴Redis執行超過多少時間被記錄的參數slowlog-log-slower-than(微妙)，

# 另一個是slow log 的長度。當一個新指令被記錄的時候最早的指令将被從隊列中移除

# 下面的時間以微妙微機關，是以1000000代表一分鐘。

# 注意制定一個負數将關閉慢日志，而設定為0将強制每個指令都會記錄

slowlog-log-slower-than 10000

# 對日志長度沒有限制，隻是要注意它會消耗記憶體

# 可以通過 SLOWLOG RESET 回收被慢日志消耗的記憶體

slowlog-max-len 1024

################################ VM ###############################

### 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 ###############################

# 當hash中包含超過指定元素個數并且最大的元素沒有超過臨界時，

# hash将以一種特殊的編碼方式（大大減少記憶體使用）來存儲，這裡可以設定這兩個臨界值

# Redis Hash對應Value内部實際就是一個HashMap，實際這裡會有2種不同實作，

# 這個Hash的成員比較少時Redis為了節省記憶體會采用類似一維數組的方式來緊湊存儲，而不會采用真正的HashMap結構，對應的value redisObject的encoding為zipmap,

# 當成員數量增大時會自動轉成真正的HashMap,此時encoding為ht。

hash-max-zipmap-entries 512

hash-max-zipmap-value 64

# list資料類型多少節點以下會采用去指針的緊湊存儲格式。

# list資料類型節點值大小小于多少位元組會采用緊湊存儲格式。

list-max-ziplist-entries 512

list-max-ziplist-value 64

# set資料類型内部資料如果全部是數值型，且包含多少節點以下會采用緊湊格式存儲。

set-max-intset-entries 512

# zsort資料類型多少節點以下會采用去指針的緊湊存儲格式。

# zsort資料類型節點值大小小于多少位元組會采用緊湊存儲格式。

zset-max-ziplist-entries 128

zset-max-ziplist-value 64

# Redis将在每100毫秒時使用1毫秒的CPU時間來對redis的hash表進行重新hash，可以降低記憶體的使用

# 當你的使用場景中，有非常嚴格的實時性需要，不能夠接受Redis時不時的對請求有2毫秒的延遲的話，把這項配置為no。

# 如果沒有這麼嚴格的實時性要求，可以設定為yes，以便能夠盡可能快的釋放記憶體

activerehashing yes

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

# 指定包含其它的配置檔案，可以在同一主機上多個Redis執行個體之間使用同一份配置檔案，而同時各個執行個體又擁有自己的特定配置檔案

# include /path/to/local.conf

# include /path/to/other.conf

可愛部落客：AlanLee

部落格位址：http://www.cnblogs.com/AlanLee

本文出自部落格園，歡迎大家加入部落格園。