需要什么
普通用户下载 Windows 或 Android 文件即可。开发者从源码运行时需要 Node.js。
自己保存账号和影片放在你的设备上
电脑手机都能用Windows、Android、浏览器均可加入
一起互动播放、聊天、语音和共享都能用
先局域网再公网先在家里试用，需要时再分享给远方朋友
四步开始一起看
房主照着做，朋友拿到地址后就能加入。
-
1
打开软件
双击 Windows 完整版；开发者也可以运行
npm start。 -
2
先改密码
首次登录后马上设置新管理员密码，再创建房间。
-
3
复制地址
同一 Wi-Fi 直接分享局域网地址；远程使用时再开启公网访问。
-
4
朋友加入
朋友打开地址、登录并输入房间号，房主点击播放即可同步。
为什么大家能同步
服务器记住房间状态。有人播放、暂停或拖动时，服务器会告诉房间里的其他人。
-
01
打开服务器
软件启动一个供大家连接的房间服务
server/index.js -
02
成员连接
浏览器、电脑和手机打开同一个地址
HTTP + WebSocket -
03
登录入房
输入账号和房间密码，确认你有权进入
session / room -
04
同步操作
播放、暂停、进度和倍速发送给所有成员
state / media -
05
保存数据
账号、房间和影片信息保存在服务器数据目录
SyncWatch同步观影-Data -
06
看到同一刻
每个人的播放器根据服务器时间自动校正
room-state / playback-sync
结果：大家看到同一进度
播放、暂停、进度、倍速和聊天会同步；影片仍保存在房主自己的服务器。
拖动控制台旋转 360°，滚轮调整深度，方向键微调。动画只展示当前调用关系，不影响阅读。
可以做什么
一起播放影片、聊天、发弹幕、语音通话，也可以共享浏览器标签页或窗口。
数据放在哪里
账号、房间、影片和聊天记录保存在你自己的服务器数据目录。
支持哪些设备
支持 Windows、Android 和现代浏览器。跨网络使用时可以配置 HTTPS 或临时公网地址。
先看看软件长什么样
下面都是实际界面截图，点击图片可以放大。
一个房间里不只是一块播放器
房主控制共同状态，成员保留自己的设备音量和必要的本地选择。
- 同步播放
- 播放、暂停、进度、倍速和可选音量同步，客户端自动校正明显偏差。
- 媒体与字幕
- 本地上传、字幕、播放队列、缩略图和浏览器兼容格式转换。
- 实时沟通
- 公聊、私聊、弹幕、表情、图片、语音消息、全麦语音和全屏公告。
- 共享与协作
- 桌面或手机屏幕共享、网页共享，以及受支持桌面端的电脑音源共享。
- 账号与权限
- 好友、在线状态、权限组、注册审批、设备管理、封禁与操作记录。
- 服务器运维
- 数据导入导出、备份恢复、邮件验证、日志、网络诊断和可选 AI 中转。
管理中心
房主可以在这里管理房间、成员、影片、账号和服务器设置。每个模块都有单独教程。
完整教程
需要从启动到每个按钮的逐步说明，请阅读 管理中心完整图文教程；需要查看错误处理和使用技巧，请阅读 常见错误 与 技巧与优势。
数据会保存在哪里
SyncWatch同步观影-Data/ 保存账号、房间、影片和设置。换设备前先停止服务器并备份整个文件夹。
| 路径 | 作用 | 备份建议 |
|---|---|---|
config.json | 账号、房间、权限、设置和媒体索引 | 必须备份，不要手工编辑 |
uploads/ | 上传的影片、音频、字幕、图片和文档 | 必须与索引一起备份 |
.secrets/、secrets/ | 邮件密钥和管理员验证材料 | 绝不能公开，随数据一起备份 |
compatible-media/ | 自动生成的浏览器兼容媒体 | 可以重建，空间不足时可在停机后清理 |
logs/、crash-dumps/ | 运行和异常诊断信息 | 提交 Issue 前先脱敏 |
只复制 config.json 会造成记录、文件或密钥不完整。软件内的“全部数据与配置”导出适合日常备份。
开发者如何启动
普通用户直接下载 Windows 完整版。开发者安装 Node.js 后，在项目文件夹打开终端运行命令。
cd $HOME\Desktop
git clone https://github.com/xuange6610/SyncWatch.git
cd SyncWatch
npm ci
npm start每条命令执行后会发生什么
cd $HOME\Desktop把当前位置切到桌面，下载后的源码通常位于桌面SyncWatch文件夹。git clone下载源码；npm ci安装依赖，结束时应回到可继续输入命令的提示符。npm start启动服务器；看到地址后打开http://127.0.0.1:20311。- 按
Ctrl+C停止。下次只需进入该文件夹，再执行npm start。
打开完整新手图文教程，查看首次登录、建房、数据目录和常见错误。
下载哪个文件
想自己开房就下载 Windows 完整版；只想加入别人的房间就下载体验版或 Android APK。
- 客户端Experience 体验版Windows 成员客户端，只连接已有服务器。
- 服务器Windows 完整便携版下载后直接双击，适合自己开房。
- 客户端Android APK通用 ABI，加入房间或在受支持设备运行手机服务器。
- 服务器环境源码与独立服务端源码 ZIP · 源码 TAR.GZ；需要 Node.js，适合开发、审查或长期部署。
- 服务器工具Node.js / cloudflared需要自己搭建服务器时再下载这些工具，文件都在 v2.4.4 下载页。
- 小提示第一次登录后先改管理员密码；遇到问题先在局域网测试。
这里是展示站，不是在线服务器
GitHub Pages 仅提供静态展示、截图、说明和下载入口，不能运行 Node.js、WebSocket、文件上传、AI 中转或临时公网访问。要体验完整功能，请下载服务器版或按部署教程启动自己的实例。
查看服务器部署教程按你的任务继续阅读
文档文件名使用稳定的英文短路径，正文保留中文，新手和自动化工具都更容易找到。
普通用户使用说明下载、启动、登录、建房、连接和常用功能
服务器部署教程Windows、Linux、Docker、HTTPS、隧道、备份和升级
技术架构与依赖模块边界、数据、构建入口和测试方式
云端媒体与商业部署对象存储、反向代理和容量边界
管理中心 3D 教程3D 动画控制舱、11 个管理模块、按钮说明和操作示例
常见错误与报错处理启动、端口、登录、媒体、Android、Tunnel、邮件和备份问题
使用技巧与优势部署顺序、权限策略、备份技巧和自托管优势
发布文件与下载说明服务器、客户端、APK、ZIP 和校验方式
cloudflared 与 Node.js官方地址、安装步骤、命令示例与 Tunnel 超时修复
仓库文件地图截图中每个文件夹、规范文件和构建入口的职责
新手快速开始双击启动、首次登录、建房、邀请成员和备份
参与贡献分支、格式、测试和 Pull Request 要求