全平台同步觀影神器：新版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還在完善的階段，可能是因為我部署環境的問題，導致網頁端使用遇到問題。不過如果後續這些問題得到了解決，我也會在教程中進行更新。 index.php?title=Category:500 常見應用指南 — Application Guides