red5是一款开源的流媒体服务器，基于Java开发，支持RTMP、HLS等常见流媒体协议，常被用来搭建直播、点播、视频会议等应用。对于刚入门流媒体开发的人来说，red5服务器环境搭建是绕不开的第一步，但很多人在这一步就被各种报错劝退了。其实red5的安装配置并不复杂，只要把准备工作做扎实，按正确的顺序操作，一般半小时内就能跑起来。本文把搭建过程拆开揉碎讲清楚，并附上高频疑问解答，帮你少走弯路。
一、搭建前的准备工作
red5是用Java写的，所以第一步必须是装好JDK。red5对JDK版本有要求，老版本red5建议使用JDK 8，较新版本可以尝试JDK 11或以上，但为了稳妥起见，新手直接选JDK 8最省心，兼容性问题最少。可以去Oracle官网下载，也可以用OpenJDK，安装过程一路下一步即可。
装完JDK别忘了配置环境变量。Windows系统需要新建JAVA_HOME变量指向JDK安装目录，比如C:\Program Files\Java\jdk1.8.0_301，然后在Path里添加%JAVA_HOME%\bin。Linux系统则是编辑/etc/profile或者用户目录下的.bashrc，添加export JAVA_HOME和export PATH的配置。配置完成后在命令行输入java -version，能正常打印版本信息就说明JDK这一关过了。
接着下载red5安装包。建议去官网或者GitHub的red5项目页面下载稳定版，新手不要追新版本，稳定版踩坑最少。Windows下有安装版和绿色版两种，推荐绿色版解压即用；Linux下直接下载压缩包解压即可。另外提前确认服务器的80端口和5080端口没有被占用，red5默认使用5080作为HTTP端口，1935作为RTMP端口，这两个端口后面都要用到。
二、red5的安装与启动步骤
Windows系统下，把压缩包解压到某个不含中文和空格的目录，比如D:\red5。这一点很重要，路径里带中文或空格经常导致启动失败，是新手最常踩的坑之一。解压完成后，进入目录找到red5.bat，双击运行，或者打开命令行执行它，看到控制台输出Server startup之类的字样，说明服务已经起来了。
Linux系统下，解压后给red5.sh加上执行权限，执行chmod +x red5.sh，然后用./red5.sh启动。如果想让它后台运行，可以用nohup ./red5.sh > log.txt 2>&1 &的方式，或者配置成系统服务开机自启。启动后用jps命令查看进程，能看到Bootstrap或者Red5字样就说明进程存活。
启动成功后，打开浏览器访问http://127.0.0.1:5080，如果看到了red5的欢迎页面，恭喜你，环境搭建基本成功。如果远程服务器上搭建，访问时要把127.0.0.1换成服务器的公网IP或内网IP，同时确保防火墙和安全组放行了5080和1935端口，云服务器还要在控制台的安全组里单独添加规则，很多人本地能访问、远程死活打不开，九成是端口没放行。
三、安装演示应用并验证流媒体功能
光看到欢迎页还不够，需要装一个应用来验证推流和播放功能。点击欢迎页面上的installer链接，进入应用安装页面，里面列出了官方提供的示例应用，比如oflaDemo，这是一个经典的流媒体演示程序，支持FLV播放和录制。点击install按钮等待安装完成。
安装完成后访问http://127.0.0.1:5080/demos/ofla_demo.html，可以用页面里的播放器测试播放red5自带的示例视频。如果能正常播放画面和声音，说明RTMP服务工作正常。之后可以用OBS等推流软件，把RTMP地址设置为rtmp://服务器IP/oflaDemo，串流密钥随意填写，推流成功后在播放端拉这个地址，就完成了最简单的一套直播验证流程。
需要提醒的是，示例应用仅供测试用，正式项目中一般要自己开发应用，把编译好的应用放到red5的webapps目录下，重启red5即可加载。webapps下每个文件夹对应一个应用，里面要有WEB-INF目录和red5-web.xml配置文件，这部分涉及开发内容，入门阶段先掌握目录结构就够了。
四、常见疑问与踩坑解答
问题一：启动时报端口被占用怎么办？这是最常见的情况，可以用netstat -ano | findstr 5080（Windows）或netstat -tlnp | grep 5080（Linux）查到占用进程，要么结束该进程，要么修改red5安装目录conf下的red5.properties文件，把http.port改成其他端口，比如5081。
问题二：启动一闪而过没有任何提示？多半是JDK没装好或版本不匹配。先用java -version确认JDK可用，再检查JAVA_HOME配置是否正确。如果用的是高版本red5配了低版本JDK，也会报错，版本要对得上。另外路径含中文、空格也会导致闪退，把red5挪到纯英文路径下再试。
问题三：本地能访问，外网访问不了？依次检查三层：服务器防火墙、云平台安全组、red5监听地址。防火墙用firewall-cmd或iptables放行端口；云服务器去控制台安全组添加5080和1935的入站规则；red5.properties里的监听地址如果写的是127.0.0.1，改成0.0.0.0才能接受外部连接。
问题四：推流后播放卡顿或延迟大？这涉及服务器带宽和编码参数，先确认服务器出口带宽够不够，推流端把码率降下来试试。red5本身性能中规中矩，并发要求高的场景需要做调优，或者考虑red5 Pro等商业方案。入门阶段先保证流程跑通，性能问题后面再逐步优化。
五、搭建要点总结
回顾整个流程，red5环境搭建的核心就是三件事：装好匹配版本的JDK并配好环境变量、把red5放在纯英文路径下正确启动、放行端口并验证安装演示应用。只要这三步都做到位，环境基本不会出大问题。遇到报错不要慌，先看red5目录下的日志文件，日志里的异常信息是排查问题的关键线索，比盲目搜索效率高得多。把这些基本知识和操作要点掌握了，后续学习red5应用开发和流媒体原理都会顺利很多。