CoolStore può ancora essere aggiunto a CasaOS tramite la funzione Aggiungi sorgente dell'App Store usando l'attuale URL ZIP pubblicato dal repository di CoolStore. Tuttavia, è uno store di terze parti, non una sorgente curata da IceWhale, quindi prima di installare un'app esamina l'immagine, i volumi, le porte e il manutentore.
Il tutorial del forum del 2023 è ormai troppo obsoleto per essere utilizzato come unica istruzione. Il repository di CoolStore pubblica attualmente un URL della sorgente mantenuto, mentre l'ecosistema più ampio degli store di app CasaOS/ZimaOS si è orientato verso protocolli più recenti e una convalida più rigorosa.
URL attuale della sorgente CoolStore
Il repository del progetto indica attualmente:
https://casaos-appstore.paodayag.dev/coolstore.zipIl repository CasaOS CoolStore dovrebbe essere considerato la fonte autorevole, invece di un link abbreviato proveniente da un vecchio tutorial.
Come aggiungere CoolStore a CasaOS
- Apri il pannello di CasaOS.
- Apri l'App Store.
- Seleziona Aggiungi sorgente.
- Incolla l'attuale URL ZIP di CoolStore.
- Attendi l'aggiornamento della sorgente.
- Verifica che le applicazioni CoolStore siano visualizzate prima di installare qualsiasi elemento.
Se Aggiungi sorgente segnala il successo ma non appare alcuna app
Aggiorna la pagina dell'App Store e verifica che la sorgente sia ancora registrata. CasaOS ha riscontrato problemi di compatibilità con gli store di terze parti quando sono cambiati i formati delle sorgenti o le radici degli store, quindi un messaggio di conferma non dimostra sempre che lo store sia stato analizzato correttamente.
Non considerare le app degli store di terze parti come app ufficiali di CasaOS
Uno store della community può distribuire software eccellente, ma il manifest dell'app potrebbe essere gestito da una persona diversa dallo sviluppatore dell'applicazione originale. Prima dell'installazione, controlla:
- origine dell'immagine Docker;
- strategia per versione e tag;
- mappature dei volumi sui percorsi dell'host;
- modalità privilegiata o accesso ai dispositivi;
- porte pubblicate;
- cronologia degli aggiornamenti.
Per le app critiche, preferisci la documentazione Docker originale
Se stai installando un database, un reverse proxy, un gestore di password o un altro servizio importante, confronta il manifest di CoolStore con la documentazione Docker attuale del progetto originale. I pacchetti di terze parti possono essere in ritardo rispetto a importanti modifiche del progetto originale.
Comprendere la nuova direzione degli App Store
La documentazione attuale per gli sviluppatori dell'App Store di IceWhale definisce ora un nuovo protocollo v2 per gli store, con store.json, index.json, file Compose per ogni app, metadati e risorse generati. Gli store ZIP legacy possono ancora esistere per compatibilità, ma non sono più l'unico formato disponibile.
L'attuale documentazione per gli sviluppatori dell'App Store illustra la nuova architettura degli store.
Rimuovere una sorgente dello store senza eliminare i dati delle app
La rimozione di una sorgente dello store deve essere considerata separatamente dalla disinstallazione delle app installate tramite essa. Un container già in esecuzione non scompare automaticamente solo perché la sorgente del catalogo viene rimossa.
Esegui il backup dei dati importanti delle app prima di disinstallare un'applicazione distribuita dalla community.
Quando è meglio usare Docker manualmente
Se un'app di CoolStore è obsoleta o richiede autorizzazioni rischiose, installa manualmente invece la definizione Compose del progetto originale. In questo modo è più facile verificare tag delle immagini, volumi, reti e segreti.
La guida Docker personalizzata offre lo stesso approccio di distribuzione trasparente.
Esegui il backup dell'app prima di cambiare i pacchetti dello store
Se hai già installato un'app da CoolStore e vuoi sostituirla con la versione di un altro store, non presumere che entrambi i manifest utilizzino gli stessi percorsi dell'host, le stesse variabili d'ambiente o gli stessi nomi dei container. Esporta o salva prima i dati persistenti dell'app, quindi confronta le due definizioni Compose prima di disinstallare qualsiasi elemento.
Come valutare lo stato di un elemento dello store
Controlla se l'immagine Docker sottostante riceve ancora aggiornamenti, se il manifest dello store fissa una versione ragionevole e se gli utenti recenti segnalano installazioni riuscite. Uno store può rimanere raggiungibile mentre un singolo pacchetto è diventato silenziosamente obsoleto.
Per i servizi sensibili alla sicurezza, verifica inoltre che il manifest non richieda la modalità privilegiata, il networking dell'host, dispositivi non elaborati o mount estesi del filesystem senza una motivazione chiara.
Domande frequenti
CoolStore è uno store ufficiale di CasaOS?
No. È uno store della community di terze parti.
Quale URL devo usare?
Usa l'attuale URL ZIP pubblicato nel repository GitHub di CoolStore invece di un vecchio link abbreviato.
L'aggiunta di CoolStore modificherà CasaOS?
Aggiunge un'altra sorgente del catalogo delle app. Le singole app possono comunque richiedere porte, volumi, privilegi o accesso all'host, quindi esamina ogni manifest separatamente.
Cosa devo fare se un'app di CoolStore è obsoleta?
Usa la documentazione Docker/Compose del progetto originale oppure un pacchetto di un altro store mantenuto, invece di forzare un manifest obsoleto.
