Mac本地RTMP服务器完全配置指南

准备工作：从零开始搭建环境

让我们先了解什么是RTMP服务器——RTMP协议（实时消息传输协议，常用于直播推流）允许你在本地搭建流媒体服务，无需依赖第三方平台即可实现视频流的接收和分发。在开始前，请确保你的开发环境满足以下条件：

🔍 环境检查清单

• macOS系统（项目基于Electron开发，专为macOS优化）
• Node.js环境（建议v12+，可通过node -v检查版本）
• npm包管理器（通常随Node.js一同安装）
• Git工具（用于克隆项目代码）

首先克隆项目代码库到本地：

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

安装项目依赖是关键步骤，我们需要通过npm安装所有必要的组件：

npm install  # 安装package.json中声明的依赖包

💡 小贴士：如果安装过程中出现Electron相关错误，尝试设置Electron镜像源加速下载：

npm config set electron_mirror https://npm.taobao.org/mirrors/electron/

核心功能解析：服务器工作原理

成功搭建环境后，让我们深入了解这个RTMP服务器的工作方式。项目基于node-media-server构建，通过Electron框架提供图形化界面，主要代码结构如下：

• main.js：主进程文件，负责启动RTMP服务器和管理应用生命周期
• renderer.js：渲染进程文件，处理UI交互和状态展示
• assets/：包含前端资源，如CSS样式和图片资源

服务器启动流程：

1. 应用启动时，Electron会创建主窗口并加载UI界面
2. NodeMediaServer实例在后台启动，默认监听1935端口（RTMP标准端口）
3. 系统托盘图标会根据流状态变化（空闲时显示readyTemplate.png，有流时显示recording.png）

查看服务器核心配置（main.js第41-65行）：

const nms = new NodeMediaServer({
  rtmp: {
    port: 1935,                  // RTMP协议默认端口
    chunk_size: 60000,           // 视频流分片大小
    gop_cache: true,             // 启用GOP缓存优化直播体验
    ping: 60,                    // 心跳检测间隔(秒)
    ping_timeout: 30             // 超时断开连接时间(秒)
  },
  http: {
    port: port,                  // HTTP服务端口(自动获取可用端口)
    mediaroot: './media',        // 媒体文件存储目录
    allow_origin: '*'            // 允许跨域访问
  },
  trans: {
    ffmpeg: '/usr/local/bin/ffmpeg',  // FFmpeg路径，用于转码
    tasks: [
      {
        app: 'live',             // 应用名称
        ac: 'aac',               // 音频编码格式
        hls: true,               // 启用HLS协议支持
        hlsFlags: '[hls_time=2:hls_list_size=3:hls_flags=delete_segments]'
      }
    ]
  }
});

⚠️ 注意事项：确保系统已安装FFmpeg，否则无法进行视频转码。可通过brew install ffmpeg快速安装。

参数调优指南：打造专属流媒体服务

虽然默认配置已能满足基本需求，但根据实际使用场景调整参数可以获得更好的性能。以下是关键配置项的优化建议：

1. 连接性能优化

• max_clients：最大连接数，默认未显式设置（node-media-server默认值为100）
  • 家庭使用：保持默认值即可
  • 小型团队：建议设置为50-80（避免资源占用过高）
  • 测试环境：可降低至10便于问题排查

2. 视频质量控制

在main.js的trans.tasks配置中，可添加视频编码参数：

tasks: [
  {
    app: 'live',
    ac: 'aac',
    hls: true,
    hlsFlags: '[hls_time=2:hls_list_size=3:hls_flags=delete_segments]',
    // 新增视频编码配置
    vc: 'h264',                 // 视频编码格式
    vcodec: 'libx264',          // 编码器
    videoBitrate: '2000k',      // 视频比特率(建议1000k-5000k)
    width: 1280,                // 输出宽度
    height: 720,                // 输出高度
    fps: 30                     // 帧率
  }
]

💡 性能平衡技巧：高分辨率（1080p）搭配低比特率（<3000k）会导致画面模糊，建议720p对应2000-3000k，1080p对应4000-6000k比特率。

3. 存储管理

默认媒体文件存储在项目根目录的media文件夹，可通过修改http.mediaroot参数更改存储路径：

http: {
  mediaroot: '/Volumes/ExternalDrive/media',  // 外部硬盘路径
  // ...其他配置
}

故障排查：解决常见启动问题

即使最完善的配置也可能遇到问题，以下是三个常见故障的解决方案：

问题1：端口被占用导致启动失败

症状：启动时报错"EADDRINUSE: address already in use :::1935" 解决方法：

1. 查找占用1935端口的进程：

lsof -i :1935

2. 根据PID终止进程：

kill -9 <PID>

3. 或修改main.js中的RTMP端口（第43行）为其他值，如1936

问题2：FFmpeg未找到

症状：转码功能失效，日志显示"ffmpeg: not found" 解决方法：

1. 通过Homebrew安装FFmpeg：

brew install ffmpeg

2. 检查安装路径：

which ffmpeg  # 通常输出/usr/local/bin/ffmpeg

3. 确保main.js中trans.ffmpeg路径与实际安装路径一致

问题3：托盘图标显示异常

症状：应用启动后托盘图标显示为问号或空白 解决方法：for循环检查assets/img目录下的图标文件是否存在：

ls -l assets/img/*.png

如果文件缺失，可从项目仓库重新获取图标资源。

使用指南：开始你的第一个直播流

完成配置后，让我们启动服务器并测试推流功能：

1. 启动应用：

npm start  # 开发模式启动
# 或构建应用后运行
npm run dist
open dist/mac/Local\ RTMP\ Server.app

2. 应用启动后，系统托盘会显示就绪状态图标（蓝色圆点）

3. 获取推流地址：点击托盘图标，在弹出窗口中复制RTMP地址（格式为rtmp://127.0.0.1/live/[随机密钥]）

4. 使用OBS等推流软件设置推流地址，开始直播

💡 实用技巧：点击界面中的复制图标可以快速复制推流地址和播放地址，无需手动输入。

总结

通过本指南，你已经掌握了Mac本地RTMP服务器的搭建、配置和优化技巧。这个轻量级解决方案特别适合开发测试、小型活动直播或个人内容创作。随着使用需求的变化，你可以进一步探索main.js中的高级配置选项，如添加访问控制、设置转码任务优先级等。

记住，流媒体服务的性能受网络环境、硬件配置和软件优化多方面影响。建议从小规模测试开始，逐步调整参数以获得最佳体验。如果遇到其他问题，可以查看项目的README.md文件或提交issue获取帮助。