查看“︁全平台同步观影神器：新版SyncTV部署和使用教程”︁的源代码

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

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

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

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

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

== 二、新版 SyncTV 的核心优势 ==
全新架构的 SyncTV 带来了新的变化：

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

== 三、准备工作 ==

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

== 四、部署安装 ==
'''第一步：安装 Docker 运行环境（已有 Docker 的可跳过）'''

先连接 SSH 执行以下官方一键安装命令来部署 Docker 环境：
 wget -qO- get.docker.com | bash
'''第二步：运行 SyncTV 一键配置脚本'''

Docker 安装完成后，直接复制并运行我们专门整合的自动配置脚本：
 bash <(curl -s <nowiki>https://vilark.com/wp-content/uploads/2026/09/synctv-Installation-Environment.sh</nowiki>)
（脚本运行过程大约需要几秒钟，请耐心等待屏幕上的完成提示。）

'''第三步：保存初始密码'''

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

[[File:20261016TV1.png|800x800px]]

'''第四步：启动 SyncTV 服务'''

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

 docker compose up -d
'''第五步：登录体验'''

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

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

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

'''1. 登录管理员账号'''

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

[[File:20261016TV2.png|800x800px]]

'''2. 绑定第三方影视平台'''

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

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

[[File:20261016TV3.png|800x800px]]

'''3. 添加账号'''

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

== 六、手机端 APP 下载与连接配置 (安卓为例) ==
新版 SyncTV 最棒的体验在于它的原生客户端。

'''1. 下载 APP'''

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

'''2. 配置服务器地址'''

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

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

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

[[File:20261016TV6.png|800x800px]]

'''3. 登录账号'''

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

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

[[File:20261016TV7.png|800x800px]]

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

1.进入部署目录：
 cd /synctv
2.拉取最新服务端镜像：
 docker compose pull
3.重启并应用更新：
 docker compose up -d
4.(可选)清理旧镜像

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

== 八、写在最后 ==
新版SyncTV还在完善的阶段，可能是因为我部署环境的问题，导致网页端使用遇到问题。不过如果后续这些问题得到了解决，我也会在教程中进行更新。
[[Category:500 常见应用指南 — Application Guides]]