Quay lại danh sách
DevOps & Hệ thống

Xây dựng hệ thống private music streaming cao cấp với Navidrome và Subsonic client

Thiết lập một hệ thống phát nhạc riêng tư cao cấp bằng Navidrome và ứng dụng Subsonic client cho phép người dùng truy cập thư viện nhạc cá nhân một cách an toàn, hiệu quả và không...

DPTCloud Engineering4 phút đọc
Xây dựng hệ thống private music streaming cao cấp với Navidrome và Subsonic client

Thiết lập một hệ thống phát nhạc riêng tư cao cấp bằng Navidrome và ứng dụng Subsonic client cho phép người dùng truy cập thư viện nhạc cá nhân một cách an toàn, hiệu quả và không giới hạn. Với Docker, Nginx và VPS NVMe, người dùng có thể triển khai toàn bộ hệ thống trên một máy chủ ảo với chi phí thấp, bảo mật cao và khả năng mở rộng dễ dàng. Hướng dẫn này cung cấp từng bước cụ thể để cấu hình Navidrome như máy chủ phát nhạc, tích hợp với Subsonic API và thiết lập giao diện người dùng thân thiện trên thiết bị di động hoặc máy tính để bàn.

Yêu cầu và chuẩn bị môi trường

Để triển khai hệ thống phát nhạc riêng tư, bạn cần một máy chủ VPS với hệ điều hành Linux (Ubuntu 22.04 hoặc tương đương), Docker và Docker Compose đã được cài đặt. VPS NVMe là lựa chọn lý tưởng vì tốc độ đọc/ghi cao, phù hợp với việc xử lý nhiều luồng phát nhạc đồng thời. Bạn cũng cần một tên miền (hoặc IP tĩnh) để truy cập hệ thống từ xa và một chứng chỉ SSL để bảo mật kết nối. Nếu chưa có, bạn có thể đăng ký VPS NVMe tại Cloud VPS NVMe cho Docker, Nginx & Database.

Triển khai Navidrome với Docker

Navidrome là một máy chủ phát nhạc mã nguồn mở, tương thích với giao thức Subsonic, cho phép người dùng truy cập thư viện nhạc từ bất kỳ thiết bị nào. Để triển khai, tạo một file `docker-compose.yml` với nội dung sau:

version: '3.8'
services:
  navidrome:
    image: navidrome/navidrome:latest
    container_name: navidrome
    ports:
      - "4533:4533"
    volumes:
      - ./navidrome/data:/data
      - ./navidrome/config:/config
      - ./music:/music
    environment:
      ND_LOG_LEVEL: info
      ND_PORT: 4533
      ND_BASEURL: /navidrome
      ND_ADMIN_PASSWORD: your_secure_password
      ND_MUSIC_FOLDER: /music
    restart: unless-stopped

Thay đổi `your_secure_password` bằng mật khẩu quản trị mạnh. Thư mục `music` chứa thư viện nhạc của bạn, cần được gắn vào container. Sau khi tạo file, chạy lệnh:

docker-compose up -d

Navidrome sẽ khởi động và sẵn sàng truy cập tại `http://your-server-ip:4533`. Bạn có thể cấu hình giao diện người dùng, thêm tài khoản người dùng và quản lý thư viện nhạc qua trang web.

Tích hợp Subsonic client và bảo mật kết nối

Subsonic client (như Subsonic for Android hoặc Subsonic for iOS) hỗ trợ giao thức Subsonic API, tương thích với Navidrome. Trong ứng dụng, nhập địa chỉ máy chủ (`http://your-server-ip:4533/navidrome`) và mật khẩu tài khoản. Để bảo mật, sử dụng Nginx làm reverse proxy và tích hợp Let's Encrypt để tạo chứng chỉ SSL miễn phí. Tạo file cấu hình Nginx (`/etc/nginx/sites-available/navidrome`):

server {
    listen 80;
    server_name your-domain.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;

    location / {
        proxy_pass http://localhost:4533;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Chạy lệnh:

sudo nginx -t
sudo systemctl reload nginx

Để tự động cấp chứng chỉ SSL, sử dụng Certbot:

sudo certbot certonly --nginx -d your-domain.com

Quản lý thư viện nhạc và tùy chỉnh

Navidrome hỗ trợ tự động quét thư viện nhạc từ thư mục được gắn vào. Để tối ưu hiệu suất, bạn có thể cấu hình thư mục âm thanh trong file `config.json` hoặc thông qua giao diện web. Dưới đây là các tùy chọn cấu hình phổ biến:

  • Thư mục âm thanh: Thiết lập `ND_MUSIC_FOLDER` trong file `docker-compose.yml` hoặc trong giao diện quản trị.
  • Phân tích âm thanh: Navidrome tự động tạo thông tin nhạc (metadata) từ tệp âm thanh.
  • Chia sẻ thư viện: Cho phép người dùng tạo thư viện riêng hoặc chia sẻ thư viện công cộng.
  • Quản lý người dùng: Tạo tài khoản người dùng, cấp quyền truy cập và thiết lập giới hạn phát nhạc.

Xác minh và khắc phục sự cố

Sau khi cấu hình, kiểm tra hệ thống bằng cách truy cập `https://your-domain.com/navidrome`. Nếu không tải được, kiểm tra log của container Navidrome:

docker logs navidrome

Đảm bảo thư mục `music` được gắn đúng và quyền truy cập cho phép đọc. Nếu Subsonic client không kết nối, kiểm tra xem giao thức Subsonic có được bật trong Navidrome (mặc định là có) và kiểm tra cổng 4533 có bị chặn bởi tường lửa hay không. Sử dụng lệnh `sudo ufw allow 4533` để mở cổng nếu cần.

Tài nguyên và tham khảo

Để tìm hiểu thêm về Navidrome, tham khảo tài liệu chính thức tại https://navidrome.org/. Hướng dẫn cấu hình Nginx và Let's Encrypt có thể được tìm thấy trong https://certbot.eff.org/instructions. Nếu bạn cần máy chủ hiệu năng cao cho hệ thống phát nhạc, xem Dedicated Server hiệu năng cao cho cụm Production.

Tham khảo hạ tầng & bài viết liên quan: Kiếm tiền với VPS: 10 mô hình kinh doanh thực tế đang hot năm 2026

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS NVMe khuyến nghị để triển khai

SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478