简介Linux环境下Redis的安装、启动、停止及服务化配置是运维与后端开发的高频需求。这份PDF文档以实操视角完整梳理了从源码包下载、tar解压、make编译到redis-server启动与redis-cli客户端测试的全流程并详细介绍了将Redis注册为系统服务的方法包括复制redis_init_script至/etc/init.d、在脚本中添加chkconfig配置、准备PID文件与配置文件目录以及使用service redis start/stop进行日常管理。针对远程连接失败问题文档专门给出了bind地址限制、protected mode保护模式的成因分析与配置方法并通过requirepass设置密码实现安全认证帮助开发者在Java客户端等场景下顺利接入。资源共1个PDF文件压缩包仅261KB内容紧凑且重点标注了服务停止时PID文件找不到、chkconfig注册失败等易错细节现已有13618人学习按步骤对照操作即可少走弯路也可作为日常运维的快速参考适合初学Redis的Linux用户及需要搭建服务环境的开发者。1. 先把 Redis 装对才谈得上后面的启动与停机刚接手的服务器上 Redis 进程看着在跑可一重启就丢数据另一台机器上 redis-server 敲了半天最后发现 PATH 里那个根本不是我们要的版本——这是 linux 下 redis 安装与启动最常见的翻车现场。很多人以为装个包就算完事其实「能用」和「被管好」是两回事安装方式、daemonize 参数、systemd 单元文件任何一环错位都会在微服务架构里变成一颗定时炸弹。这篇笔记把 redis 从安装、启动、停止到做成服务的整条链路走一遍。新手照着敲能跑通老手可以直接跳到参数边界和踩坑点少交点血泪学费。2. 装之前先分清三件事版本来源、运行形态、系统参数2.1 系统包管理器安装和源码编译分别适合什么人你拿到一台 Linux 服务器第一件事不是急着敲安装命令而是想清楚 Redis 从哪来。最常见的选择就是系统包管理器或者源码编译。Debian/Ubuntu 上用 apt 安装 Redis 最省事一条命令把二进制、默认配置、甚至 systemd 脚本都给你摆好CentOS/RHEL 系的 yum/dnf 同样有 redis 包。区别主要在版本apt 仓库里的 redis 通常和发行版生命周期绑定老系统上可能还是 4.x/5.xRedis 7 开始提供的多线程 IO、访问控制列表这些能力就享受不到。适合的场景是「马上能用、不想折腾依赖、接受系统源的版本」。源码编译适合三类人需要新版本特性的人比如要在微服务拆分后拿 Redis 做中间件必须上新版才有的命令需要自定义安装目录和编译参数的人比如统一装在 /opt/redis还有内网环境连不上外网仓库只能把源码包拷进去编。代价是依赖和后续升级自己维护。我给普通业务环境的建议是能上包就上包除非有明确的版本或定制需求如果踩到老版本 bug再换源码编译不迟。不要为了「显得专业」上来就编译。两种方式对比如下选型时可以对号入座。| 对比项 | 包管理器安装 | 源码编译安装 | | 版本 | 随发行版源可能偏旧 | 自己决定可新可旧 | | 依赖 | 自动处理 | 需要 gcc、make 等工具链 | | 服务脚本 | 多数发行版自带 systemd 单元 | 通常要自己写 | | 定制能力 | 低 | 可以改编译参数和安装前缀 |选型重点不是「哪个更高级」而是「升级和排障时你搞不搞得定」。包管理器装的出问题可以直接 apt remove --purge 重来是后悔药源码编译装的卸载就得自己清理二进制和配置文件路径乱了反而更容易藏问题。2.2 前台进程、daemonize、systemd 托管三种运行形态先分清Redis 的「运行形态」决定了你后面怎么停、怎么自启很多启动失败其实是形态没选对。第一种是前台运行直接执行 redis-server进程占住当前终端日志实时打到屏幕上CtrlC 就能停。这是排障时最推荐的方式因为你能亲眼看到每一条启动日志和报错。第二种是 daemonize yes让 Redis 自己 fork 到后台变成守护进程。这种方式能脱离终端常驻PID 写进 pidfile传统 sysvinit 时代很流行。问题在于一旦进程崩了没有人替你拉起来你只看到「端口没了」进程状态成了黑匣子得靠外部监控发现。第三种是 systemd 托管RHEL 7 之后和大部分现代发行版的标准做法。redis-server 保持前台进程systemd 把它的生命周期管起来支持崩溃重启、开机自启、日志统一收集到 journalctl。这里必须记住一条红线daemonize yes 和 systemd 的 Typesimple 是冲突的。systemd 以为主进程退出就等于服务结束于是你明明看到 Redis 进程在跑systemctl status 却显示 inactive (dead)。后面第 5 章做成服务时配置文件里要把 daemonize 改成 no让 systemd 来做那个「监护人」。这条捋不顺后面启动和停止都会出各种别扭的问题。2.3 动手装之前先把三个系统参数调到位很多 Redis 启动正常、运行翻车的案例锅在操作系统参数而不是 Redis 本身。第一个是 vm.overcommit_memory。Redis 做 RDB 持久化时要 fork 子进程fork 需要申请内存如果内核不允许内存过载申请后台保存会直接失败日志报 Cannot allocate memory。官方建议把它设为 1总是允许在一台 4G 内存、Redis 占用 3G 的机器上这个参数能救命。检查命令是 sysctl vm.overcommit_memory临时设置是 sysctl -w vm.overcommit_memory1持久化写进 /etc/sysctl.conf。第二个是透明大页 THP。Redis 官方明确建议关闭因为大页分配会导致内存页移动造成延迟毛刺看起来就是「莫名其妙的慢」。关闭命令是 echo never /sys/kernel/mm/transparent_hugepage/enabled要开机自动关闭可以写到 rc.local或者用 systemd-tmpfiles 配置。第三个是文件描述符上限。默认 ulimit -n 常常是 1024Redis 连接数一多就报 max clients reached。在 systemd 单元里用 LimitNOFILE 调到 65535 是最干净的做法不用去动全局的系统配置。除此之外swap 的大小也会直接影响 Redis 的响应性。如果 maxmemory 设置得比物理内存大很多或者机器本身内存吃紧Redis 的页会被换到 swap读写延迟从毫秒级跳到百毫秒级业务侧看到的就是超时。调优时我习惯先用 free -m 看清楚真实内存余量再决定 maxmemory 上限别把 Redis 当成无底洞往里塞。以上参数不调Redis 也能装也能跑但在压力上来或者持久化触发时会以最难查的方式翻车。我一般装完第 3 章的步骤、跑通最小实例之后顺手就把这几个参数确认一遍省得后面出事再来翻 /var/log 猜原因。3. 装一个能用的 Redis两条安装路线和装完必须确认的三项配置3.1 用系统包管理器安装一分钟跑通最小实例如果你手里的 Linux 镜像装出来的是常见发行版最快路径是直接用包管理器。以 Debian/Ubuntu 为例sudo apt-get update sudo apt-get install -y redis-server # RHEL 系对应的命令 # sudo dnf install -y redis redis-cli --version redis-server --version这段的逻辑是先把软件源刷新一次再安装包。注意在 RHEL 系上redis 可能不在默认仓库里如果 dnf install 提示找不到包先检查当前启用的软件源里有没有没有就加对应发行版维护的 redis 源。装完以后验证版本redis-cli --version 是客户端版本redis-server --version 是服务端版本两者不一致通常无害但你要知道你手里的到底是哪个版本这个信息后面排障很有用。Debian 系安装 redis-server 时通常会自动把它注册成服务并启动所以装完直接验证就行。RHEL 系某些版本不会自动启动需要手动 systemctl start redis。到底起没起用 ping 命令验证redis-cli -h 127.0.0.1 -p 6379 ping返回 PONG 说明服务正常返回 Could not connect说明服务没启动或端口不是 6379。-h 指定主机、-p 指定端口本地默认可以省略成 redis-cli ping。这一步做完你已经有一个最小可用的 Redis 了剩下的工作都在「管好它」而不是「装好它」。如果你的需求只是本地开发到这里就可以收工了。3.2 需要特定版本或定制目录时源码编译三步走包管理器版本太旧、需要官方最新稳定版、或者要自定义安装目录时源码编译是更可控的方案。步骤大致是准备工具链、下载源码包、编译安装# 1. 准备编译环境 sudo apt-get install -y build-essential # RHEL 系对应sudo dnf groupinstall Development Tools # 2. 从官网下载源码包并解压 wget https://download.redis.io/releases/redis-7.2.4.tar.gz tar -xzf redis-7.2.4.tar.gz cd redis-7.2.4 # 3. 编译并安装 make -j$(nproc) sudo make install PREFIX/usr/local/redis逻辑说明build-essential 提供 gcc、make 等编译工具官网源码包下载拿到的是你选定的稳定版示例里的 7.2.4 可以按需替换别刻舟求剑。make -j$(nproc) 用 nproc 检测出的核数并行编译失败时建议去掉 -j 重跑能看到更完整的错误信息第一遍全量编译大约几分钟。PREFIX 指定安装前缀装完后二进制在 /usr/local/redis/bin 下不在默认 PATH 里需要手动把该目录加进 PATH或者直接使用绝对路径。源码包里自带的 redis.conf 是很好的起点拷到 /etc/redis/redis.conf 备用。编译后如果想跑一遍自检可以执行 make test官方测试套件能帮着发现环境层面的兼容性问题虽然耗时比较长。这里提醒一句源码编译不等于「一定比包管理好」你获得版本自由的同时也接过了安全更新和 systemd 管理的责任。特别是第 5 章的 redis.service包管理器通常已经帮你写好源码编译就得自己写了。选择源码编译时最好在安装目录之外再留一个版本的副本升级时可以平滑切回去。3.3 装完第一件事查看 bind、protected-mode、daemonize 三个默认值新装好的 Redis 是从默认配置启动的默认配置未必适合你的场景。我先习惯查四个值redis-cli CONFIG GET bind redis-cli CONFIG GET protected-mode redis-cli CONFIG GET daemonize redis-cli CONFIG GET requirepassCONFIG GET 的返回值会列出参数名和当前值。bind 默认通常是 127.0.0.1部分新版本还带着 ::1意味着只有本机能连本机 redis-cli 能用远程连接工具一概超时。protected-mode 默认 yes它的作用是在没有设置 requirepass、并且 bind 了非本机地址的情况下拒绝外部主机的连接。requirepass 默认是空也就是任何人都能用 redis-cli 连上来前提是网络能到达。这三个值组合起来决定了你的 Redis 暴露给谁。如果之前已经设过密码CONFIG GET 要带上 -a 参数再查。本地开发环境保持默认值没问题但如果这台机器要被其他业务访问——比如微服务架构里的某个服务要读写 Redis——就必须把 bind 改成内网 IP并设置一个靠得住的口令。改的时候用 CONFIG SET 可以热生效但要想重启后还在要么改 redis.conf要么 CONFIG REWRITE。最后记住daemonize 先别设为 yes后面做成服务时会用 systemd 接管这里保持 no 最干净。4. 启动与停止的正确姿势前台启动、优雅停机、临时参数4.1 首启动前台模式亲眼看完日志再谈下一步服务的第一次启动我最建议前台跑别一上来就 daemonize。命令很简单redis-server /etc/redis/redis.conf # 或者临时用一个指定端口起测试实例 redis-server --port 6380带配置文件启动时Redis 会读取 bind、port、logfile、dir 等配置不带任何参数则用内置默认配置。前台模式下日志直接打在终端上你能看到启动链路端口绑定、是否加载持久化文件、是否 ready。看到 Ready to accept connections 这行说明启动成功。如果端口被占会直接报 bind 失败如果配置里的日志目录没有写权限也会在这里暴露而不是等到服务跑到一半才悄悄挂掉。另一种排障做法是临时指定端口起一个不干扰现有 6379 的测试实例。参数优先级高于配置文件所以 --port 6380 会覆盖配置文件里的 6379。前台启动时 CtrlC 就是停止Redis 收到 SIGINT 后会尽力做一次保存再退出。这一步跑通了你对「启动长什么样」就有直观认识后面用 systemd 也只是把 stdout 交给 journald 而已。4.2 用 redis-cli shutdown 优雅停机别把 kill -9 当习惯停止 Redis 不是杀掉进程那么简单尤其是开了持久化的情况下。正确姿势是用客户端发 shutdown 命令redis-cli -p 6379 shutdown # 设置了 requirepass 时必须带密码 redis-cli -p 6379 -a yourpassword shutdown # 明确不想保存当前数据快照 redis-cli -p 6379 shutdown nosaveshutdown 的流程是停止接收新命令按 save 策略做一次 RDB 保存除非带 nosave刷写 AOF然后关闭监听端口并退出。也就是说shutdown 是给 Redis 一次「体面退场」的机会。kill -9 相当于直接拔电源后果包括最近未落盘的数据丢失AOF 文件写到一半留下残缺主从场景下从库被迫做全量重同步带宽瞬间被打满。这个教训我在生产环境见过不止一次。nosave 参数适合清理临时实例比如测试环境里不想留下脏数据直接清掉快照退出。注意-a 密码会出现在命令行进程列表里虽然方便生产不建议用明文方式可以改用 REDISCLI_AUTH 环境变量。日常停官方服务我基本只用 systemctl stop redis因为它内部最终也是走 shutdown。4.3 daemonize 与 systemd 的角色分工别让两个「后台化」打架很多教程会教你 daemonize yes 然后手动 redis-server 甩后台这在十年前没问题但今天会跟 systemd 打架。先说清楚两边的定位daemonize yes 是 Redis 自己 fork 一个子进程到后台原进程退出子进程脱离终端systemd 则是希望看到「一个稳定的主进程」来托管。如果 redis.conf 里 daemonize yes再用 systemd 以 Typesimple 方式托管systemd 启动后立刻发现主进程退出了会判定服务失败表现为进程在跑systemctl status 却显示 inactive (dead)。如果真想用 daemonize那 unit 文件必须写 Typeforking 并且指定 PIDFile让 systemd 跟着 fork 出来的子进程走。但现在主流做法是反过来redis.conf 里 daemonize no进程保持前台由 systemd 来做后台化。这样 systemd 能准确知道主进程的状态崩溃自动重启、开机自启、日志采集全都顺理成章。提示redis.conf 里 daemonize 务必设为 no否则后面手写 service 文件时大概率踩「进程在跑但服务 dead」的坑。一句话手动后台有手动的玩法做成服务就走服务该走的路。手动起后台任务时用 nohup 也是可以的但既然现代发行版都带 systemd没必要绕回老办法。4.4 命令行临时指定参数不污染配置的测试玩法有些时候我们不想动正式配置文件只想临时验证某个参数的效果。Redis 允许在命令行直接覆盖配置redis-server --port 6380 --requirepass test123 --maxmemory 256mb # 运行时把内存上限调大 redis-cli -p 6380 -a test123 CONFIG SET maxmemory 512mb第一行启动一个 6380 端口的独立实例内存上限先给 256mb密码 test123全部通过命令行传入不影响 /etc/redis/redis.conf。第二行是在运行时把 maxmemory 改成 512mb。注意 CONFIG SET 是热生效但只改内存里那份配置想让重启后保持需要再执行 CONFIG REWRITE它会回写当前配置文件。多实例是很常见的使用场景比如一台机器上 6379 给业务缓存、6380 给队列这种临时起停的方式配合 redis-cli -p shutdown 非常顺手。5. 把 Redis 做成服务systemd 单元文件、权限与高频问题排查5.1 手写一个干净的 redis.service 单元文件如果是包管理器装的 redis系统的 /lib/systemd/system/redis-server.service 通常已经现成不需要重写。源码编译或者想把服务名改成更顺手的 redis 时可以在 /etc/systemd/system/ 下手写一个[Unit] DescriptionRedis server Afternetwork.target [Service] Typesimple Userredis Groupredis ExecStart/usr/local/redis/bin/redis-server /etc/redis/redis.conf ExecReload/bin/kill -HUP $MAINPID ExecStop/usr/local/redis/bin/redis-cli -p 6379 shutdown Restarton-failure RestartSec3s LimitNOFILE65535 [Install] WantedBymulti-user.target逐行说明Typesimple 表示 systemd 直接管理前台主进程对应 redis.conf 里 daemonize noUser/Group 指定运行用户生产环境别用 root 跑 RedisExecStart 是真正的启动命令路径要和前面安装的二进制一致ExecReload 用 kill -HUP 让 Redis 重新加载配置日常可以用 systemctl reload redisExecStop 调用 redis-cli shutdown 做优雅停机这是关键避免 systemd 直接 SIGTERM 导致非优雅退出。如果设置了 requirepassExecStop 要写成带 -a 的形式或者把口令放在 EnvironmentFile 里避免明文出现在进程列表。Restarton-failure 让服务在崩溃时自动拉起RestartSec3s 是重启前的等待时间。LimitNOFILE65535 把这个服务的文件描述符上限放大解决连接数打满的默认限制。写完后先 daemon-reload 让 systemd 认这个新文件。还要确认运行用户存在以及配置文件里 dir、logfile、pidfile 对应的目录属主都是 redis。如果缺用户用 useradd -r -s /sbin/nologin redis 建一个目录用 chown -R redis:redis 给权。这样 unit 文件才算是完整闭环。5.2 权限、SELinux、AppArmor服务起不来的三个拦路虎做成服务以后最常见的启动失败反而不是 Redis 本身的问题。第一是文件权限。redis-server 以 redis 用户运行但配置里 dir 指向 /var/lib/redislogfile 指向 /var/log/redis/redis.log这两个目录如果属主是 root 且没有写权限进程启动就报 Cant open the log file: Permission denied 或 Cant create PID file。排查方法是先看 redis.conf 里的 dir、logfile、pidfile 三个值再用 ls -ld 确认属主。解决很简单目录给 redis 用户写权限或者建目录后 chown。第二是 SELinux主要在 RHEL/CentOS 系。Redis 写非默认目录会被 SELinux 策略挡掉错误日志有时只在 /var/log/audit/audit.log 里留下一条 avc: denied看起来就像玄学。先用 setenforce 0 临时关掉验证如果立刻能启动就是策略问题。长期解决是用 semanage fcontext 把新目录的默认类型改成 redis_var_lib_t再 restorecon 一下。不推荐长期关 SELinux等于给自己埋雷。第三是 AppArmorUbuntu 系默认启用。源码编译把 Redis 装到 /opt/redis数据目录写到 /data/redis如果 /etc/apparmor.d/ 里有 redis 相关的 profile访问会被拒。现象是进程起来了但 dir 创建失败日志被截断。排查看 dmesg 或 /var/log/syslog 里有没有 apparmorDENIED。解决是把 profile 的路径规则改好再 reload或者把数据目录放到 profile 允许的位置。这些坑的共同点是看 Redis 日志只是第一层系统日志才是最终答案。5.3 启动、开机自启、看日志systemctl 三件套unit 文件就位后剩下的操作就是标准的 systemd 流程sudo systemctl daemon-reload sudo systemctl enable redis sudo systemctl start redis sudo systemctl status redis journalctl -u redis --since todaydaemon-reload 是新增或修改了 /etc/systemd/system/ 下的 unit 后必做的让 systemd 重新扫描enable 只是建立开机自启的软链不会立即启动start 才真正拉起进程。所以首次做成服务时enable 和 start 都要执行以后开机自动跑这次也立刻跑起来。status 输出里看 Active: active (running)下面 CGroup 段落能看到 redis-server 进程。journalctl -u redis 看这个服务这次启动的日志--since today 过滤出今天的如果单元文件里没有配置标准输出重定向Redis 的日志会出现在这里。日常维护基本就是 systemctl restart redis 和 systemctl stop redis 两个命令和手动 redis-cli shutdown 等价但更统一。5.4 高频翻车记录现象、原因、解决这一节写我踩过的几个真实方向每一条都按「现象、原因、解决」来复盘。坑 1执行 redis-cli shutdown 后端口还在。现象是日志显示已退出但 ss -lntp 还能看到监听进程。原因多半是 systemd 单元文件的 ExecStop 里写错了端口或者机器上其实起了两个 redis-server 实例。解决先 ps -ef | grep redis-server 数一遍进程核对 unit 文件 ExecStop 的端口与 redis.conf 端口一致统一改成 systemctl stop redis 来停。坑 2进程在跑systemctl status 却显示 dead。现象是 redis-server 变成后台进程systemd 认为主进程结束了。原因是 redis.conf 里 daemonize yes 与 Typesimple 冲突。解决把 redis.conf 的 daemonize 改为 no如果确实要 daemonize把 unit 的 Type 改成 forking 并补上 PIDFile。这条是「redis 做成服务」最典型的翻车点。坑 3内存策略设错导致服务卡死。现象是写入量一大Redis 性能骤降日志出现 OOM command not allowed。原因是 maxmemory 设置得太小同时 maxmemory-policy 选了 noeviction写命令被拒。解决用 INFO memory 看 used_memory 峰值结合机器物理内存重新估 maxmemory缓存场景用 allkeys-lru 比 noeviction 稳妥改完记得 CONFIG REWRITE。坑 4外部机器连不上本地却一切正常。现象是 redis-cli ping 在本机通了Redis Desktop Manager 或微服务里的 api 服务连不上。原因是 bind 127.0.0.1 只监听本机protected-mode yes 在没有密码时拒绝外部。解决生产环境把 bind 改成内网 IP设置 requirepassredis-cli 访问时也带 -h 内网IP -a 口令。不要为了图省事把 bind 改成 0.0.0.0 且不开密码那等于把数据裸奔在网络上。坑 5kill -9 之后 AOF 文件损坏。现象是重启时报 Bad file formatRedis 起不来。原因是 AOF 文件写入到一半被强制中断。解决先用 redis-check-aof --fix 修复 AOF再启动修复前先备份原文件。日常停止一定要走 shutdown 或 systemctl stopkill -9 只有进程僵死时才能作为最后手段。6. 服务做完了还要会验证健康度、读日志与留后路6.1 三个命令确认服务真的健康服务做成之后我习惯用三个命令做冒烟验证redis-cli ping redis-cli info memory | head -20 redis-cli info keyspaceping 确认链路通info memory 里重点看 used_memory 和 used_memory_peak如果峰值已经顶着 maxmemory说明容量预警info keyspace 看各个库的 key 数量判断业务有没有把 Redis 当无限存储乱写。想压一下性能可以顺手跑 redis-benchmarkredis-benchmark -h 127.0.0.1 -p 6379 -c 50 -n 100000 -t set,get-c 并发数、-n 总请求数、-t 测试命令集合输出每秒请求数和平均延迟。压测注意别在生产高峰期直接打满小并发跑两分钟就够了主要是看有没有异常掉底。6.2 日志里值得警惕的几条危险信号后面维护 Redis日志里看到这几条要当回事。OOM command not allowed 说明内存策略开始干活了业务在丢写失败Cant save in background: fork: Cannot allocate memory 指向 overcommit 参数或内存不足Failed opening the RDB file 基本是目录权限或磁盘满Possible SECURITY ATTACK detected 说明有人在探测你的实例立刻检查 bind 和密码。平时多用 journalctl -u redis 翻日志别等服务挂了再去看那样只能拿到事后诸葛亮。6.3 我的习惯改配置前先留后悔药最后一点也是我踩坑换来的习惯动 redis.conf 之前一定先备份。我改任何参数前都会执行 cp redis.conf redis.conf.bak-$(date %F)运行中热改完习惯性 CONFIG REWRITE但 rewrite 之前再备份一次因为它会把原文件里的注释和格式整理一遍回滚时有个干净的前一版比对。升级或迁移前用 redis-cli SAVE 主动落一次盘再做系统的快照。曾经我图省事直接 kill -9 一台从库的 Redis重启后主从全量同步把内网带宽打爆整个集群跟着抖动。后来再碰 Redis一律 systemctl restart 或 shutdown手动进程先查 PID 再动手。这套流程维持到现在基本没再在启停上翻过车。希望帮到你。本文还有配套的精品资源点击获取
