開源神器 KaraokeEternal:自托管無廣告,手機點歌 + 多房間 KTV,Docker 一鍵搭!
有沒有適合家庭派對、小型聚會的 KTV 方案?不要那種滿是廣告的付費軟件,最好能自己管歌曲庫,手機點歌還不用裝 APP 的?
今天就給大家安利一款完美匹配這些需求的開源工具 ——KaraokeEternal。它不僅能讓你在家輕松開起 KTV 派對,還支持全平臺自托管,部署起來也沒門檻,新手用 Docker 跟著步驟走就能搞定。
![]()
軟件核心:開源、輕量、全瀏覽器化
先明確下 KaraokeEternal 的定位:它是一款專注于 “派對場景” 的開源 KTV 系統,核心優勢就是 “輕量無負擔”—— 不管是點歌的手機端,還是播放的大屏端,全靠瀏覽器運行,不用額外裝任何 APP,對新手和非技術用戶特別友好。
關鍵信息先擺清楚,方便大家直接上手:
? 開源地址 :https://github.com/bhj/KaraokeEternal/(代碼可查,無隱私顧慮)
? 官方文檔 :https://www.karaoke-eternal.com/(詳細配置看這里)
? Docker 鏡像 :radrootllc/karaoke-eternal(部署首選,省去環境配置麻煩)
? 支持平臺 :Windows、Mac、Linux,甚至樹莓派、群暉 NAS 這類輕量設備都能跑
用過不少 KTV 工具,KaraokeEternal 最讓我覺得 “貼心” 的是,它的功能全是針對實際派對場景設計的,沒有花里胡哨的冗余功能:
1. 格式兼容 + 音效優化,音質不翻車
支持 MP3+G(老卡拉 OK 文件)和 MP4 視頻(現在主流的 KTV 視頻格式),還能識別 ReplayGain 標簽 —— 簡單說,就是不管你找的歌曲音量大小不一,播放時會自動統一音量,不用中途手忙腳亂調音量。
2. 多房間 + 密碼保護,人多也不亂
朋友多的時候,能開多個同步房間(比如 “華語金曲房”“歐美流行房”),每個房間可以設密碼,避免陌生人亂進。每個房間的點歌隊列獨立,互不干擾。
3. 動態隊列,不用搶麥
點歌不用 “搶”,系統會自動按順序排,還能調整隊列順序(比如長輩想先唱,直接把歌曲移到前面),既公平又靈活,不會因為搶點歌掃了興。
4. 全自托管 + 無廣告,隱私有保障
所有數據(歌曲庫、用戶信息)都存在你自己的設備上,沒有廣告彈窗,也不會收集任何使用數據(官方明確說 “無 telemetry”),不管是家庭用還是小社團用,隱私都放心。
Docker 部署:Ubuntu 為例,3 步搞定
KaraokeEternal 支持多種部署方式,但星哥最推薦 Docker—— 不用管依賴,一鍵啟動,后續升級也方便。下面以 Ubuntu 系統為例,一步步教大家操作:
第一步:安裝 Docker 和 docker-compose
先更新系統,再安裝 Docker 和 docker-compose(如果已經裝過,可以跳過這步):
# 更新系統軟件包 sudo apt update # 安裝Docker和docker-compose sudo apt install -y docker.io docker-compose # 驗證安裝成功(出現版本號就沒問題) docker --version docker-compose --version第二步:創建 docker-compose.yml 配置文件建議在/home目錄下創建配置文件,方便后續管理(比如修改路徑、升級容器)。先進入 /home 目錄,然后創建文件:
# 進入/home目錄 cd /home # 創建并編輯docker-compose.yml nano docker-compose.yml把下面的內容復制進去(注意修改路徑,確保符合你的實際需求):
services: karaoke-eternal: # 使用官方Docker鏡像 image:radrootllc/karaoke-eternal # 容器名字,方便后續管理 container_name:karaoke-eternal # 數據卷映射:左邊是你本地路徑,右邊是容器內路徑 volumes: -/home/config:/config# 存放系統配置(比如用戶、房間設置) -/home/mnt/karaoke:/mnt/karaoke# 存放你的KTV歌曲庫 # 端口映射:本地8000端口映射到容器8080端口(8000可以改,只要不沖突) ports: -8000:8080 # 重啟策略:除非手動停止,否則容器掛了會自動重啟 restart: unless-stopped復制完后,按Ctrl+O保存,再按Ctrl+X退出編輯。
第三步:啟動容器,訪問系統
執行下面的命令,啟動 KaraokeEternal 容器:
# 后臺啟動容器(-d表示后臺運行) sudo docker-compose up -d # 查看容器狀態(出現Up就表示啟動成功) sudo docker ps | grep karaoke-eternal啟動成功后,就可以訪問了:
? 本地訪問 :在同一局域網的設備上,打開瀏覽器輸入
http://localhost:8000(如果是服務器,把 localhost 換成服務器的局域網 IP);
我這邊用8002端口
![]()
docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 003eb9c1e043 radrootllc/karaoke-eternal "karaoke-eternal-ser…" 13 seconds ago Up 11 seconds 0.0.0.0:8002->8080/tcp, :::8002->8080/tcp karaoke-eternal? 云服務器訪問 :如果用的是云服務器,需要先在安全組里開放 8000 端口,然后用
http://服務器公網IP:8000訪問。
![]()
四、快速體驗:不想寫配置?一條命令搞定
如果只是想先試試水,不想創建 docker-compose.yml,也可以用一條命令直接啟動容器(注意:這種方式適合體驗,正式用還是建議用 docker-compose,方便后續管理):
sudo docker run \ --name=karaoke-eternal \ -v /home/config:/config \ -v /home/mnt/karaoke:/mnt/karaoke \ -p 8000:8080 \ --restart unless-stopped \ radrootllc/karaoke-eternal五、使用小貼士:讓體驗更絲滑1. **歌曲庫怎么加?**把下載好的 MP3+G 或 MP4 格式歌曲,放到
/home/mnt/karaoke目錄(就是你配置里映射的歌曲庫路徑),系統會自動掃描,不用手動添加。2. **手機點歌怎么操作?**手機和服務器連同一局域網,打開瀏覽器輸入服務器地址,登錄后選一個房間,搜索歌曲、加入隊列就行 —— 界面是響應式的,手機上點起來很順手。
3. **麥克風怎么弄?**KaraokeEternal 的播放器只輸出音樂,麥克風需要自己配(比如用藍牙麥克風、外接麥克風),這樣你可以根據自己的預算搭配音頻設備,靈活度很高。
4. **遇到問題找誰?**官方有 Discord 社區(https://discord.com/invite/PgqVtFq),可以去里面問問題,也能和其他用戶交流歌曲庫資源;GitHub 上也能提 Issue,作者響應挺及時的。
如果你需要一款 “無廣告、可控性強、部署簡單” 的 KTV 工具,不管是家庭聚會、朋友派對,還是小社團活動,KaraokeEternal 都很合適 —— 它沒有復雜的設置,開源免費,還能自己管歌曲庫,完全不用被付費軟件 “綁架”。
特別聲明:以上內容(如有圖片或視頻亦包括在內)為自媒體平臺“網易號”用戶上傳并發布,本平臺僅提供信息存儲服務。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.