ttshivers/synclounge

镜像概述

ttshivers/synclounge是SyncLounge项目的优化分支镜像，相比主版本提升了稳定性，并新增直接流、直接播放等功能。它通过中间服务器实现多Plex客户端的播放状态同步，支持用户跨设备、跨地域与朋友同步观看Plex媒体内容。

核心功能

分支增强功能

• 简化房间创建与加入流程
• 优化Web播放器（与Plex Web一致）：支持直接播放、原生字幕、跳过片头/自动跳过片头、剧集上下集快速切换
• 自动主机模式：任何用户均可启动新内容播放（不限于初始主机）
• 聊天声音/桌面通知提醒
• 同步逻辑的重大重构与优化，解决高码率播放错误问题

基础功能

• 跨互联网同步Plex客户端播放状态（播放、暂停、快进等）
• 内置SyncLounge专用播放器（专为同步场景设计）
• 可配置同步参数：客户端轮询间隔、同步灵活性、同步方式（直接跳转/跳过前向）
• Plex媒体服务器内容浏览与推送
• 房间密码保护、邀请链接生成
• 房间内实时聊天功能

使用场景

• 远程朋友同步观看Plex电影/剧集，实现线上观影派对
• 家庭跨设备共享观影（如客厅电视与卧室平板同步播放）
• 多人实时互动的媒体共享体验

配置说明

Docker部署

直接拉取并运行镜像：

bash
docker pull ttshivers/synclounge
docker run -p 8088:8088 ttshivers/synclounge:latest

可通过环境变量修改默认配置（参考https://github.com/ttshivers/synclounge/blob/master/config/defaults.js%EF%BC%89%E3%80%82

Nginx反向代理配置

子域名配置（示例：synclounge.yourdomain.com）

nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      '';
}

server {
    listen 80;
    listen [::]:80;
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name synclounge.yourdomain.com;

    # 替换为你的SSL证书配置
    # ssl_certificate /path/to/cert.pem;
    # ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:8088;
        proxy_http_version 1.1;
        proxy_socket_keepalive on;
        proxy_redirect off;

        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $server_name;
        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-Port $server_port;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Sec-WebSocket-Extensions $http_sec_websocket_extensions;
        proxy_set_header Sec-WebSocket-Key $http_sec_websocket_key;
        proxy_set_header Sec-WebSocket-Version $http_sec_websocket_version;
    }
}

子目录配置（示例：yourdomain.com/synclounge）

nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      '';
}

server {
    listen 80;
    listen [::]:80;
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    server_name yourdomain.com;

    # 替换为你的SSL证书配置
    # ssl_certificate /path/to/cert.pem;
    # ssl_certificate_key /path/to/key.pem;

    location /synclounge/ {
        proxy_pass http://localhost:8088/;
        proxy_http_version 1.1;
        proxy_socket_keepalive on;
        proxy_redirect off;

        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $server_name;
        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-Port $server_port;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Sec-WebSocket-Extensions $http_sec_websocket_extensions;
        proxy_set_header Sec-WebSocket-Key $http_sec_websocket_key;
        proxy_set_header Sec-WebSocket-Version $http_sec_websocket_version;
    }
}