redis 系列（二） 配置檔案說明
阿新 • • 發佈：2018-12-30
# 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