Je eigen App Center: lever je QPKG-pakketten vanaf Git naar elke NAS
Bucket & Code Server IDE houdt een App Center-repository op je NAS bij. Een QPKG-project dat je aanmaakt met Nieuw project bouwt bij elke Git-push en publiceert het pakket daarin. Je andere NAS-apparaten voegen het adres van de repository eenmalig toe in App Center en kunnen daarna je pakketten installeren en bijwerken, net als elke andere app. Cloudflare Tunnel kan de repository, en desgewenst ook Git, op internet publiceren zonder dat je een poort op de router opent.
- Voorbereidenmodules, QDK, een certificaat
- ProjectNieuw project, QPKG-pakket
- Repositoryhet adres ervan in App Center
- Interneteen hostnaam voor pakketten
De afbeeldingen komen uit het paneel, met elk veld ingevuld zoals deze handleiding beschrijft. De adressen zijn die van een NAS op 192.168.1.20, en de gepubliceerde namen zijn voorbeelden onder example.com.
01Voordat je begint
- Git, CI en de Editor moeten aan staan: een beheerder zet elke module aan met de knop op het Overzicht (Git aanzetten, Git en CI aanzetten, Editor aanzetten). De wizard Nieuw project heeft Git en de Editor nodig, en CI voert bij elke push de workflow van het project uit.
- QDK moet geïnstalleerd zijn: installeer op de pagina Toolchains, tabblad QNAP, QNAP QDK 2.5.0.
- Je hebt een certificaat voor codeondertekening nodig, gekocht bij een certificaatautoriteit of door QNAP aan jou uitgegeven, in de vorm van bestanden (
certificate,private_keyen, voor de keten,ca_certs) of met de sleutel op een USB-token.
02Het project aanmaken
Open Nieuw project op de pagina Git of via het opdrachtenpalet (rol developer).
- Sjabloon. Kies onder Pakketten voor QTS de optie QPKG-pakket en druk op Volgende.

- Naam en zichtbaarheid. De repository, de map en het pakket krijgen allemaal dezelfde naam: 1 tot 20 letters, cijfers, koppeltekens of underscores. De eigenaar is je account of een organisatie; laat het project op Privé staan.

- Dienst. Kies hoe het pakket start en stopt: Opdrachtregelprogramma koppelt het programma in
/usr/bin, Achtergronddienst voert het uit onder een eigen account en Webapp voegt ook de knop Openen in App Center toe. Leeg maakt een dienstscript waarvan de opdrachten start, stop en andere nog geen blokken bevatten. Je kunt deze blokken later aanpassen in de projectweergave.
- Bouwen. Kies de omgeving waarin het project bouwt en laat Direct na het aanmaken bouwen aan staan.

- Publiceren. Zet Publiceren in de App Center-repository van deze NAS aan. Dezelfde schakelaar blijft daarna in de instellingen van het project staan en laat CI bij elke run publiceren.

- Controle. Bekijk de stappen die worden uitgevoerd en druk op Project aanmaken.

De eerste taak maakt de repository in Forgejo aan, en de map projects/<name> met de eerste commit: de bestanden van het sjabloon en de workflow .forgejo/workflows/build.yml.
03Elke push publiceert
Bij elke push naar de repository draait de workflow op de eigen runner van de NAS. De workflow bouwt het pakket en publiceert het met --latest, zodat repo.xml de nieuwe versie meteen vermeldt en App Center die bij de volgende controle aanbiedt.
De pagina van het project (Projecten, of de zijbalk van de Editor) voert dezelfde stappen met de hand uit: Bouwen, Opnieuw bouwen, Testuitrol (alleen van een beheerder) en Publiceren.
De kaart Instellingen bevat de schakelaar Publiceren in de App Center-repository. Zolang die uit staat, slaat een CI-run de publicatie over met een melding.
De pagina Pakketten toont elk pakket met de nieuwste versie en de handtekening. Een versie die een developer daar met de hand uploadt, wordt pas de nieuwste als een beheerder dat zo instelt.
04Voeg de repository toe op je andere NAS-apparaten
- Kopieer het adres van de kaart App Center-adres op de pagina Pakketten.

- Op de andere NAS: App Center → ⚙ Instellingen → App-repository → Toevoegen. Geef de repository een naam, plak het adres en druk op Toevoegen.
- Je pakketten staan onder die naam in de linkerkolom van App Center. Installeer ze daar. Zodra de repository een nieuwere versie vermeldt, biedt App Center die aan als update.
Dit LAN-adres werkt voor NAS-apparaten in je netwerk. Voor een NAS buiten je netwerk publiceer je de repository op internet.
05Via internet met Cloudflare Tunnel
Het pakket bevat cloudflared, dat vanaf de NAS een uitgaande verbinding met Cloudflare maakt: er hoeft geen poort op de router open, en Cloudflare beheert de certificaten voor de namen. Je hebt een domein nodig waarvan de DNS bij Cloudflare staat, en een API-token voor die zone (dash.cloudflare.com, My Profile → API Tokens) met vier rechten: Account, Cloudflare Tunnel, Edit; Zone, DNS, Edit; Zone, Cache Rules, Edit; Zone, Cache Purge, Purge. Heeft het token Client IP Address Filtering, zet dan beide publieke adressen van de NAS erin, IPv4 en IPv6.
| Naam | Wat het levert |
|---|---|
Hostnaam voor pakkettenqpkg.example.com | alleen GET en HEAD van /repo/, voor App Center op je andere NAS-apparaten; meer hebben ze niet nodig |
Hoofdhostnaamcode.example.com | het paneel, Forgejo op /git/ voor clone en push via HTTPS, de repository alleen-lezen, de webweergave van openbare repositories en de gebruikershandleiding |
- Bij een hoofdhostnaam moet je eerst Openbaar bladeren inschakelen op de pagina Git en op Opslaan en Forgejo herstarten drukken: de pagina Publiceren weigert een hoofdhostnaam zolang dit uit staat. Repositories die als privé zijn gemarkeerd, blijven verborgen.

- Open Publiceren onder Beheer (alleen beheerders). Typ de namen en het token, laat Cache-voorinstellingen aan staan en druk op Publiceren. Het pakket controleert alles eerst bij Cloudflare, verandert daar niets als een controle mislukt, en vertelt wat je moet oplossen.

- Daarna maakt het pakket de tunnel aan, laat elke naam ernaar wijzen en start cloudflared. De kaart Tunnel toont de verbindingen.

- Het App Center-adres op de pagina Pakketten noemt nu de hostnaam voor pakketten. Voeg dat adres toe op NAS-apparaten buiten je netwerk.

- Bij een hoofdhostnaam stel je Openbare URL op de pagina Netwerk in op het adres ervan, zodat de links van Forgejo en de HTTPS-kloonadressen dat adres gebruiken.

- Git via SSH gaat niet via de tunnel. Van buitenaf kloon en push je via HTTPS, of je stuurt een poort op de router door naar de Git-over-SSH-poort (9952) en stelt op de pagina Netwerk SSH-host in kloon-URL’s in.
- Cloudflare accepteert verzoeken tot 100 MB. Push of upload alles wat groter is via het LAN-adres.
- Een publicatie naar de repository wist
repo.xmlmeteen uit de cache van Cloudflare, zodat App Center de nieuwe versie bij de volgende controle ziet.
06Wat het internet bereikt
De pagina Publiceren toont wat elke naam levert, en de cacheregels ernaast.
- De hoofdhostnaam antwoordt op
/ide/met 404 totdat een beheerder De editor publiceren inschakelt. De terminal van de editor is een root-shell op de NAS, dus schakel eerst tweefactorauthenticatie in voor developer- en beheerdersaccounts.
- Zolang CI aan staat, draait elke workflow die naar een repository wordt gepusht als root op de NAS, of de push nu van internet komt of van het LAN. Geef pushtoegang alleen aan mensen aan wie je ook het beheerderswachtwoord van de NAS zou geven.
- Het eerste beheerderswachtwoord wordt nooit via een gepubliceerde naam ingesteld: het scherm bij de eerste start accepteert alleen een client op het lokale netwerk.
- Stoppen beëindigt cloudflared en verandert niets bij Cloudflare. Van Cloudflare verwijderen verwijdert de DNS-records, de cacheregels en de tunnel die het pakket heeft gemaakt, en vergeet het token.