ttshivers/syncloungeweb

SyncLounge Web Server 镜像说明

镜像概述

该镜像是SyncLounge项目的分支版本（基于https://github.com/samcm/synclounge%EF%BC%89%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E6%9B%B4%E7%A8%B3%E5%AE%9A%E7%9A%84Plex%E5%AA%92%E4%BD%93%E5%90%8C%E6%AD%A5%E4%BD%93%E9%AA%8C%E3%80%82%E5%AE%83%E6%94%AF%E6%8C%81%E8%B7%A8%E6%9C%AC%E5%9C%B0/%E8%BF%9C%E7%A8%8BPlex%E5%AE%A2%E6%88%B7%E7%AB%AF%E5%90%8C%E6%AD%A5%E6%92%AD%E6%94%BE%E5%BD%B1%E8%A7%86%E5%86%85%E5%AE%B9%EF%BC%8C%E5%85%B7%E5%A4%87%E7%9B%B4%E6%8E%A5%E6%92%AD%E6%94%BE%E3%80%81%E5%AD%97%E5%B9%95%E6%94%AF%E6%8C%81%E7%AD%89%E5%A2%9E%E5%BC%BA%E5%8A%9F%E8%83%BD%EF%BC%8C%E4%B8%94%E6%97%A0%E9%9C%80%E9%A2%9D%E5%A4%96%E9%85%8D%E7%BD%AE%E5%8D%B3%E5%8F%AF%E9%80%9A%E8%BF%87%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E9%83%A8%E7%BD%B2%E3%80%82

核心功能

增强特性（相比主版本）

• 简化房间创建与加入流程
• 优化Web播放器（与Plex Web一致）：
  • 直接播放/直接流（Direct Play/Direct Stream）支持
  • 原生字幕显示
  • 剧集跳过控制（下一集/上一集）
  • 高码率内容兼容（解决"appendBuffer"错误）
• 跳过片头/自动跳过片头功能
• 自动主机模式（任何人可启动新内容）
• 聊天声音/桌面通知
• 同步逻辑重写优化

基础功能

• 跨互联网同步Plex客户端
• 密码锁定房间与邀请链接生成
• Plex媒体服务器浏览与内容搜索
• 自动匹配等效媒体内容
• 房间内实时聊天

使用场景

1. 远程同步观影：与异地朋友/家人同步观看Plex影视
2. 本地多设备同步：同一空间内多设备（电视、手机）同步播放
3. 共享媒体库：确保共享Plex库用户的观看进度一致

配置说明

端口与反向代理

• 默认监听端口：8088
• 支持子域名/子目录反向代理，无需修改镜像配置

部署示例

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反向代理配置

子域名配置

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证书（自行添加）

    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;
    }
}

子目录配置

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证书（自行添加）

    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;
    }
}