開(kāi)源神器 KaraokeEternal：自托管無(wú)廣告，手機(jī)點(diǎn)歌 + 多房間 KTV，Docker 一鍵搭！

有沒(méi)有適合家庭派對(duì)、小型聚會(huì)的 KTV 方案？不要那種滿是廣告的付費(fèi)軟件，最好能自己管歌曲庫(kù)，手機(jī)點(diǎn)歌還不用裝 APP 的？

今天就給大家安利一款完美匹配這些需求的開(kāi)源工具 ——KaraokeEternal。它不僅能讓你在家輕松開(kāi)起 KTV 派對(duì)，還支持全平臺(tái)自托管，部署起來(lái)也沒(méi)門(mén)檻，新手用 Docker 跟著步驟走就能搞定。

軟件核心：開(kāi)源、輕量、全瀏覽器化

先明確下 KaraokeEternal 的定位：它是一款專注于 “派對(duì)場(chǎng)景” 的開(kāi)源 KTV 系統(tǒng)，核心優(yōu)勢(shì)就是 “輕量無(wú)負(fù)擔(dān)”—— 不管是點(diǎn)歌的手機(jī)端，還是播放的大屏端，全靠瀏覽器運(yùn)行，不用額外裝任何 APP，對(duì)新手和非技術(shù)用戶特別友好。

關(guān)鍵信息先擺清楚，方便大家直接上手：

• ? 開(kāi)源地址 ：https://github.com/bhj/KaraokeEternal/（代碼可查，無(wú)隱私顧慮）

• ? 官方文檔 ：https://www.karaoke-eternal.com/（詳細(xì)配置看這里）

• ? Docker 鏡像 ：radrootllc/karaoke-eternal（部署首選，省去環(huán)境配置麻煩）

• ? 支持平臺(tái) ：Windows、Mac、Linux，甚至樹(shù)莓派、群暉 NAS 這類輕量設(shè)備都能跑

用過(guò)不少 KTV 工具，KaraokeEternal 最讓我覺(jué)得 “貼心” 的是，它的功能全是針對(duì)實(shí)際派對(duì)場(chǎng)景設(shè)計(jì)的，沒(méi)有花里胡哨的冗余功能：

1. 格式兼容 + 音效優(yōu)化，音質(zhì)不翻車

支持 MP3+G（老卡拉 OK 文件）和 MP4 視頻（現(xiàn)在主流的 KTV 視頻格式），還能識(shí)別 ReplayGain 標(biāo)簽 —— 簡(jiǎn)單說(shuō)，就是不管你找的歌曲音量大小不一，播放時(shí)會(huì)自動(dòng)統(tǒng)一音量，不用中途手忙腳亂調(diào)音量。

2. 多房間 + 密碼保護(hù)，人多也不亂

朋友多的時(shí)候，能開(kāi)多個(gè)同步房間（比如 “華語(yǔ)金曲房”“歐美流行房”），每個(gè)房間可以設(shè)密碼，避免陌生人亂進(jìn)。每個(gè)房間的點(diǎn)歌隊(duì)列獨(dú)立，互不干擾。

3. 動(dòng)態(tài)隊(duì)列，不用搶麥

點(diǎn)歌不用 “搶”，系統(tǒng)會(huì)自動(dòng)按順序排，還能調(diào)整隊(duì)列順序（比如長(zhǎng)輩想先唱，直接把歌曲移到前面），既公平又靈活，不會(huì)因?yàn)閾岦c(diǎn)歌掃了興。

4. 全自托管 + 無(wú)廣告，隱私有保障

所有數(shù)據(jù)（歌曲庫(kù)、用戶信息）都存在你自己的設(shè)備上，沒(méi)有廣告彈窗，也不會(huì)收集任何使用數(shù)據(jù)（官方明確說(shuō) “無(wú) telemetry”），不管是家庭用還是小社團(tuán)用，隱私都放心。

Docker 部署：Ubuntu 為例，3 步搞定

KaraokeEternal 支持多種部署方式，但星哥最推薦 Docker—— 不用管依賴，一鍵啟動(dòng)，后續(xù)升級(jí)也方便。下面以 Ubuntu 系統(tǒng)為例，一步步教大家操作：

第一步：安裝 Docker 和 docker-compose

先更新系統(tǒng)，再安裝 Docker 和 docker-compose（如果已經(jīng)裝過(guò)，可以跳過(guò)這步）：

# 更新系統(tǒng)軟件包 sudo apt update # 安裝Docker和docker-compose sudo apt install -y docker.io docker-compose # 驗(yàn)證安裝成功（出現(xiàn)版本號(hào)就沒(méi)問(wèn)題） docker --version docker-compose --version

建議在/home目錄下創(chuàng)建配置文件，方便后續(xù)管理（比如修改路徑、升級(jí)容器）。先進(jìn)入 /home 目錄，然后創(chuàng)建文件：

# 進(jìn)入/home目錄 cd /home # 創(chuàng)建并編輯docker-compose.yml nano docker-compose.yml

把下面的內(nèi)容復(fù)制進(jìn)去（注意修改路徑，確保符合你的實(shí)際需求）：

services:   karaoke-eternal:     # 使用官方Docker鏡像     image:radrootllc/karaoke-eternal     # 容器名字，方便后續(xù)管理     container_name:karaoke-eternal     # 數(shù)據(jù)卷映射：左邊是你本地路徑，右邊是容器內(nèi)路徑     volumes:       -/home/config:/config# 存放系統(tǒng)配置（比如用戶、房間設(shè)置）       -/home/mnt/karaoke:/mnt/karaoke# 存放你的KTV歌曲庫(kù)     # 端口映射：本地8000端口映射到容器8080端口（8000可以改，只要不沖突）     ports:       -8000:8080     # 重啟策略：除非手動(dòng)停止，否則容器掛了會(huì)自動(dòng)重啟     restart: unless-stopped

復(fù)制完后，按Ctrl+O保存，再按Ctrl+X退出編輯。

第三步：?jiǎn)?dòng)容器，訪問(wèn)系統(tǒng)

執(zhí)行下面的命令，啟動(dòng) KaraokeEternal 容器：

# 后臺(tái)啟動(dòng)容器（-d表示后臺(tái)運(yùn)行） sudo docker-compose up -d # 查看容器狀態(tài)（出現(xiàn)Up就表示啟動(dòng)成功） sudo docker ps | grep karaoke-eternal

啟動(dòng)成功后，就可以訪問(wèn)了：

• ? 本地訪問(wèn) ：在同一局域網(wǎng)的設(shè)備上，打開(kāi)瀏覽器輸入 http://localhost:8000 （如果是服務(wù)器，把 localhost 換成服務(wù)器的局域網(wǎng) 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

• ? 云服務(wù)器訪問(wèn) ：如果用的是云服務(wù)器，需要先在安全組里開(kāi)放 8000 端口，然后用 http://服務(wù)器公網(wǎng)IP:8000 訪問(wèn)。

四、快速體驗(yàn)：不想寫(xiě)配置？一條命令搞定

如果只是想先試試水，不想創(chuàng)建 docker-compose.yml，也可以用一條命令直接啟動(dòng)容器（注意：這種方式適合體驗(yàn)，正式用還是建議用 docker-compose，方便后續(xù)管理）：

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. 1. **歌曲庫(kù)怎么加？**把下載好的 MP3+G 或 MP4 格式歌曲，放到 /home/mnt/karaoke 目錄（就是你配置里映射的歌曲庫(kù)路徑），系統(tǒng)會(huì)自動(dòng)掃描，不用手動(dòng)添加。

2. 2. **手機(jī)點(diǎn)歌怎么操作？**手機(jī)和服務(wù)器連同一局域網(wǎng)，打開(kāi)瀏覽器輸入服務(wù)器地址，登錄后選一個(gè)房間，搜索歌曲、加入隊(duì)列就行 —— 界面是響應(yīng)式的，手機(jī)上點(diǎn)起來(lái)很順手。

3. 3. **麥克風(fēng)怎么弄？**KaraokeEternal 的播放器只輸出音樂(lè)，麥克風(fēng)需要自己配（比如用藍(lán)牙麥克風(fēng)、外接麥克風(fēng)），這樣你可以根據(jù)自己的預(yù)算搭配音頻設(shè)備，靈活度很高。

4. 4. **遇到問(wèn)題找誰(shuí)？**官方有 Discord 社區(qū)（https://discord.com/invite/PgqVtFq），可以去里面問(wèn)問(wèn)題，也能和其他用戶交流歌曲庫(kù)資源；GitHub 上也能提 Issue，作者響應(yīng)挺及時(shí)的。

如果你需要一款 “無(wú)廣告、可控性強(qiáng)、部署簡(jiǎn)單” 的 KTV 工具，不管是家庭聚會(huì)、朋友派對(duì)，還是小社團(tuán)活動(dòng)，KaraokeEternal 都很合適 —— 它沒(méi)有復(fù)雜的設(shè)置，開(kāi)源免費(fèi)，還能自己管歌曲庫(kù)，完全不用被付費(fèi)軟件 “綁架”。