30分钟办一场K歌派对KaraokeEternal从安装到点出第一首歌的7个步骤【免费下载链接】KaraokeEternalOpen karaoke party system项目地址: https://gitcode.com/gh_mirrors/ka/KaraokeEternalKaraokeEternal 是一款开源的自托管卡拉OK系统让你在家就能办一场K歌派对朋友用手机浏览器打开网页即可点歌电脑或电视端的播放器全屏展示歌词与MV无需安装任何 App、无广告、数据完全保存在你自己的设备里。本文带你从零开始按 7 个步骤完成卡拉OK服务器安装、添加曲库、点出第一首歌30 分钟内即可开唱 。第1步准备工作——备齐歌曲、服务器和播放器开派对前先确认手里有三样东西需要准备说明 卡拉OK歌曲支持MP3GMP3 CDG 歌词文件支持 zip 压缩包和MP4 视频️ 服务器设备Windows 电脑、Mac、树莓派或 NAS 均可 播放器设备连接屏幕和音响的设备用浏览器全屏播放可以和服务器是同一台机器两个小提醒歌曲文件请按“艺术家 - 歌名”如Jay Chou - 晴天.mp3命名这是扫描器的默认解析规则命名不对的歌曲不会出现在曲库里。不需要麦克风。播放器本身只输出伴奏人声怎么接随你——从手机直插到专业KTV音响都行。详细说明可参考 docs/content/docs/getting-started/index.md。第2步一键安装 KaraokeEternal ServerNPM 方式最快在将要当服务器的设备上先安装 Node.js v24 或更高版本然后打开终端执行两条命令npm i -g karaoke-eternal karaoke-eternal-server --port 8080第一条命令全局安装卡拉OK服务器-g表示全局第二条命令启动服务器并固定使用 8080 端口不加--port时会随机选端口。看到Web server running at...字样就成功了记下后面的地址这就是服务器 URL。服务器端的入口代码在 server/main.ts媒体扫描逻辑在 server/Scanner/Scanner.ts。 如果你用的是 NAS 或专用服务器也可以用 Docker 镜像radrootllc/karaoke-eternal部署支持 amd64/arm64compose 文件示例见 docs/content/docs/karaoke-eternal-server/index.md。第3步浏览器访问服务器URL创建管理员账号用浏览器打开刚才的服务器 URL推荐用手机体验最佳首次访问会要求创建admin 管理员账号设置用户名和一个强密码并记好——管理员可以管理用户、房间和全部设置放心所有数据都只存储在你的服务器上不外传。账号相关的前端页面在 src/routes/Account/ 目录下。第4步添加媒体文件夹让扫描器收录歌曲登录后你会看到一个空曲库点“Add media folders”链接或底部导航的人像图标进入 Account 页面在Preferences区域选择Media Folders添加存放卡拉OK歌曲的文件夹可拖拽调整顺序顺序靠前者优先等待媒体扫描完成曲库就会自动填充。扫描完成后如果发现歌没出来先检查文件名是否遵循“艺术家 - 歌名”规范或查看扫描日志排查。第5步在曲库中点出你的第一首歌切回Library页面曲库已按艺术家分组列好顶部还支持搜索和筛选点一下艺术家展开歌单点一下歌名即可点歌被点中的歌和艺术家会发光表示已进队列。曲库视图的代码入口是 src/routes/Library/views/LibraryView.tsx。先随便点两三首别客气派对嘛 第6步启动播放器把音乐推上大屏幕播放器就是同一个网页应用的另一个形态需要在连接屏幕和音响的设备上运行在该设备的浏览器Chrome / Edge / Firefox / Safari 最新版中打开服务器 URL用管理员账号登录此时 App 顶部会显示“No player in room”提示点击Start Player链接进入全屏播放器后在播放器内部直接按播放——这样可以避开浏览器的自动播放限制之后管理员和正在演唱的用户都能在手机上看到播放与显示控制。播放器和显示选项的实现在 src/routes/Player/views/PlayerView.tsx。如果没看到 “No player in room” 提示说明浏览器不支持全屏可手动访问/player路径。第7步扫码或共享链接邀请朋友一起点歌一切就绪让派对热闹起来房间播放器上会显示二维码朋友用手机一扫即进入点歌界面自动选好房间管理员可以在 Account 页的Rooms面板为房间设置名字、密码并开放访客模式让没有账号的朋友直接以游客身份加入队列采用轮询公平机制后加入的人排在当前演唱者之后不会因来晚就被挤到队尾人人都有机会唱。房间与队列的管理代码分别在 server/Rooms/Rooms.ts 和 server/Queue/Queue.ts。小贴士让派对更顺滑每次开新房间建议每场派对新建一个房间玩完设为closed收尾避免上一场的队列残留音量忽大忽小如果你的歌曲都带 ReplayGain 标签可在偏好设置里开启 clip-safe 音量均衡▶️远程启动播放器不响按 docs/content/faq/enabling-autoplay.md 打开浏览器的自动播放权限去哪找卡拉OK歌参考 docs/content/faq/where-can-i-download-karaoke-songs.md。7 个步骤走完第一首歌已经响起——剩下的就交给歌声吧 【免费下载链接】KaraokeEternalOpen karaoke party system项目地址: https://gitcode.com/gh_mirrors/ka/KaraokeEternal创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考