KaraokeEternal
自托管卡拉OK派对系统,支持手机点歌与全屏播放
智能下载
前往项目主页
该项目暂未提供安装包,请直接访问源代码仓库
用手机点歌的卡拉OK派对系统
核心功能
- 支持MP3+G(含ZIP压缩包)、MP4视频和可视化效果
- 手机浏览器扫码即可加入、搜索歌曲并排队
- 多房间独立队列,可选密码保护
- 动态队列保持公平有趣,无需手动干预
- 完全自托管,无广告或遥测
避坑指南
- •需自备服务器(如Windows/Mac/Raspberry Pi),不需要专用麦克风但需自行处理音频输出;歌曲文件(MP3+G、MP4)需用户自行准备;目前不支持实时歌词编辑或自动K歌评分。
适用场景
- 家庭或朋友聚会办卡拉OK派对
- 酒吧、企业活动等需要多人点歌的场景
详细介绍
Karaoke Eternal 是一款开源卡拉OK派对系统。你可在服务器上自托管,参与者用手机浏览器扫码加入、搜索歌曲并排队。播放器在电脑上全屏运行,支持MP3+G(含CDG歌词)、MP4视频和音乐同步可视化。无需专用麦克风,可自由搭配音响。支持多房间、密码保护、动态队列,无广告无遥测。
常见问题与排障 (2)
故障排除安装 npm 包时如何修复“Python not installed”严重错误?
该错误发生是因为某些依赖必须针对你的平台/架构从源代码编译。作为变通方法,安装预发布版本,其中可能包含预编译的二进制文件:npm install <package-name>@next。如果失败,请改用适用于你平台的预构建可执行文件。安装 Python 和所需的构建工具也可以使源代码编译成功。
故障排除如何修复 Windows 上由 license-webpack-plugin 引起的 npm webpack 构建错误 "ENOENT: no such file or directory, scandir"?
该故障是由 license-webpack-plugin 尝试扫描缺失的 package/license 目录引起的,而非应用程序代码所致。对于本地 Windows 构建,请在 config/webpack.config.js 中禁用该插件:在 plugins 数组中找到 new LicensePlugin({ ... }) 并将其注释掉,然后重新运行 npm run build。如果需要生成许可证,请先使用 npm install -D license-webpack-plugin@latest 升级该插件;如果错误仍然存在,请配置 handleMissingLicenseText: 'ignore',或为警告中列出的包提供 licenseTextOverrides。许可证警告本身并非致命错误;致命的步骤是该插件的 scandir 调用。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
克隆仓库并进入目录:git clone ... && cd karaoke-eternal
安装依赖:npm install
启动开发服务器:npm run dev
- 克隆仓库并进入目录:git clone ... && cd karaoke-eternal
- 安装依赖:npm install
- 启动开发服务器:npm run dev
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载,并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
删除项目文件夹及其所有文件即可卸载。若使用Docker则执行 docker compose down 并删除容器。
无额外依赖
下载后即可直接使用,无需安装其他运行环境
遇到问题?查看下方 FAQ
2 FAQs