SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor

Tự host music streaming bằng Navidrome trên VPS

Chạy Navidrome trên VPS để nghe thư viện nhạc riêng trên mọi điện thoại. Tính dung lượng, chọn Subsonic client, offline sync, TLS và backup an toàn.

Tự host music streaming trên VPS mang lại gì

Tự host music streaming trên VPS nghĩa là bạn tự chạy player và cung cấp nhạc. Server lưu các file bạn đã sở hữu, và mọi điện thoại đều có thể truy cập qua Internet bằng thông tin đăng nhập thông thường. Hãy xác định rõ điểm đánh đổi trước khi bắt đầu: cách này thay thế player của một dịch vụ streaming, không thay thế catalog của dịch vụ đó. Thư viện của bạn sẽ không có thêm nội dung mới cho đến khi bạn mua hoặc rip nội dung đó, rồi copy file lên server.

Audio ít gây tải cho server hơn video rất nhiều. Các file audio nhỏ, điện thoại giải mã được mọi format phổ biến mà không cần hỗ trợ thêm, và một người nghe sử dụng ít bandwidth hơn một cuộc gọi video. CPU không phải vấn đề đáng lo ở đây. Dung lượng disk mới là giới hạn thực tế. Hai yếu tố khác quyết định việc này có hoạt động tốt hay không là chất lượng tag và việc app trên điện thoại có thể download nhạc để nghe offline hay không.

Chọn music server nào: Navidrome, Jellyfin hay Funkwhale?

Navidrome là lựa chọn mặc định nếu bạn chỉ quan tâm đến audio. Đây là một binary Go trong một container, và lưu trạng thái trong một database SQLite duy nhất. Nó cung cấp Subsonic API, nhờ đó mới có cả một hệ sinh thái lớn các app điện thoại bên thứ ba. Version 0.64.2, phát hành ngày 24 September 2026, vẫn là release hiện tại vào ngày 2026-10-27. Không chạy version cũ hơn 0.64.1. Bản này đã sửa 5 security advisory, trong đó có lỗi đoán password không bị giới hạn tốc độ đối với đăng nhập Subsonic. Dự án cho biết nó chạy tốt trên phần cứng hạn chế tài nguyên như Raspberry Pi, nên server software không phải phần khiến bạn tốn nhiều chi phí.

Jellyfin đáng dùng nếu bạn đã chạy Jellyfin làm media server trên VPS để phát video. Music library của nó hoạt động tốt, và Finamp là một app nhạc Jellyfin miễn phí cho Android và iOS, có thể tải track để nghe offline. Bản thân Jellyfin vẫn chưa có Subsonic endpoint tích hợp sẵn, nhưng một plugin cộng đồng bổ sung endpoint này. Subfin-NG, một fork của plugin Subfin, "cho phép các app nhạc tương thích với Subsonic phát music library của Jellyfin" bằng cách thêm OpenSubsonic API vào Jellyfin. Nó yêu cầu Jellyfin 12.0 trở lên. Đây là mức tối thiểu được release v12.1.13.0 đặt ra vào ngày 16 October 2026 khi bổ sung hỗ trợ Jellyfin 12.0. Plugin cũng thay đổi nhanh: có ít nhất 7 release được phát hành trong khoảng từ 24 đến 28 September 2026. Vì vậy, các app Subsonic cũng có thể truy cập Jellyfin thông qua plugin bên thứ ba thay vì tính năng lõi. Bạn nên test client đã chọn với plugin trước khi phụ thuộc vào nó. Bridge cũng hoạt động theo chiều ngược lại: Navidrome 0.64.0 đã thêm Jellyfin API thử nghiệm, mặc định tắt và bật bằng ND_JELLYFIN_ENABLED. Tài liệu của Navidrome cho biết API này đã được test với Finamp, Jellify và Feishin.

Funkwhale là lựa chọn federated, và version 2.0 được phát hành vào March 2026. Một server Funkwhale được gọi là pod. Các pod federate với nhau qua ActivityPub (protocol đứng sau Mastodon), và user có thể follow playlist của nhau giữa các pod. Version 2.0 thay thế library cũ bằng playlist, biến việc follow library thành follow playlist. Pod chạy 2.0 không federate với các pod vẫn chạy 1.x. Nó cũng cung cấp một phần Subsonic API, với một khác biệt cần biết: mỗi user đặt một password Subsonic riêng trong settings của mình, vì Subsonic protocol yêu cầu password mà server có thể đọc lại. Funkwhale cài đặt nặng hơn vì cần PostgreSQL và task queue bên cạnh web app.

Chọn Navidrome trừ khi bạn muốn federation hoặc Jellyfin đã chạy sẵn. Phần còn lại của guide này sẽ thiết lập Navidrome bằng Docker.

API Subsonic quyết định ứng dụng điện thoại bạn dùng như thế nào

Subsonic từng là một music server có HTTP API trở thành ngôn ngữ chung cho audio tự host, còn OpenSubsonic là dự án cộng đồng tiếp tục mở rộng API đó. Vì vậy điện thoại của bạn có nhiều lựa chọn. Navidrome không cung cấp mobile app riêng và cũng không cần làm vậy, vì mọi Subsonic client đều đăng nhập bằng địa chỉ server và thông tin tài khoản của bạn.

Điều này quan trọng nhất với tính năng đồng bộ offline, vì đây là tính năng quyết định hệ thống có đáp ứng được nhu cầu sử dụng hằng ngày hay không. Điện thoại trong đường hầm không thể kết nối đến server, nên client phải sao chép các file vào local storage từ trước. Client nào cũng stream được. Chỉ một số client hỗ trợ download. Danh mục client tại navidrome.org/apps cho biết client nào hỗ trợ tính năng này. Cả hai nền tảng đều có nhiều lựa chọn: Substreamer và Ultrasonic trên Android, Amperfy và play:Sub trên iOS. Một số client tốt nhất là ứng dụng trả phí, trong đó Symfonium trên Android là ứng dụng được nhắc đến thường xuyên nhất. Hãy cài thử 2 ứng dụng trước khi quyết định, vì đây là phần của hệ thống bạn sẽ sử dụng mỗi ngày.

Thư viện nhạc cần bao nhiêu dung lượng lưu trữ?

Biểu đồStorage per 1,000 albums by audio format
Dữ liệu đằng sau biểu đồ này
[
  {
    "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"
  }
]

Đây là các con số theo bậc độ lớn, được suy ra từ bitrate chứ không phải số đo của một bộ sưu tập thực tế. Phép tính đủ đơn giản để bạn đối chiếu với các file của mình. Coi một album dài 45 phút, tức 2,700 giây. Nhân bitrate tính bằng kilobit mỗi giây với 2,700, rồi chia cho 8,000 để ra megabyte. Ở mức 320 kbps, một album chiếm 108 MB, nên một nghìn album chiếm khoảng 108 GB.

Lossless cho kết quả khác. FLAC chất lượng CD thường có bitrate trung bình gần 900 kbps với các bản nhạc thông thường, nên một nghìn album như vậy cần khoảng 304 GB. Thư viện 24 bit, 96 kHz cần khoảng 1,013 GB, tức tròn một terabyte cho một bộ sưu tập mà bạn có thể liệt kê trên giấy. Bản Opus tối ưu cho điện thoại ở mức 128 kbps chứa cùng một nghìn album trong 43 GB. Chạy du -sh /path/to/music trên thư viện hiện có, vì bitrate trung bình của chính bạn là con số duy nhất cần quan tâm khi chọn gói.

Bandwidth là phần nhỏ hơn trong tổng chi phí. Một luồng 320 kbps tương đương 40 kilobyte mỗi giây, nên một giờ nghe nhạc truyền khoảng 144 MB. Một trăm giờ mỗi tháng vào khoảng 14 GB, thường không đáng kể so với hạn mức truyền dữ liệu của VPS. Ngoại lệ là lần đồng bộ offline đầu tiên trên điện thoại, có thể đẩy hàng chục gigabyte trong một buổi tối.

Tầng lưu trữ hay tầng compute?

Music server là một khối dữ liệu cold rất lớn, gần như không cần xử lý trên đó. Đọc file ở tốc độ 40 kilobyte mỗi giây khiến mọi disk gần như không hoạt động, còn CPU chỉ thực sự bận khi scan library, khi transcoding — việc mà bạn hầu như sẽ không làm — và khi trích xuất rồi cache ảnh bìa trong lúc scan hoặc lần đầu có người mở một item. Vì vậy, NVMe nhanh trên compute plan không mang lại lợi ích nào trong trường hợp này, trong khi giá trên mỗi gigabyte của nó lại khiến bạn không thể upload các bản FLAC. Đây là trường hợp storage VPS phù hợp hơn regular VPS, vì các plan này tính giá theo terabyte thay vì theo core.

Nhu cầu memory không cao. Navidrome phục vụ một library cá nhân chỉ với vài trăm megabyte, và mức dùng cao nhất xảy ra khi scan chứ không phải khi playback. Cấp cho máy 1 GB hoặc 2 GB RAM, rồi dùng phần ngân sách còn lại cho disk.

Cài đặt Navidrome bằng Docker Compose

Trước tiên, hãy tạo các thư mục và gán quyền sở hữu cho user id mà container sẽ chạy bằng. Nếu bạn chưa quen với Compose, Docker Compose trên VPS giải thích các giả định của file này.

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

Chỉ cần ghi docker-compose.yml, không thêm nội dung không cần thiết, trong thư mục riêng của nó:

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 phải hiển thị service đang chạy thay vì liên tục restart. Container restart theo vòng lặp gần như luôn là do vấn đề quyền trên /srv/navidrome, và docker compose logs navidrome cho biết tên file mà container không thể ghi.

Có 4 chi tiết trong file này cần giải thích. Port chỉ được publish trên 127.0.0.1, vì vậy server chỉ có thể truy cập thông qua reverse proxy và không mở port 4533 ra Internet. Docker tự ghi các firewall rule của nó, nên một 4533:4533 đơn thuần vẫn bị expose ngay cả trên máy chủ mà ufw báo mọi thứ đều bị deny. Volume chứa nhạc được mount ở chế độ read-only. Điều này ngăn lỗi trong scanner xóa bản sao duy nhất của bạn. ND_SCANNER_SCHEDULE mặc định bị tắt, và các hướng dẫn viết trước Navidrome 0.55 gọi nó là ND_SCANSCHEDULE, tên cũ đã được đổi trong 0.55. Ba tùy chọn backup bật tính năng backup database tích hợp mà phần backup bên dưới sử dụng.

Đưa thư viện nhạc lên server

Dùng rsync để sao chép thư viện lên server. rsync sẽ tiếp tục từ vị trí hiện tại thay vì bắt đầu lại khi kết nối bị ngắt.

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

Dấu gạch chéo ở cuối đường dẫn nguồn rất quan trọng. Nếu không có dấu này, bạn sẽ nhận được /srv/music/Music. Khi sao chép xong, sửa quyền sở hữu:

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

Container chạy dưới user id 1000 và mount ở chế độ chỉ đọc. Vì vậy, id này cần quyền đọc trên mọi file và quyền truy cập để duyệt qua mọi directory. Nếu thư mục được sao chép với quyền sở hữu thuộc account khác, đồng thời permissions chặn mọi user khác, quá trình quét sẽ tìm thấy 0 track trong khi web interface vẫn trống và log hiển thị open /music: permission denied. Lệnh chown ở trên là một cách xử lý. Nếu các chương trình khác cũng dùng thư mục này, tài liệu Docker của Navidrome đề xuất mở quyền đọc cho thư mục thay vì đổi owner: sudo chmod -R a+rX /srv/music. id -u in ra id thực của bạn, còn cách PUID và PGID hoạt động trong Docker container giải thích đầy đủ cơ chế ánh xạ này.

Reverse proxy và TLS để điện thoại hoạt động từ mọi nơi

Trỏ DNS A record đến VPS, sau đó thêm 3 dòng vào Caddy:

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

Caddy request certificate ở background ngay khi load site, không cần chờ visitor. Cổng 443 phải được mở. Mặc định, Caddy bật 2 ACME (automatic certificate management environment) challenge: HTTP challenge trên cổng 80 và TLS-ALPN challenge trên cổng 443. Nó chọn ngẫu nhiên một challenge thay vì luôn bắt đầu bằng HTTP. Sau một lần fail, nó retry một lần rồi chuyển sang challenge còn lại, nên cổng 80 bị đóng không làm certificate fail. Dù vậy, hãy để cổng 80 mở vì automatic redirect từ HTTP sang HTTPS của Caddy được phục vụ tại đó. Với nginx, thêm proxy_buffering off; vào location block: Navidrome đẩy progress event đến web interface qua một connection kéo dài. Khi bật buffering, interface sẽ chờ response mà nginx vẫn đang giữ. Nếu serve nó dưới một path như /music thay vì subdomain riêng, đặt ND_BASEURL thành cùng path đó. Nếu không, interface sẽ load thành một trang trắng. Ba proxy phổ biến được so sánh trong Nginx, Caddy và Traefik trên VPS.

Mở site và tạo account đầu tiên. Không có password mặc định. Visitor đầu tiên sẽ được yêu cầu tạo admin user, nên hãy làm việc này trước khi đưa địa chỉ cho bất kỳ ai. Sau đó test đúng path mà phone client sử dụng:

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"

Response hợp lệ bắt đầu bằng {"subsonic-response":{"status":"ok" và có navidrome là server type. Body chứa "status":"failed" cùng error code 40 nghĩa là proxy hoạt động bình thường nhưng credentials sai. Certificate error ở bước này là lỗi cần sửa trước, vì hầu hết phone client sẽ reject certificate không hợp lệ bằng một message không cho user biết nguyên nhân.

Vì sao thư viện hiển thị sai sau lần quét đầu tiên

Navidrome duyệt nhạc theo tag thay vì theo thư mục, nên tag quyết định nội dung bạn thấy. Track không có tag album artist sẽ được xếp theo track artist. Vì vậy, một album tổng hợp có artist khác nhau trên từng track sẽ bị tách thành hai mươi album, mỗi album chỉ có một track. Hãy sửa tag trong file, không sửa trong Navidrome: MusicBrainz Picard và beets đều tra album trong cơ sở dữ liệu MusicBrainz rồi ghi lại các tag chuẩn.

Navidrome cũng tách một tag chứa nhiều artist thành các artist riêng. Vì vậy, tên của một band có chứa ký tự phân tách có thể bị tách nhầm; AC/DC là ví dụ phổ biến nhất. ND_SCANNER_ARTISTSPLITEXCEPTIONS chứa những tên không bao giờ được tách.

File mới được file watcher phát hiện vài giây sau khi được thêm vào. Watcher phụ thuộc vào kernel change notification. Các notification này không được gửi cho file được ghi trên network share mount từ máy khác. Vì vậy, với kiểu triển khai này, ND_SCANNER_SCHEDULE là cơ chế giữ cho thư viện luôn được cập nhật. Full rescan đọc tag của mọi file, nên sẽ chậm với thư viện lớn. Đây là một lý do nên bảo vệ database được đề cập bên dưới.

Người dùng, playlist và chia sẻ

Quản trị viên tạo các tài khoản khác trong giao diện web; người dùng không thể tự đăng ký. Mỗi người dùng có số lượt phát, playlist, mục yêu thích và đánh giá riêng, nên các thành viên trong nhà không phải dùng chung một hồ sơ sở thích.

Playlist được thêm từ hai nguồn. Playlist tạo trong client được lưu trong database. Tệp .m3u được chép vào thư mục thư viện sẽ được import trong lúc scan. Đây là cách đơn giản để chuyển playlist từ trình phát trên desktop. Smart playlist là các tệp .nsp, tức các tệp JSON nhỏ chứa bộ quy tắc và được import theo cách tương tự. Chúng tự cập nhật khi thư viện thay đổi.

Tính năng chia sẻ được bật mặc định từ phiên bản 0.63.0, phát hành vào tháng 7 năm 2026. Tính năng này cho phép người dùng tạo public link đến một album mà bất kỳ ai cũng có thể mở mà không cần đăng nhập. Trên server chứa toàn bộ thư viện của bạn, đây có thể không phải điều bạn muốn; đặt ND_ENABLESHARING thành false sẽ tắt tính năng này.

Sao lưu database riêng với các file nhạc

Tính năng backup riêng của Navidrome chỉ sao lưu database. Tài liệu nói rất rõ: quy trình backup sao lưu database, bao gồm user, số lượt phát và các dữ liệu khác; nó không sao lưu nhạc hoặc config. Đây là cách phân tách đúng, vì hai phần này hỏng theo những cách khác nhau. Có thể copy lại các file nhạc từ disk gốc đã dùng để rip chúng. Số lượt phát, rating, mục yêu thích và playlist không tồn tại ở nơi nào khác. Rescan cũng không khôi phục được các dữ liệu đó.

File compose đã ghi một bản sao hằng đêm vào /data/backup và giữ lại 7 bản. Hãy tạo thêm một bản sao thủ công trước khi upgrade:

sudo docker compose run --rm navidrome backup create

Quá trình chuyển từ 0.63 lên 0.64 là lần upgrade cần backup nhất. Version 0.64.0 mã hóa lại mọi internal id trong một migration tác động đến mọi table. Các client giữ bản download offline có thể phải sync lại sau đó.

Restore sẽ xóa database hiện tại rồi copy bản backup vào vị trí của database đó. Phải thực hiện restore khi Navidrome đã dừng. Không có thao tác restore nào an toàn trên server đang chạy.

Các file đó vẫn nằm trên cùng VPS, nên sẽ không tồn tại nếu VPS gặp sự cố. Hãy định kỳ push /srv/navidrome sang máy khác hoặc object storage. Đây là công việc mà restic và BorgBackup được thiết kế để thực hiện. Toàn bộ directory này nhỏ, thường dưới 1 gigabyte, nên một bản sao được mã hóa mỗi ngày bên ngoài máy gần như không tốn chi phí nhưng có thể khôi phục toàn bộ dữ liệu mà rescan không thể khôi phục.

FAQ

Tôi có cần transcode nhạc trên VPS không?

Hầu như không. Điện thoại tự decode MP3, AAC, Opus và FLAC. Các trình duyệt hiện tại trên hầu hết hệ thống cũng vậy. Vì thế server chỉ gửi file nguyên trạng và gần như không dùng CPU. Cần kiểm tra ở phía trình duyệt: Firefox chỉ phát AAC khi hệ điều hành hoặc một library bên ngoài cung cấp decoder. Do đó, audio player trên web dùng thư viện AAC có thể cần stream đã được transcode. Trường hợp đáng bật transcoding nhất là khi stream thư viện FLAC qua mạng di động. Chuyển từ khoảng 900 kbps xuống Opus ở 128 kbps sẽ giảm lượng dữ liệu sử dụng khoảng 7 lần. Navidrome hỗ trợ transcoding do server quản lý từ version 0.61. Nó phát hiện các codec client hỗ trợ, áp dụng bitrate mặc định phù hợp với format và cho phép giới hạn bitrate theo từng player.

Vì sao app trên điện thoại không thể tải nhạc để nghe offline?

Vì lưu trữ offline là tính năng của client, không phải của server. Subsonic API cho phép mọi client tải toàn bộ file, nhưng app quyết định có giữ bản sao trên điện thoại hay không. Hãy kiểm tra danh mục client tại navidrome.org/apps và chọn client có mô tả đề cập đến offline download hoặc caching. Một số client chỉ cache những bài bạn đã phát. Cách này không giống với việc đồng bộ cả album trước một chuyến đi.

Vì sao một album bị tách thành nhiều album sau khi scan?

Tag album artist bị thiếu hoặc không nhất quán giữa các track. Navidrome nhóm theo tag thay vì theo folder. Vì vậy, 12 track có 12 giá trị artist khác nhau và không có giá trị album artist dùng chung sẽ bị xem như 12 album. Hãy đặt tag album artist trên mọi track trong album, thường là Various Artists đối với compilation, rồi cho Navidrome scan lại. MusicBrainz Picard hoặc beets có thể làm việc này cho toàn bộ folder cùng lúc.

Music streaming tự host có thay thế được Spotify không?

Nó thay thế player và library, không thay thế catalogue. Bạn có bộ sưu tập riêng trên mọi thiết bị, cùng playlist và play count mà không thay đổi giấy phép nào có thể lấy mất. Bạn không có các bản phát hành mới và cũng không có recommendation được xây dựng từ thói quen nghe của người khác. Hầu hết những người vận hành hệ thống này đều mua nhạc và giữ một tài khoản streaming giá rẻ để khám phá nhạc mới.

Bài viết này có hữu ích không?

#navidrome#music#streaming#tự lưu trữ#media-server