plugNmeet 2.5.3 介绍与选型指南
plugNmeet 2.5.3 开源自托管视频会议平台介绍:LiveKit SFU 架构、功能特性、官方安装快速开始、适用场景限制,并与 Jitsi Meet/BigBlueButton/Galene/MiroTalk SFU 量化对比(2026-10-26 实查)。
plugNmeet 2.5.3 介绍与选型指南
目标:面向自托管场景,从官方渠道实查并梳理 plugNmeet 2.5.3 的定位、架构、功能与选型依据,回答「它是什么、能做什么、跟 Jitsi Meet/Galene/MiroTalk SFU/BigBlueButton 比该怎么选」。本文为认知篇,全部信息来自官方文档站与 GitHub 仓库的联网溯源(查询日期 2026-10-26,来源在各节标注),未做本地部署实测。
一、环境信息
本篇为联网溯源篇,不涉及本地部署,所有事实性信息(版本、许可证、依赖、端口、性能口径)均于查询日期 2026-10-26 从下列官方渠道实查取得:
- 官方文档站:https://www.plugnmeet.org(intro / installation / api 等页面)
- 服务端源码仓库:https://github.com/mynaparrot/plugNmeet-server(v2.5.3 发布页)
- 安装脚本仓库:https://github.com/mynaparrot/plugNmeet-install(
install.shv2.5.3 配套版) - 客户端与录制器仓库:https://github.com/mynaparrot/plugNmeet-client、https://github.com/mynaparrot/plugNmeet-recorder
- Docker Hub 官方镜像:https://hub.docker.com/r/mynaparrot/plugnmeet-server
- 版本与星数取证:shields.io 徽章数据(GitHub Releases 与仓库元数据的镜像源)
⚠️ 仓库更名提示:plugNmeet 的 GitHub 组织已从早期的
plugnmeet迁移到mynaparrot(开发公司 MynaParrot),旧仓plugnmeet/plugnmeet与旧镜像plugnmeet/plugnmeet在 2026-10-26 实查时均已不存在(shields.io 返回 repo not found),搜索资料或旧教程时请以mynaparrot组织下的新仓为准。
二、软件概述
plugNmeet(官方写法 Plug-N-Meet,常写作 plugNmeet)是一个开源、自托管的 WebRTC 视频会议平台:把会议服务器部署在自己的机器上,参会者用浏览器直接入会,无需安装客户端,数据与录制文件全部留在自己的服务器上。与 Zoom、Google Meet 同赛道,差异在于「你的品牌、你的域名、你的数据」。
2.1 基本信息(2026-10-26 溯源)
| 项目 | 内容 | 来源 |
|---|---|---|
| 当前稳定版 | v2.5.3(服务端 GitHub Release) | github.com/mynaparrot/plugNmeet-server/releases |
| 首次开源 | 服务端项目由 MynaParrot 公司开发并维护,官方站点声明项目长期活跃 | plugnmeet.org / 公司背景页 |
| 社区规模 | 服务端仓库 Star 573(shields.io,2026-10-26) | img.shields.io/github/stars/mynaparrot/plugNmeet-server |
| 许可证 | MIT(自由使用、修改、商用) | shields.io license 徽章实查 |
| 技术栈 | 服务端 Go 单二进制;客户端 React + Redux;录制器 Go + Chrome + FFmpeg | 各仓库 README |
| 官方镜像 | mynaparrot/plugnmeet-server(Docker Hub,持续更新) | hub.docker.com 实查 |
| 商业形态 | 开源 MIT 免费 + 可选 plugNmeet Cloud 托管服务 | plugnmeet.cloud |
💡 说明:plugNmeet 的 Star 数(573)在同类开源会议系统中偏小,这与其定位有关——它不是「最大众化」的会议软件,而是面向需要嵌入自家网站/App、需要白标(white-label)与 API 自动化的开发商。选型时社区规模应与其 API 生态、BBB 兼容性一起权衡(见第七章)。
三、核心架构
3.1 三大自有组件
官方把系统拆成三个组件(来源:plugNmeet-server README「Core Components」,2026-10-26):
| 组件 | 角色 | 技术栈 |
|---|---|---|
| plugNmeet-server | 后端引擎:房间/用户/录制/AI 的全部业务逻辑与 REST API | Go,单一二进制 |
| plugNmeet-client | 前端会议界面:参会者看到的一切 | React + Redux,构建产物为静态文件 |
| plugNmeet-recorder | 云录制器:把会议录制为 MP4,独立进程可单独部署 | Go + Google Chrome + Xvfb + PulseAudio + FFmpeg |
3.2 依赖服务栈
服务端自身不处理媒体转发,依赖一组成熟的基础组件(来源:plugNmeet-install 仓库 install.sh 与官方 Docker Compose 模板,2026-10-26 实查):
| 依赖 | 用途 | 说明 |
|---|---|---|
| LiveKit | WebRTC SFU 媒体转发内核 | 负责音视频流的转发、simulcast/dynacast;附带 TURN 服务(udp/443、tls/5349) |
| NATS JetStream | 信令、聊天、白板/协作状态的消息总线与 KV 存储 | 官方模板为 nats 2.15 系,带 NKey 账号鉴权 |
| Redis | 房间临时状态(TTL 24h 默认) | 服务器重启后临时状态自然清空,历史数据在 MariaDB |
| MySQL / MariaDB | 业务历史数据(用户、房间记录、录制元数据、分析 JSON) | 官方安装脚本固定安装 MariaDB 12.3 |
| HAProxy | TLS 终结与反代(官方脚本路径) | 承接 443,转发到 8080/7880/TURN,集成 Let's Encrypt 证书续期钩子 |
数据流一句话概括:浏览器 ↔ HAProxy(443) → plugNmeet-server(8080, 业务与 REST API) + LiveKit(7880, 媒体信令) ;媒体 RTP 流直连 LiveKit 的 UDP 端口段;聊天/白板/协作消息走 NATS WebSocket;临时状态进 Redis,历史进 MariaDB,录制器独立进程产出 MP4。
💡 技术拓展:WebRTC 多方会议的媒体拓扑有三条经典路线——Mesh(每人对其他所有人各推一路流,服务器几乎零负担,只适合 4~6 人)、MCU(服务器解码混流再编码下行,CPU 极重,适合大规模转码直播)、SFU(每人只推一路流,服务器按订阅关系选择性转发,不转码)。主流自托管会议系统(Jitsi Meet 的 JVB、LiveKit、Galene、mediasoup、plugNmeet 内核)全部落在 SFU 路线上,因为它是「服务器压力」与「参会规模」的最佳平衡点。plugNmeet 的特点是把 SFU 选型交给 LiveKit:不自研媒体层,专注业务与集成,同时继承了 LiveKit 的 simulcast/dynacast 弱网自适应能力与原生移动端 SDK 生态。
3.3 兼容与集成面
- BigBlueButton API 兼容:提供
/bigbluebutton/兼容端点,已有 BBB 集成的应用可以不改代码切换到 plugNmeet(来源:官方《Migrating from BigBlueButton》教程)。 - REST API + SDK:
POST /auth/*统一认证路径,API-KEY+HASH-SIGNATURE(对请求体做 HMAC-SHA256)双重头鉴权;官方提供 PHP 与 JavaScript SDK,社区提供 Python SDK。 - 无代码集成:WordPress、Moodle、Joomla 官方插件,以及任意 LMS 的 LTI 接入。
- 移动端:hybrid 混合集成——原生层用 LiveKit iOS/Android/Flutter/React Native SDK 处理媒体,界面用 WebView 加载 plugNmeet 客户端,不锁定私有移动 SDK。
四、功能特性
以下功能清单来自官方文档站 intro 与客户端文档(查询日期 2026-10-26):
会议基础
- HD 音视频、虚拟背景、屏幕共享,全平台现代浏览器免安装入会;
- 弱网自适应:自动降低缩略图质量、暂停不可见视频,simulcast/dynacast 由 LiveKit 承担;
- 公开 + 私聊,聊天支持文件传输。
协作与互动
- 交互式白板:可上传 PDF/Office 文件并在上面批注(默认预载文件上限 5MB,可在配置调整);
- 共享记事本(会议纪要协作);
- 投票(含 quiz 模式)、举手、等候室;
- 分组讨论室(breakout rooms,默认上限 6 间、最大 16 间);
- 主持人细粒度管控:可锁定成员的麦克风/摄像头/聊天/白板权限;
- 嵌入任意网页内容(Google Doc、仪表盘)与同步播放 YouTube/本地视频。
录制与广播
- 云录制输出通用 MP4 文件(可直接下载、合并、移动,无私有后处理格式);
- 浏览器端本地录制;
- RTMP 直播推流到 YouTube/Facebook;OBS 通过 RTMP/WHIP 作为演播室输入源接入;
- 电话拨入:SIP 网关支持纯电话音频入会(LiveKit SIP)。
AI 能力
- 实时字幕、语音翻译、转写、会议摘要、聊天助手;AI 供应商由使用者自配(Azure 语音、Google Gemini 等 OpenAI 兼容/官方 API);
- E2EE 房间自动禁用需要「听到音频」的服务端 AI。
安全与合规
- HMAC 签名的 API + JWT 会话令牌,全链路 TLS;
- 可选端到端加密(E2EE),媒体与数据通道在终端加解密,服务器无法读取内容;
- 会议分析报表:出勤、发言时长、互动度、连接质量,按会话生成分析文件。
五、快速开始(官方最小可用路径)
以下为官方文档站 Installation Quick Start 给出的最小路径(本节为溯源引用,未做本地实测;本地实测部署见本专栏后续安装/部署篇):
5.1 前提条件(官方口径)
- 一台干净的 Ubuntu/Debian 服务器,有公网 IP,且未安装 Apache/Nginx/HAProxy(脚本要求干净环境避免端口冲突);
- 两个子域名解析到服务器公网 IP:会议域名(如
plugnmeet.example.com)与 TURN 域名(如turn.example.com); - 一个用于签发 Let's Encrypt 证书的邮箱;
- 硬件:测试环境 2 核 2-4GB 即可;生产建议 ≥100Mbps 带宽、4 核 4GB 起(装录制器建议 8 核 8GB 起)。官方基准页口径:单台 4 vCore/16GB 服务器在单房间跑了 300-500 人。
5.2 一条命令安装
# 下载官方安装脚本(可先审阅内容再执行)
wget https://raw.githubusercontent.com/mynaparrot/plugNmeet-install/main/install.sh
# 交互式执行(root):依次询问域名、TURN 域名、邮箱、是否装录制器、是否配 UFW
sudo bash install.sh
# 或非交互式(适合 cloud-init 自动化)
sudo bash install.sh --domain plugnmeet.example.com --turn-domain turn.example.com \
--email admin@example.com --recorder yes --ufw yes
脚本完成后输出三件关键凭据:Server URL、API Key、API Secret(关闭窗口也可在 /opt/plugNmeet/config.yaml 找回)。全部组件以 systemd 服务托管:主服务 plugnmeet,录制器 plugnmeet-recorder。
5.3 验证
浏览器打开 https://plugnmeet.example.com/login.html,用安装输出的 API_KEY/API_SECRET 生成临时令牌入会测试;服务端检查:
systemctl status plugnmeet # 应为 active (running)
tail -n 200 -f /opt/plugNmeet/log/plugNmeet.log # 查看运行日志
⚠️ 说明:该脚本会安装 Docker 并以官方编排模板拉起 LiveKit、NATS 等依赖,同时安装 Redis 与 MariaDB 12.3、HAProxy 并签发 Let's Encrypt 证书——这是官方唯一「一键」路径,强依赖公网域名与 80/443 端口。内网或无公网环境请参考本专栏《Ubuntu 24.04 安装 plugNmeet 2.5.3 指南》的手动部署方案。
5.4 不装服务器先体验
官方提供在线 Demo(2026-10-26 可用):会议入口 https://demo.plugnmeet.com/landing.html;开发者可用官方公开的 Demo API 凭据(https://demo.plugnmeet.com,API KEY plugnmeet)直接调试 REST API。
六、适用场景与限制
6.1 适合
- 在线课堂与培训:白板 + 记事本 + 投票/quiz + 分组讨论室 + 出勤分析,还有 Moodle/WordPress/Joomla 插件与 LTI;
- 把会议嵌入自有产品:REST API 创建房间、签发入会令牌、webhook 事件回传,PHP/JS SDK 开箱即用;白标改 logo/配色/域名不用改代码;
- 从 BigBlueButton 平迁:
/bigbluebutton/兼容端点让既有 BBB 集成无缝切换; - 对外直播/大型活动:等候室 + 主持人管控 + RTMP 推流 YouTube/Facebook + OBS 演播室接入;
- 隐私敏感场景:自托管 + 可选 E2EE + 录制文件为自有磁盘上的普通 MP4;
- 电话混合参会:SIP 拨入让无网参与者以纯音频入会。
6.2 限制与代价
- 组件栈不轻:LiveKit + NATS + Redis + MariaDB 四件依赖是官方口径的固定组合,比 Galene「单二进制」重得多;排查故障、做备份巡检都要面对多组件;
- 官方自动化脚本强绑定公网:要求两个公网子域名 + Let's Encrypt + 干净服务器(不能装过 Apache/Nginx/HAProxy),内网/离线部署必须走手动路线;
- 录制器资源消耗大:录制走无头 Chrome 截屏 + FFmpeg 编码,官方建议录制专用机(8 核 8GB 起),并把录制器与主服务分开部署;
- 社区规模小:Star 数、第三方教程与问答存量明显少于 Jitsi Meet/BBB,遇到问题更多依赖官方 Discord 与文档;
- AI 功能依赖外部供应商:转写/翻译/摘要需要自配 Azure/Gemini 等 API Key,不是纯离线能力。
七、同类选型对比
下列同类项目数据查询日期:2026-10-26(plugNmeet/Jitsi Meet/BigBlueButton 为 shields.io 实查;Galene、MiroTalk SFU 数据与本平台《Galene 1.2 介绍与选型指南》《MiroTalk SFU 2.6.88 介绍与选型指南》2026-10-25/26 实查一致)。
| 项目 | 架构 | 语言/栈 | 许可证 | Stars | 依赖栈 | 录制 | 集成与自动化 | 定位 |
|---|---|---|---|---|---|---|---|---|
| plugNmeet 2.5.3 | SFU(LiveKit 内核) | Go + React | MIT | 573 | LiveKit+NATS+Redis+MariaDB | 服务端 MP4(独立录制器) | REST API+HMAC、PHP/JS SDK、BBB 兼容端点、WordPress/Moodle/Joomla/LTI、webhook | 白标可嵌入的会议平台,教育/集成首选之一 |
| Jitsi Meet | SFU(JVB) | Java + TS | Apache-2.0 | ≈30.1k | JVB+Jicofo+Prosody 多组件 | 服务端录制 + 直播 | iframe API 生态最大,插件/集成多 | 功能最全、社区最大的开源会议套件 |
| BigBlueButton 3.x | 全家桶(FreeSWITCH 等) | Java + TS | LGPL-3.0 | ≈9.3k | 十余组件,官方脚本绑定 Ubuntu | 内置录制回放 | Moodle 深度集成、出勤/测验 | 在线教育专用全家桶,资源要求最高 |
| Galene 1.2 | SFU | Go | MIT | ≈1.4k | 单二进制 + 静态页 | 服务端录制 | 管理精简、无重型集成 | 极简省资源的中小会议/教学 |
| MiroTalk SFU 2.6.88 | SFU(mediasoup) | Node.js | AGPLv3 | ≈3138 | 单服务 + MongoDB | 服务端录制 | REST API 完整,前端可深度定制 | 轻量可定制的 Node 系会议服务 |
选型建议(如果…则…):
- 如果要把会议嵌进自家网站/App、白标 + API 自动化、还要 BBB 兼容迁移——选 plugNmeet,它的 API/插件/BBB 兼容三件套在 MIT 许可下是同类里最齐的;
- 如果要开箱即用、社区答案多、能接受多组件运维——选 Jitsi Meet;
- 如果做标准在线教育且需要成熟的 Moodle 深度联动与课堂管理——选 BigBlueButton(接受其对 Ubuntu 版本与硬件的硬要求);
- 如果只要小团队快速拉个会、服务器预算极低——选 Galene(单二进制);
- 如果团队是 Node.js 栈、想深度魔改前端且接受 AGPLv3——选 MiroTalk SFU。
站内延伸阅读:《Galene 1.2 介绍与选型指南》、《MiroTalk SFU 2.6.88 介绍与选型指南》。
八、参考链接
- 官方文档站:https://www.plugnmeet.org/docs/intro、https://www.plugnmeet.org/docs/installation
- 服务端仓库:https://github.com/mynaparrot/plugNmeet-server
- 安装脚本仓库:https://github.com/mynaparrot/plugNmeet-install(install.sh、update.sh)
- 客户端 / 录制器:https://github.com/mynaparrot/plugNmeet-client、https://github.com/mynaparrot/plugNmeet-recorder
- API 文档:https://www.plugnmeet.org/docs/api/intro
- 性能基准:https://www.plugnmeet.org/docs/benchmark
- 官方镜像:https://hub.docker.com/r/mynaparrot/plugnmeet-server
- 官方 Discord 社区:https://discord.gg/2X2ZaCHu4C
- 站内相关文档:《Galene 1.2 介绍与选型指南》、《MiroTalk SFU 2.6.88 介绍与选型指南》