vdo.ninja

⚠ 注意！我们已从OBS.Ninja更名为VDO.Ninja - 其他一切保持不变 ✨

什么是 VDO NINJA

VDO.Ninja使用点对点技术将远程摄像头引入OBS或其他工作室软件。

在大多数情况下，所有视频数据直接在对等节点之间传输，无需通过任何视频服务器。这可以实现高质量的视频和超低延迟。在少数情况下，视频数据可能会通过加密的TURN服务器传输，该服务器用于在无法直接连接时促进对等连接。

VDO.Ninja旨在允许内容创作者使用远程媒体流制作实时直播节目。它还可以将智能手机变成无线网络摄像头，配合额外的虚拟摄像头软件使用。

VDO.Ninja作为托管服务在https://vdo.ninja免费提供使用。App Store和Play Store上也有原生应用版本，但这些原生应用相比网页版功能较为简单。

如需实时支持，请加入我们的Discord：https://discord.vdo.ninja

请查看子版块获取更多信息：https://reddit.com/r/vdoninja

还可以查看用户文档：https://docs.vdo.ninja

如何使用

YouTube上有VDO.Ninja基本用法的视频演示和播放列表：https://www.youtube.com/watch?v=QaA_6aOP9z8&list=PLWodc2tCfAH1l_LDvEyxEqFf42hOBKqQM&index=1

这里还有一个涉及更多高级设置的视频系列：https://www.youtube.com/watch?v=mQ1Jdhf5aYg&list=PL8VJWj2-XLFpFu3G35Hdm1nKZ2xn9_0_8

查看子版块获取更多使用案例、高级功能和支持。高级功能包括高质量音频模式、自定义视频分辨率等。

这个仓库包含什么

这个仓库包含VDO.Ninja的Web客户端软件，以及许多利用其IFRAME API的示例应用。还提供了示例配置文件和设置可选TURN视频中继服务器的说明。VDO.Ninja本身的用户文档可在docs.vdo.ninja找到。

如何部署这个仓库

VDO.Ninja在https://vdo.ninja提供免费使用的托管服务，因此部署是可选的。如果你确实想自行部署服务，以下提供了详细信息。

托管私人/个人部署可以简单到在启用HTTPS的Web服务器上托管此仓库中的文件。这里有一个非常简单的方法视频指南：https://www.youtube.com/watch?v=uYLKkX2_flY

对于更高级的用户，你可以查看install.md文件，了解其他托管选项和部署其他系统组件的更多详细信息。我们为自行部署提供有限的技术支持，主要是因为这类请求非常耗时，但在install.md文件中提供了完全部署所有必需系统组件的详细信息。

如果自行托管，你可能还希望托管自己的视频中继TURN服务器。如何部署TURN服务器的说明列在turnserver.md文件中。通常只有约5%的远程访客需要TURN服务器，通常是那些通过4G LTE连接或在严格防火墙后面的用户，但大多数其他用户不需要。虽然VDO.Ninja确实托管了一些公共TURN服务器，但它们的运营成本相当高，所以请尽量避免滥用。如果你正在部署自己的VDO.Ninja版本，我希望你能够使用自己的TURN服务器（如果可能的话）；如果你无法做到这一点，也是可以理解的。

对于希望离线托管VDO.Ninja的用户（没有互联网连接的情况），这里有一个包含本地和离线部署所需一切内容的仓库：https://github.com/steveseguin/offline_deployment。离线版本包括Docker选项，并且有一些社区创建的Docker可用于在线托管。我最终可能会提供一个为有更高要求的在线用户设计的官方Docker选项，但目前我缺乏时间和支持来维护这样一个项目。

开发版与发布版

这个仓库的develop分支有点像VDO.Ninja的预览版或每夜版。它应该是功能性的，但可能没有经过充分测试，或者可能有未完成的功能。develop版本与通常在vdo.ninja/alpha/上的版本密切相关，非常适合那些希望提交代码更改或获取实验性新功能的人。你也可以在Github页面上访问GitHub develop分支的托管版本：https://steveseguin.github.io/vdo.ninja/

VDO.Ninja的发布版本有自己的分支。这些最新的发布分支将根据需要更新以修复错误或关键问题，但除此之外保持不变。https://github.com/steveseguin/vdo.ninja/branches

由于实时视频制作的性质，通常不欢迎对应用程序进行意外更改，所以我不经常更新https://vdo.ninja/。此外，对主托管应用程序的持续更新使支持用户变得具有挑战性，因为很难判断问题是出在代码上还是用户身上。因此，VDO.Ninja对主要托管的生产版本进行不频繁的更新。希望获得新功能或风险承受能力更强的用户应该使用https://vdo.ninja/alpha/的alpha版本。

服务器端/API软件

由于VDO.Ninja使用点对点技术，在95%的情况下，视频连接直接在查看者和发布者之间建立。自行托管TURN服务器可能有助于提高性能，但不到1%的用户会通过使用TURN服务器看到视频质量的改善。TURN服务器也不会帮助降低带宽使用或CPU使用，所以通常你希望尽可能避免使用它们。

提供了如何部署TURN服务器的详细信息；请参阅：turnserver.md。对于那些能够托管自己的TURN服务器的人，如果可能的话，我们将非常感谢，因为TURN服务器目前是VDO.Ninja产生的最大成本。（当然，除了时间之外）除了TURN服务器，VDO.Ninja还使用公共STUN服务器和托管的握手服务器。这些服务器用于促进对等连接的初始设置，通常在建立对等连接后不再需要。这些服务器可以免费访问和使用，即使是私人部署也是如此。从VDO.Ninja的17.3版本开始，您可以托管自己的握手服务器或使用第三方管理的服务器（如piesocket.com）；详情请参见：https://github.com/steveseguin/websocket_server

VDO.Ninja的一个设计目标是无服务器化，我们已经接近99%实现这一目标。这一设计目标确保VDO.Ninja可以免费提供，同时提供更高级别的安全性和隐私保护。