01
更完整的音樂掃描
不要求音樂必須採用固定的目錄結構。
支援處理:
- 複雜目錄
- 多碟專輯
- CUE
- 不完整 Metadata
- Artist / Album Artist 不一致
- 不同音訊格式
目標很簡單:盡可能不要因為目錄或 Metadata 不夠規範,而讓音樂被遺漏。
Mossca Server
完整掃描音樂資料庫,圍繞 Album 和 Artist 組織內容,並提供 Tag 與 Metadata 輔助整理能力。
支援 Web、Mac 和 iOS 存取,適合 NAS 與大型個人音樂資料庫。
Self-hosted · Docker · NAS · Web · macOS · iOS

已經有 Navidrome,為什麼還需要 Mossca Server?
讓個人音樂資料庫更完整、更清楚,也更容易持續維護。
更強的掃描 · 更快更好的整理與瀏覽 · 更省事的輔助整理
**更強的掃描:**無論音樂檔案如何組織,都盡可能完整掃描並納入資料庫,減少遺漏。
**更快更好的整理與瀏覽:**針對大型音樂資料庫最佳化效能,圍繞 Artist 和 Album,並透過 Tag 串聯組織。
**更省事的輔助整理:**自動發現音樂資料庫來源資料的問題,並協助補齊與整理。
01
不要求音樂必須採用固定的目錄結構。
支援處理:
目標很簡單:盡可能不要因為目錄或 Metadata 不夠規範,而讓音樂被遺漏。
02
Mossca Server 按 Album · Artist 組織音樂資料庫。
Mossca 認為 Artist 和 Album 才是個人音樂收藏的核心;一張專輯本身,就是一次完整的作品表達。
03
除了 Genre、Year 等固定欄位,也可以使用 Tag 組織 Album 和 Artist。
也可以編輯與建立自己的 Tag:
Tag 可以成為比傳統固定分類更自由、更靈活的音樂資料庫組織方式。
04
Mossca Server 可以持續發現音樂資料庫中的 Metadata 問題:
缺少的內容可以提供補全建議。對於疑似錯誤的內容,Mossca Server 會優先提供修改建議,確認後才寫回整理,減少逐張專輯手動處理的繁瑣工作。
05
針對大型音樂資料庫進行最佳化,支援上萬張專輯的流暢使用:
06
同一套 Mossca Server 音樂資料庫可以透過:
Web
直接使用瀏覽器存取。
Mac / iOS
透過 Mossca 客戶端瀏覽與播放。
CarPlay
輕鬆延伸至車載聆聽情境。
區域網路 / 公網
可以在家庭網路中存取,也可以搭配自己的遠端存取方案從外部連線。
你的音樂資料庫,在不同情境間無縫延續。
07
面向個人音樂收藏的自託管部署、掃描、整理與多裝置存取能力。
部署與執行
部署方式
Docker · NAS / Home Server · Desktop Server
執行環境
Synology · QNAP · Unraid · TrueNAS · Linux · macOS with Docker · Windows Desktop
映像檔與連接埠
ghcr.io/fungansar/mossca-server:latest
預設連接埠:45331
音樂資料庫與掃描
音樂目錄
透過 /music 掛載音樂目錄,支援複雜子目錄、多層結構與大型音樂資料庫。
支援格式
FLAC · WAV · AIFF · ALAC / M4A · MP3 · AAC · DSD(DSF / DFF)· CUE
掃描能力
完整掃描 · 增量掃描 · 多碟專輯 · CUE · Album / Artist 聚合 · 背景掃描
組織與 Metadata
核心實體
Album · Artist · Track
Metadata
Title · Album · Artist · Album Artist · Track Number · Disc Number · Genre · Year / Date · Composer · Artwork
輔助整理
缺失資訊偵測、候選補全建議、疑似錯誤提示,以及人工確認後寫回。
存取與資料
客戶端
Web · macOS · iOS · CarPlay
網路存取
支援區域網路存取;公網存取可以搭配自己的網域、反向代理或內網穿透方案。
資料儲存
Server 資料儲存在 /data 對應的 Docker Volume 中;音樂檔案以唯讀方式掛載。
規格說明
部分 Metadata 輔助整理與 Tag 組織能力仍在開發中,實際可用功能以目前發布版本為準。
完整掃描,以 Album 和 Artist 為核心,用 Tag 持續組織,自動補齊 Metadata,並針對大型音樂資料庫最佳化。
這就是 Mossca Server。
Mossca Server
如果你不熟悉 Docker,請使用 NAS、Mac、Windows 或 Linux 上的 Docker / Container Manager,全程不需要使用終端機。
1. 安裝 Docker。
2. 在 Docker / Container Manager 中搜尋並下載以下映像:
ghcr.io/fungansar/mossca-server:latest3. 使用映像建立容器。設定連接埠 45331 → 45331,將音樂資料夾掛載到 /music 並設為唯讀,再將另一個資料夾掛載到 /data 儲存 Server 資料。
Your Music Folder → /music
Server Data Folder → /data
Port → 453314. 啟動容器,然後在瀏覽器開啟下方的區域網路地址。
http://SERVER_IP:453315. 開啟容器的 Logs 頁面,尋找 Pairing code 並複製配對碼。
6. 在 Mossca 中開啟 Music Server → Add Server → Mossca Server,輸入地址與配對碼。
公網存取是可選功能,在家中使用時區域網路地址已經足夠。
使用 Docker 部署。你只需要準備 Docker、一個音樂目錄,以及一台 NAS、Mac、Windows 或 Linux 裝置。
1. 建立 compose.yaml
新增一個資料夾並建立 compose.yaml。將 /path/to/Music 替換成你的音樂目錄:
services:
mossca-server:
image: ghcr.io/fungansar/mossca-server:latest
restart: unless-stopped
ports:
- "45331:45331"
volumes:
- /path/to/Music:/music:ro
- mossca-data:/data
volumes:
mossca-data:2. 啟動 Mossca Server
在該目錄執行
docker compose up -d,再使用
docker ps確認容器已經執行。
3. 取得配對碼
執行
docker compose logs mossca-server | grep "Pairing code",記錄終端機顯示的配對碼。
4. 加入 Mossca 客戶端
依序選擇 Music Server → Add Server → Mossca Server,輸入 http://伺服器IP:45331,再填入配對碼。5. 存取 Web Player
在區域網路中可以透過 http://伺服器IP:45331 開啟;若需要公網存取,可以搭配自己的網域、反向代理或內網穿透方案。
6. 更新版本
進入 compose.yaml 所在目錄,執行
docker compose pull,再執行
docker compose up -d。
常用指令
docker compose up -d # 啟動
docker compose down # 停止
docker compose logs -f # 查看日誌
docker compose pull # 取得更新音樂資料夾以唯讀方式掛載到 /music;Server 資料儲存在 Docker Volume mossca-data 中。
關閉按鈕:關閉
下一批我可以直接继续给 Deutsch + Français + Español,再下一批给 Português (Brasil) + 한국어 + Italiano + Polski + Русский,这样整页一次收完。