Med One-Click Apps installerar du appar som Nextcloud, n8n, databaser eller övervakningsverktyg från en appkatalog på din dedikerade server och hanterar dem direkt i ZapX-kontrollpanelen. I bakgrunden körs Coolify, en plattform med öppen källkod för containerappar.
Till skillnad från på en VPS konfigurerar du One-Click-appar på en dedikerad server själv en gång: Du skapar ett kommando i kontrollpanelen och kör det som root på din server. ZapX sköter resten. I den här guiden får du veta vad din server behöver, hur konfigurationen går till, hur du hanterar appar och vad ZapX underhållsåtkomst gör på din server.
Det här behöver din dedikerade server: Kontrollera de här punkterna innan du kör kommandot. Kommandot kontrollerar dem själv och avbryts utan att göra några ändringar om något inte stämmer.
| Krav | Minst |
|---|---|
| Operativsystem | Debian eller Ubuntu med SSH-server |
| RAM | 2 GB |
| CPU | 2 kärnor |
| Ledigt lagringsutrymme | 30 GB |
| IP-adress | Offentlig IPv4-adress som är konfigurerad på servern |
| Lediga portar | 8000, 6001, 6002 och 8080 (dina appar behöver 80 och 443) |
| SSH | ZapX måste kunna nå serverns SSH-port |
Vi rekommenderar ett nyinstallerat operativsystem: Konfigurera helst One-Click-appar på en nyinstallation av Debian eller Ubuntu. Tjänster som redan använder portar, en egen Docker-konfiguration eller en befintlig Coolify-installation med egen inloggning gör att konfigurationen avbryts. Du startar en nyinstallation under fliken Installation för din dedikerade server.
Proxmox-värd och Windows: Du kan inte konfigurera One-Click-appar direkt på en Proxmox-värd. Använd i stället en virtuell maskin på servern som använder någon av serverns IP-adresser. Windows stöds inte.
Det är bara serverns ägare som kan konfigurera One-Click-appar.
Öppna din dedikerade server i ZapX-kontrollpanelen och gå till fliken One-Click Apps. Där hittar du kortet Konfigurera One-Click Apps.
Välj två uppgifter:
- IP-adress för panel och appar: Här visas serverns offentliga IPv4-adresser. Den primära adressen är markerad. Coolify-panelen och dina appar blir tillgängliga via den här IP-adressen.
- Administratörens e-postadress för Coolify: Du använder den här e-postadressen för att logga in i Coolify-panelen.
Klicka sedan på Skapa kommando. ZapX förbereder adressen för panelen. Det kan ta upp till en minut.
Logga in på servern via SSH som root. Kopiera kommandot som visas med kopieringsikonen och kör det. Det börjar med curl -fsSL och slutar med | bash.
Om curl saknas på servern installerar du det först med:
apt update && apt install -y curl
Installationen fortsätter sedan i bakgrunden. Du kan stänga terminalen.
Dela inte kommandot: Kommandot innehåller en personlig nyckel som gäller just den här servern och är giltig i 24 timmar. Dela den inte med någon. Om du behöver ett nytt kommando klickar du på Avbryt manuell installation och skapar ett nytt.
På fliken kan du se hur långt konfigurationen har kommit:
| Status | Betydelse |
|---|---|
| Vi väntar på att du ska köra kommandot på din server. | Kommandot har inte startats än |
| Ansluten. Installationen körs på din server. | ZapX installerar Coolify. Det tar oftast upp till 10 minuter |
| Coolify är installerat. Vi ansluter panelen. | Sista steget, tar ungefär en minut |
Om ZapX inte kan nå servern via SSH efter några minuter visas ett meddelande på fliken. Kontrollera då att brandväggen tillåter inkommande anslutningar till serverns SSH-port.
- Det kontrollerar operativsystem, resurser, IP-adress och lediga portar, och avbryts med ett meddelande om något inte stämmer.
- Det skapar användaren
zapx-appsmed sudo-behörighet. ZapX använder den här användaren för att hantera Coolify och dina appar. Inloggning fungerar endast med en nyckel från ZapX och endast från ZapX-adresser. Det går inte att logga in med lösenord. - Det installerar Coolify med det officiella installationsprogrammet, som även konfigurerar Docker.
- För själva konfigurationen använder ZapX tillfälligt en root-nyckel med starkt begränsade behörigheter och anpassar vid behov SSH-konfigurationen. Båda tas bort när konfigurationen är klar.
- Kommandot ändrar inte brandväggsregler.
Du hittar installationsloggen på servern under /var/lib/zapx-oneclick-apps/setup.log.
När konfigurationen är klar visar fliken One-Click Apps tre områden:
| Område | Innehåll |
|---|---|
| Installerade appar | Dina appar med status och åtgärder |
| Appkatalog | Alla appar som går att installera |
| Åtkomst och inställningar | Paneladress, inloggning och underhållsåtkomst |
- Öppna Appkatalog och sök efter appen du vill ha.
- Klicka på Installera.
- Fyll i de efterfrågade värdena i fönstret Installera app, till exempel
[ditt_appnamn]eller[din_domän]. - Klicka på Köa installation.
Om servern inte har tillräckligt med RAM för en app visas meddelandet ”Din server har för lite RAM för den här appen.” i katalogen.
Få hjälp av ZapX AI Agent: I ZapX AI Agent för din server kan du be om förslag på en app, kontrollera statusen för dina appar eller förbereda en installation. Agenten genomför ändringar först efter att du har bekräftat dem. Du hanterar alltid inloggningsuppgifter och hemligheter under fliken One-Click Apps.
Under Installerade appar kan du styra varje app direkt:
| Åtgärd | Syfte |
|---|---|
| Starta | Startar en stoppad app |
| Stoppa | Stoppar en app som körs |
| Starta om | Startar om appen |
| Loggar | Visar appens loggar för felsökning |
| Inställningar | Ändrar miljövärden, domän och andra alternativ för appen |
Kortet Underhållsåtkomst visar om ZapX kan nå din server:
| Status | Betydelse |
|---|---|
| Aktiv | ZapX kan nå din server och hantera Coolify och dina appar |
| Avbruten | ZapX kan inte längre nå din server, till exempel för att SSH-värdnyckeln har ändrats eller ZapX-nyckeln inte längre accepteras |
| Borttagen | Du har tagit bort underhållsåtkomsten |
Med Ta bort åtkomst tar ZapX bort sin nyckel, sudo-regeln och användaren zapx-apps från servern. Coolify och dina appar fortsätter att köras, men ZapX kan inte längre hantera dem. Det går då inte längre att installera appar, felsöka eller göra ändringar i kontrollpanelen. I stället hanterar du apparna direkt i Coolify-panelen.
Om servern inte går att nå när åtkomsten tas bort spärrar ZapX åtkomsten på sin sida. Då kan du själv ta bort användaren zapx-apps och filen /etc/sudoers.d/zapx-apps från servern.
Med Återställ åtkomst skapar du ett nytt kommando som bara konfigurerar underhållsåtkomsten på nytt. Coolify och dina appar förblir oförändrade. Kör kommandot som root på servern, på samma sätt som när du konfigurerade det första gången.
| Händelse | Vad händer |
|---|---|
| Nyinstallation via fliken Installation | Konfigurationen återställs och adresserna på zap.cloud tas bort. Systemet installeras på nytt. Säkerhetskopiera dina appdata först. Konfigurera sedan One-Click-appar på nytt. |
| Frigöring av IP-adressen för panelen och apparna | Underhållsåtkomsten tas bort, adresserna på zap.cloud raderas och konfigurationen återställs. Coolify och dina appar fortsätter att köras på servern. Om du vill hantera dem igen i kontrollpanelen konfigurerar du One-Click-appar på nytt med en annan IP-adress. |
| Uppsägning eller avslutat avtal | Underhållsåtkomsten och adresserna på zap.cloud tas bort. |
| Meddelande eller problem | Lösning |
|---|---|
| Ingen SSH-anslutning efter några minuter | Kontrollera att SSH-servern körs och att brandväggen tillåter anslutningar till SSH-porten |
| Portarna används redan | Stoppa tjänsterna på portarna 8000, 6001, 6002 och 8080 eller installera om servern |
| Coolify är redan installerat | ZapX kan inte ta över en Coolify-installation med egen inloggning. Ta bort den eller använd ett nyinstallerat system |
| Din SSH-server tillåter bara vissa användare (AllowUsers) | Lägg till zapx-apps i SSH-konfigurationen och kör kommandot igen |
| En installation pågår på servern | Vänta tills installationen under fliken Installation är klar |
| Servern har ännu ingen offentlig IPv4-adress | Konfigurera först en offentlig IPv4-adress för servern |
| För många försök | Vänta några minuter och skapa sedan kommandot på nytt |
Mer information om en misslyckad konfiguration finns i /var/lib/zapx-oneclick-apps/setup.log. Om du inte kommer vidare skapar du ett supportärende och anger felmeddelandet från fliken.
Föredragen källa hos Google
