firefwing24/syncplay

Syncplay Docker镜像文档

1. 镜像概述

本Docker镜像基于https://github.com/Syncplay/syncplay%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%87%87%E7%94%A8Python3.7%E5%92%8CDebian Stretch系统环境，主要用于运行Syncplay服务器程序（syncplayServer.py），实现多用户间媒体播放的同步控制。

2. 核心功能与特性

• 同步播放控制：支持多用户实时同步媒体播放进度、播放/暂停状态
• 轻量级部署：基于Python3.7和Stretch基础镜像，体积小巧，资源占用低
• 便捷运行：内置Syncplay服务器程序，无需额外配置即可快速启动
• 兼容性：兼容标准Syncplay客户端，支持跨平台用户连接

3. 使用场景与适用范围

• 远程观影派对：多用户在线同步观看电影、剧集
• 团队培训：同步播放教学视频，确保所有成员观看进度一致
• 媒体协作：需要同步媒体内容观看的各类场景

4. 使用方法与配置说明

4.1 基本运行命令

通过以下命令快速启动Syncplay服务器：

bash
docker run -d -p 8999:8999 --name syncplay-server syncplay-image

• -d：后台运行容器
• -p 8999:8999：映射容器内Syncplay默认端口8999到主机
• --name syncplay-server：指定容器名称

4.2 自定义配置（可选）

如需自定义服务器配置，可通过挂载配置文件实现：

bash
docker run -d -p 8999:8999 -v /path/to/your/config:/app/config --name syncplay-server syncplay-image

4.3 查看日志

通过以下命令查看服务器运行日志：

bash
docker logs syncplay-server

5. 注意事项

• 默认端口为8999，如需要更改，需同时修改容器端口映射和Syncplay服务器配置
• 确保主机防火墙允许8999端口（或自定义端口）的入站连接，以便客户端正常连接
• 服务器配置文件可参考Syncplay官方文档进行自定义