Redis 配置目录:
- 源码:
/data/targz/redis-6.2.4/redis.conf
- 自定义:
/data/opt/redis-6.2.4/redis.conf
# Redis configuration file example.
#
# Note that in order to read the configuration file, Redis must be
# started with the file path as first argument:
#
# ./redis-server /path/to/redis.conf
1-UNITS
# Note on units: when memory size is needed, it is possible to specify
# 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.
配置内存单位:
- 开头定义了一些基本的度量单位,只支持 bytes,不支持 bit。
- 大小写不敏感。
2-INCLUDES
# include /path/to/local.conf
# include /path/to/other.conf
Redis 只有一个配置文件,多实例的情况可以把公用配置提取出来。提取的配置文件可以通过include /path/to/local.conf
引入,而原本的 redis.conf 配置文件就作为一个总闸。
- 若将此配置写在 redis.conf 文件的开头,后面的配置会覆盖引入文件的配置。
- 若想以引入文件的配置为主,需要将 include 配置写在 redis.conf 文件的末尾。
3-MODULES
# loadmodule /path/to/my_module.so
# loadmodule /path/to/other_module.so
通过 loadmodule 配置将引入自定义模块来新增一些功能。
4-NETWORK
4.1-bind
# bind 192.168.1.100 10.0.0.1 # listens on two specific IPv4 addresses
# bind 127.0.0.1 ::1 # listens on loopback IPv4 and IPv6
# bind * -::* # like the default, all available interfaces
bind 127.0.0.1 -::1
- 默认情况
bind=127.0.0.1
只能接受本机的访问请求。 - 不写的情况下,无限制接受任何 IP 地址的访问。
- 生产环境肯定要写应用服务器的地址,服务器是需要远程访问的,需要将其注释掉。
- 若开启了 protected-mode,那么在没有设定 bind ip 且没有设密码的情况下,Redis 只允许接受本机的响应。
4.2-protected-mode
protected-mode yes
本机访问保护模式。
4.3-port
port 6379
Redis 运行的端口,默认是 6379。
4.4-tcp-backlog
tcp-backlog 511
Tcp 的 backlog 其实是一个连接队列,backlog 队列总和 = 未完成三次握手队列 + 已经完成三次握手队列。
高并发环境下需要一个高 backlog 值来避免慢客户端连接问题。
注意:Linux 内核会将这个值减小到/proc/sys/net/core/somaxconn
的值(128),需要确认增大/proc/sys/net/core/somaxconn
和/proc/sys/net/ipv4/tcp_max_syn_backlog
(128)两个值来达到想要的效果。
4.5-unixsocket
# unixsocket /run/redis.sock
# unixsocketperm 700
unix socket 的路径。
4.6-timeout
timeout 0
客户端连接时的超时时间,单位为秒。当客户端在这段时间内没有发出任何指令,那么关闭该连接。默认值为 0,表示永不关闭。
4.7-tcp-keepalive
tcp-keepalive 300
单位是秒,表示将周期性的使用 SO_KEEPALIVE 检测客户端是否还处于健康状态,避免服务器一直阻塞,官方给出的建议值是 300 s。若设置为 0,则不会周期性的检测。
5-TLS/SSL
6-GENERAL
6.1-daemonize
daemonize yes
是否以守护模式启动,默认为 no,配置为 yes 时以守护模式启动。此时 redis instance 会将进程号 pid 写入默认文件/var/run/redis.pid
。
6.2-supervised
# supervised auto
可以通过 upstart 和 systemd 管理 Redis 守护进程。
6.3-pidfile
pidfile /var/run/redis_6379.pid
存放 pid 文件的位置,每个实例会产生一个不同的 pid 文件。
6.4-loglevel
loglevel notice
Redis 日志级别:
- debug:记录大量日志信息,适用于开发、测试阶段。
- verbose:较多日志信息。
- notice:适量日志信息,使用于生产环境。
- warning:仅有部分重要、关键信息才会被记录。
6.5-logfile
logfile ""
日志文件的位置。当指定为空字符串时,为标准输出。若 Redis 已守护进程模式运行,那么日志将会输出到/dev/null
。
6.6-databases
databases 16
设置数据库的数目。默认的数据库是 DB 0,可以在每个连接上使用select <dbid>
命令选择一个不同的数据库,dbid 是一个介于 0 到 databases - 1 之间的数值。
7-SNAPSHOTTING
8-REPLICATION
9-KEYS TRACKING
10-SECURITY
10.1-requirepass
# requirepass foobared
Redis 连接密码。在命令中设置密码只是临时的,重启 Redis 服务器,密码就还原了。永久设置需要再配置文件中设置。
11-CLIENTS
11.1-maxclients
# maxclients 10000
- 设置 Redis 同时可以与多少个客户端进行连接。
- 默认情况下为 10000 个客户端。
- 若达到了此限制,Redis则会拒绝新的连接请求,并且向这些连接请求方发出
max number of clients reached
以作回应。
12-MEMORY MANAGEMENT
12.1-maxmemory
# maxmemory <bytes>
- 建议必须设置,否则将内存占满,造成服务器宕机。
- 设置 Redis 可以使用的内存量。一旦到达内存使用上限,Redis 将会试图移除内部数据,移除规则可以通过 maxmemory-policy 来指定。
- 若 Redis 无法根据移除规则来移除内存中的数据,或者设置了
不允许移除
,那么 Redis 则会针对那些需要申请内存的指令返回错误信息,比如 SET、LPUSH 等。但是对于无内存申请的指令,仍然会正常响应,比如 GET 等。 - 若 Redis 是主 Redis,那么在设置内存使用上限时,需要在系统中留出一些内存空间给同步队列缓存,只有设置的是
不移除
的情况下,才不用考虑这个因素。
12.2-maxmemory-policy
# maxmemory-policy noeviction
- volatile-lru:使用 LRU 算法移除 key,只对设置了过期时间的键(最近最少使用)。
- allkeys-lru:在所有集合 key 中,使用 LRU 算法移除 key。
- volatile-random:在过期集合中移除随机的 key,只对设置了过期时间的键。
- allkeys-random:在所有集合 key 中,移除随机的 key。
- volatile-ttl:移除那些 TTL 值最小的 key,即那些最近要过期的 key。
- noeviction:不进行移除。针对写操作,只是返回错误信息。
12.3-maxmemory-samples
# maxmemory-samples 5
- 设置样本数量,LRU 算法和最小 TTL 算法都并非是精确的算法,而是估算值,所以可以设置样本的大小,Redis 默认会检查这么多个 key 并选择其中 LRU 的那个。
- 一般设置 3 到 7 的数字,数值越小样本越不准确,但性能消耗越小。