Dzięki One-Click Apps zainstalujesz na serwerze dedykowanym aplikacje takie jak Nextcloud, n8n, bazy danych czy narzędzia do monitorowania. Wybierzesz je z katalogu aplikacji i będziesz nimi zarządzać bezpośrednio w panelu ZapX. W tle działa Coolify — platforma open source do obsługi aplikacji w kontenerach.
W przeciwieństwie do VPS-a aplikacje One-Click na serwerze dedykowanym konfigurujesz samodzielnie tylko raz: tworzysz polecenie w panelu i uruchamiasz je na serwerze jako root. Resztą zajmuje się ZapX. Z tego poradnika dowiesz się, czego potrzebujesz na serwerze, jak przebiega konfiguracja, jak zarządzać aplikacjami i do czego ZapX wykorzystuje dostęp serwisowy do twojego serwera.
Twój serwer dedykowany musi spełniać te wymagania: Sprawdź je przed uruchomieniem polecenia. Polecenie samo je zweryfikuje i przerwie działanie bez wprowadzania zmian, jeśli coś się nie zgadza.
| Wymaganie | Minimum |
|---|---|
| System operacyjny | Debian lub Ubuntu z serwerem SSH |
| RAM | 2 GB |
| Procesor | 2 rdzenie |
| Wolne miejsce na dysku | 30 GB |
| Adres IP | Publiczny adres IPv4 skonfigurowany na serwerze |
| Wolne porty | 8000, 6001, 6002 i 8080 (twoje aplikacje będą potrzebować portów 80 i 443) |
| SSH | Port SSH twojego serwera musi być dostępny dla ZapX |
Zalecamy świeży system operacyjny: Najlepiej skonfiguruj aplikacje One-Click na świeżej instalacji Debiana lub Ubuntu. Usługi, które już zajmują porty, własna konfiguracja Dockera lub wcześniej zainstalowane Coolify z osobnym loginem spowodują przerwanie konfiguracji. Ponowną instalację uruchomisz w zakładce Instalacja swojego serwera dedykowanego.
Host Proxmox i Windows: Nie możesz skonfigurować aplikacji One-Click bezpośrednio na hoście Proxmox. Zamiast tego użyj maszyny wirtualnej na serwerze, która korzysta z jednego z adresów IP twojego serwera. System Windows nie jest obsługiwany.
Tylko właściciel serwera może skonfigurować aplikacje One-Click.
Otwórz swój serwer dedykowany w panelu ZapX i przejdź do zakładki One-Click Apps. Znajdziesz tam kartę Skonfiguruj One-Click Apps.
Wybierz dwie wartości:
- Adres IP panelu i aplikacji: Znajdziesz tu publiczne adresy IPv4 swojego serwera. Adres główny jest oznaczony. Pod tym adresem będą później dostępne panel Coolify i twoje aplikacje.
- Adres e-mail administratora Coolify: Za pomocą tego adresu e-mail zalogujesz się do panelu Coolify.
Następnie kliknij Utwórz polecenie. ZapX przygotuje adres panelu. Może to potrwać do minuty.
Zaloguj się na serwerze przez SSH jako root. Skopiuj wyświetlone polecenie za pomocą ikony kopiowania i uruchom je. Zaczyna się od curl -fsSL i kończy na | bash.
Jeśli na serwerze nie ma curl, najpierw zainstaluj go za pomocą polecenia:
apt update && apt install -y curl
Instalacja będzie kontynuowana w tle. Możesz zamknąć terminal.
Nie udostępniaj polecenia: Polecenie zawiera osobisty klucz przeznaczony dla tego serwera i jest ważne przez 24 godziny. Nie udostępniaj go nikomu. Jeśli potrzebujesz nowego polecenia, kliknij Anuluj instalację ręczną i utwórz je ponownie.
W zakładce zobaczysz postęp konfiguracji:
| Komunikat | Znaczenie |
|---|---|
| Czekamy, aż uruchomisz polecenie na serwerze. | Polecenie nie zostało jeszcze uruchomione |
| Połączono. Instalacja trwa na twoim serwerze. | ZapX instaluje Coolify. Zwykle trwa to do 10 minut |
| Coolify jest zainstalowane. Łączymy panel. | Ostatni krok, który trwa około minuty |
Jeśli po kilku minutach ZapX nadal nie może połączyć się z serwerem przez SSH, w zakładce pojawi się odpowiedni komunikat. Sprawdź wtedy, czy zapora sieciowa zezwala na przychodzące połączenia z portem SSH twojego serwera.
- Sprawdza system operacyjny, zasoby, adres IP i wolne porty. Jeśli coś się nie zgadza, przerywa działanie i wyświetla komunikat.
- Tworzy użytkownika
zapx-appsz uprawnieniami sudo. Za jego pośrednictwem ZapX zarządza Coolify i twoimi aplikacjami. Logowanie jest możliwe tylko za pomocą klucza ZapX i wyłącznie z adresów ZapX. Logowanie hasłem nie jest dostępne. - Instaluje Coolify za pomocą oficjalnego instalatora, który konfiguruje również Dockera.
- Na czas konfiguracji ZapX używa tymczasowo klucza root z mocno ograniczonymi uprawnieniami i w razie potrzeby modyfikuje konfigurację SSH. Oba elementy są usuwane po zakończeniu konfiguracji.
- Nie zmienia reguł zapory sieciowej.
Dziennik konfiguracji znajdziesz na serwerze w pliku /var/lib/zapx-oneclick-apps/setup.log.
Po zakończeniu konfiguracji w zakładce One-Click Apps zobaczysz trzy sekcje:
| Sekcja | Zawartość |
|---|---|
| Zainstalowane aplikacje | Twoje aplikacje, ich status i dostępne działania |
| Katalog aplikacji | Wszystkie aplikacje dostępne do instalacji |
| Dostęp i ustawienia | Adres panelu, dane logowania i dostęp serwisowy |
- Otwórz Katalog aplikacji i znajdź aplikację, której potrzebujesz.
- Kliknij Zainstaluj.
- W oknie Zainstaluj aplikację wpisz wymagane wartości, na przykład
[dein_appname]lub[deine_domain]. - Kliknij Dodaj instalację do kolejki.
Jeśli na serwerze brakuje RAM-u potrzebnego do uruchomienia aplikacji, w katalogu zobaczysz komunikat „Twój serwer ma za mało pamięci RAM dla tej aplikacji”.
Skorzystaj z pomocy agenta AI ZapX: Agent AI ZapX na twoim serwerze może polecić odpowiednią aplikację, sprawdzić status aplikacji lub przygotować instalację. Agent wprowadzi każdą zmianę dopiero po uzyskaniu twojego potwierdzenia. Dane logowania i inne poufne informacje edytujesz zawsze w zakładce One-Click Apps.
W sekcji Zainstalowane aplikacje możesz zarządzać każdą aplikacją bezpośrednio:
| Działanie | Cel |
|---|---|
| Uruchom | Uruchamia zatrzymaną aplikację |
| Zatrzymaj | Zatrzymuje działającą aplikację |
| Uruchom ponownie | Uruchamia aplikację ponownie |
| Dzienniki | Wyświetla dzienniki aplikacji, które pomogą znaleźć przyczynę problemu |
| Ustawienia | Zmienia zmienne środowiskowe, domenę i inne opcje aplikacji |
Karta Dostęp serwisowy informuje, czy ZapX może połączyć się z twoim serwerem:
| Status | Znaczenie |
|---|---|
| Aktywny | ZapX może połączyć się z serwerem i zarządzać Coolify oraz twoimi aplikacjami |
| Przerwany | ZapX nie może już połączyć się z serwerem, na przykład z powodu zmiany klucza hosta SSH lub odrzucania klucza ZapX |
| Usunięty | Usunięto dostęp serwisowy ZapX |
Po kliknięciu Usuń dostęp ZapX skasuje ze swojego serwera klucz, regułę sudo i użytkownika zapx-apps. Coolify i twoje aplikacje będą nadal działać, ale ZapX nie będzie już nimi zarządzać. Nie będzie można instalować aplikacji, rozwiązywać problemów ani wprowadzać zmian w panelu. W takiej sytuacji zarządzaj aplikacjami bezpośrednio w panelu Coolify.
Jeśli w chwili usuwania dostępu serwer jest niedostępny, ZapX zablokuje dostęp po swojej stronie. Użytkownika zapx-apps i plik /etc/sudoers.d/zapx-apps możesz wtedy usunąć samodzielnie na serwerze.
Kliknij Przywróć dostęp, aby utworzyć nowe polecenie, które skonfiguruje ponownie tylko dostęp serwisowy. Coolify i twoje aplikacje pozostaną bez zmian. Uruchom polecenie na serwerze jako root, tak jak podczas pierwszej konfiguracji.
| Zdarzenie | Co się stanie |
|---|---|
| Ponowna instalacja w zakładce Instalacja | Konfiguracja zostanie zresetowana, a adresy w domenie zap.cloud usunięte. System zostanie zainstalowany od nowa, dlatego wcześniej zabezpiecz dane aplikacji. Następnie skonfiguruj ponownie aplikacje One-Click. |
| Zwolnienie adresu IP panelu i aplikacji | Dostęp serwisowy zostanie usunięty, adresy w domenie zap.cloud skasowane, a konfiguracja zresetowana. Coolify i twoje aplikacje będą nadal działać na serwerze. Aby ponownie zarządzać nimi w panelu, skonfiguruj aplikacje One-Click z innym adresem IP. |
| Wypowiedzenie lub zakończenie umowy | Dostęp serwisowy i adresy w domenie zap.cloud zostaną usunięte. |
| Komunikat lub problem | Rozwiązanie |
|---|---|
| Brak połączenia SSH po kilku minutach | Sprawdź, czy serwer SSH działa i czy zapora sieciowa zezwala na połączenia z portem SSH |
| Porty są już zajęte | Zatrzymaj usługi korzystające z portów 8000, 6001, 6002 i 8080 albo ponownie zainstaluj serwer |
| Coolify jest już zainstalowane | ZapX nie przejmie istniejącej instalacji Coolify z osobnym loginem. Usuń ją albo użyj świeżego systemu |
| Serwer SSH zezwala na połączenia tylko wybranym użytkownikom (AllowUsers) | Dodaj zapx-apps do konfiguracji SSH i ponownie uruchom polecenie |
| Na serwerze trwa instalacja | Zaczekaj, aż instalacja w zakładce Instalacja zostanie zakończona |
| Serwer nie ma jeszcze publicznego adresu IPv4 | Najpierw skonfiguruj publiczny adres IPv4 na serwerze |
| Zbyt wiele prób | Zaczekaj kilka minut, a następnie utwórz polecenie ponownie |
Więcej informacji o nieudanej konfiguracji znajdziesz w pliku /var/lib/zapx-oneclick-apps/setup.log. Jeśli nadal nie możesz rozwiązać problemu, utwórz zgłoszenie do pomocy technicznej i podaj komunikat o błędzie z zakładki.
Preferowane źródło w Google
