SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor · Aggiornato 2026-10-28

Come creare uno streaming musicale self-hosted su VPS

Installa Navidrome su un VPS e ascolta la tua libreria da ogni telefono. Guida a spazio, client Subsonic, sincronizzazione offline, TLS e backup sicuri.

Cosa offre lo streaming musicale self-hosted su un VPS

Lo streaming musicale self-hosted su un VPS significa gestire il player e fornire la musica. Il server conserva i file che già possiedi e qualsiasi telefono può raggiungerlo tramite Internet con un normale accesso. Prima di iniziare, valuta con chiarezza il compromesso: questa soluzione sostituisce il player di un servizio di streaming, non il relativo catalogo. Nella libreria non compare nulla di nuovo finché non acquisti o estrai la musica e non copi il file sul server.

L'audio richiede molte meno risorse rispetto al video. I file sono piccoli, i telefoni decodificano tutti i formati comuni senza assistenza e un ascoltatore usa meno banda rispetto a una videochiamata. La CPU non è un problema in questo caso. Il vero limite è lo spazio su disco. Gli altri due fattori che determinano il funzionamento della soluzione sono la qualità dei tag e la possibilità per l'app del telefono di scaricare la musica per l'uso offline.

Quale server musicale: Navidrome, Jellyfin o Funkwhale?

Navidrome è la scelta predefinita quando interessa soltanto l'audio. È un singolo binario Go eseguito in un singolo container e conserva il proprio stato in un unico database SQLite. Espone la Subsonic API, motivo per cui esiste una vasta famiglia di app per telefoni di terze parti. La versione 0.64.2, rilasciata il 24 settembre 2026, era ancora la release corrente il 2026-10-27. Non eseguire versioni precedenti alla 0.64.1, che ha corretto cinque avvisi di sicurezza, tra cui il tentativo illimitato di indovinare la password per l'accesso Subsonic. Il progetto dichiara che funziona bene su hardware con risorse limitate, come un Raspberry Pi, quindi il software server non è la voce per cui dovrai pagare.

Jellyfin è una scelta utile se esegui già Jellyfin come server multimediale su un VPS per i video. La libreria musicale funziona e Finamp è un'app musicale Jellyfin gratuita per Android e iOS che scarica i brani per l'ascolto offline. Jellyfin non include ancora un endpoint Subsonic, ma un plugin della community ne aggiunge uno. Subfin-NG, un fork del plugin Subfin, "consente alle app musicali compatibili con Subsonic di riprodurre la libreria musicale Jellyfin" aggiungendo a Jellyfin un'API OpenSubsonic. Richiede Jellyfin 12.0 o versioni successive, requisito fissato dalla release v12.1.13.0 il 16 ottobre 2026, quando ha aggiunto il supporto per Jellyfin 12.0. Cambia inoltre rapidamente: tra il 24 e il 28 settembre 2026 sono state pubblicate almeno sette release. Le app Subsonic possono quindi raggiungere anche Jellyfin, tramite un plugin di terze parti anziché una funzionalità del core, e conviene testare il client scelto prima di farvi affidamento. Il bridge funziona anche nella direzione opposta: Navidrome 0.64.0 ha aggiunto un'API Jellyfin sperimentale, disabilitata per impostazione predefinita e attivabile con ND_JELLYFIN_ENABLED, che secondo la documentazione è testata con Finamp, Jellify e Feishin.

Funkwhale è l'opzione federata e la versione 2.0 è stata rilasciata a marzo 2026. Un server Funkwhale è chiamato pod, i pod federano tramite ActivityPub (il protocollo alla base di Mastodon) e gli utenti seguono le playlist degli altri utenti tra pod diversi. La versione 2.0 ha sostituito le vecchie librerie con le playlist, trasformando i follow delle librerie in follow delle playlist; inoltre, un pod 2.0 non federa con pod che eseguono ancora la versione 1.x. Espone anche una parte della Subsonic API, con una differenza importante: ogni utente imposta una password Subsonic separata nelle proprie impostazioni, perché il protocollo Subsonic prevede una password che il server possa leggere. Funkwhale richiede un'installazione più complessa, perché accanto all'app web servono PostgreSQL e una coda di task.

Scegli Navidrome, a meno che tu non voglia la federazione o Jellyfin sia già in esecuzione. Il resto di questa guida configura Navidrome con Docker.

Perché l’API Subsonic determina quale app usare sul telefono

Subsonic era un server musicale la cui API HTTP è diventata il linguaggio comune per l’audio self-hosted, mentre OpenSubsonic è il progetto della community che continua a estenderla. Per questo sul telefono sono disponibili diverse opzioni. Navidrome non distribuisce una propria app mobile e non ne ha bisogno, perché qualsiasi client Subsonic accede usando l’indirizzo del server e le credenziali dell’account.

Questo è particolarmente importante per la sincronizzazione offline, la funzione che determina se la configurazione è adatta all’uso quotidiano. Un telefono in una galleria non può raggiungere il server, quindi il client deve aver copiato in anticipo i file nello spazio di archiviazione locale. Tutti i client eseguono lo streaming. Solo alcuni scaricano i file. La directory dei client all’indirizzo navidrome.org/apps indica quali lo supportano; la scelta è ampia su entrambe le piattaforme: Substreamer e Ultrasonic su Android, Amperfy e play:Sub su iOS. Alcuni dei client più completi sono app a pagamento e, su Android, Symfonium è quello citato più spesso. Installane due prima di decidere, perché questa è la parte del sistema con cui interagisci ogni giorno.

Di quanto spazio di archiviazione ha bisogno una libreria musicale?

GraficoStorage per 1,000 albums by audio format
I dati alla base di questo grafico
[
  {
    "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"
  }
]

Queste sono stime dell’ordine di grandezza ricavate dal bitrate, non misurazioni di una raccolta reale. Il calcolo è abbastanza semplice da poter essere verificato sui propri file. Considera un album di 45 minuti, cioè 2.700 secondi. Moltiplica il bitrate espresso in kilobit al secondo per 2.700, quindi dividi per 8.000 per ottenere i megabyte. A 320 kbps si ottengono 108 MB per album, quindi mille album occupano circa 108 GB.

Il formato lossless cambia il risultato. Un FLAC con qualità CD raggiunge in media circa 900 kbps con materiale ordinario, quindi gli stessi mille album richiedono circa 304 GB. Una libreria a 24 bit e 96 kHz arriva a circa 1,013 GB, cioè un terabyte per una raccolta che potresti elencare su carta. Una copia Opus ottimizzata per gli smartphone a 128 kbps contiene gli stessi mille album in 43 GB. Esegui du -sh /path/to/music sulla libreria che hai già, perché il tuo bitrate medio è l’unico dato rilevante quando scegli un piano.

La larghezza di banda rappresenta la parte minore del costo complessivo. Uno stream a 320 kbps trasferisce 40 kilobyte al secondo, quindi un’ora di ascolto genera circa 144 MB di traffico. Cento ore al mese corrispondono a circa 14 GB, una quantità che non incide sul limite di trasferimento di una VPS. L’eccezione è la prima sincronizzazione offline di un telefono, che in una sola sera può trasferire decine di gigabyte.

Livello di storage o livello di calcolo?

Un music server contiene una grande quantità di dati freddi e richiede pochissima potenza di calcolo. La lettura di un file a 40 kilobyte al secondo lascia inattivo qualsiasi disco, mentre la CPU svolge un lavoro significativo soltanto durante la scansione della libreria, la transcodifica, che nella maggior parte dei casi non userai, e l'estrazione e la memorizzazione nella cache delle copertine, durante la scansione o la prima apertura di un elemento. In questo caso, quindi, il veloce storage NVMe incluso in un piano di calcolo non offre alcun vantaggio, mentre il suo costo per gigabyte è proprio ciò che impedisce di caricare le copie FLAC. È il caso in cui un VPS di storage è migliore di un VPS standard, perché questi piani hanno un prezzo basato sul terabyte anziché sul numero di core.

La memoria richiesta è contenuta. Navidrome serve una libreria personale con poche centinaia di megabyte e la scansione rappresenta il picco di utilizzo, non la riproduzione. Assegna al server 1 GB o 2 GB di RAM e destina il resto del budget allo storage.

Installare Navidrome con Docker Compose

Creare prima le directory e assegnarle all’ID utente con cui verrà eseguito il container. Se Compose è una novità, Docker Compose su un VPS illustra le ipotesi alla base di questo file.

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

Scrivere docker-compose.yml senza aggiungere quasi nient’altro, nella sua directory:

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 dovrebbe mostrare il servizio in esecuzione, non in riavvio continuo. Un container che entra in un ciclo di riavvio ha quasi sempre un problema di permessi su /srv/navidrome, mentre docker compose logs navidrome indica il file che non è stato possibile scrivere.

Nel file ci sono quattro dettagli che meritano una spiegazione. La porta è pubblicata solo su 127.0.0.1, quindi il server è raggiungibile tramite il reverse proxy e non sulla porta 4533 da Internet. Docker scrive le proprie regole firewall, quindi un semplice 4533:4533 resta esposto anche su un sistema in cui ufw indica che tutto è negato. Il volume della musica è in sola lettura: un bug dello scanner non può quindi eliminare l’unica copia dei file. ND_SCANNER_SCHEDULE è disabilitato per impostazione predefinita. Nelle guide scritte prima di Navidrome 0.55 viene chiamato ND_SCANSCHEDULE, il nome precedente rinominato nella versione 0.55. Le tre impostazioni di backup attivano il backup integrato del database, utilizzato nella sezione sui backup riportata di seguito.

Trasferisci la musica sul server

Copia la libreria con rsync, che riprende il trasferimento dal punto in cui si è interrotto invece di ricominciare da capo quando la connessione cade.

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

La barra finale nel percorso di origine è importante. Senza di essa ottieni /srv/music/Music. Al termine della copia, correggi la proprietà:

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

Il container viene eseguito con l'ID utente 1000 e il mount è in sola lettura. Questo ID deve quindi avere accesso in lettura a ogni file e permesso di attraversamento su ogni directory. Se la copia viene assegnata a un altro account con permessi che impediscono l'accesso agli altri utenti, la scansione non trova alcuna traccia, mentre l'interfaccia web resta vuota e il log mostra open /music: permission denied. Il comando chown precedente è una soluzione. Se la directory viene usata anche da altri programmi, la documentazione Docker di Navidrome suggerisce di abilitarne invece la lettura senza modificare il proprietario: sudo chmod -R a+rX /srv/music. id -u stampa il tuo ID effettivo e spiega come funzionano PUID e PGID nei container Docker illustra in dettaglio la mappatura.

Un reverse proxy e TLS per usare il telefono ovunque

Punta un record DNS A al VPS, quindi assegna a Caddy queste tre righe:

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

Caddy richiede il certificato in background non appena carica il sito, senza attendere l'accesso di un visitatore. La porta 443 deve essere aperta. Caddy abilita per impostazione predefinita due challenge ACME (automatic certificate management environment): la challenge HTTP sulla porta 80 e la challenge TLS-ALPN sulla porta 443. Ne sceglie una casualmente, invece di iniziare sempre con HTTP. Dopo un errore riprova una volta e poi passa all'altra challenge, quindi la chiusura della porta 80 non impedisce di ottenere il certificato. Lascia comunque aperta la porta 80, perché il redirect automatico da HTTP a HTTPS di Caddy viene servito su quella porta. Su nginx, aggiungi proxy_buffering off; al blocco location: Navidrome invia gli eventi di avanzamento all'interfaccia web tramite una connessione persistente e, con il buffering attivo, l'interfaccia rimane in attesa di una risposta che nginx sta ancora trattenendo. Se lo pubblichi sotto un percorso come /music invece che su un sottodominio dedicato, imposta ND_BASEURL sullo stesso percorso; altrimenti l'interfaccia viene caricata come una pagina vuota. I tre proxy più comuni sono confrontati in Nginx, Caddy e Traefik su un VPS.

Apri il sito e crea il primo account. Non esiste una password predefinita e al primo visitatore viene chiesto di creare l'utente amministratore, quindi esegui questa operazione prima di comunicare l'indirizzo a chiunque. Poi testa il percorso esatto utilizzato dal client del telefono:

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"

Una risposta corretta inizia con {"subsonic-response":{"status":"ok" e indica navidrome come tipo di server. Un corpo che contiene "status":"failed" e il codice di errore 40 significa che il proxy funziona e che le credenziali sono errate. Un errore del certificato in questa fase è il primo problema da correggere, perché la maggior parte dei client per telefoni rifiuta un certificato non valido mostrando all'utente un messaggio privo di informazioni utili.

Perché la libreria appare errata dopo la prima scansione

Navidrome organizza la musica in base ai tag e non alle directory, quindi sono i tag a determinare ciò che viene visualizzato. Una traccia senza il tag dell'artista dell'album viene catalogata in base all'artista della traccia. Per questo una compilation con un artista diverso per ogni traccia può diventare una raccolta di venti album composti da una sola traccia ciascuno. Correggete i tag nei file, non in Navidrome: MusicBrainz Picard e beets cercano l'album nel database MusicBrainz e riscrivono i tag standard.

Navidrome divide inoltre un tag con più artisti in artisti distinti. Di conseguenza, il nome di una band che contiene un separatore viene suddiviso per errore; AC/DC è l'esempio più comune. ND_SCANNER_ARTISTSPLITEXCEPTIONS contiene i nomi che non devono mai essere suddivisi.

I nuovi file vengono rilevati da un file watcher pochi secondi dopo la loro aggiunta. Il watcher dipende dalle notifiche delle modifiche del kernel, che non vengono generate per i file scritti su una condivisione di rete montata da un altro computer. In questo tipo di configurazione, quindi, è la scansione periodica ND_SCANNER_SCHEDULE a mantenere aggiornata la libreria. Una scansione completa legge i tag di ogni file, quindi può essere lenta in una libreria di grandi dimensioni. Questo è uno dei motivi per cui conviene proteggere il database descritto di seguito.

Utenti, playlist e condivisione

L'amministratore crea gli altri account nell'interfaccia web; non è prevista l'autoregistrazione. Ogni utente dispone di conteggi degli ascolti, playlist, preferiti e valutazioni separati. In questo modo gli utenti della stessa famiglia non condividono un unico profilo dei gusti.

Le playlist possono arrivare da due origini. Una playlist creata in un client viene memorizzata nel database. Un file .m3u copiato nella directory della libreria viene importato durante la scansione. Questo è il modo più semplice per trasferire le playlist da un player desktop. Le playlist intelligenti sono file .nsp, piccoli file JSON che definiscono le regole e vengono importati nello stesso modo. Si aggiornano automaticamente quando cambia la libreria.

La condivisione è attiva per impostazione predefinita dalla versione 0.63.0, rilasciata a luglio 2026. Consente a un utente di creare un link pubblico a un album, che chiunque può aprire senza autenticarsi. Su un server che contiene l'intera libreria, questo comportamento potrebbe non essere desiderato. Impostare ND_ENABLESHARING su false lo disattiva.

Eseguire il backup del database separatamente dai file musicali

Il backup integrato di Navidrome copre solo il database. La documentazione è esplicita: il processo esegue il backup del database, quindi di utenti, conteggi degli ascolti e degli altri dati, ma non esegue il backup della musica né della configurazione. È corretto considerare separatamente questi due componenti, perché possono andare persi per motivi diversi. I file musicali possono essere copiati di nuovo dal disco da cui sono stati acquisiti. I conteggi degli ascolti, le valutazioni, i preferiti e le playlist non esistono altrove e una nuova scansione non li ripristina.

Il file compose crea già una copia notturna in /data/backup e ne conserva sette. Eseguire manualmente una copia prima di un aggiornamento:

sudo docker compose run --rm navidrome backup create

Il passaggio dalla versione 0.63 alla 0.64 è l'aggiornamento per cui questa precauzione è più importante. La versione 0.64.0 ricodifica ogni ID interno durante una migrazione che interessa tutte le tabelle; i client che conservano download offline potrebbero dover eseguire nuovamente la sincronizzazione.

Il ripristino cancella il database corrente e copia il backup al suo posto. Deve essere eseguito mentre Navidrome è arrestato. Un ripristino non è sicuro su un server in esecuzione.

Questi file si trovano ancora sullo stesso VPS, quindi non sopravvivono a un guasto del VPS. Trasferire /srv/navidrome a un'altra macchina o a uno storage a oggetti secondo una pianificazione. È il caso d'uso per cui sono progettati restic e BorgBackup. L'intera directory è piccola, in genere molto al di sotto di un gigabyte. Una copia giornaliera crittografata al di fuori del server ha quindi un costo trascurabile e consente di recuperare tutti i dati che una nuova scansione non può ripristinare.

FAQ

È necessario transcodificare la musica su un VPS?

Quasi mai. I telefoni decodificano autonomamente MP3, AAC, Opus e FLAC. Lo stesso vale per i browser attuali sulla maggior parte dei sistemi. Il server invia quindi il file nel formato originale e utilizza una quantità di CPU quasi nulla. Il controllo principale va fatto sui browser: Firefox riproduce AAC solo quando il sistema operativo o una libreria esterna fornisce il decodificatore. Di conseguenza, un lettore web con una libreria AAC può richiedere uno stream transcodificato. Il caso in cui vale maggiormente la pena abilitarla è una libreria FLAC riprodotta tramite rete mobile. La conversione da circa 900 kbps a Opus a 128 kbps riduce il traffico dati utilizzato di circa sette volte. Navidrome gestisce la transcodifica sul server dalla versione 0.61: rileva i codec supportati dal client, applica valori predefiniti del bitrate in base al formato e consente di limitare il bitrate per ciascun player.

Perché l'app del telefono non riesce a scaricare la musica per l'ascolto offline?

Perché la memorizzazione offline è una funzione del client, non del server. L'API Subsonic consente a qualsiasi client di scaricare un file completo, ma è l'app a decidere se conservarne una copia sul telefono. Controlla la directory dei client all'indirizzo navidrome.org/apps e scegline uno la cui descrizione menzioni i download offline o la memorizzazione nella cache. Alcuni client memorizzano nella cache soltanto i contenuti già riprodotti. Questo non equivale a sincronizzare un album prima di un viaggio.

Perché dopo la scansione un album è stato suddiviso in più album?

Il tag dell'artista dell'album manca oppure non è coerente tra le tracce. Navidrome raggruppa i brani in base ai tag, non alle directory. Di conseguenza, dodici tracce con dodici valori diversi per l'artista e senza un valore comune per l'artista dell'album vengono interpretate come dodici album. Imposta il tag dell'artista dell'album su ogni traccia dell'album, in genere su Various Artists per una compilation, quindi avvia una nuova scansione. MusicBrainz Picard o beets possono eseguire questa operazione contemporaneamente su un'intera directory.

Lo streaming musicale self-hosted sostituisce Spotify?

Sostituisce il player e la libreria, non il catalogo. Hai la tua raccolta su ogni dispositivo, con le playlist e i conteggi degli ascolti che nessuna modifica delle licenze può sottrarti. Non ottieni le nuove uscite e non ottieni suggerimenti basati sugli ascolti di altre persone. La maggior parte delle persone che usa questa soluzione acquista la propria musica e mantiene un account streaming economico per scoprire nuovi contenuti.

Questo articolo ti è stato utile?

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