CoolStore kan nog steeds aan CasaOS worden toegevoegd via de functie Bron toevoegen in de App Store, met de huidige ZIP-URL die door de CoolStore-repository wordt gepubliceerd. Het is echter een winkel van derden en geen door IceWhale samengestelde bron. Controleer daarom vóór de installatie de image, volumes, poorten en beheerder van elke app.
De forumhandleiding uit 2023 is inmiddels te verouderd om als enige instructie te gebruiken. De CoolStore-repository publiceert momenteel een onderhouden bron-URL, terwijl het bredere CasaOS/ZimaOS-appstore-ecosysteem is overgestapt op nieuwere winkelprotocollen en strengere validatie.
Huidige CoolStore-bron-URL
De huidige projectrepository vermeldt:
https://casaos-appstore.paodayag.dev/coolstore.zipDe CasaOS CoolStore-repository moet als de bron van waarheid worden beschouwd, in plaats van een verkorte link uit een oude handleiding.
CoolStore toevoegen in CasaOS
- Open het CasaOS-dashboard.
- Open de App Store.
- Kies Bron toevoegen.
- Plak de huidige CoolStore-ZIP-URL.
- Wacht tot de bron is vernieuwd.
- Controleer of CoolStore-applicaties verschijnen voordat je iets installeert.
Als Bron toevoegen ‘Succes’ aangeeft, maar er geen apps verschijnen
Vernieuw de App Store-pagina en controleer of de bron nog steeds is geregistreerd. CasaOS heeft compatibiliteitsproblemen met winkels van derden gehad wanneer bronindelingen of winkelroots veranderden. Een melding dat de bewerking is geslaagd, bewijst daarom niet altijd dat de winkel correct is verwerkt.
Beschouw apps uit winkels van derden niet als officiële CasaOS-apps
Een communitywinkel kan uitstekende software aanbieden, maar het appmanifest kan worden onderhouden door iemand anders dan de ontwikkelaar van de upstream-applicatie. Controleer vóór de installatie:
- bron van de Docker-image;
- strategie voor versies en tags;
- toewijzingen van volumes naar hostpaden;
- bevoorrechte modus of apparaattoegang;
- gepubliceerde poorten;
- updategeschiedenis.
Gebruik voor kritieke apps bij voorkeur de Docker-documentatie van het upstreamproject
Als je een database, reverse proxy, wachtwoordbeheerder of andere belangrijke service installeert, vergelijk dan het CoolStore-manifest met de actuele Docker-documentatie van het upstreamproject. Pakketten van derden kunnen achterlopen op grote wijzigingen in het upstreamproject.
Begrijp de nieuwe richting van de App Store
De huidige ontwikkelaarsdocumentatie van IceWhale voor de App Store definieert nu een nieuwer v2-winkelprotocol met gegenereerde store.json, index.json, Compose-configuraties per app, metadata en assets. Legacy ZIP-winkels kunnen voor compatibiliteit blijven bestaan, maar zijn niet langer de enige indeling voor appstores.
De huidige ontwikkelaarsdocumentatie voor de App Store legt de nieuwere winkelarchitectuur uit.
Een winkelbron verwijderen zonder je appgegevens te verwijderen
Het verwijderen van een winkelbron moet los worden gezien van het verwijderen van apps die daaruit zijn geïnstalleerd. Een container die al actief is, verdwijnt niet automatisch wanneer de catalogusbron wordt verwijderd.
Maak een back-up van belangrijke appgegevens voordat je een applicatie verwijdert die uit een communitywinkel afkomstig is.
Wanneer handmatig Docker beter is
Als een CoolStore-app verouderd is of om risicovolle rechten vraagt, installeer dan in plaats daarvan handmatig de upstream-Compose-definitie. Zo kun je imagetags, volumes, netwerken en secrets eenvoudiger controleren.
De aangepaste Docker-handleiding biedt dezelfde transparante implementatiemethode.
Maak een back-up van de app voordat je van winkelpakket wisselt
Als je al een app uit CoolStore hebt geïnstalleerd en deze wilt vervangen door de versie uit een andere winkel, ga er dan niet van uit dat beide manifesten dezelfde hostpaden, omgevingsvariabelen of containernamen gebruiken. Exporteer of maak eerst een back-up van de permanente gegevens van de app en vergelijk vervolgens de twee Compose-definities voordat je iets verwijdert.
Beoordelen of een winkelvermelding betrouwbaar is
Controleer of de onderliggende Docker-image nog updates ontvangt, of het winkelmanifest een verstandige versie vastzet en of recente gebruikers succesvolle installaties melden. Een winkel kan bereikbaar blijven terwijl een afzonderlijk pakket ongemerkt verouderd is geraakt.
Controleer bij beveiligingsgevoelige services ook of het manifest geen bevoorrechte modus, hostnetwerk, onbewerkte apparaten of brede bestandssysteemkoppelingen aanvraagt zonder duidelijke reden.
Veelgestelde vragen
Is CoolStore een officiële CasaOS-winkel?
Nee. Het is een communitywinkel van derden.
Welke URL moet ik gebruiken?
Gebruik de huidige ZIP-URL die in de CoolStore-GitHub-repository wordt gepubliceerd, in plaats van een oude verkorte link.
Past het toevoegen van CoolStore CasaOS zelf aan?
Het voegt een andere bron voor appcatalogi toe. Afzonderlijke apps kunnen nog steeds poorten, volumes, rechten of toegang tot de host aanvragen. Controleer daarom elk manifest afzonderlijk.
Wat moet ik doen als een app in CoolStore verouderd is?
Gebruik de upstream-Docker/Compose-documentatie of een ander onderhouden winkelpakket, in plaats van een oud manifest te forceren.
