SyncTV

SyncTV是什么？

SyncTV是一款开源的远程同步观影平台，让用户无论身处何地，都能与朋友、家人或团队实时同步观看电影、电视剧和直播。支持本地视频、网络视频及屏幕视频共享，自带文字聊天、弹幕互动和语音/视频通话，打造沉浸式“云端影院”体验。支持 Docker 等多种部署方式，安全灵活，适合远程聚会、线上教学、企业活动与跨地域协作。

SyncTV的主要功能

• 同步观看：保证所有人处于同一播放进度，支持暂停、快进、快退、倍速播放等操作，大家都会同步。
• 直播与剧院模式：不仅能看点播视频，还能一起看直播或模拟“影院”体验。
• 聊天互动：内置文字聊天、打弹幕，还支持WebRTC在线语音聊天、视频聊天。
• 视频代理与解析：提供代理缓存、实时解析（如 Bilibili、Emby 等），方便多人一起看网络视频。
• 屏幕共享：可以共享声音和屏幕，用于演示或一起看本地视频。 

使用场景

• 异地情侣、朋友一起看电影或追剧
• 远程聚会、线上观影派对
• 教学、演示、直播互动
• 企业或社群的线上活动 

SyncTV的使用教程

一、快速体验（客户端/用户）

1. 访问演示站点：官方提供了一个Demo地址：https://demo.synctv.wiki，打开后即可直接体验同步观影、聊天等功能。
2. 加入房间： 输入房间号或创建新房间，并分享链接邀请朋友一起观看。
3. 播放视频： 支持本地上传、网络视频链接（如 Bilibili、Emby）、直播流。播放、暂停、快进、倍速等操作会自动同步给所有人。
4. 互动功能： 提供文字聊天、弹幕、语音视频通话及屏幕和声音共享功能。

二、进阶部署（适合开发者/自建服务器）

1. 二进制安装： 从 Release 页面下载并解压，运行 ./synctv server 启动服务并生成默认 root 用户。

2. 脚本安装： 执行一行安装脚本命令即可自动下载并部署最新版本。

sudo -v ; curl -fsSL https://raw.githubusercontent.com/synctv-org/synctv/main/script/install.sh | sudo bash -s — -v latest

3. Docker部署： 使用 docker run 命令快速拉取镜像并运行 Synctv 容器。

docker run -d –name synctv \
-v /opt/synctv:/root/.synctv \
-p 8080:8080 \
synctvorg/synctv

4. Docker Compose： 创建 docker-compose.yml 配置文件后，运行 docker-compose up -d 启动服务。

version: ‘3’
services:
synctv:
image: synctvorg/synctv
container_name: synctv
ports:
– “8080:8080”
volumes:
– /opt/synctv:/root/.synctv

5. Helm 部署（Kubernetes）： 添加 Helm 仓库并执行 helm upgrade –install 命令完成集群部署。

helm repo add synctv https://docs.synctv.wiki/helm-charts
helm repo update synctv
helm upgrade –install synctv synctv/synctv \
-n synctv –create-namespace \
–set ingress.enabled=true \
–set ingress.className=nginx \
–set ‘ingress.hosts[0].host=’ \
–set ‘ingress.hosts[0].secretName=’