Self-hosting Ionide
Co robi instalator, czego od Ciebie potrzebuje i jak aktualizować lub przekonfigurować bota.
Bot Ionide działa wyłącznie w modelu self-hosted. Nie ma wersji hostowanej przez nas. Ta strona opisuje, co robi instalator i jak zarządzać kontenerem później. Pełny przewodnik krok po kroku znajdziesz w Pierwszych krokach.
Pierwszy raz z self-hostingiem? To po prostu oznacza uruchomienie bota na maszynie, którą kontrolujesz, zamiast usługi, którą prowadzimy za Ciebie. Tani VPS (koszt i wymagania poniżej) w zupełności wystarczy — nie musi być mocny, wystarczy, że jest online zawsze, gdy chcesz, aby Ionide aktywnie zarządzał pozycjami.
Wymagania
- Host z Linuksem i Dockerem (instalator zaoferuje instalację Dockera, jeśli go brakuje).
- Aplikacja bota Discord i token (zobacz niżej, jeśli jeszcze go nie masz).
Jaki serwer wybrać?
Wybierz mały VPS z Linuksem. Nie musisz rozumieć Dockera, Javy, heapów pamięci ani ustawień kontenerów — instalator zajmuje się tym za Ciebie.
- Pamięć RAM: minimum 512 MB; zalecane 1 GB. To daje wygodny zapas dla bota i Dockera.
- Dysk: minimum 5 GB wolnego miejsca; zalecane 10 GB na aktualizacje i zwykłe pliki Dockera.
- CPU: wystarczy jeden wirtualny rdzeń.
- Sieć: serwer powinien być online, gdy chcesz, aby Ionide monitorował pozycje i nimi zarządzał.
Sam bot używa mało miejsca: na serwerze zostają zaszyfrowane dane giełdowe, stan aktywacji i małe dane operacyjne. Dodatkowy zapas dysku jest dla obrazów i aktualizacji Dockera, nie dla dużej lokalnej bazy historii transakcji.
W praktyce podstawowy VPS za 4–5 USD/mies. z 1 GB RAM i 10 GB dysku w zupełności wystarczy.
Darmowe opcje VPS
Zużycie zasobów Ionide jest na tyle małe, że mieści się w darmowych na stałe tierach niektórych dostawców, nie tylko w płatnych okresach próbnych:
- Oracle Cloud "Always Free" — instancja Ampere ARM (4 OCPU / 24 GB RAM) jest darmowa na stałe, znacznie więcej niż potrzebuje Ionide. Wymaga podania karty przy rejestracji, mimo że nic nie jest pobierane w darmowym tierze, a Oracle bywa znany z odzyskiwania bezczynnych darmowych instancji w niektórych regionach przy zbyt niskim użyciu, albo z czasowego braku dostępnej pojemności w popularnych regionach.
- Google Cloud "Always Free" — jedna instancja
e2-micro(1 GB RAM) jest darmowa na stałe, ale tylko w konkretnych regionach USA (us-west1,us-central1,us-east1). Mieści się w wymaganiach Ionide bez problemu. - AWS Free Tier oraz darmowy okres próbny Azure — obie oferują małą instancję tylko przez 12 miesięcy, potem naliczają normalne opłaty. Dobre do testów, nie stanowią stałej darmowej opcji.
Kompromis: darmowe tiery nie mają gwarantowanego SLA dostępności, jaki płatny VPS zapewnia efektywnie dzięki reputacji i wsparciu dostawcy. Polityka odzyskiwania bezczynnych instancji Oracle w szczególności oznacza, że darmowa instancja może w praktyce zostać odebrana, jeśli wygląda na nieużywaną — realne ryzyko dla bota, który ma działać bez nadzoru miesiącami. Płatny VPS za 4–5 USD/mies. to bardziej przewidywalny wybór do ciągłego, bezobsługowego zarządzania pozycjami; darmowy tier to rozsądny sposób, by najpierw wypróbować Ionide albo uruchomić go, jeśli sam monitorujesz dostępność.
Tworzenie tokenu bota Discord
- Przejdź do Discord Developer Portal i utwórz New Application.
- Otwórz zakładkę Bot, kliknij Reset Token i skopiuj token. Wkleisz go do instalatora.
Uruchomienie instalatora
curl -fsSL https://install.ionide.net | bash -s -- --lang pl
install-confirm::Skonfigurowano dla języka Polski — ustawia domyślny język Twojego samodzielnie hostowanego bota (można zmienić później w konfiguracji bota).
Instalator:
- Sprawdza obecność Dockera i oferuje jego instalację przez oficjalny skrypt instalacyjny Dockera, jeśli go brakuje.
- Pyta raz o token bota Discord.
- Generuje
SECRETS_ENCRYPTION_KEYi zapisuje obie wartości do lokalnego pliku.env. Ten klucz szyfruje Twoje sekrety API giełd w spoczynku. Zrób jego kopię zapasową — jego utrata oznacza utratę dostępu do wszystkich danych giełdowych zapisanych przez/secrets action:set. - Uruchamia bota i wznawia go po restarcie serwera. Lokalne dane bota zostają zachowane między aktualizacjami.
- Czeka, aż bot wejdzie online, i wypisuje link zaproszenia do Discorda zbudowany z tokenu bota.
- Wyświetla bieżący publiczny adres IPv4, jeśli opcjonalne jednorazowe sprawdzenie się powiedzie. Dodaj go do allowlisty klucza API giełdy tylko, gdy wiesz, że adres jest stały; nie jest on zapisywany ani wysyłany do Ionide. Zobacz Bezpieczeństwo i dane.
Zaproś bota za pomocą wypisanego linku, a następnie kontynuuj od połączenia konta.
Aktualizacja
Ionide aktualizuje się domyślnie sam. Co godzinę sprawdza nową wersję, a następnie instaluje ją, gdy jest bezpiecznie: żadna pozycja nie jest blisko likwidacji i rozliczenie finansowania nie jest tuż przed terminem. Przy zwykłych aktualizacjach nie musisz łączyć się z serwerem przez SSH.
Jeśli nowa wersja nie uruchomi się poprawnie, Ionide automatycznie wraca do poprzedniej wersji i
powiadamia właścicieli bota. Uruchom /update-check na Discordzie, gdy chcesz sprawdzić aktualizację
i zatwierdzić ją od razu zamiast czekać na następną bezpieczną aktualizację automatyczną.
Uruchom ponownie instalator tylko, aby naprawić instalację lub odświeżyć jej pliki konfiguracji. Zachowa token bota i klucz szyfrowania:
curl -fsSL https://install.ionide.net | bash -s -- --lang pl
install-confirm::Skonfigurowano dla języka Polski — ustawia domyślny język Twojego samodzielnie hostowanego bota (można zmienić później w konfiguracji bota).
Aby zmienić token bota Discord albo wygenerować nowy klucz szyfrowania, przekaż --reconfigure:
curl -fsSL https://install.ionide.net | bash -s -- --reconfigure
Gdzie co się znajduje
.env: token bota Discord i klucz szyfrowania./app/data(wolumen Dockera): lokalna baza danych bota, w tym zaszyfrowane dane giełdowe i stan aktywacji. Zrób kopię zapasową razem z kluczem szyfrowania, jeśli zmieniasz hosta.
Rozwiązywanie problemów
- Kontener nie wstaje / instalator zawiesza się w oczekiwaniu na niego: sprawdź
docker logs ionide-discord-botpod kątem błędów. Brakujący lub nieprawidłowy token bota to najczęstsza przyczyna. - Komendy nie odpowiadają w Discordzie: bot blokuje każdą komendę poza
/setup, dopóki licencja nie zostanie aktywowana. Najpierw uruchom/setup. - Nadal utknąłeś? Zapytaj na Discordzie.