RoomDeck

项目概述

线下聚会想让每个人的照片和投票都汇到大屏上，靠传微信群再投屏通常很折腾。RoomDeck 的做法是给现实房间配一个自托管的数字房间：参与者扫码或输六位房间码免账号进入，分享照片、文件、便签与链接，主持人挑选内容上屏，用手机或电脑控制电视投影，活动结束导出 ZIP 并自动清理。

一台 NAS 或服务器，给每个聚会配一间可分享的数字房间。

项目	内容
形态	自托管 Web 服务（Docker 部署）
技术栈	Go + WebSocket + LiveKit
镜像	ghcr.io/panda-995/roomdeck:latest（amd64/arm64）
默认限制	每房 2 GB、50 人，上限 100 房、每房 2000 条
许可证	AGPL-3.0

主要功能

• 免账号进房：六位房间码加二维码，邀请轮换，昵称会话，主持人可移出或暂停某人上传
• 内容共享：照片上传（JPEG/PNG/WebP，自动转正、去元数据）、文件附件、便签、链接
• 投票：匿名单选/多选，结果可隐藏，支持改票
• 大屏控制：独立只读大屏页，轮播、暂停、黑屏，可指定内容与投票上屏
• 轮流投屏：成员经 LiveKit 轮流共享屏幕，多位观众同看，主持人可随时终止
• 小游戏：内置谁是卧底与骰子猜点数，含私人信息、回合结算、积分与断线重连
• 共绘画板：共同画板与限时你画我猜，支持按职责授权的协同主持
• 数据管理：ZIP 导出加校验清单，到期删除、重启清理与单实例数据锁

部署与初始化

1. NAS 或服务器上下载仓库的 compose.yaml，执行 docker compose pull 与 docker compose up -d
2. 打开 http://服务器IP:8080，用日志里的 First-run setup token 完成初始化，管理员密码在网页设置
3. NAS 新装可直接用 compose.nas.yaml，只填局域网 IP，无需 .env
4. 需要投屏时配置 HTTPS 与媒体端口，可用自带自动 HTTPS 配置或复用现有反代

使用流程

1. 主机建房，把二维码投上大屏或发进群聊
2. 参与者扫码进入，上传照片、发便签、参与投票
3. 主持人在控制端挑选内容上屏，电视或投影显示只读大屏
4. 活动结束导出 ZIP，到期数据自动删除

适用人群

• 班级聚会、年会、婚礼现场的组织者
• 找大屏互动方案的 NAS 玩家
• 需要临时共享空间的线下社团

注意事项

• 照片格式：预览仅支持 JPEG/PNG/WebP，HEIC 与视频只能作普通文件共享，无转码
• 匿名边界：匿名投票按浏览器会话去重，不验证真实身份
• 投屏前提：多人投屏需要正确的媒体 IP、端口与 HTTPS，纯 HTTP 局域网不能保证浏览器允许捕获屏幕
• 容量上限：上限 100 房、每房 2000 条内容，默认每房 2 GB 与 50 人，可在设置调整
• 示例素材：内置示例照片来自 Unsplash，正式使用应替换为自己的素材