文件分类
| 文件类型 | 文件名模式 | 谁下载 | 能做什么 | 注意事项 |
| --- | --- | --- | --- | --- |
| Windows 体验版 | SyncWatch-Experience-Client-Portable-v版本-x64.exe | 普通成员 | 输入已有服务器地址加入房间,不在本机运行服务器 | 体积较小但不包含服务端;需要房主先启动服务 |
| Windows 标准版 | SyncWatch-Standard-Server-Portable-v版本-x64.exe | 房主、服务器管理员 | 绿色便携运行,启动服务器、管理房间、上传媒体和配置公网访问 | 内置 Electron/Node、FFmpeg/FFprobe 和 cloudflared |
| Windows 安装完整版 | SyncWatch-v版本-Full-Offline-Installer-x64.exe | 希望正常安装并给各平台成员分发客户端的房主 | 安装目录、快捷方式、卸载入口、完整 Windows 服务端和内嵌的 Windows/Android/macOS 下载文件 | 不需要另装 Node.js/cloudflared;文件超过 1 GB;首次登录立即修改 admin888 |
| Windows 独立 EXE 完整版 | SyncWatch-v版本-Full-Offline-Portable-x64.exe | 不想安装但需要完整离线下载中心的房主 | 直接双击运行完整 Windows 服务端,内嵌内容与安装完整版一致 | 文件超过 1 GB;运行目录必须有写入权限 |
| Android APK | SyncWatch同步观影-v版本.apk | Android 用户 | 加入房间;支持的设备可以启动手机服务器 | 包含 arm64-v8a、armeabi-v7a 和 x86_64 ABI |
| 独立服务器 ZIP | SyncWatch同步观影-Server-v版本.zip | Windows/Linux/Docker 管理员 | 使用 Node.js、启动脚本或 Docker 长期部署 | 包含生产依赖、FFmpeg/FFprobe、cloudflared、客户端和 APK |
| macOS 服务器 DMG/ZIP | SyncWatch-Server-macOS-v版本-x64/arm64.* | Mac 房主 | Intel 或 Apple Silicon 上运行服务器 | 必须由 macOS 主机或 macOS CI 生成,不能用 Windows 文件冒充 |
| macOS 客户端 DMG/ZIP | SyncWatch-Client-macOS-v版本-x64/arm64.* | Mac 成员 | Intel 或 Apple Silicon 上加入房间 | 需要系统允许网络、麦克风或屏幕共享权限时按提示授权 |
| macOS 完整版 DMG/ZIP | SyncWatch-Full-Offline-macOS-v版本-x64/arm64.* | Mac 房主 | 当前架构的完整服务端、cloudflared 和全平台离线下载中心 | Intel 选 x64,Apple Silicon 选 arm64;每个文件超过 1 GB |
| cloudflared 安装包 | cloudflared-windows-x64-installer.msi / cloudflared-windows-x86-installer.msi | 需要手工配置 Tunnel 的 Windows 管理员 | MSI 提供安装入口;安装后可在终端调用 cloudflared | 只从 Cloudflare 官网 或 官方 Release 下载 并校验 SHA-256;命令行 EXE 双击不会显示安装向导 |
| Node.js 环境包 | node-v24.19.0-x64.msi / arm64.msi / macOS 包 | 源码开发、独立服务器管理员 | 提供 node 与 npm,用于源码安装依赖和启动独立服务器 | 从 Node.js 官网 或 官方下载 获取对应平台包;正式 Windows EXE 已内置 Node.js |
选择流程
- 你是房主:Windows 下载服务器 EXE;Mac 下载 macOS 服务器包;Linux 优先下载独立服务器 ZIP 或使用 Docker。
- 你是成员:下载对应平台的客户端;也可以直接用浏览器打开房主发来的地址。
- 你只想试用:先看 GitHub Pages 展示站;它展示真实界面,但不能替代服务器。
- 你要开发:下载源码,安装 Node.js 22+,执行
npm ci和npm start。 - 看到不存在的平台资产:不要下载相似名称的第三方文件;按
docs/macos-build.md或构建脚本自行生成。
下载后校验
在 Release 页面打开对应文件旁的 SHA-256 校验值,PowerShell 使用:
Get-FileHash .\SyncWatch-v2.2.0-Full-Offline-Installer-x64.exe -Algorithm SHA256Linux/macOS 使用:
shasum -a 256 SyncWatch同步观影-v2.2.0.apk如果哈希不同、文件大小为 0,或者文件名中的版本与 Release 不一致,请删除文件并重新下载。
完整版为什么很大
Windows、macOS、Android 的运行时、签名方式、CPU 架构和系统权限不同,不能互相运行。离线完整版不会把它们伪装成 Windows 功能,而是把真实构建的 Windows 客户端、Android APK、macOS x64/arm64 客户端与服务器 ZIP 作为本机下载资源保存。房主安装并启动后,成员通过登录页或账号菜单下载适合自己的文件,因此即使现场没有 GitHub 网络也能完成分发。标准版和体验版仍保持较小体积。
cloudflared 与 Node.js 的区别、官方地址、安装步骤和命令示例见 cloudflared 与 Node.js 安装使用教程。
Release 备注应包含的内容
每次发布说明至少写明:版本号、构建提交、支持的平台和架构、服务器/客户端区别、默认登录后的安全动作、是否包含 cloudflared、已验证的测试、已知未提供的成品,以及数据备份和授权内容边界。

