3个步骤搭建macOS本地RTMP流媒体服务

核心功能解析

Local RTMP Server是一款基于Electron框架开发的macOS应用，专为本地流媒体传输设计。它能在你的Mac上快速构建一个轻量级RTMP服务器，实现本地网络内的视频流传输与分发。

核心特性包括：

• 自动端口分配与冲突检测
• 多流并发处理能力
• 实时流状态监控
• 简洁的菜单栏操作界面
• HLS协议支持，便于多设备访问

快速上手指南

步骤1：获取项目代码

执行以下指令克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/ma/mac-local-rtmp-server
cd mac-local-rtmp-server

步骤2：安装依赖并启动服务

执行以下指令安装项目依赖：

npm install

启动应用程序：

npm start

💡 技巧：首次启动时，应用会自动在菜单栏创建图标，默认状态显示为就绪状态图标。

步骤3：配置流媒体源

1. 启动后，应用会自动生成随机流密钥
2. 在OBS等推流软件中设置推流地址：rtmp://127.0.0.1/live/[随机流密钥]
3. 开始推流后，菜单栏图标会变为录制状态
4. 通过应用窗口查看当前流状态和访问链接

个性化配置教程

核心配置参数说明

参数	默认值	说明
rtmp.port	1935	RTMP协议默认端口
rtmp.chunk_size	60000	数据块大小，单位：字节
rtmp.gop_cache	true	是否启用GOP缓存
rtmp.ping	60	心跳检测间隔，单位：秒
rtmp.ping_timeout	30	心跳超时时间，单位：秒
http.port	随机	HTTP服务器端口
http.mediaroot	./media	媒体文件存储路径

参数调整建议及效果对比

[!TIP] 对于低配置Mac，建议将chunk_size调整为40000以减少内存占用，但可能会略微增加网络传输开销。

配置方案	适用场景	优势	劣势
默认配置	标准使用	平衡性能与质量	无特殊优化
chunk_size=40000	低配设备	降低内存占用	略微增加网络传输
gop_cache=false	实时性要求高	减少延迟	增加带宽消耗

端口占用检测技巧

执行以下指令检查1935端口是否被占用：

lsof -i :1935

如果端口被占用，可以修改main.js中的端口配置：

const nms = new NodeMediaServer({
  rtmp: {
    port: 1936, // 修改为未占用端口
    // 其他配置...
  }
});

新手常见问题

Q1：启动后菜单栏没有显示应用图标？

A：可能是应用被系统隐藏，请在系统偏好设置→扩展→菜单栏中启用该应用。

Q2：推流成功但无法观看？

A：检查防火墙设置，确保1935端口允许入站连接；或尝试关闭VPN后重试。

Q3：如何从局域网其他设备推流？

A：将推流地址中的127.0.0.1替换为Mac的局域网IP，例如：rtmp://192.168.1.100/live/streamkey

Q4：应用意外退出怎么办？

A：查看系统日志或项目根目录下的错误日志，通常是端口冲突或依赖缺失导致。

Q5：如何开机自动启动？

A：在系统偏好设置→用户与群组→登录项中添加应用程序。

同类方案对比分析

Local RTMP Server作为轻量级解决方案，与专业流媒体服务器相比：

优势：

• 无需复杂配置，即开即用
• 资源占用低，适合个人使用
• 专为macOS优化的用户界面

劣势：

• 不支持集群部署
• 高级功能如转码、权限管理有限
• 不适合大规模生产环境使用

相比OBS内置的媒体服务器，本项目提供更稳定的连接和多流支持，但缺少OBS的录制和编辑功能。

功能扩展建议

HTTPS配置

通过反向代理（如Nginx）为RTMP流添加HTTPS支持，提高传输安全性：

server {
  listen 443 ssl;
  server_name yourdomain.com;
  
  ssl_certificate /path/to/cert.pem;
  ssl_certificate_key /path/to/key.pem;
  
  location /live {
    proxy_pass http://localhost:8000;
    proxy_set_header Host $host;
  }
}

集群部署方向

对于需要更高并发的场景，可以：

1. 使用负载均衡分发RTMP流
2. 配置共享存储实现媒体文件同步
3. 部署多个实例并通过API统一管理

高级监控集成

可通过修改main.js添加Prometheus指标导出，实现流量和连接数监控：

// 在nms.run()之后添加
const promClient = require('prom-client');
const express = require('express');
const app = express();

const register = new promClient.Registry();
promClient.collectDefaultMetrics({ register });

// 添加自定义指标
const streamCount = new promClient.Gauge({
  name: 'rtmp_streams_total',
  help: 'Total number of active streams'
});
register.registerMetric(streamCount);

// 更新指标
setInterval(() => {
  streamCount.set(currentStreams.size);
}, 5000);

app.get('/metrics', async (req, res) => {
  res.set('Content-Type', register.contentType);
  res.end(await register.metrics());
});
app.listen(9090);

总结

通过本文介绍的三个步骤，你已成功搭建了一个功能完备的本地RTMP服务器。无论是游戏直播、教学录制还是家庭媒体共享，该工具都能提供稳定高效的流媒体服务。根据实际需求调整配置参数，并探索扩展功能，可以进一步提升服务质量和适用范围。

该项目特别适合内容创作者、教育工作者和开发人员使用，为本地网络流媒体传输提供了便捷解决方案。随着使用场景的深入，你可以根据本文提供的扩展建议，逐步构建更强大的流媒体服务架构。