synctvorg/synctv

SyncTV Docker镜像文档

快速参考

• 维护者：
  https://github.com/synctv-org

• 获取帮助：
  官方文档
  https://github.com/synctv-org/synctv/issues

• 讨论交流：
  ***群组

关于SyncTV

SyncTV是一款支持远程同步观看电影、直播的程序，提供同步观影、直播推流及聊天功能。无论身处何地，您都可以与亲友共同观看视频和直播内容。

其核心的同步观影功能确保所有观看者处于同一播放进度：当您执行暂停、快进、后退、调整播放速度等操作时，其他所有观看者的播放进度将实时同步，实现无缝协同观影体验。

使用方法

启动SyncTV实例

通过以下命令快速启动一个SyncTV容器：

bash
docker run --name synctv -d -p 8080:8080 -v /opt/synctv:/root/.synctv synctvorg/synctv:latest

参数说明：

• --name synctv：指定容器名称为synctv
• -d：后台运行容器
• -p 8080:8080：映射容器8080端口到主机8080端口（TCP/UDP）
• -v /opt/synctv:/root/.synctv：挂载主机目录/opt/synctv到容器内数据目录，持久化配置和数据

使用docker-compose部署

最新示例文件请参考 https://github.com/synctv-org/synctv/blob/main/script/docker-compose.yml

以下是docker-compose.yml配置示例：

yml
version: '3.3'
services:
  synctv:
    image: 'synctvorg/synctv:latest'  # 使用最新版镜像
    container_name: synctv  # 容器名称
    restart: unless-stopped  # 非手动停止时自动重启
    ports:
      - '8080:8080/tcp'  # TCP端口映射
      - '8080:8080/udp'  # UDP端口映射
    volumes:
      - /opt/synctv:/root/.synctv  # 数据持久化目录
    environment:
      - PUID=0  # 用户ID（默认root）
      - PGID=0  # 组ID（默认root）
      - UMASK=022  # 文件权限掩码
      - TZ=Asia/Shanghai  # 时区设置

部署命令：在docker-compose.yml文件所在目录执行 docker-compose up -d 启动服务。

配置说明

详细配置参数及高级用法请参考 官方文档。