推荐使用顺序
- 先在同一个 Wi-Fi 内启动服务器和两台客户端,完成登录、创建房间、上传短视频和同步播放。
- 给管理员设置独立强密码,给正式房间设置房间密码;普通成员使用普通账户,不共享管理员账号。
- 确认媒体、聊天和权限正常后,再开启 Cloudflare Tunnel 或自己的 HTTPS 反向代理。
- 第一次迁移或升级前停止服务,完整备份
SyncWatch同步观影-Data/,新版本启动后检查房间、媒体和密钥。
实用技巧
- 降低排错复杂度:出现问题时先切回局域网,确认基础功能后再判断是公网、代理还是权限问题。
- 控制播放冲突:观看时只让房主或一名可信成员拥有控制权,其他成员使用聊天反馈问题。
- 选择媒体版本:原画保留最高质量;浏览器兼容版本适合编码复杂或设备性能较弱的成员。
- 管理大文件:上传前检查磁盘空间,使用有线或稳定 Wi-Fi;转码期间不要关闭服务器。
- 保护日志:导出日志前删除 IP、邮箱、令牌、媒体名称和聊天正文,保留时间、事件类型和错误码即可。
- 设置邮件:使用 QQ 等服务商的应用专用授权码,测试成功后不要把授权码写入 README、Issue 或截图。
- Android 省电:手机作为服务器时关闭电池优化,保持前台服务通知,避免系统杀掉 Node.js Mobile。
- 公网分享:只把临时地址发给可信成员,不要把带管理员权限的链接放到公开群组。
主要优势
自托管和隐私边界清晰
账号、房间、媒体、聊天和配置默认保存在自己的设备。GitHub Pages 只做静态展示,不会代替你的服务器保存数据。
一套房间,多端接入
Windows、Android、macOS 和现代浏览器共用同一套网页业务与 Socket.IO 房间状态,成员不必安装相同设备类型的客户端。
同步播放不依赖单一播放器
服务器广播播放状态、时间和版本,客户端按延迟和缓冲进行校正;支持播放、暂停、进度、倍速、字幕、聊天和公告协作。
从轻量到完整部署
可以使用 Windows 完整 EXE、Android 手机服务器、独立 Node.js ZIP、Docker 或 macOS 成品。需要长期运行时再接入固定 HTTPS 反向代理。
管理、审计和备份一体化
房间、成员、权限、申请、邮件、日志、Tunnel 和数据导入导出集中在管理中心,敏感操作有权限检查和操作记录。
开源可审查、可共同维护
Apache-2.0 允许依法使用、修改和再发布;贡献者通过 Fork、分支和 Pull Request 协作,main 经过自动测试与维护者审核后才更新。


操作完成后请回到真实应用验证结果。不要在公开 Issue、截图或日志中提交密码、令牌、真实 IP、邮箱或私人媒体信息。