全平台同步观影神器：新版SyncTV部署和使用教程

SyncTV是一个可以让你和异地的好友、伴侣一起同步看电影、追番的同步观影神奇软件。新版的SyncTV功能上更加完善，虽然目前我测试网页端的播放还有些问题，但是新版的APP非常方便，功能支持也更多。

SyncTV要实现流畅的同步观影体验，特别是使用视频代理播放和多人语音功能，对服务器的网络质量要求很高。这正是搬瓦工中国优化线路的巨大优势所在。所以部署SyncTV的服务器选择，要么是国内服务器，要么是搬瓦工的中国优化线路服务器。

其实之前我已经写过一篇旧版SynvTV的教程，如何搭建个人影音中心，实现多人同步观影（OpenList+SyncTV），旧版SynvTV在网页端更加简洁和流畅，但是移动web和APP体验不太好。本次要部署的新版SyncTV，刚好拥有极佳APP观影体验。

一、为什么写这篇教程？

在新版SyncTV的官方文档 (https://docs.syncs.tv/) 中，虽然有着非常详细的部署教程，但它有一个对新手不友好的环节：要求用户手动生成三个核心环境变量文件，再将它们上传到服务器并解压。 这个流程容易导致小白用户在文件传输、权限设置或解压时出错，而导致部署中断。

为了解决这个问题，我对官方的繁杂步骤进行了整合，制作了这套一键部署脚本。使用教程的脚本，系统会自动帮您创建目录、一键随机生成所有必需的高强度密钥文件和管理员密码。实现了一键安装，降低了新手的部署门槛。

二、新版 SyncTV 的核心优势

全新架构的 SyncTV 带来了新的变化：

• 全面的 APP 体验：不拥有跨平台客户端（Android / Windows 等），操作顺滑。
• 同步与低延迟：底层架构重构，拖拽进度条双端几乎无缝衔接，。
• 更强大的播放能力：完美支持视频切片流媒体播放，自由调节倍速，可以默认显示第一备选字幕。
• 更完善的语音互动：优化了语音连麦与文字聊天功能。

三、准备工作

• 一台云服务器 (VPS)：推荐使用Debian 12操作系统。
• 放行端口：请在服务器防火墙或云服务商控制台的安全组中，提前放行 8080  端口。

四、部署安装

第一步：安装 Docker 运行环境（已有 Docker 的可跳过）

先连接 SSH 执行以下官方一键安装命令来部署 Docker 环境：

wget -qO- get.docker.com | bash

第二步：运行 SyncTV 一键配置脚本

Docker 安装完成后，直接复制并运行我们专门整合的自动配置脚本：

bash <(curl -s https://vilark.com/wp-content/uploads/2026/09/synctv-Installation-Environment.sh)

（脚本运行过程大约需要几秒钟，请耐心等待屏幕上的完成提示。）

第三步：保存初始密码

脚本执行完毕后，会随机生成如图的初始管理员账号 (root) 和 高强度密码。请将这个密码复制并妥善保存。

第四步：启动 SyncTV 服务

密码保存好后，进入刚才脚本自动为您创建的 synctv 目录，并启动服务：

cd synctv

docker compose up -d

第五步：登录体验

等待服务启动（通常只需几十秒），打开浏览器访问 http://服务器公网IP:8080。

使用刚才保存的 root 账号密码登录，即可开启您的同步观影之旅！

五、网页端基础配置

需要注意，我测试下来，目前网页端使用视频直链和Alist途径的视频似乎无法正常播放，所以推荐用APP，可使用网页端进行一些设置。

1. 登录管理员账号

打开浏览器访问 http://服务器公网IP:8080。点击页面右上角的登录按钮，输入刚才脚本生成的 root 账号和密码进行登录。

2. 绑定第三方影视平台

登录后点击右上角的个人头像，依次进入 账号中心 -> 绑定。在这里，可以绑定 B站（Bilibili）、YouTube、Emby 等各大平台。

绑定成功后，即可在创建房间时直接拉取这些平台的视频源。

3. 添加账号

为了更方便地和朋友一起观影，可以给他们分配账号。点击右上角头像，依次进入 管理员设置 -> 用户，点击新增用户，可以新增并设置权限。

六、手机端 APP 下载与连接配置 (安卓为例)

新版 SyncTV 最棒的体验在于它的原生客户端。

1. 下载 APP

访问官方的发布页面：https://github.com/synctv-org/synctv-app/releases

2. 配置服务器地址

安装并打开 APP 后，根据图示操作：

先点击主界面上方的 “服务器” 按钮。然后点击 “添加”，输入你的服务器地址，然后点完成即可。

注意： 在填写服务器地址时，必须以 http:// 开头（如果您配置了域名 SSL，则是 https://）。

3. 登录账号

地址填写正确并点击完成后，APP 就会成功连上您的服务器，此时使用账号密码登录即可畅享观影。

以下是手机播放的全屏页面，右上角有延迟和同步延迟，左下角有同步、设置、倍速按钮，屏幕左右侧上下滑动可以调节亮度和音量。

七、后续维护

当官方发布新版本时，执行以下三条命令，可完成无损升级（历史数据、房间配置全都会保留）：

1.进入部署目录：

cd /synctv

2.拉取最新服务端镜像：

docker compose pull

3.重启并应用更新：

docker compose up -d

4.(可选)清理旧镜像

升级完成后，可执行命令清理旧版本的废弃镜像以释放服务器磁盘空间

docker image prune -f

八、写在最后

新版SyncTV还在完善的阶段，可能是因为我部署环境的问题，导致网页端使用遇到问题。不过如果后续这些问题得到了解决，我也会在教程中进行更新。