Konfiguracja Coolify na serwerze Linux - Samodzielny hosting aplikacji w chmurze
Idealne produkty do tego poradnika
Zacznij od razu — zamów odpowiedni produkt i postępuj zgodnie z tym poradnikiem krok po kroku.
Wprowadzenie
Coolify to open-source’owa, samodzielnie hostowana alternatywa dla Heroku i Vercel, która pozwala łatwo zarządzać serwerami, aplikacjami i bazami danych.
Intuicyjny panel główny Coolify sprawia, że samodzielny hosting jest prosty. Daje Ci pełną kontrolę nad infrastrukturą, automatyczne wdrożenia z GitHub i pomaga utrzymać niskie koszty chmury.
W tym poradniku przeprowadzimy Cię krok po kroku przez proces konfiguracji, wstępnego ustawienia konta administratora i wszystkiego, co musisz wiedzieć.
Zastosowania Coolify
Coolify sprawdzi się w wielu codziennych scenariuszach i jest idealne dla każdego, kto chce zautomatyzować wdrożenia aplikacji, hostować bazy danych lub uruchamiać background workery. Coolify jest świetne zarówno dla początkujących, jak i ekspertów.
Coolify oferuje wbudowane wsparcie dla wdrażania Static Sites, Node.js, Python, PHP, Rust oraz kontenerów Docker. Ma modne szablony jednym kliknięciem, takie jak WordPress, Ghost, Grafana, Appwrite, Nextcloud i bazy danych PostgreSQL. Automatycznie obsługuje certyfikaty SSL Let's Encrypt oraz routing reverse proxy przez Traefik.
Przygotowanie
Choć Coolify jest lekkie w podstawie, zużycie zasobów może znacznie wzrosnąć w zależności od liczby wdrożonych aplikacji, budowanych kontenerów Docker i działających baz danych jednocześnie. Zalecamy następujące wymagania sprzętowe, aby hostować Coolify na Twoim VPS/serwerze dedykowanym.
| Sprzęt | Minimum | Zalecane |
|---|---|---|
| CPU | 2 rdzenie vCPU | 4 rdzenie vCPU |
| RAM | 2 GB | 4 GB+ |
| Miejsce na dysku | 30 GB | 50 GB+ |
Przed instalacją Coolify musisz połączyć się z serwerem i upewnić się, że system operacyjny jest aktualny. Połącz się z serwerem przez SSH z uprawnieniami root. Mamy już poradnik o pierwszym dostępie przez SSH, jeśli potrzebujesz pomocy.
Zdecydowanie polecamy skonfigurowanie klucza SSH zamiast hasła jako metody uwierzytelniania. Dowiedz się, jak to zrobić, korzystając z naszego poradnika konfiguracji klucza SSH.
Instalacja
Po połączeniu z serwerem zaktualizuj pakiety systemowe i zainstaluj curl, który jest potrzebny do pobrania skryptu instalacyjnego Coolify:
sudo apt update && sudo apt upgrade -y && sudo apt install curl -y
Przygotuj dane administratora
Coolify wymaga ścisłych zasad bezpieczeństwa dla konta administratora. Przed uruchomieniem instalacji przygotuj dane użytkownika root zgodnie z poniższymi wymaganiami:
- Nazwa użytkownika
- Minimum 3 znaki
- Maksimum 255 znaków
- Może zawierać tylko litery, cyfry, spacje, podkreślenia i myślniki
- Email
- Musi być prawidłowym adresem email
- Musi mieć poprawny rekord DNS
- Maksymalnie 255 znaków
- Hasło
- Minimum 8 znaków
- Musi zawierać wielkie i małe litery
- Musi zawierać co najmniej jedną cyfrę
- Musi zawierać co najmniej jeden znak specjalny
- Nie może być powszechnie używanym lub wyciekłym hasłem
Uruchom skrypt instalacyjny
Coolify oferuje szybki, zautomatyzowany skrypt instalacyjny. Aby zabezpieczyć instalację, użyjemy zmiennych środowiskowych do zdefiniowania konta administratora root. Zapobiega to nieautoryzowanemu dostępowi podczas konfiguracji.
Uruchom poniższe polecenie, pamiętając, aby podmienić nazwę użytkownika, email i hasło na swoje bezpieczne dane:
env ROOT_USERNAME=zaphosting ROOT_USER_EMAIL=info@zap-hosting.com ROOT_USER_PASSWORD=zaphosting bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
Kod źródłowy skryptu instalacyjnego znajdziesz w oficjalnym repozytorium Coolify
Skrypt automatycznie zainstaluje Dockera, skonfiguruje potrzebne sieci i ustawi kontenery Coolify. Proces może potrwać kilka minut, w zależności od sprzętu serwera.
Dostęp do Coolify
Po zakończeniu instalacji następnym krokiem jest dostęp do panelu głównego przez przeglądarkę. Wpisz adres IP serwera wraz z portem 8000: http://[twoj_adres_ip_serwera]:8000
Ponieważ podałeś już dane logowania podczas instalacji, zobaczysz od razu ekran logowania, a nie kreatora konfiguracji.
Wprowadź email i hasło, których użyłeś w poleceniu, aby zalogować się do panelu.
Konfiguracja rekordów DNS
Po zalogowaniu do panelu Coolify pierwszą rzeczą, którą powinieneś zrobić, jest ustawienie własnej domeny. Dostęp do Coolify przez adres IP (http://[twoj_adres_ip_serwera]:8000) jest niebezpieczny.
Podłączenie domeny pozwala Coolify automatycznie generować darmowe certyfikaty SSL dla panelu i wszystkich przyszłych aplikacji.
Wejdź na stronę zarządzania DNS u swojego dostawcy domeny i dodaj dwa nowe rekordy A wskazujące na Twój serwer. Jeśli Twoja domena jest zarejestrowana w ZAP-Hosting, możesz skorzystać z naszego poradnika Rekordy domeny, aby łatwo dodać te wpisy:
| Nazwa / Host | Typ | Wartość | TTL |
|---|---|---|---|
@ | A | [twoj_adres_ip] | Auto / Najniższy |
* | A | [twoj_adres_ip] | Auto / Najniższy |
- Rekord
@pozwala Coolify korzystać z głównej domeny - Rekord
*(wildcard) umożliwia Coolify automatyczne kierowanie dowolnej nowej subdomeny (np.api.[twoja_domena]) bez konieczności dodawania rekordów DNS dla każdego projektu.
Konfiguracja domeny instancji
Aby zabezpieczyć instancję Coolify certyfikatem SSL, przypisz do niej domenę. Przejdź do Ustawienia w lewym pasku bocznym i znajdź pole Instance Domain. Wpisz swoją domenę wraz z prefiksem https:// (np. https://coolify.[twoja_domena]). Kliknij Zapisz, aby zakończyć ten krok.
Wdrożenie pierwszej aplikacji
Po tym możesz przejść do zakładki Projekty i zacząć wdrażać swoją pierwszą aplikację!
Kliknij + Dodaj zasób, aby dodać publiczne repozytorium lub plik Docker Compose albo wybierz jeden z wielu prekonfigurowanych serwisów z biblioteki szablonów jednym kliknięciem. Twoja instalacja Coolify jest gotowa!
Podsumowanie i dodatkowe materiały
Gratulacje! Udało Ci się zainstalować Coolify na serwerze i możesz od razu zacząć wdrażać swoje projekty. Polecamy też rzucić okiem na poniższe materiały, które mogą pomóc i wesprzeć Cię podczas konfiguracji serwera.
- coolify.io - Oficjalna strona
- coolify.io/docs - Dokumentacja Coolify
Masz pytania, które nie zostały tu poruszone? Jeśli potrzebujesz dalszej pomocy, śmiało kontaktuj się z naszym supportem, który jest dostępny codziennie, by Ci pomóc! 🙂