開源神器 KaraokeEternal：自托管無廣告，手機點歌 + 多房間 KTV，Docker 一鍵搭！

開源神器 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

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

2. 2. **手機點歌怎么操作？**手機和服務器連同一局域網，打開瀏覽器輸入服務器地址，登錄后選一個房間，搜索歌曲、加入隊列就行 —— 界面是響應式的，手機上點起來很順手。

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

4. 4. **遇到問題找誰？**官方有 Discord 社區（https://discord.com/invite/PgqVtFq），可以去里面問問題，也能和其他用戶交流歌曲庫資源；GitHub 上也能提 Issue，作者響應挺及時的。

如果你需要一款 “無廣告、可控性強、部署簡單” 的 KTV 工具，不管是家庭聚會、朋友派對，還是小社團活動，KaraokeEternal 都很合適 —— 它沒有復雜的設置，開源免費，還能自己管歌曲庫，完全不用被付費軟件 “綁架”。