From 12b878f4383d4b1908beab89b7d8b46aa6af0b70 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Orzech?= Date: Sun, 3 Aug 2025 13:17:11 +0200 Subject: [PATCH] Update README.md --- README.md | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 82 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 494a57e..8b940f2 100644 --- a/README.md +++ b/README.md @@ -50,9 +50,89 @@ AutoScript buduje kompleksowy ekosystem usług, gotowych do użycia zaraz po ins 2. Przejdź do sekcji **"B2 Cloud Storage"** > **"Buckets"** i stwórz nowy, prywatny bucket. 3. Przejdź do **"App Keys"** i wygeneruj nowy klucz aplikacyjny z dostępem do Twojego bucketa. Będziesz potrzebował `applicationKeyId` (jako `B2_ACCOUNT_ID`) oraz `applicationKey` (jako `B2_ACCOUNT_KEY`). -## 3. Instalacja (Szybki Start) +## 3. Instalacja: Od Zera do Działającej Platformy -Proces instalacji pozostaje taki sam jak w poprzednich wersjach, ale teraz wdraża znacznie więcej usług! +Ta sekcja to szczegółowy, kompletny przewodnik, który poprowadzi Cię od zera do w pełni działającej, bezpiecznej platformy. Wykonuj polecenia w podanej kolejności. Zakładamy, że zaczynasz od świeżo zainstalowanego serwera z systemem **Debian 12** lub **Ubuntu 22.04+**. + +### Krok 1: Pierwsze Połączenie z Serwerem + +Zaraz po stworzeniu serwera u swojego dostawcy hostingu, otrzymasz adres IP. Połącz się z serwerem jako użytkownik `root` za pomocą terminala SSH. Na swoim lokalnym komputerze (Linux, macOS, Windows z WSL lub Git Bash) wpisz: + +```bash +ssh root@ +``` + +Będziesz poproszony o hasło roota, które dostarczył Twój hostingodawca. + +### Krok 2: Pobranie AutoScript + +Będąc zalogowanym jako `root` na serwerze, Twoim pierwszym zadaniem jest instalacja `git` (jeśli go nie ma) i pobranie kodu AutoScript. Wszystkie poniższe komendy wykonujesz **na serwerze**. + +```bash +# Aktualizuje listę dostępnych pakietów i instaluje git +apt update && apt install -y git + +# Klonuje repozytorium do folderu /root/autoscript i przechodzi do niego +git clone https://github.com/pawelorzech/autoscript.git && cd autoscript +``` + +### Krok 3: Konfiguracja Platformy + +To najważniejszy krok, w którym definiujesz, jak będzie działać Twoja platforma. Musisz stworzyć plik konfiguracyjny i wypełnić go swoimi danymi. + +```bash +# Tworzy kopię pliku z przykładem +cp autoscript.conf.example autoscript.conf + +# Otwiera plik konfiguracyjny w prostym edytorze tekstu +nano autoscript.conf +``` + +Otworzy się edytor `nano`. Użyj strzałek, aby poruszać się po pliku. Uważnie wypełnij **wszystkie wymagane zmienne**, postępując zgodnie z instrukcjami z sekcji "Przewodnik Konfiguracyjny: Zdobywanie Kluczy". Zwróć szczególną uwagę na `PUBLIC_KEY`, `CF_DNS_API_TOKEN` oraz domeny dla poszczególnych usług. + +**Aby zapisać plik i wyjść z edytora `nano`:** +1. Naciśnij `Ctrl + X`. +2. Naciśnij `Y` (aby potwierdzić chęć zapisu). +3. Naciśnij `Enter` (aby potwierdzić nazwę pliku). + +### Krok 4: Walidacja Konfiguracji + +Zanim dokonasz jakichkolwiek zmian w systemie, uruchom walidację. Skrypt sprawdzi, czy klucze API są poprawne i czy może połączyć się z wymaganymi usługami. To Twoja siatka bezpieczeństwa. + +```bash +# Upewnij się, że jesteś w folderze /root/autoscript +sudo ./start.sh validate +``` + +Jeśli walidacja zakończy się sukcesem, jesteś gotowy do instalacji. Jeśli nie, skrypt poinformuje Cię, co należy poprawić w pliku `autoscript.conf`. + +### Krok 5: Uruchomienie Instalacji + +Wykonaj główną komendę instalacyjną. Skrypt zajmie się resztą. Usiądź wygodnie, proces może potrwać od kilku do kilkunastu minut. + +```bash +# Upewnij się, że jesteś w folderze /root/autoscript +sudo ./start.sh install +``` + +Skrypt zainstaluje wszystkie pakiety, skonfiguruje zabezpieczenia, wdroży wszystkie usługi w kontenerach Docker i połączy je w jeden sprawnie działający ekosystem. + +### Krok 6: Kroki Po Instalacji (Bardzo Ważne!) + +Gdy skrypt zakończy pracę, Twój serwer jest gotowy, ale jego zabezpieczenia zostały fundamentalnie zmienione: + +1. **Logowanie na `root` jest ZABLOKOWANE.** +2. **Port SSH został ZMIENIONY** na losowy numer z zakresu 10000-65535. Aby go poznać, wykonaj na serwerze: + ```bash + cat /root/ssh_port.txt + ``` +3. **Nowy użytkownik `admin` został stworzony.** Od teraz logujesz się tylko na to konto, używając swojego klucza SSH i nowego portu. Na **swoim lokalnym komputerze** wykonaj: + ```bash + ssh admin@ -p + ``` +4. **Konfiguracja 2FA (TOTP):** Przy pierwszej próbie użycia `sudo` (np. `sudo ls /root`), na ekranie pojawi się kod QR. Zeskanuj go aplikacją typu Google Authenticator lub Authy i **zapisz kody zapasowe w bezpiecznym miejscu!** Są one jednorazowe i niezbędne do odzyskania dostępu w razie utraty telefonu. + +Twoja platforma jest gotowa do użytku. Usługi będą dostępne pod domenami skonfigurowanymi w pliku `autoscript.conf`. ## 4. Przewodnik po Komendach