
- 打开微信,搜索「软件教程管家」关注,或长按下方二维码关注
- 回复关键词 mirotalk-c2c
- 公众号自动回复网盘链接,点击即可保存下载
打开微信扫一扫关注或搜索【软件教程管家】
30 秒速读:想给自己的网站或业务加一个一对一视频通话入口,又不想把通话数据交给第三方平台?MiroTalk C2C 是开源自托管的视频通话平台,基于 WebRTC 点对点直连,支持屏幕共享与端到端加密,5 条命令就能在本地跑起来,还能用 iframe 嵌进任意网页。本篇讲清楚它适合谁、源码部署与 Docker 部署怎么选、装完必须改的 4 个配置,以及它明确不适合的场景。
MiroTalk C2C 软件信息表
| 软件名称 | MiroTalk C2C |
| 开发方 | Miroslav Pejic 及开源社区 |
| 开源协议 | AGPLv3(修改后须同样开源;另有付费商业许可可选) |
| 适用平台 | 浏览器即用;服务端需 Node.js 或 Docker 环境 |
| 运行方式 | 自托管部署,浏览器打开即用,无需安装客户端 |
| 核心技术 | WebRTC 点对点通信、端到端加密 |
| 核心功能 | 一对一视频通话、屏幕共享、摄像头背景效果、iframe 嵌入 |
| 本地端口 | 默认 8080(可通过配置文件修改) |
版本选择:源码部署与 Docker 部署怎么选
结论先行:本地试用选源码部署,5 条命令即跑;要长期对外提供服务选 Docker 部署,环境隔离、升级回滚都更省心。两者跑的是同一份代码,差别只在运维方式。
| 部署方式 | 适合谁 | 上手成本 | 推荐度 |
|---|---|---|---|
| 源码部署 | 本地快速试用、改代码做二次开发 | 最低,装好 Node.js 后 5 条命令 | 试用首选 |
| Docker 部署 | 长期对外服务、不想折腾依赖环境 | 中等,需装 Docker Engine 与 Docker Compose | 生产首选 |
无论选哪种,首次部署前都要想好一件事:这个房间地址是只给自己人用,还是要发给外部客户。只给自己人用,内网跑起来就能测;要对外服务,域名与 HTTPS 得提前准备好,浏览器不给非安全来源开摄像头和麦克风。
MiroTalk C2C 安装步骤
下面两条路线任选其一,命令均来自官方 README,跑通后打开 http://localhost:8080 即可进入。
路线一:源码部署(5 条命令)
- 拉取代码:
git clone https://github.com/miroslavpejic85/mirotalkc2c.git,进入目录cd mirotalkc2c。 - 复制配置模板:
cp .env.template .env,先别急着改,默认配置就能跑起来。 - 安装依赖:
npm install,首次安装需要联网下载依赖包。 - 启动服务:
npm start,看到服务正常监听后再进行下一步。 - 浏览器打开
http://localhost:8080,允许摄像头与麦克风权限,建一个房间即可开始通话。
路线二:Docker 部署
- 先装好 Docker Engine 与 Docker Compose,拉取代码并进入目录。
- 复制两份模板:
cp .env.template .env与cp docker-compose.template.yml docker-compose.yml。 - 可选先拉镜像:
docker-compose pull,再执行docker-compose up(加-d后台运行)。 - 同样打开
http://localhost:8080验证,通话正常后再配域名与反向代理。
视频通话装完必改的 4 个设置
下面 4 项是部署后最容易被忽略、但直接影响能不能正常用的配置,装完先过一遍:
- 房间地址与加入方式:先在本地建两个房间测一遍直接加入链接是否可用,再把地址发给别人。iframe 嵌入场景下,先确认嵌入页面的域名与跳转逻辑,别等客户反馈打不开才排查。
- HTTPS 与反向代理:正式对外服务必须走 HTTPS,否则浏览器会拒绝摄像头与麦克风授权。部署时把反向代理与证书一起配好,本地 8080 只留作内网调试入口。
- 摄像头背景效果开关:背景支持关闭、模糊与图片三种模式,图片可用 PNG、JPEG 与 WebP。背景处理在浏览器本地完成,官方说明所选图片不会上传;但背景效果依赖 WebGL2 与画布流捕获,低配设备或老浏览器会回退到原始画面,正式用之前先在目标设备上测一遍。
- 外部资源与 CSP 策略:据项目说明,背景效果会按需从 jsDelivr 加载 MediaPipe Tasks Vision 及 WASM 文件,并从 Google Storage 加载自拍分割模型。如果你的站点配了自定义 CSP 或处在网络受限环境,要先把这两处资源放行,否则背景功能会静默失效。
注意事项:先看完这 6 条再决定上不上
- 它只做一对一,不要当会议系统用。项目定位就是一对一视频通信,README 没有给出多人会议或大房间能力的说明。需要多人开会请另选方案,不要指望后续“顺带”支持。
- 屏幕共享的摄像头叠加只在桌面浏览器里提供。手机浏览器上先按基础通话能力验收,叠加画面这类细节功能不要默认手机上也有。
- 背景效果受设备与网络双重影响。除了 WebGL2 与浏览器能力,背景模型还要从外部加载,设备性能不足、浏览器后台节流或网络不通都会让效果打折甚至回退。
- 身份认证与合规要自己补。公开信息里没有现成的复杂身份体系与录制管理说明,咨询、辅导、远程医疗这类场景,上线前要自己确认录制、权限、身份认证与合规要求。
- AGPLv3 有传染性要求。修改后的版本同样要开源并公开。公司内部二次开发、改完要闭源商用之前,先评估许可影响,或直接走官方的商业许可渠道。
- 生产运维能力要自己验证。监控、数据存储、异常恢复这类能力在公开说明里着墨不多,正式对外服务前,先在测试环境完整跑一遍通话、录制、屏幕共享与 iframe 嵌入流程再上线。
适用人群与同类方案分工
适合谁:需要自托管一对一实时视频通信的开发者、网站运营者与隐私敏感场景的产品团队,尤其适合在线咨询、远程辅导、客户支持、远程医疗这类单次或持续通话场景;也适合想把视频通话嵌进现有网站、又不想接第三方 SDK 的团队。
不适合谁:要开多人会议的团队、需要现成账号体系与后台管理的企业、以及没有运维人力、希望“装好就不用管”的用户,这三类先别选它。
与同类方案的分工:需要多人会议与完整管理后台的,可以看同系列面向多人的版本或 Jitsi 这类会议系统;只是要一个轻量、可嵌入、自己掌控的一对一通话入口,MiroTalk C2C 的边界更清晰、部署成本也更低。选型时先问一句“到底是一对一还是多人”,答案直接决定该不该用它。
MiroTalk C2C 下载
前往 GitHub 查看 / 下载 MiroTalk C2C
GitHub 国内访问较慢,如打不开可多刷新几次
仓库为 miroslavpejic85/mirotalkc2c,README 里有完整的自托管指南、配置说明与 REST API 文档,部署前建议先看一遍官方文档的自托管章节。

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›
文章推荐
标签推荐
这款软件怎么样?
平均 暂无评分(0 人评)
取链次数:0
评分与投票来自真实访客,从 0 开始累计;觉得有用就点一下,帮更多人判断这款软件值不值得下。






