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

一、为什么写这篇教程？

在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