redis.conf文件詳解

轉載:http://blog.csdn.net/zhutulang/article/details/51969760

之所以轉載這篇博客 :①作者寫的很用心②自己因爲一個參數不熟悉,導致一個問題糾結了一天,所以方便以後查看。

redis.conf文件可以在github上查看,下面是我整理的其中的配置項(版本是3.2)的解析,儘量全面一些吧。

參考:1、http://running.iteye.com/blog/2065351

             2、http://chembo.iteye.com/blog/2054021

             3、http://www.cnblogs.com/kreo/p/4423362.html

             4、www.111cn.net/database/276/84771.htm


注:REDIS CLUSTER 之後的配置暫時沒有列出來。實在是太多了。

1、include

解釋:引入其它配置文件。比如說當你有多個server,而有一些配置項是它們公用的,那麼你可以將這些公用的配置項寫進一個配置文件common.conf裏,然後這些server再include這個配置文件,這些server自己的配置項則分別寫在自己的配置文件裏。

示例:include /path/to/common.conf


2、loadmodule

解釋:此配置項尚未了解。註釋是這樣的:啓動時加載模塊,如果server無法加載模塊,則此配置會被忽略。可以使用多個loadmodule。

示例:loadmodule /path/to/my_module.so


3、bind

解釋:默認情況下,redis 在 server 上所有有效的網絡接口上監聽客戶端連接。如果只想讓它在一個或多個網絡接口上監聽,那你就綁定一個IP或者多個IP。多個ip空格分隔即可。

示例: bind 192.168.1.100 10.0.0.1
             bind 127.0.0.1 ::1


4、protected-mode

解釋:當開啓後,禁止公網訪問redis。它啓用的條件有兩個,第一是沒有使用bind,第二是沒有設置訪問密碼。

示例:protected-mode yes


5、port

解釋:指定該redis server監聽的端口號。默認是6379,如果指定0則不監聽。

示例:port 6379


6、tcp-backlog

解釋:此參數確定了TCP連接中已完成隊列(完成三次握手之後)的長度, 當然此值必須不大於Linux系統定義的/proc/sys/net/core/somaxconn值,默認是511,而Linux的默認參數值是128。當系統併發量大並且客戶端速度緩慢的時候,可以將這二個參數一起參考設定。

示例:tcp-backlog 511


7、unixsocket

解釋:指定 unix socket 的路徑。

示例:unixsocket /tmp/redis.sock


8、unixsocketperm

解釋:指定 unix socket file 的權限。

示例:unixsocketperm  755


9、timeout

解釋:當客戶端閒置多少秒後關閉連接,如果設置爲0表示關閉該功能。

示例:timeout  30


10、tcp-keepalive

解釋:單位是秒,表示將週期性的使用SO_KEEPALIVE檢測客戶端是否還處於健康狀態,避免服務器一直阻塞,官方給出的建議值是300S

示例:tcp-keepalive 300


11、daemonize

解釋:是否以守護模式啓動,默認爲no,配置爲yes時以守護模式啓動,這時redis instance會將進程號pid寫入默認文件/var/run/redis.pid。

示例:daemonize yes


12、supervised

解釋:可以通過upstart和systemd管理Redis守護進程,這個參數是和具體的操作系統相關的。

示例:supervised no


13、pidfile

解釋:配置pid文件路徑。當redis以守護模式啓動時,如果沒有配置pidfile,pidfile默認值是/var/run/redis.pid 。

示例:pidfile /var/run/redis_6379.pid


14、loglevel

解釋:日誌級別。可選項有:debug(記錄大量日誌信息,適用於開發、測試階段);  verbose(較多日誌信息);  notice(適量日誌信息,使用於生產環境);warning(僅有部分重要、關鍵信息纔會被記錄)。

示例:loglevel notice


15、logfile

解釋:日誌文件的位置,當指定爲空字符串時,爲標準輸出,如果redis已守護進程模式運行,那麼日誌將會輸出到  /dev/null 。

示例:logfile ""


16、syslog-enabled

解釋:是否把日誌記錄到系統日誌。(何意?)

示例:syslog-enabled no


17、syslog-ident

解釋:設置系統日誌的id

示例:syslog-ident redis


18、syslog-facility

解釋:指定syslog設備(facility),必須是user或則local0到local7。

示例:syslog-facility local0


19、databases

解釋:設置數據庫的數目。默認的數據庫是DB 0 ,可以在每個連接上使用select  <dbid> 命令選擇一個不同的數據庫,dbid是一個介於0到databases - 1 之間的數值。

示例:databases 16

 

20、save

解釋:保存數據到磁盤。格式是:save <seconds> <changes> ,含義是在 seconds 秒之後至少有 changes個keys 發生改變則保存一次。

示例:save 900 1
            save 300 10
            save 60 10000


21、stop-writes-on-bgsave-error

解釋:默認情況下,如果 redis 最後一次的後臺保存失敗,redis 將停止接受寫操作,這樣以一種強硬的方式讓用戶知道數據不能正確的持久化到磁盤, 否則就會沒人注意到災難的發生。 如果後臺保存進程重新啓動工作了,redis 也將自動的允許寫操作。然而你要是安裝了靠譜的監控,你可能不希望 redis 這樣做,那你就改成 no 好了。

示例:stop-writes-on-bgsave-error no


22、rdbcompression

解釋:是否在dump  .rdb數據庫的時候壓縮字符串,默認設置爲yes。如果你想節約一些cpu資源的話,可以把它設置爲no,這樣的話數據集就可能會比較大。

示例:rdbcompression yes


23、rdbchecksum

解釋:是否CRC64校驗rdb文件,會有一定的性能損失(大概10%)。

示例:rdbchecksum yes


24、dbfilename

解釋:rdb文件的名字。

示例:dbfilename dump.rdb


25、dir

解釋:數據庫存放目錄。必須是一個目錄,aof文件也會保存到該目錄下。

示例:dir ./


26、slaveof

解釋:設置本機爲slave服務。格式:slaveof <masterip> <masterport>。設置master服務的IP地址及端口,在Redis啓動時,它會自動從master進行數據同步。

示例:slaveof  192.168.0.1  6379


27、masterauth

解釋:當master服務設置了密碼保護時,slav服務連接master的密碼。

示例:masterauth   123456


28、slave-serve-stale-data

解釋:當一個slave與master失去聯繫時,或者複製正在進行的時候,slave應對請求的行爲:1) 如果爲 yes(默認值) ,slave 仍然會應答客戶端請求,但返回的數據可能是過時,或者數據可能是空的在第一次同步的時候;2) 如果爲 no ,在你執行除了 info 和 salveof 之外的其他命令時,slave 都將返回一個 "SYNC with master in progress" 的錯誤。
示例:slave-serve-stale-data yes


29、slave-read-only

解釋:設置slave是否是隻讀的。從2.6版起,slave默認是隻讀的。

示例:slave-read-only  yes


30、repl-diskless-sync

解釋:主從數據複製是否使用無硬盤複製功能。

示例:repl-diskless-sync no


31、repl-ping-slave-period

解釋:指定slave定期ping master的週期,默認10秒鐘。

示例:repl-ping-slave-period 10


32、repl-timeout

解釋:設置主庫批量數據傳輸時間或者ping回覆時間間隔,默認值是60秒 。 

示例:repl-timeout 60


33、repl-disable-tcp-nodelay
解釋:指定向slave同步數據時,是否禁用socket的NO_DELAY選 項。若配置爲“yes”,則禁用NO_DELAY,則TCP協議棧會合並小包統一發送,這樣可以減少主從節點間的包數量並節省帶寬,但會增加數據同步到 slave的時間。若配置爲“no”,表明啓用NO_DELAY,則TCP協議棧不會延遲小包的發送時機,這樣數據同步的延時會減少,但需要更大的帶寬。 通常情況下,應該配置爲no以降低同步延時,但在主從節點間網絡負載已經很高的情況下,可以配置爲yes。

示例:repl-disable-tcp-nodelay no


34、repl-backlog-size

解釋:設置主從複製backlog容量大小。這個 backlog 是一個用來在 slaves 被斷開連接時存放 slave 數據的 buffer,所以當一個 slave 想要重新連接,通常不希望全部重新同步,只是部分同步就夠了,僅僅傳遞 slave 在斷開連接時丟失的這部分數據。這個值越大,salve 可以斷開連接的時間就越長。

示例:repl-backlog-size 1mb


35、repl-backlog-ttl

解釋:配置當master和slave失去聯繫多少秒之後,清空backlog釋放空間。當配置成0時,表示永遠不清空。

示例:repl-backlog-ttl 3600


36、slave-priority

解釋:當 master 不能正常工作的時候,Redis Sentinel 會從 slaves 中選出一個新的 master,這個值越小,就越會被優先選中,但是如果是 0 , 那是意味着這個 slave 不可能被選中。 默認優先級爲 100。

示例:slave-priority 100


37、requirepass

解釋:設置redis連接密碼。

示例:requirepass foobared


38、rename-command

解釋:將命令重命名。爲了安全考慮,可以將某些重要的、危險的命令重命名。當你把某個命令重命名成空字符串的時候就等於取消了這個命令。

示例:rename-command CONFIG b840fc02d524045429941cc15f59e41cb7be6c52

            rename-command CONFIG ""


39、maxclients

解釋:設置客戶端最大併發連接數,默認無限制,Redis可以同時打開的客戶端連接數爲Redis進程可以打開的最大文件描述符數-32(redis server自身會使用一些),如果設置 maxclients 0,表示不作限制。當客戶端連接數到達限制時,Redis會關閉新的連接並向客戶端返回max number of clients reached錯誤信息。

示例:maxclients 10000


40、maxmemory

解釋: 指定Redis最大內存限制,Redis在啓動時會把數據加載到內存中,達到最大內存後,Redis會先嚐試清除已到期或即將到期的Key,當此方法處理 後,仍然到達最大內存設置,將無法再進行寫入操作,但仍然可以進行讀取操作。Redis新的vm機制,會把Key存放內存,Value會存放在swap區,格式:maxmemory <bytes> 。

示例:maxmemory 1024000


41、maxmemory-policy

解釋:當內存使用達到最大值時,redis使用的清楚策略。有以下幾種可以選擇(明明有6種,官方配置文件裏卻說有5種可以選擇?):

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

            2)allkeys-lru   利用LRU算法移除任何key 

            3)volatile-random 移除設置過過期時間的隨機key 

            4)allkeys-random  移除隨機key 

            5)volatile-ttl   移除即將過期的key(minor TTL) 

            6)noeviction  noeviction   不移除任何key,只是返回一個寫錯誤 。默認選項

示例:maxmemory-policy noeviction


42、maxmemory-samples

解釋:LRU 和 minimal TTL 算法都不是精準的算法,但是相對精確的算法(爲了節省內存),隨意你可以選擇樣本大小進行檢測。redis默認選擇3個樣本進行檢測,你可以通過maxmemory-samples進行設置 樣本數。

示例:maxmemory-samples 5


43、appendonly

解釋:是否啓用aof持久化方式 。即是否在每次更新操作後進行日誌記錄,默認配置是no,即在採用異步方式把數據寫入到磁盤,如果不開啓,可能會在斷電時導致部分數據丟失。

示例:appendonly no


44、appendfilename

解釋:更新日誌文件名,默認值爲appendonly.aof 。

示例:appendfilename "appendonly.aof"


45、appendfsync

解釋:aof文件刷新的頻率。有三種:

            1)no 依靠OS進行刷新,redis不主動刷新AOF,這樣最快,但安全性就差。

             2) always 每提交一個修改命令都調用fsync刷新到AOF文件,非常非常慢,但也非常安全。

             3) everysec 每秒鐘都調用fsync刷新到AOF文件,很快,但可能會丟失一秒以內的數據。

示例:appendfsync everysec


46、no-appendfsync-on-rewrite

解釋:指定是否在後臺aof文件rewrite期間調用fsync,默認爲no,表示要調用fsync(無論後臺是否有子進程在刷盤)。Redis在後臺寫RDB文件或重寫AOF文件期間會存在大量磁盤IO,此時,在某些linux系統中,調用fsync可能會阻塞。

示例:no-appendfsync-on-rewrite no


47、auto-aof-rewrite-percentage

解釋:當AOF文件增長到一定大小的時候Redis能夠調用 BGREWRITEAOF 對日誌文件進行重寫 。當AOF文件大小的增長率大於該配置項時自動開啓重寫。

示例:auto-aof-rewrite-percentage 100


48、auto-aof-rewrite-min-size

解釋:當AOF文件增長到一定大小的時候Redis能夠調用 BGREWRITEAOF 對日誌文件進行重寫 。當AOF文件大小大於該配置項時自動開啓重寫。

示例:auto-aof-rewrite-min-size 64mb


49、aof-load-truncated

解釋:redis在啓動時可以加載被截斷的AOF文件,而不需要先執行 redis-check-aof 工具。

示例:aof-load-truncated yes


50、lua-time-limit

解釋:一個Lua腳本最長的執行時間,單位爲毫秒,如果爲0或負數表示無限執行時間,默認爲5000。

示例:lua-time-limit 5000

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章