Funkce Aplikace na jedno kliknutí ti umožňuje procházet rozsáhlý katalog aplikací a nasazovat aplikace přímo přes webové rozhraní svého VPS. V tomto návodu se dozvíš, jak připravit server, vybrat správný typ instalace, instalovat a spravovat aplikace a v případě potřeby využívat pokročilá nastavení a nástroje pro řešení problémů.
Než začneš používat Aplikace na jedno kliknutí, tvůj VPS musí splňovat minimální požadavky a používat podporovaný operační systém.
Minimální požadavky Funkce Aplikace vyžaduje, aby byl tvůj VPS online a měl dostatek prostředků pro spolehlivý běh platformových služeb i nainstalovaných aplikací.
| Požadavek | Minimum | Doporučeno |
|---|---|---|
| Stav serveru | Online | Online |
| Úložiště | 30 GB | 50 GB |
| RAM | 2 GB | 4 GB |
| CPU | 2 jádra | 4 jádra |
| Operační systém | Debian nebo Ubuntu LTS | Debian 13 |
Doporučujeme čistou instalaci operačního systému Důrazně doporučujeme nastavit funkci Aplikace na čisté instalaci operačního systému. Vyhneš se tak konfliktům se stávajícími službami, obsazenými porty, nastavením Dockeru nebo vlastními konfiguracemi, které už na serveru jsou.
Pokud potřebuješ VPS přeinstalovat, použij čistý, podporovaný obraz Debianu nebo Ubuntu LTS z rozhraní pro správu VPS.
Otevři svůj VPS na řídicím panelu ZapX a přejdi na kartu Aplikace na jedno kliknutí. Tam můžeš spustit počáteční konfiguraci a později spravovat všechny aplikace nainstalované na serveru.
Při prvním otevření této funkce musíš vybrat, jak se má platforma na tvém VPS nainstalovat.
Můžeš si vybrat mezi úplnou instalací a instalací pouze uzlu. Správná možnost závisí na tom, jestli má tento VPS hostovat panel pro správu i aplikace, nebo sloužit pouze jako propojený uzel pro jiný panel.
Vyber Úplná instalace, pokud chceš nastavit server s panelem a samotným serverem jako uzlem. Tuto možnost doporučujeme začátečníkům a pro většinu běžných nasazení.
Tato metoda ti umožní:
- nasazovat aplikace z katalogu aplikací
- spravovat projekty a prostředí
- organizovat všechny aplikace na jednom místě
- používat integrované nástroje pro správu na řídicím panelu
- v případě potřeby později získat přístup k pokročilému panelu
Doporučujeme většině uživatelů Pokud funkci Aplikace používáš poprvé, vyber úplnou instalaci. Nabízí nejjednodušší nastavení a plnou správu přímo přes řídicí panel ZapX.
Vyber Instalace pouze uzlu, pokud má tento VPS sloužit jen jako uzel. Potom ho můžeš propojit s jiným VPS nebo externí instancí panelu.
Tato možnost se hodí, pokud chceš:
- škálovat napříč několika systémy VPS
- soustředit správu do jednoho centrálního panelu
- připojit tento server ke stávajícímu prostředí pro nasazování
- rozšířit stávající nastavení s více uzly
Pokročilá možnost nasazení Instalace pouze uzlu je určená uživatelům, kteří už mají jinou instanci panelu nebo chtějí připojit tento server k externímu prostředí.
Po výběru typu instalace můžeš spustit nastavení přímo na kartě Aplikace na jedno kliknutí. První instalace obvykle trvá jen několik minut.
Během tohoto procesu se na tvém VPS nasadí platformové služby potřebné pro funkci Aplikace na jedno kliknutí. Po dokončení najdeš katalog aplikací a oblasti pro správu na příslušné kartě.
Průběh instalace Přesný průběh instalace se může lišit podle výkonu VPS, stavu operačního systému a podmínek sítě. Pokud se nastavení nepodaří dokončit, podívej se později do části tohoto návodu věnované řešení problémů.
Po instalaci můžeš otevřít katalog aplikací a procházet dostupné aplikace. Katalog obsahuje více než 300 aplikací připravených k okamžitému použití a nabízí filtry, díky kterým snadno najdeš tu správnou.
V katalogu můžeš vyhledávat aplikace podle názvu a filtrovat je podle kategorií. Díky tomu zúžíš širokou nabídku ve stylu obchodu s aplikacemi a najdeš vhodný cíl nasazení pro svůj projekt.
Mezi běžné akce patří:
- vyhledávání podle názvu aplikace
- filtrování podle kategorie
- procházení dostupných položek katalogu aplikací
- výběr aplikace k instalaci
Tento postup se hodí zejména tehdy, když spravuješ mnoho aplikací nebo před instalací porovnáváš několik služeb.
Po výběru aplikace z katalogu můžeš spustit instalaci přímo na kartě. V závislosti na aplikaci budeš muset zadat například tyto hodnoty:
[dein_projektname][dein_umgebungsname][deine_domain][dein_appname]
Tyto zástupné symboly představují konkrétní hodnoty tvého prostředí pro nasazení. Například [deine_domain] nahraď doménou, kterou chceš pro aplikaci používat.
Projekty a prostředí Používej projekty a prostředí, aby bylo nasazení přehledné. To se hodí zejména tehdy, když hostuješ více aplikací, testuješ verze nebo odděluješ produkční a přípravné služby.
Po nasazení se nainstalované aplikace zobrazí v oblasti správy na příslušné kartě. Odtud můžeš sledovat a ovládat své služby, aniž bys musel ručně pracovat s kontejnery, které za nimi běží.
V oblasti nainstalovaných aplikací můžeš přímo na kartě provádět běžné akce související s jejich životním cyklem.
| Akce | Účel |
|---|---|
| Spustit | Spustí zastavenou aplikaci |
| Zastavit | Zastaví spuštěnou aplikaci |
| Zkontrolovat logy | Otevře logy aplikace pro řešení problémů |
| Přeinstalovat | Znovu nastaví aplikaci |
Tyto nástroje ti usnadní správu všech aplikací na jednom místě, zvlášť pokud dáváš přednost jednoduchému ovládání přes web před ruční prací v příkazovém řádku.
Projekty a prostředí ti pomáhají přehledně strukturovat nasazení. Můžeš je použít k oddělení:
- soukromých a produkčních aplikací
- testovacích a ostrých prostředí
- nasazení pro různé zákazníky nebo týmy
- různých softwarových sestav na stejném VPS
Taková organizace je čím dál důležitější, jak roste tvoje sbírka aplikací a spravuješ více služeb na jednom nebo několika uzlech.
Funkce Aplikace na jedno kliknutí podporuje vlastní domény a integraci ZAP Cloud. Díky tomu můžeš aplikace zpřístupnit bezpečně a zajistit pro svá nasazení SSL certifikáty.
Podpora domén a SSL Pro aplikace můžeš používat vlastní domény a využívat automatické vystavování SSL certifikátů, pokud platforma dané nastavení podporuje.
Při přiřazování domény se ujisti, že její záznamy DNS směřují na [deine_server_ip]. Pokud doména není správně nakonfigurovaná, aplikace nemusí být dostupná z internetu.
| Hodnota | Popis |
|---|---|
[deine_domain] | Doména nebo subdoména přiřazená tvé aplikaci |
[deine_server_ip] | Veřejná IP adresa tvého VPS |
DNS musí směřovat na tvůj VPS
Pokud DNS pro [deine_domain] nesměřuje na [deine_server_ip], ověření domény a přístup k aplikaci mohou selhat.
Pokročilí uživatelé mohou využívat další funkce prostřednictvím externího panelu v oblasti pokročilých nastavení.
To se hodí, když potřebuješ podrobnější přizpůsobení, pokročilejší kontrolu nasazení nebo přímý přístup k funkcím, které přesahují možnosti standardního webového rozhraní.
Rozsah podpory při používání pokročilého panelu Pokročilí uživatelé mohou pro další úpravy a funkce používat externí panel Coolify. Podpora se však vztahuje pouze na řídicí panel ZapX. Na změny provedené mimo něj se podpora nemusí vztahovat.
Pokročilý panel se hodí, pokud potřebuješ:
- podrobněji přizpůsobovat nasazení
- používat přímé postupy pro propojení uzlů
- provádět pokročilou konfiguraci aplikací
- spravovat panel i jinak než prostřednictvím zjednodušeného rozhraní
Pokud ztratíš přístup nebo integrace přestane reagovat, použij před provedením ručních změn nástroje pro řešení problémů popsané níže.
Pokud jsi zvolil instalaci pouze uzlu, můžeš tento VPS propojit s jiným VPS nebo externí instancí panelu. Můžeš tak škálovat svou infrastrukturu a spravovat několik uzlů centrálně.
Propojení uzlů se hodí, pokud chceš:
- rozdělit aplikace mezi několik systémů VPS
- centralizovat správu
- rozšířit kapacitu bez vytváření oddělených nasazení
- připojit se k externímu prostředí panelu
Propojení s externím panelem Svůj uzel můžeš propojit s jiným VPS nebo externí instancí panelu. Přesný postup propojení závisí na cílovém prostředí, které už používáš.
Pokud řídicí panel zobrazuje zhoršený stav, znamená to, že platforma nemůže kontaktovat instanci, která zajišťuje funkci Aplikace na jedno kliknutí, nebo z ní načíst data. Postupuj podle kroků pro řešení problémů v uvedeném pořadí.
Vyskakovací okno pro řešení problémů může zobrazovat tyto indikátory:
| Stav | Význam |
|---|---|
| Stav Coolify: Aktivní | Služba panelu zřejmě běží |
| Stav API: Dostupné | Rozhraní API je momentálně dostupné |
| Stav služby: Online | Tvůj VPS je online |
Pokud jedna nebo více částí nefunguje správně, pokračuj následujícími kroky.
Nejdřív se ujisti, že je tvůj VPS na řídicím panelu ZapX online. Pokud je server offline, platforma Aplikace nemůže fungovat.
Použij akci Aktualizovat stav a znovu spusť kontrolu stavu s nejnovějšími údaji. Může to vyřešit dočasné problémy s připojením.
Dočasné problémy s připojením Zhoršený stav může být někdy způsoben krátkodobými problémy s komunikací. Aktualizace stavu je nejrychlejší první kontrola.
Pokud se stav nezlepší, použij akci Restartovat Docker. Tím se restartuje instance platformy. Po úspěšném potvrzení počkej 1-2 Minuten a znovu aktualizuj stav.
Restartování služby Restartování Dockeru může dočasně přerušit běh aplikací, než se služby znovu spustí.
Jako poslední krok použij Aktualizovat přihlašovací údaje. To je obzvlášť důležité, pokud je stav online, ale některé funkce řídicího panelu, například instalace aplikací, nefungují.
Tato akce:
- nesmaže tvoje data
- aktualizuje přihlašovací údaje uživatele root
- obnoví token API používaný řídicím panelem
- při úspěšném dokončení automaticky aktualizuje přihlašovací údaje panelu
Bezpečná aktualizace přihlašovacích údajů Aktualizace přihlašovacích údajů neodstraní nainstalované aplikace ani data nasazení. Obnoví pouze přihlašovací údaje potřebné pro přístup a komunikaci.
Pokud problém přetrvává i po provedení všech kroků pro řešení problémů, vytvoř žádost o podporu na webu ZAP-Hosting.
Aby funkce Aplikace na jedno kliknutí zůstala stabilní a snadno spravovatelná, řiď se těmito doporučeními:
| Osvědčený postup | Důvod |
|---|---|
| Používej čistou instalaci operačního systému | Zabrání konfliktům se stávajícími službami a porty |
| Splň doporučené požadavky na prostředky | Zlepší výkon a spolehlivost |
| Organizuj aplikace do projektů a prostředí | Zachová přehlednost nasazení |
| Nakonfiguruj DNS před přiřazením domény | Zabrání problémům s přístupem a SSL |
| Pokročilá nastavení používej uvážlivě | Předejdeš nepodporovaným vlastním úpravám |
Udržuj nasazení přehledné
Pokud chceš hostovat mnoho aplikací, vytvoř si ještě před prvním nasazením jasné schéma pojmenování pro [dein_projektname], [dein_umgebungsname] a [dein_appname].