SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor · 已更新 2026-10-28

如何在 VPS 上自架 Navidrome 音樂串流

學會在 VPS 執行 Navidrome,從儲存空間估算、Subsonic 用戶端與離線同步,到 TLS 設定及安全備份,隨時串流自己的音樂庫。

在 VPS 上自架音樂串流能提供什麼

在 VPS 上自架音樂串流,表示由你執行播放器並提供音樂。伺服器會保存你已擁有的檔案,任何手機都能透過網際網路使用一般登入方式存取。開始前請先確認這項取捨:它取代的是串流服務的播放器,不是串流服務的曲庫。除非你購買或擷取音樂,再將檔案複製到伺服器,否則媒體庫不會新增任何內容。

音訊對伺服器的負擔比視訊小得多。檔案較小,手機不需額外處理即可解碼所有常見格式,而且一位聽眾使用的頻寬比視訊通話少。CPU 通常不是問題。真正的限制是磁碟空間。另一個決定這項方案能否順利運作的因素,是標籤品質;手機應用程式是否支援下載音樂供離線使用,也同樣重要。

Navidrome 是只需要音訊時的預設選擇。它是一個容器中的單一 Go binary,並將狀態儲存在單一 SQLite database。它提供 Subsonic API,因此才有大量第三方手機 app。Version 0.64.2 於 24 September 2026 released,在 2026-10-27 仍是目前的 release。不要執行早於 0.64.1 的版本,因為該版本修正了 5 個 security advisories,其中包括可針對 Subsonic login 進行且沒有速率限制的密碼猜測。專案說明它能在 Raspberry Pi 等資源有限的硬體上良好運作,因此你需要付費的部分不會是伺服器軟體。

Jellyfin 適合已經使用 Jellyfin 作為 VPS 上的媒體伺服器處理影片的情況。它的音樂 library 可以正常運作,而 Finamp 是適用於 Android 和 iOS 的免費 Jellyfin 音樂 app,可下載曲目以供離線聆聽。Jellyfin 本身仍沒有內建 Subsonic endpoint,但社群 plugin 可加入此功能。Subfin-NG 是 Subfin plugin 的 fork,會在 Jellyfin 中加入 OpenSubsonic API,讓「與 Subsonic 相容的音樂 app 播放你的 Jellyfin music library」。它要求 Jellyfin 12.0 或更新版本;release v12.1.13.0 於 16 October 2026 加入 Jellyfin 12.0 支援,因此確立了這項最低版本要求。它的變更速度也很快:24 至 28 September 2026 之間至少發布了 7 個 release。因此,Subsonic app 也能透過第三方 plugin 連線到 Jellyfin,但這不是核心功能,正式依賴前應先用選定的 client 進行測試。這個 bridge 也能反向運作:Navidrome 0.64.0 加入實驗性的 Jellyfin API,預設關閉,需使用 ND_JELLYFIN_ENABLED 開啟;文件表示該功能已使用 Finamp、Jellify 和 Feishin 進行測試。

Funkwhale 是 federated 選項,version 2.0 於 March 2026 released。Funkwhale server 稱為 pod,pod 透過 ActivityPub(Mastodon 背後使用的 protocol)進行 federation,使用者可以跨 pod 追蹤彼此的 playlist。Version 2.0 以 playlist 取代舊的 library,因此 library follow 會變成 playlist follow;而執行 2.0 的 pod 無法與仍執行 1.x 的 pod federation。它也提供部分 Subsonic API,但有一項值得注意的差異:每位使用者都要在自己的設定中設定獨立的 Subsonic password,因為 Subsonic protocol 預期 server 能讀回 password。Funkwhale 的安裝較複雜,因為 web app 之外還需要 PostgreSQL 和 task queue。

除非你需要 federation,或已經在執行 Jellyfin,否則請選擇 Navidrome。本指南其餘內容會使用 Docker 設定 Navidrome。

Subsonic API 如何決定你使用哪個手機 App

Subsonic 是一套音樂伺服器,其 HTTP API 後來成為自架音訊服務的通用介面;OpenSubsonic 則是持續擴充這套介面的社群專案。這段歷史造就了多種手機 App 可供選擇。Navidrome 不提供自有的行動 App,也不需要提供,因為任何 Subsonic 用戶端都能使用伺服器位址與帳號資訊登入。

這對離線同步尤其重要,因為這項功能會決定整套服務能否適合日常使用。手機進入隧道後無法連線到伺服器,因此用戶端必須事先將檔案複製到本機儲存空間。每個用戶端都能串流,但只有部分用戶端支援下載。位於 navidrome.org/apps 的用戶端目錄會說明哪些用戶端支援下載;兩個平台都有多種選擇:Android 上有 Substreamer 和 Ultrasonic,iOS 上有 Amperfy 和 play:Sub。多個功能最完整的用戶端都是付費 App,而 Android 上最常被提到的是 Symfonium。請先安裝兩個再做決定,因為這是你每天都會直接使用的系統部分。

音樂資料庫需要多少儲存空間?

圖表Storage per 1,000 albums by audio format
此圖表背後的資料
[
  {
    "label": "Opus 128k",
    "kbps": 128,
    "gb_per_1000_albums": 43
  },
  {
    "label": "MP3 320k",
    "kbps": 320,
    "gb_per_1000_albums": 108
  },
  {
    "label": "FLAC 16/44.1",
    "kbps": 900,
    "gb_per_1000_albums": 304
  },
  {
    "label": "FLAC 24/96",
    "kbps": "3,000",
    "gb_per_1000_albums": "1,013"
  }
]

這些是根據位元率推算出的數量級,而不是實際收藏的測量值。計算方式很簡單,可以用自己的檔案驗算。將一張專輯視為 45 分鐘,也就是 2,700 秒。將每秒千位元的位元率乘以 2,700,再除以 8,000,即可得到 MB。在 320 kbps 下,一張專輯約為 108 MB,因此 1,000 張專輯約為 108 GB。

無損格式會改變結果。一般音訊素材的 CD 品質 FLAC 平均接近 900 kbps,因此同樣的 1,000 張專輯約需 304 GB。24 bit、96 kHz 的資料庫約需 1,013 GB;對一個可以列在紙上的收藏來說,這已經是完整的 1 TB。適合手機的 128 kbps Opus 副本,則能將同樣的 1,000 張專輯壓縮在 43 GB 內。對現有的資料庫執行 du -sh /path/to/music,因為規劃方案時,真正重要的只有你自己的平均位元率。

頻寬只占總成本較小的一部分。320 kbps 的串流每秒傳輸 40 KB,因此聆聽 1 小時約會傳輸 144 MB。每月聆聽 100 小時約為 14 GB,這通常不會讓 VPS 的流量額度感到負擔。例外是手機首次進行離線同步,單一晚間就可能傳輸數十 GB。

儲存層還是運算層?

音樂伺服器大多是冷資料,幾乎不需要額外運算。以每秒 40 kilobytes 讀取檔案時,任何磁碟都處於閒置狀態。CPU 真正需要處理工作時,通常只有掃描媒體庫、轉碼,以及擷取並快取封面圖片的期間。後兩項主要發生在掃描時,或使用者首次開啟項目時;而你大多不會進行轉碼。因此,運算方案提供的高速 NVMe 在這裡沒有實際效益。每 gigabyte 的價格反而會限制你上傳 FLAC 副本。這正是儲存型 VPS 優於一般 VPS的情況,因為這類方案是依 terabyte 而非依核心計價。

記憶體需求不高。Navidrome 只需幾百 megabytes 就能提供個人媒體庫服務,掃描時的需求峰值高於播放期間。配置 1 GB 或 2 GB RAM,將其餘預算投入磁碟空間。

使用 Docker Compose 安裝 Navidrome

先建立目錄,並將擁有者設為容器執行時使用的 user id。如果你不熟悉 Compose,VPS 上的 Docker Compose 說明了此檔案所假設的設定。

sudo install -d -m 755 -o 1000 -g 1000 /srv/navidrome /srv/music

在自己的目錄中建立 docker-compose.yml,不要加入其他內容:

services:
  navidrome:
    image: deluan/navidrome:0.64.2
    user: "1000:1000"
    ports:
      - "127.0.0.1:4533:4533"
    restart: unless-stopped
    environment:
      ND_LOGLEVEL: "info"
      ND_SESSIONTIMEOUT: "24h"
      ND_SCANNER_SCHEDULE: "@every 24h"
      ND_BACKUP_PATH: "/data/backup"
      ND_BACKUP_SCHEDULE: "0 4 * * *"
      ND_BACKUP_COUNT: "7"
    volumes:
      - /srv/navidrome:/data
      - /srv/music:/music:ro
docker compose up -d
docker compose ps

docker compose ps 應顯示服務正在執行,而不是持續重新啟動。容器若不斷進入重新啟動迴圈,幾乎總是因為 /srv/navidrome 的權限問題,而 docker compose logs navidrome 會指出無法寫入的檔案名稱。

此檔案中有 4 個細節值得說明。連接埠只發布到 127.0.0.1,因此伺服器會透過反向代理提供存取,而不會在公開網際網路上開放 4533 連接埠:Docker 會自行寫入防火牆規則,因此即使在 ufw 報告所有連線都遭拒絕的主機上,單純使用 4533:4533 仍會讓連接埠保持暴露。音樂磁碟區設為唯讀,因此即使掃描器發生錯誤,也無法刪除唯一的音樂副本。ND_SCANNER_SCHEDULE 預設停用;在 Navidrome 0.55 之前撰寫的指南會將它稱為 ND_SCANSCHEDULE,這是 0.55 改用前的舊名稱。最後 3 個備份設定會啟用內建資料庫備份,下一節的備份流程會依賴這項功能。

將音樂複製到伺服器

使用 rsync 複製音樂庫。連線中斷時,rsync 會從中斷處繼續,而不會重新開始。

rsync -av --info=progress2 ~/Music/ user@music.example.com:/srv/music/

來源路徑結尾的斜線很重要。省略斜線會得到 /srv/music/Music。複製完成後,修正擁有者:

sudo chown -R 1000:1000 /srv/music
id -u

容器會以使用者 ID 1000 執行,且掛載內容為唯讀。因此,該 ID 必須具備每個檔案的讀取權限,以及每個目錄的目錄遍歷權限。如果複製後的檔案由其他帳號擁有,且權限禁止其他使用者存取,掃描就會找不到任何曲目。此時 Web 介面仍會顯示空白,日誌則會顯示 open /music: permission denied。上方的 chown 是其中一種修正方式。如果該資料夾也由其他程式使用,Navidrome 的 Docker 文件建議改為開放讀取權限,而不變更擁有者:sudo chmod -R a+rX /srv/music。id -u 會列出目前使用者的實際 ID,而 Docker 容器中的 PUID 與 PGID 運作方式 會完整說明這項對應關係。

設定 reverse proxy 和 TLS,讓手機可從任何地方連線

將 DNS A record 指向 VPS,然後在 Caddy 中加入 3 行:

music.example.com {
    reverse_proxy 127.0.0.1:4533
}
sudo systemctl reload caddy

Caddy 載入 site 後就會在背景中請求 certificate,不必等到 visitor 存取。Port 443 必須開放。Caddy 預設啟用 2 種 ACME(automatic certificate management environment)challenge:port 80 的 HTTP challenge,以及 port 443 的 TLS-ALPN challenge;它會隨機選擇其中一種,不一定先使用 HTTP。一次失敗後,它會重試 1 次,然後切換到另一種 challenge,因此關閉 port 80 不會阻止取得 certificate。不過仍應開放 port 80,因為 Caddy 從 HTTP 導向 HTTPS 的 automatic redirect 會在該 port 提供服務。使用 nginx 時,請在 location block 加入 proxy_buffering off;:Navidrome 會透過單一長時間連線,將進度事件推送到 web interface;若啟用 buffering,interface 會一直等待 nginx 尚未傳送的 response。若將服務放在 /music 這類 path 下,而不是使用獨立的 subdomain,請將 ND_BASEURL 設為相同的 path,否則 interface 會載入空白頁面。3 種常見 proxy 的比較請參閱 VPS 上的 Nginx、Caddy 與 Traefik。

開啟 site 並建立第一個 account。系統沒有預設 password,第一位 visitor 會被要求建立 admin user,因此應在提供 address 給任何人之前完成此操作。接著測試手機 client 實際使用的 path:

SALT=$(openssl rand -hex 6)
TOKEN=$(printf '%s%s' 'YOUR_PASSWORD' "$SALT" | md5sum | cut -d' ' -f1)
curl -s "https://music.example.com/rest/ping.view?u=YOUR_USER&t=$TOKEN&s=$SALT&v=1.16.1&c=curl&f=json"

正常回應會以 {"subsonic-response":{"status":"ok" 開頭,並將 navidrome 列為 server type。若 body 包含 "status":"failed" 和 error code 40,表示 proxy 正常,但 credentials 錯誤。此時若出現 certificate error,應優先修正,因為大多數手機 client 會拒絕錯誤的 certificate,且顯示給使用者的訊息通常無法指出原因。

首次掃描後媒體庫顯示不正確的原因

Navidrome 會依標籤而不是資料夾瀏覽,因此標籤決定你看到的內容。沒有專輯演出者標籤的曲目會歸到該曲目的演出者底下。這就是為什麼每首曲目由不同演出者演出的合輯,會變成 20 張各自只有 1 首曲目的專輯。請直接在檔案中修正標籤,不要在 Navidrome 中處理:MusicBrainz Picard 和 beets 都會在 MusicBrainz 資料庫中查詢專輯,並將標準標籤寫回檔案。

Navidrome 也會將包含多位演出者的標籤拆成個別演出者。因此,名稱包含分隔符號的樂團可能會被錯誤拆分,AC/DC 就是最常見的例子。ND_SCANNER_ARTISTSPLITEXCEPTIONS 放置絕對不可拆分的名稱。

新檔案寫入後幾秒,檔案監控程式就會偵測到這些檔案。監控程式依賴核心的變更通知;對於從另一台機器掛載的網路共用,這些通知不會傳送到本機。因此,在這類環境中,定期執行的 ND_SCANNER_SCHEDULE 才能讓媒體庫維持最新狀態。完整重新掃描會讀取每個檔案的標籤;大型媒體庫執行速度很慢,這也是值得保護下方資料庫的原因之一。

使用者、播放清單與分享

管理員會在 Web 介面中建立其他帳號,不提供自行註冊功能。每位使用者都有獨立的播放次數、播放清單、最愛項目與評分,因此家庭成員不會共用同一份偏好設定。

播放清單有兩種來源。在用戶端建立的播放清單會儲存在資料庫中。將 .m3u 檔案放入媒體庫資料夾後,系統會在掃描期間匯入;這是從桌面播放器轉移播放清單的簡便方式。智慧型播放清單是 .nsp 檔案,也就是以相同方式匯入的小型 JSON 規則檔案,並會隨媒體庫變更自動更新。

從 0.63.0 版本起,分享功能預設啟用;該版本於 2026 年 7 月發布。使用者可以為專輯建立公開連結,任何人都能在未登入的情況下開啟。如果伺服器包含完整媒體庫,這項設定可能不符合需求;將 ND_ENABLESHARING 設為 false 即可停用分享功能。

將資料庫與音樂檔案分開備份

Navidrome 本身的備份只涵蓋資料庫。文件明確指出,備份程序會備份資料庫,也就是使用者、播放次數及其他資料,但不會備份音樂檔案或設定。這種區分方式才是正確的理解方式,因為這兩部分的故障情況不同。音樂檔案可以從存放原始檔案的磁碟再次複製。播放次數、評分、最愛項目與播放清單都沒有其他副本,重新掃描也無法還原這些資料。

compose 檔案已將每晚的副本寫入 /data/backup,並保留 7 份。升級前先手動執行一次:

sudo docker compose run --rm navidrome backup create

從 0.63 升級至 0.64 是最需要這項備份的升級。版本 0.64.0 會在遷移過程中重新編碼所有內部 ID,並修改每個資料表;保留離線下載的用戶端之後可能需要重新同步。

還原會清除目前的資料庫,並將備份複製到原本的位置;執行時必須先停止 Navidrome。在執行中的伺服器上還原並不安全。

這些檔案仍位於同一台 VPS,因此無法在 VPS 故障時保留。請定期將 /srv/navidrome 推送至另一台機器或物件儲存體,這正是 restic 與 BorgBackup 適合處理的工作。整個目錄很小,通常遠低於 1 GB,因此每天將加密副本備份到伺服器外幾乎沒有成本,卻能保留重新掃描無法還原的所有資料。

FAQ

我需要在 VPS 上轉碼音樂嗎?

幾乎不需要。手機會自行解碼 MP3、AAC、Opus 和 FLAC;目前大多數系統上的瀏覽器也可以,因此伺服器只需原樣傳送檔案,幾乎不會占用 CPU。應先檢查瀏覽器支援情況:Firefox 只有在作業系統或外部函式庫提供解碼器時才能播放 AAC,因此網頁播放器中的 AAC 音樂庫可能需要轉碼串流。最值得啟用轉碼的情況,是透過行動數據串流 FLAC 音樂庫。此時將約 900 kbps 轉為 128 kbps 的 Opus,可將資料用量降低約 7 倍。Navidrome 自 version 0.61 起支援伺服器端轉碼管理:它會偵測用戶端支援的編解碼器、套用格式感知的位元率預設值,並允許你為每個播放器設定位元率上限。

為什麼我的手機應用程式無法下載音樂供離線聆聽?

因為離線儲存是用戶端功能,不是伺服器功能。Subsonic API 允許任何用戶端擷取完整檔案,但是否在手機上保留副本,取決於應用程式。請查看 navidrome.org/apps 上的用戶端目錄,選擇說明中提到離線下載或快取功能的用戶端。有些用戶端只會快取你已播放的內容,這不同於在旅程前同步整張專輯。

為什麼掃描後,一張專輯會分成多張專輯?

因為專輯演出者標籤遺失,或各音軌的標籤內容不一致。Navidrome 依標籤而非資料夾分組,因此 12 首音軌若有 12 個不同的演出者值,且沒有共用的專輯演出者值,就會被視為 12 張專輯。請在該專輯的每首音軌上設定專輯演出者標籤;合輯通常設定為 Various Artists,然後讓 Navidrome 重新掃描。MusicBrainz Picard 或 beets 可一次處理整個資料夾。

自架音樂串流能取代 Spotify 嗎?

它能取代播放器與音樂庫,但不能取代音樂目錄。你可以在每台裝置上使用自己的收藏,播放清單與播放次數也不會因授權變更而被移除。你不會取得新發行內容,也不會取得根據其他人聆聽紀錄產生的推薦。多數自行架設這類服務的人會購買音樂,並保留便宜的串流帳戶來探索新音樂。

這篇文章對您有幫助嗎?

#navidrome#music#streaming#self-hosting#media-server