Gemenskapslösning

Lägg till CoolStore i CasaOS på ett säkert sätt: Aktuell källguide

A 2023 tutorial introduced CoolStore as a CasaOS third-party app store; the current repository still publishes an Add Source ZIP URL.

CoolStore kan fortfarande läggas till i CasaOS via App Stores funktion Lägg till källa med den aktuella ZIP-URL som publiceras av CoolStore-arkivet. Det är dock en tredjepartsbutik, inte en källa som kurateras av IceWhale, så granska varje apps avbild, volymer, portar och underhållare innan du installerar den.

Forumhandledningen från 2023 är nu för gammal för att användas som enda instruktion. CoolStore-arkivet publicerar för närvarande en underhållen käll-URL, medan det bredare ekosystemet för CasaOS/ZimaOS-appbutiker har gått mot nyare butiksprotokoll och striktare validering.

Aktuell CoolStore-käll-URL

Det aktuella projektarkivet anger:

https://casaos-appstore.paodayag.dev/coolstore.zip

CasaOS CoolStore-arkivet bör betraktas som den tillförlitliga källan i stället för en förkortad länk från en gammal handledning.

Så lägger du till CoolStore i CasaOS

  1. Öppna CasaOS-instrumentpanelen.
  2. Öppna App Store.
  3. Välj Lägg till källa.
  4. Klistra in den aktuella CoolStore-URL:en för ZIP-filen.
  5. Vänta medan källan uppdateras.
  6. Bekräfta att CoolStore-appar visas innan du installerar något.

Om Lägg till källa visar att det lyckades men inga appar visas

Uppdatera App Store-sidan och kontrollera om källan fortfarande är registrerad. CasaOS har haft kompatibilitetsproblem med tredjepartsbutiker när källformat eller butiksrötter har ändrats, så ett meddelande om att åtgärden lyckades bevisar inte alltid att butiken tolkades korrekt.

Betrakta inte appar från tredjepartsbutiker som officiella CasaOS-appar

En community-butik kan paketera utmärkt programvara, men appmanifestet kan underhållas av en annan person än den som utvecklar programvaran i uppströmsprojektet. Kontrollera följande före installation:

  • källa för Docker-avbilden;
  • strategi för versioner/taggar;
  • volymmappningar till värdsökvägar;
  • privilegierat läge eller enhetsåtkomst;
  • publicerade portar;
  • uppdateringshistorik.

Föredra uppströmsprojektets Docker-dokumentation för kritiska appar

Om du installerar en databas, omvänd proxy, lösenordshanterare eller annan viktig tjänst bör du jämföra CoolStore-manifestet med uppströmsprojektets aktuella Docker-dokumentation. Paket från tredje part kan ligga efter större ändringar i uppströmsprojektet.

Förstå den nya riktningen för appbutiker

IceWhales aktuella utvecklardokumentation för App Store definierar nu ett nyare v2-butiksprotokoll med genererade store.json, index.json, Compose-filer per app, metadata och tillgångar. Äldre ZIP-butiker kan fortfarande finnas kvar av kompatibilitetsskäl, men de är inte längre det enda appbutiksformatet.

Den aktuella utvecklardokumentationen för App Store beskriver den nyare butiksarkitekturen.

Ta bort en butikskälla utan att radera appdata

Att ta bort en butikskälla bör hanteras separat från att avinstallera appar som installerats från den. En container som redan körs försvinner inte automatiskt bara för att katalogkällan tas bort.

Säkerhetskopiera viktiga appdata innan du avinstallerar en community-paketerad app.

När manuell Docker är bättre

Om en CoolStore-app är föråldrad eller begär riskfyllda behörigheter bör du i stället installera uppströmsprojektets Compose-definition manuellt. Då blir det enklare att granska avbildstaggar, volymer, nätverk och hemligheter.

Den anpassade Docker-guiden beskriver samma transparenta distributionsmetod.

Säkerhetskopiera appen innan du byter butikspaket

Om du redan har installerat en app från CoolStore och vill ersätta den med en version från en annan butik ska du inte anta att båda manifesten använder samma värdsökvägar, miljövariabler eller containernamn. Exportera eller säkerhetskopiera appens beständiga data först och jämför sedan de två Compose-definitionerna innan du avinstallerar något.

Så bedömer du om en butikspost är välunderhållen

Kontrollera om den underliggande Docker-avbilden fortfarande får uppdateringar, om butiksmanifestet låser en rimlig version och om användare nyligen rapporterar lyckade installationer. En butik kan fortfarande vara nåbar trots att ett enskilt paket i tysthet har blivit föråldrat.

För säkerhetskänsliga tjänster bör du även kontrollera att manifestet inte begär privilegierat läge, värdnätverk, råa enheter eller breda filsystemmonteringar utan en tydlig anledning.

Vanliga frågor

Är CoolStore en officiell CasaOS-butik?

Nej. Det är en community-driven tredjepartsbutik.

Vilken URL ska jag använda?

Använd den aktuella ZIP-URL som publiceras i CoolStores GitHub-arkiv i stället för en gammal förkortad länk.

Ändrar tillägg av CoolStore själva CasaOS?

Det lägger till ytterligare en källa till appkatalogen. Enskilda appar kan fortfarande begära portar, volymer, privilegier eller åtkomst till värdsystemet, så granska varje manifest separat.

Vad gör jag om en app i CoolStore är föråldrad?

Använd uppströmsprojektets Docker-/Compose-dokumentation eller ett annat underhållet butikspaket i stället för att tvinga fram ett gammalt manifest.