Questa guida spiega come scegliere un URL canonico, simulare l’estrazione, usare una sessione del browser che controlli, limitare il primo lotto, proteggere i lavori ripetuti con un archivio e distinguere i problemi di accesso dagli errori di configurazione.
Inizia con un URL pubblico di post, profilo o media Instagram tra virgolette e aggiungi --simulate. Se l’estrattore richiede l’autenticazione, accedi normalmente in un profilo browser che controlli e usa --cookies-from-browser. Dopo un piccolo test riuscito, aggiungi un archivio stabile e trasferisci nella configurazione solo valori verificati.
Scegli il tipo esatto di URL che vuoi controllare: un post pubblico, un profilo o una pagina media copiata dalla normale barra degli indirizzi. Evita link abbreviati, parametri di tracciamento, reindirizzamenti mobili e link ricevuti in messaggi privati finché non hai confermato la pagina canonica nel browser.
Il primo comando dovrebbe normalmente essere una simulazione. Permette di separare installazione, riconoscimento dell’URL, accesso e selezione dei file prima di scrivere i media. Racchiudi l’URL tra virgolette per evitare che la shell interpreti caratteri speciali.
gallery-dl --simulate "https://www.instagram.com/p/POST_ID/"gallery-dl --simulate "https://www.instagram.com/USERNAME/"gallery-dl -K "https://www.instagram.com/p/POST_ID/"POST_ID e USERNAME sono esempi. Usa un URL e contenuti a cui sei autorizzato ad accedere, controlla la simulazione e solo dopo rimuovi --simulate.
L’elenco upstream dei siti supportati include Instagram e mostra Cookies tra i metodi di autenticazione indicati. È un riferimento utile per pianificare, non una garanzia per ogni pagina, account, regione o variante di URL. La versione installata e l’URL preciso sono la prova operativa.
Un singolo post pubblico è il primo test più semplice. Profili, Reel, Stories e aree personalizzate possono richiedere una sessione valida e regole di accesso diverse; simula sempre l’URL esatto che utilizzerai.
Un post pubblico è il caso diagnostico più piccolo. Controlla estrattore, media selezionati, nome file e destinazione prima di provare un intero account.
Un URL di profilo può selezionare molti elementi e richiedere autenticazione. Inizia con un intervallo ristretto invece di attraversare tutto l’account.
Queste aree sono più sensibili a sessione, scadenza, privacy e cambiamenti della piattaforma. Simula l’URL preciso invece di dedurre il supporto da un’altra pagina Instagram.
| URL o obiettivo | Primo test | Nota sull’autenticazione |
|---|---|---|
| Un post pubblico | --simulate URL | Diagnostica anonima più chiara |
| Profilo o pagina media | --simulate --range 1-10 URL | Possono servire cookie del browser |
| Reel o Stories | Simula l’URL esatto | Sessione e disponibilità possono variare |
| Metadati o filtri | -K URL | Conferma i campi prima dei filtri |
Quando Instagram rifiuta una richiesta anonima, accedi normalmente in un profilo browser che controlli e verifica che il target si apra lì. Poi indica quel profilo locale a gallery-dl. Non devi incollare valori grezzi dei cookie in questo sito o in un forum pubblico.
Chiudi completamente il browser se il database dei cookie è bloccato e scegli il profilo con la sessione attiva. Sessioni scadute, controlli di attività, account privati, differenze regionali e cambiamenti nelle regole delle richieste restano cause possibili.
gallery-dl --cookies-from-browser firefox --simulate "https://www.instagram.com/USERNAME/"gallery-dl --cookies-from-browser chrome --simulate "https://www.instagram.com/USERNAME/"gallery-dl --cookies-from-browser edge --simulate "https://www.instagram.com/USERNAME/"Non pubblicare database dei cookie, percorsi dei profili, identificatori di sessione o log non ripuliti. Rimuovi nomi locali e URL privati prima di chiedere aiuto.
Dopo una simulazione riuscita, mantieni piccolo il primo lavoro reale. Usa --range per un profilo o una raccolta, scegli una cartella base prevedibile e controlla i primi percorsi. Potrai vedere video, media ripetuti o un ambito inatteso prima che aumenti lo spazio usato.
Per i lavori ricorrenti aggiungi --download-archive con un percorso locale stabile. L’archivio registra gli ID degli estrattori completati e salta gli elementi corrispondenti nelle esecuzioni successive. Previene duplicati, ma non è un backup dei media.
gallery-dl --range "1-10" --destination "D:/Media/Instagram" "https://www.instagram.com/USERNAME/"gallery-dl --range "1-25" --download-archive "instagram.sqlite3" "https://www.instagram.com/USERNAME/"gallery-dl -K --simulate "https://www.instagram.com/p/POST_ID/"| Obiettivo | Opzione | Perché conta |
|---|---|---|
| Evitare un primo lavoro grande | --range 1-10 | Rende facile controllare output e accesso |
| Scegliere una cartella radice | --destination PATH | Mantiene il lavoro in una posizione prevedibile |
| Evitare download ripetuti | --download-archive FILE | Salva gli ID completati |
| Controllare i campi dei nomi | -K URL | Mostra metadati prima dei filtri |
| Fermare sorprese della configurazione | --config-ignore | Prova senza default caricati |
Lascia i valori sperimentali nella riga di comando, dove sono visibili e facili da rimuovere. Sposta cartella base, nomi file, archivio, scelta dei cookie e tempi delle richieste in una configurazione controllata solo dopo che un comando limitato si comporta come previsto.
Un file di configurazione può influenzare ogni richiesta corrispondente. Un filtro copiato può selezionare nulla quando l’estrattore espone metadati diversi. Controlla i campi con -K, valida il JSON e confronta con --config-ignore quando il risultato cambia.
{
"extractor": {
"base-directory": "D:/Media/Instagram",
"archive": "D:/Media/Instagram/archive.sqlite3"
}
}gallery-dl --config-ignore --simulate "https://www.instagram.com/USERNAME/"gallery-dl --config-statusNon inserire cookie, password, token, URL privati o percorsi personali del browser in una configurazione pubblica. Usa segnaposto e controlla ogni opzione.
Non trattare ogni errore Instagram come un flag mancante. Confronta prima l’URL esatto nel browser normale, poi esegui una simulazione pulita ignorando la configurazione. Se la richiesta pulita funziona, controlla configurazione, filtri, archivio e profilo browser uno alla volta.
Un archivio cookie bloccato o scaduto è diverso da un limite di richieste. Un limite richiede tempo e meno ripetizioni, non un ciclo di retry paralleli. Un risultato vuoto può dipendere da URL errato, contenuto non disponibile, filtro restrittivo o elemento già presente nell’archivio.
| Sintomo | Prima verifica | Passo successivo sicuro |
|---|---|---|
| Risultato non supportato o vuoto | Copia l’URL canonico ed esegui -E o --simulate | Prova un post pubblico prima del profilo |
| Cookie richiesti | Apri il target nel profilo selezionato | Aggiorna la sessione normale e chiudi il browser |
| Attività sospetta o HTTP 429 | Ferma le ripetizioni e controlla il ritmo | Aspetta, riduci l’ambito e controlla l’upstream |
| Tutto viene saltato | Controlla il percorso dell’archivio | Usa un archivio separato solo per la diagnosi |
| La configurazione cambia il risultato | Esegui --config-ignore | Rimuovi una chiave sospetta alla volta |
gallery-dl è un downloader locale, non un sistema di autorizzazione. Scarica e riutilizza solo media a cui sei autorizzato ad accedere; rispetta privacy, copyright, regole della piattaforma, permessi dell’account e limiti delle richieste. L’accessibilità tecnica non è una licenza per ripubblicare contenuti.
Il comportamento dell’estrattore può cambiare quando Instagram cambia il sito o le regole delle richieste. Il 6 agosto 2026 questa pagina ha verificato i metadati ufficiali PyPI e i file upstream; la versione verificata è gallery-dl 1.32.9. Ricontrolla la versione quando un comando prima funzionante cambia comportamento.
L’elenco upstream corrente include Instagram e mostra Cookies tra le funzioni di autenticazione della riga. Versione installata, URL, stato dell’account, regione e comportamento della piattaforma determinano comunque il risultato: simula prima l’URL esatto.
Accedi normalmente in un profilo browser che controlli, verifica la pagina e usa --cookies-from-browser. Mantieni privati database dei cookie, identificatori di sessione, percorsi e log.
Un URL di profilo può selezionare molti elementi e richiedere autenticazione. Inizia con --simulate e un --range piccolo, controlla i percorsi e aggiungi un --download-archive stabile prima di ampliare.
Controlla URL canonico, estrattore, sessione, filtri, configurazione e archivio. Confronta il comando normale con gallery-dl --config-ignore --simulate e riaggiungi un’opzione alla volta.
Usa --download-archive con un percorso locale stabile. Registra gli ID completati e salta le corrispondenze successive; non è però un backup dei file scaricati.
Il 6 agosto 2026 sono stati verificati gallery-dl 1.32.9, i metadati ufficiali PyPI e i file upstream. Ricontrolla release ufficiale e --version installato prima di affidarti a un comportamento sensibile alla versione.
Interrompi le ripetizioni, riduci l’ambito, aspetta e verifica la sessione normale del browser. Non usare retry paralleli per aggirare una sfida; controlla release e indicazioni upstream se il comportamento continua.