S One-Click Apps nainstaluješ aplikace, jako jsou Nextcloud, n8n, databáze nebo monitorovací nástroje, z katalogu aplikací na svůj dedikovaný server a budeš je spravovat přímo v dashboardu ZapX. Na pozadí k tomu běží Coolify, open-source platforma pro aplikace v kontejnerech.
Na rozdíl od VPS si One-Click Apps na dedikovaném serveru nastavíš jednou sám: V dashboardu vytvoříš příkaz a spustíš ho na svém serveru jako root. O zbytek se postará ZapX. V tomto návodu se dozvíš, co tvůj server potřebuje, jak nastavení probíhá, jak spravovat aplikace a k čemu slouží údržbový přístup ZapX k tvému serveru.
Co tvůj dedikovaný server potřebuje: Než spustíš příkaz, zkontroluj tyto požadavky. Příkaz je ověří sám a pokud něco nebude vyhovovat, skončí bez provedení změn.
| Požadavek | Minimum |
|---|---|
| Operační systém | Debian nebo Ubuntu se serverem SSH |
| RAM | 2 GB |
| CPU | 2 jádra |
| Volné místo na disku | 30 GB |
| IP adresa | Veřejná IPv4 adresa nastavená na serveru |
| Volné porty | 8000, 6001, 6002 a 8080 (porty 80 a 443 potřebují tvoje aplikace) |
| SSH | Port SSH na tvém serveru musí být dostupný pro ZapX |
Doporučujeme čistý operační systém: One-Click Apps nastav nejlépe na čisté instalaci Debianu nebo Ubuntu. Služby, které už používají porty, vlastní nastavení Dockeru nebo už nainstalované Coolify s vlastním přihlášením způsobí, že se nastavení přeruší. Novou instalaci spustíš na kartě Instalace svého dedikovaného serveru.
Hostitel Proxmox a Windows: One-Click Apps nelze nastavit přímo na hostiteli Proxmox. Použij k tomu virtuální počítač na serveru, který využívá jednu z IP adres tvého serveru. Windows není podporován.
One-Click Apps může nastavit pouze vlastník serveru.
Otevři svůj dedikovaný server v dashboardu ZapX a přejdi na kartu One-Click Apps. Najdeš tam kartu Nastavit One-Click Apps.
Vyber dvě možnosti:
- IP adresa pro panel a aplikace: Zobrazí se veřejné IPv4 adresy tvého serveru, primární adresa je označená. Pod touto IP adresou budou později dostupné panel Coolify a tvoje aplikace.
- E-mail správce pro Coolify: Touto e-mailovou adresou se přihlásíš do panelu Coolify.
Potom klikni na Vytvořit příkaz. ZapX připraví adresu pro tvůj panel. Může to trvat až minutu.
Přihlas se na svůj server přes SSH jako root. Zkopíruj zobrazený příkaz pomocí ikony kopírování a spusť ho. Začíná na curl -fsSL a končí na | bash.
Pokud na serveru nemáš curl, nejdřív ho nainstaluj příkazem:
apt update && apt install -y curl
Instalace pak poběží na pozadí. Terminál můžeš zavřít.
Příkaz nikomu neposílej: Příkaz obsahuje osobní klíč určený právě pro tento server a platí 24 hodin. Nikomu ho neposílej. Pokud potřebuješ nový příkaz, klikni na Zrušit ruční instalaci a vytvoř ho znovu.
Na kartě uvidíš, jak nastavení postupuje:
| Zobrazený stav | Význam |
|---|---|
| Čekáme, až spustíš příkaz na svém serveru. | Příkaz se ještě nespustil |
| Připojeno. Instalace probíhá na tvém serveru. | ZapX instaluje Coolify, což obvykle trvá až 10 minut |
| Coolify je nainstalováno. Právě připojujeme panel. | Poslední krok, který trvá přibližně minutu |
Pokud se ZapX ani po několika minutách nemůže připojit k tvému serveru přes SSH, na kartě se zobrazí upozornění. Zkontroluj, jestli firewall povoluje příchozí připojení na port SSH tvého serveru.
- Zkontroluje operační systém, prostředky, IP adresu a volné porty. Pokud něco nebude vyhovovat, zobrazí zprávu a skončí.
- Vytvoří uživatele
zapx-appss právy sudo. Prostřednictvím tohoto uživatele bude ZapX spravovat Coolify a tvoje aplikace. Přihlášení funguje pouze pomocí klíče od ZapX a pouze z adres ZapX. Přihlášení heslem není možné. - Nainstaluje Coolify pomocí oficiálního instalačního programu, který nastaví také Docker.
- Pro samotné nastavení ZapX dočasně použije silně omezený klíč root a v případě potřeby upraví konfiguraci SSH. Obojí se po dokončení nastavení odstraní.
- Příkaz nemění pravidla firewallu.
Protokol nastavení najdeš na serveru v souboru /var/lib/zapx-oneclick-apps/setup.log.
Po dokončení nastavení se na kartě One-Click Apps zobrazí tři oblasti:
| Oblast | Obsah |
|---|---|
| Nainstalované aplikace | Tvoje aplikace se stavem a dostupnými akcemi |
| Katalog aplikací | Všechny dostupné aplikace k instalaci |
| Přístup a nastavení | Adresa panelu, přihlášení a údržbový přístup |
- Otevři Katalog aplikací a vyhledej požadovanou aplikaci.
- Klikni na Nainstalovat.
- V okně Instalovat aplikaci vyplň požadované údaje, například
[dein_appname]nebo[deine_domain]. - Klikni na Zařadit instalaci do fronty.
Pokud tvůj server nemá pro aplikaci dostatek RAM, v katalogu se zobrazí upozornění „Tvůj server nemá pro tuto aplikaci dostatek RAM.“
Pomoc od ZapX AI Agenta: V ZapX AI Agentovi svého serveru si můžeš nechat doporučit vhodnou aplikaci, zkontrolovat stav aplikací nebo připravit instalaci. Agent provede jakoukoli změnu až po tvém potvrzení. Přihlašovací údaje a tajné informace upravuj vždy na kartě One-Click Apps.
V části Nainstalované aplikace můžeš každou aplikaci přímo ovládat:
| Akce | Účel |
|---|---|
| Spustit | Spustí zastavenou aplikaci |
| Zastavit | Zastaví spuštěnou aplikaci |
| Restartovat | Restartuje aplikaci |
| Protokoly | Zobrazí protokoly aplikace pro řešení problémů |
| Nastavení | Změní proměnné prostředí, doménu a další možnosti aplikace |
V části Přístup a nastavení najdeš URL panelu a e-mail správce pro panel Coolify. Heslo se zobrazí po krátkém bezpečnostním potvrzení po kliknutí na Zobrazit. Nové heslo nastavíš kliknutím na Obnovit heslo. Přihlašovací údaje vidí pouze vlastník serveru.
Panel najdeš na vlastní adrese na zap.cloud, například https://appspanel-[nummer].zap.cloud.
Rozsah podpory v panelu Coolify: V panelu Coolify si můžeš vše upravit sám. Podpora ZapX se ale vztahuje pouze na správu prostřednictvím dashboardu ZapX. Změny provedené přímo v panelu podpora nepokrývá.
Karta Údržbový přístup ukazuje, jestli se ZapX může připojit k tvému serveru:
| Stav | Význam |
|---|---|
| Aktivní | ZapX se může připojit k tvému serveru a spravovat Coolify a tvoje aplikace |
| Přerušený | ZapX se už nemůže připojit k tvému serveru, například protože se změnil klíč hostitele SSH nebo server přestal přijímat klíč ZapX |
| Odebraný | Údržbový přístup jsi odebral |
Pomocí možnosti Odebrat přístup ZapX odstraní ze serveru svůj klíč, pravidlo sudo a uživatele zapx-apps. Coolify a tvoje aplikace poběží dál, ale ZapX je už nebude moct spravovat: instalace, řešení problémů a změny v dashboardu už nebudou fungovat. V takovém případě budeš aplikace spravovat přímo v panelu Coolify.
Pokud server při odebrání přístupu nebude dostupný, ZapX zablokuje přístup na své straně. Uživatele zapx-apps a soubor /etc/sudoers.d/zapx-apps pak můžeš ze serveru odstranit sám.
Pomocí možnosti Obnovit přístup vytvoříš nový příkaz, který znovu nastaví pouze údržbový přístup. Coolify a tvoje aplikace zůstanou beze změny. Spusť příkaz na serveru jako root, stejně jako při prvním nastavení.
| Událost | Co se stane |
|---|---|
| Nová instalace na kartě Instalace | Nastavení se resetuje a adresy na zap.cloud se odstraní. Systém se nainstaluje znovu, proto si předem zálohuj data aplikací. Potom nastav One-Click Apps znovu. |
| Uvolnění IP adresy panelu a aplikací | Údržbový přístup se odebere, adresy na zap.cloud se odstraní a nastavení se resetuje. Coolify a tvoje aplikace budou na serveru dál fungovat. Pokud je chceš znovu spravovat v dashboardu, nastav One-Click Apps znovu s jinou IP adresou. |
| Zrušení nebo ukončení smlouvy | Údržbový přístup a adresy na zap.cloud se odeberou. |
| Zpráva nebo problém | Řešení |
|---|---|
| Ani po několika minutách se nejde připojit přes SSH | Zkontroluj, jestli server SSH běží a firewall povoluje port SSH |
| Porty už jsou obsazené | Zastav služby na portech 8000, 6001, 6002 a 8080 nebo server nainstaluj znovu |
| Coolify už je nainstalováno | ZapX nepřevezme Coolify s vlastním přihlášením. Odeber ho, nebo použij čistý systém |
| Server SSH povoluje pouze určité uživatele (AllowUsers) | Přidej zapx-apps do konfigurace SSH a znovu spusť příkaz |
| Na serveru právě probíhá instalace | Počkej, až instalace na kartě Instalace skončí |
| Server ještě nemá veřejnou IPv4 adresu | Nejdřív pro server nastav veřejnou IPv4 adresu |
| Příliš mnoho pokusů | Počkej několik minut a potom vytvoř příkaz znovu |
Další informace o neúspěšném nastavení najdeš v souboru /var/lib/zapx-oneclick-apps/setup.log. Pokud si nevíš rady, vytvoř žádost o podporu a uveď chybovou zprávu z karty.