Debian Redis配置中常见问题及解决

Debian 环境下 Redis 配置常见问题与解决

一 基础检查与快速定位

• 确认安装与运行状态：使用命令查看是否安装、服务是否启动与开机自启，Debian 的默认配置文件为 /etc/redis/redis.conf，数据目录通常为 /var/lib/redis。示例：sudo systemctl status redis-server、sudo systemctl enable redis-server。
• 连接与认证：本地用 redis-cli 测试连通性，若设置了密码需先 AUTH <password>；远程连接需指定 -h <IP> -p 6379。
• 日志与配置语法：查看日志定位启动失败原因（Debian 包日志通常在 /var/log/redis/redis-server.log）；修改配置后先语法校验：sudo redis-server /etc/redis/redis.conf --test-memory 2，再重启服务。
• 防火墙与监听：放通端口（如 sudo ufw allow 6379/tcp），并确保配置监听在期望的接口上。

二 常见故障与修复对照表

三 关键配置项与推荐值

• 网络与安全
  • bind 127.0.0.1 ::1：默认仅本地；需要远程访问时改为内网接口或注释该行，并配合 requirepass 与防火墙使用。
  • protected-mode yes：无密码时仅允许本地/Unix 套接字；公网开放务必设置强密码或改为 no（仅内网）。
  • port 6379：保持默认或改为内网端口；如需禁用明文端口可设 port 0 并启用 tls-port。
  • tcp-backlog 511：高并发建议提高，并与内核 net.core.somaxconn 匹配。
  • requirepass <strong_password>：生产必设；可配合 rename-command 重命名危险命令（如 FLUSHALL/FLUSHDB/SHUTDOWN）。
• 持久化
  • RDB：save 900 1、save 300 10、save 60 10000；dir /var/lib/redis；dbfilename dump.rdb。
  • AOF：appendonly yes、appendfsync everysec、auto-aof-rewrite-percentage 100、auto-aof-rewrite-min-size 64mb。
• 内存与客户端
  • maxmemory <size>（如 2GB/4GB）、maxmemory-policy allkeys-lru。
  • maxclients 10000、timeout 0、tcp-keepalive 300。
• 日志与监控
  • loglevel notice、logfile /var/log/redis/redis-server.log。
  • slowlog-log-slower-than 10000、slowlog-max-len 128。
• systemd 监督
  • daemonize no、supervised systemd（与 systemd 服务单元配合）。

四 生产环境最小可用配置示例

# 网络
bind 10.0.0.10         # 仅内网
port 6379
protected-mode yes
tcp-backlog 1024
timeout 0
tcp-keepalive 300

# 安全
requirepass YourStrongPassw0rd!
rename-command FLUSHALL "FLUSHALL_PROD"
rename-command FLUSHDB  "FLUSHDB_PROD"
rename-command SHUTDOWN "SHUTDOWN_PROD"

# 持久化
dir /var/lib/redis
dbfilename dump.rdb
save 900 1
save 300 10
save 60 10000
appendonly yes
appendfilename "appendonly.aof"
appendfsync everysec
auto-aof-rewrite-percentage 100
auto-aof-rewrite-min-size 64mb

# 内存
maxmemory 2gb
maxmemory-policy allkeys-lru

# 日志与监控
loglevel notice
logfile /var/log/redis/redis-server.log
slowlog-log-slower-than 10000
slowlog-max-len 128

# 其他
databases 16
lazyfree-lazy-eviction yes

• 应用此配置后执行：sudo systemctl restart redis-server，并用 redis-cli -h 10.0.0.10 -a <password> ping 验证连通。

五 安全与加固要点

• 仅在内网开放，或在前置 TLS 终止后再转发明文 Redis；必要时使用 port 0 + tls-port 6379 并配置证书。
• 强制设置 强密码，重命名或禁用危险命令，限制可写目录与命令执行权限。
• 以 非 root 运行（Debian 包默认创建 redis 用户），目录权限最小化：/var/lib/redis、/var/log/redis 归属 redis:redis。
• 开启 AOF 或合理的 RDB 策略，定期备份数据目录；结合监控与慢查询日志进行容量与性能调优。