OpenList + SyncTV。OpenList 负责挂载云盘资源、提供稳定的视频直链;SyncTV 则承担多人同步播放、弹幕互动与房间管理的职责。两者配合,即可实现在任意网页端与朋友同步观看影视内容,无需安装任何客户端。
要实现流畅的同步观影体验,尤其是多人同时在线的场景,对服务器的网络质量要求极高——任何一方的延迟抖动都会破坏同步效果。这正是搬瓦工 CN2 GIA / CMIN2 优化线路的核心优势:超低延迟、稳定带宽、三网直连,能够为国内用户提供极为顺畅的访问体验。本项目将充分利用这一线路优势,打造一个稳定可靠的多人影音中心。
本次教程主要分为三个阶段:部署 OpenList 并对接夸克网盘 → 安装 SyncTV → 完成 SyncTV 与 OpenList 的对接与调试。
需要准备的事项
- 拥有一台搬瓦工的服务器(参考选购指南);
- 服务器正常运行,且已安装 Debian 12 系统;
- 拥有一个可对接 OpenList 的不限速网盘(例如 88VIP 夸克网盘,咸鱼约 10 元可开通一年);
- SSH 连接工具已准备就绪(例如 Xshell,个人/家庭用户可免费下载使用)。
一、连接服务器并安装 OpenList
OpenList 是一个功能强大的开源文件列表程序,其核心能力在于统一挂载和管理各类主流云存储服务,包括阿里云盘、115 网盘、夸克网盘、OneDrive、Google Drive 等数十种存储后端。通过 OpenList,你可以将分散在不同网盘中的影视资源整合到同一个访问入口,并为 SyncTV 提供稳定的视频直链支持。相比直接使用网盘客户端,OpenList 的优势在于可通过 Web 界面统一管理,并支持 WebDAV、直链分享等高级功能,非常适合作为个人媒体库的资源层。
1. SSH 连接与基础工具安装
使用 SSH 工具连接到您的搬瓦工服务器(推荐使用 Xshell 等工具;个人或家庭用户可前往官网免费下载),成功登录后,执行以下命令安装后续操作所需的基础工具:

apt-get install wget curl vim sudo unzip -y
这一步将安装 wget(文件下载)、curl(HTTP 请求)、vim(文本编辑)、sudo(权限管理)和 unzip(解压缩)等常用工具,是后续所有安装步骤的基础依赖,建议在全新系统上首先执行。
2. 安装 OpenList
执行以下一键安装命令,脚本会自动拉取最新版本的 OpenList 并完成安装配置。运行后根据提示选择 1 进行安装,然后直接按回车键确认:
curl -fsSL https://res.oplist.org/script/v4.sh > install-openlist-v4.sh && sudo bash install-openlist-v4.sh
安装完成后,终端会输出 OpenList 的公网访问地址以及初始账号密码,请务必将这些信息妥善保存,后续登录和配置都需要用到。如果不小心遗漏,可以通过查看 OpenList 的配置文件或重置命令重新获取。
二、登录 OpenList 并设置储存
OpenList 安装完成后,下一步是登录管理后台,并通过获取 Cookie 的方式将夸克网盘添加为储存后端。如果你使用的是 115 网盘或阿里云盘,操作流程基本类似,可参考 OpenList 官方文档 获取对应驱动的详细配置说明。
1. 登录 OpenList
在浏览器中访问刚才保存的公网地址(格式为 http://你的IP:5244),输入初始账号密码完成登录。出于安全考虑,第一次登录后请务必立即修改默认账号和密码,避免因使用弱密码导致服务器资源被他人滥用。建议设置包含大小写字母与数字的强密码,并记录在安全的地方。
2. 添加 OpenList 储存
全新安装的 OpenList 默认没有任何储存挂载,需要手动添加。在管理后台点击转到储存进入储存管理界面,点击添加按钮,在驱动列表中选择夸克,并在挂载路径一栏填写你希望在主页显示的目录名称(例如 /quark 或 /我的网盘)。挂载路径决定了该网盘在 OpenList 主页的显示位置,可以根据个人习惯自由命名。
3. 获取夸克网盘 Cookie
打开一个新的浏览器标签页,访问夸克网盘官网 https://pan.quark.cn/,使用手机扫码完成登录。确认已成功登录后,按下 F12(或 Shift+Ctrl+I)打开浏览器开发者工具,切换到”网络(Network)”选项卡,刷新页面后找到任意一个请求,在请求头(Request Headers)中找到 Cookie 字段,复制其完整内容并保存。
注意:Cookie 是访问夸克网盘的身份凭证,请勿将其泄露给他人。Cookie 存在有效期,若后续出现无法访问网盘的情况,通常需要重新获取并更新。
4. 完成 OpenList 添加夸克储存
返回第 2 步的储存添加界面,将刚才复制的 Cookie 粘贴到对应的 Cookie 输入栏中,然后点击保存。保存成功后,回到 OpenList 主页,访问你设置的挂载路径,即可看到夸克网盘中的所有文件和目录。至此,云盘资源层已配置完毕,可以进入 SyncTV 的安装阶段。
三、安装 SyncTV
SyncTV 是一款专为远程同步观影设计的开源程序,其核心功能是通过服务端统一控制视频播放进度,确保所有在线观看者的时间轴完全一致。除基础的同步播放外,SyncTV 还支持实时聊天、弹幕发送、直播房间创建、多平台视频源对接等功能,是目前开源社区中功能最完善的同步观影解决方案之一。相较于临时使用 Discord 屏幕共享等方案,SyncTV 在视频质量、延迟控制和功能丰富度上均有显著优势。
1. 使用一键脚本安装
运行以下一键安装脚本,系统将自动下载并安装最新版本的 SyncTV。默认情况下,脚本不会在终端输出登录信息,安装完成后请参考下文的默认账号信息:
sudo -v ; curl -fsSL https://raw.githubusercontent.com/synctv-org/synctv/main/script/install.sh | sudo bash -s -- -v latest
2. 启动并设置开机自启动
安装完成后,依次执行以下两条命令,启动 SyncTV 服务并将其设置为开机自动启动,确保服务器重启后无需手动干预:
systemctl start synctv.service
systemctl enable synctv.service
执行完毕后,可通过 systemctl status synctv.service 命令确认服务是否正常运行,输出中出现 active (running) 即表示启动成功。
四、调试 SyncTV 并对接 OpenList
SyncTV 在默认配置下是独立运行的,不会自动关联任何储存程序。本章节将演示如何将 SyncTV 与 OpenList 完成对接,并创建房间实现多人同步观影的完整流程。
1. 登录 SyncTV
SyncTV 的默认访问信息如下:
访问地址:你的IP:8080
默认账号:root
初始密码:root
重要提示:登录后请立即修改默认用户名和密码。SyncTV 的管理员账号拥有房间创建、用户管理、系统配置等全部权限,使用弱密码存在较大安全风险,尤其是在公网环境下。
2. SyncTV 对接 OpenList
登录 SyncTV 管理后台后,进入系统设置中的储存对接模块,按照界面提示填写 OpenList 的访问地址(格式为 http://127.0.0.1:5244)及对应的访问令牌(Token)。OpenList 的 Token 可在其管理后台的”个人信息”或”设置”页面中获取。填写完成并保存后,界面将显示对接成功的状态提示,此时 SyncTV 即可读取 OpenList 中挂载的所有网盘资源。
3. 添加用户
SyncTV 的核心价值在于多人同步观影,因此在正式使用前,建议先在管理后台为参与观影的朋友创建独立账号。每个账号可以设置不同的权限级别,例如普通用户只能观看,而受信任的用户可以拥有控制播放进度的权限。
4. 创建房间
在 SyncTV 主页顶部的菜单栏(若浏览器窗口较窄,则在右侧侧边栏)点击”创建房间”按钮,填写房间名称并根据需要设置访问权限(公开或需要密码加入)。房间创建后,房主拥有对播放进度的完全控制权。
5. 添加影片
进入已创建的房间后,点击添加影片按钮,在弹出的资源选择界面中,浏览 OpenList 挂载的网盘目录,找到目标视频文件并添加到播放列表。SyncTV 支持添加多个视频形成队列,方便连续观看多集内容。
6. 加入房间
其他用户登录 SyncTV 主页后,可以在房间列表中看到已创建的房间并直接加入(公开房间无需密码,私密房间需输入密码)。房间内的所有成员共享同一个播放进度,任何一方的操作都会实时同步到所有观看者。
7. 共同观影
观影过程中,房主执行暂停、快进、跳转等操作时,所有观看者的播放器会同步响应,实现时间轴的完全一致。配合 SyncTV 内置的实时聊天和弹幕功能,整体体验与线下共同观影非常接近,非常适合异地朋友的日常娱乐场景。
五、进阶优化
基础部署完成后,以下进阶配置能够显著提升系统的稳定性、安全性和使用体验。SyncTV 与 OpenList 均拥有丰富的扩展能力,值得深入探索。
1. 设置房间权限
拥有管理权限的账户可以对房间进行精细化配置,例如:禁止访客(未登录用户)加入、限制普通用户的播放控制权限(仅允许观看,不允许暂停或跳转)、开启弹幕审核等。合理的权限设置有助于维护观影秩序,避免因误操作打断正在进行的观影体验。
2. 程序的原理与流量消耗
理解 SyncTV + OpenList 的工作原理,有助于更好地规划服务器资源。在默认配置下,视频数据流的路径如下:夸克网盘 → OpenList 所在服务器 → 观看者浏览器。这意味着每一位观看者播放视频时,OpenList 服务器都需要从夸克网盘拉取数据并转发,流量消耗约为实际观看流量的双倍(上行+下行各一份)。
对于搬瓦工 E-Commerce SLA VPS 用户,需要特别关注月度流量配额。建议优先选择支持直链输出的网盘(夸克网盘在 OpenList 中支持直链),并在 SyncTV 中启用直链播放模式,使观看者直接从网盘服务器获取视频流,从而绕过 VPS 中转,大幅降低服务器流量消耗。
3. 扩展玩法
SyncTV 的功能远不止同步观影,其扩展性包括:
- 源视频代理播放:支持将源视频通过服务器进行代理中转播放,适合网盘直链访问受限的场景。
- 对接 Bilibili:可绑定 Bilibili 账号,直接通过 BV 号搜索并播放视频,适合追番或分享 UP 主内容。
- 直链与直播支持:支持播放任意 HTTP 直链视频,甚至可以导入 M3U8 直播流,创建专属的直播观看房间。
你可以根据实际需求进一步挖掘 SyncTV 的全部潜力,打造更丰富的个人影音娱乐生态。
4. 使用域名反向代理
SyncTV 和 OpenList 默认均以 IP + 端口 的形式访问,不仅不便记忆,也无法启用 HTTPS 加密,存在一定安全隐患。建议通过 Nginx Proxy Manager 配置反向代理,将两个服务绑定到独立域名并启用 SSL 证书,实现更专业、更安全的访问方式。
具体配置方法可参考:如何搭建 Nginx Proxy Manager 并使用反向代理和远程桌面加速。
需要注意,SyncTV 和 OpenList 的反向代理均需要使用特定的配置参数,以下是来自官方文档的推荐配置:
SyncTV:
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Protocol $scheme;
proxy_set_header X-Forwarded-Host $http_host;
proxy_set_header REMOTE-HOST $remote_addr;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Range $http_range;
proxy_set_header If-Range $http_if_range;
client_max_body_size 20m;
proxy_http_version 1.1;
}
SyncTV 的宝塔面板用户请删除以下代码段(否则会导致静态资源加载异常):
location ~ ^/(.user.ini|.htaccess|.git|.svn|.project|LICENSE|README.md
location ~ .*.(gif|jpg|jpeg|png|bmp|swf)$
location ~ .*.(js|css)?$
OpenList:
location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Range $http_range;
proxy_set_header If-Range $http_if_range;
proxy_redirect off;
proxy_pass http://127.0.0.1:5244;
proxy_http_version 1.1;
# 最大上传文件大小限制
client_max_body_size 20000m;
}
5. 访问异常排查
如果遇到 SyncTV 或 OpenList 无法访问的情况,最常见的原因是防火墙或面板程序屏蔽了对应端口。请检查服务器是否安装了 UFW、iptables、nftables 或宝塔面板等防火墙工具,并为以下端口添加放行规则:
- SyncTV:
8080 - OpenList:
5244
此外,还需确认搬瓦工 KiwiVM 控制面板中没有额外的网络访问限制。如果使用了域名反向代理,还需检查 Nginx 配置是否正确,以及 SSL 证书是否有效。关于搬瓦工防火墙配置的详细说明,可参考对应的专项教程。
通过本文的完整部署流程,你已经拥有了一套功能完备的私人影音中心:OpenList 负责统一管理云盘资源,SyncTV 提供多人同步观影与互动体验,两者在搬瓦工 CN2 GIA 优化线路的加持下,能够为国内用户提供极为流畅的访问体验。无论是日常追剧、异地共同观影,还是搭建小型私人影院,这套方案都能胜任。后续你可以进一步探索域名绑定、权限管理、直链优化等进阶玩法,将这套系统打磨得更加完善。如有疑问,欢迎参考 OpenList 官方文档 和 SyncTV 项目主页获取更多帮助。
原创文章,作者:banwagong,如若转载,请注明出处:https://bwgcn2gia.com/archives/380.html
