Troubleshooting: Inne problemy

Rozwiązywanie ogólnych problemów z platformą SGS Hub.

Problemy z logowaniem

Problem: "Invalid credentials" mimo prawidłowego hasła

Możliwe przyczyny:

1. Caps Lock włączony

• Sprawdź czy CAPS LOCK nie jest aktywny
• Hasła są case-sensitive (A ≠ a)

2. Spacje w haśle/emailu

• Przypadkowa spacja na początku/końcu
• Skopiuj-wklej może dodać spacje

3. Konto nieaktywowane

• Sprawdź email: "Verify your SGS Hub account"
• Kliknij link weryfikacyjny
• Link ważny 24h (po tym: Request new verification)

4. Hasło zmienione przez recovery

• Jeśli resetowałeś hasło: użyj NOWEGO hasła
• Sprawdź email z linkiem do zmiany hasła

Rozwiązanie:

1. Kliknij "Forgot password?"
2. Wpisz email
3. Sprawdź email (także SPAM folder)
4. Kliknij link → ustaw nowe hasło
5. Zaloguj się nowym hasłem

Problem: "Account locked" po wielu próbach

Przyczyna: 5+ nieudanych prób logowania w ciągu 15 minut.

Rozwiązanie:

• Auto-unlock: Po 30 minutach konto zostanie automatycznie odblokowane
• Manual unlock: Kliknij "Unlock account" w emailu (wysłany po zablokowaniu)
• Natychmiastowy unlock: Kontakt support@sgshub.eu z Subject: "Account locked - urgent"

Problem: 2FA kod nie działa

"Invalid 2FA code"

Sprawdź:

1. Czas na telefonie

Settings → Date & Time → Set automatically: ON

2FA kody są czasowe - jeśli zegar telefonu się różni, kody będą nieprawidłowe.

2. Kod wygasł Kody 2FA ważne 30 sekund. Poczekaj na nowy kod (odliczanie w aplikacji).

3. Używasz starego kodu Każdy kod działa tylko raz. Nawet jeśli odświeżysz stronę, potrzebujesz NOWEGO kodu.

Jeśli zgubiłeś telefon (brak dostępu do 2FA):

Opcja 1: Użyj kodu zapasowego

Login → 2FA screen → "Use backup code"
Wpisz jeden z 10 kodów zapisanych podczas setup 2FA

Opcja 2: Recovery przez email

Login → 2FA screen → "Lost access?"
Wyślemy link recovery (ważny 1h)
Kliknij link → wyłącz 2FA tymczasowo
Zaloguj się → skonfiguruj 2FA ponownie

Opcja 3: Kontakt support (24-48h weryfikacja)

Problemy z dashboardem

Problem: Dashboard nie ładuje się (biały ekran)

Diagnoza:

1. Sprawdź status platformy

Odwiedź: https://status.sgshub.eu
Sprawdź czy "Dashboard" = Operational

2. Console errors

Kliknij F12 (DevTools)
Zakładka Console
Szukaj red errors

Częste błędy:

Error	Przyczyna	Rozwiązanie
Failed to fetch	API down lub firewall	Sprawdź status.sgshub.eu, wyłącz VPN
ChunkLoadError	Outdated cache	Hard refresh (Ctrl+Shift+R)
Unauthorized (401)	Session wygasła	Wyloguj się → zaloguj ponownie
Script error	Ad blocker	Wyłącz ad blocker dla sgshub.eu

Uniwersalne rozwiązanie:

1. Ctrl+Shift+R (hard refresh)
2. Clear cache: Ctrl+Shift+Delete → Clear browsing data
3. Restart przeglądarki
4. Spróbuj incognito mode
5. Spróbuj innej przeglądarki

Problem: Dane w dashboardzie nie aktualizują się

Przykład: Uruchomiłeś serwer, ale Status wciąż pokazuje "STOPPED"

Przyczyna: Cache lub WebSocket disconnected.

Rozwiązanie:

1. Manual refresh

Kliknij przycisk "Refresh" (🔄) w prawym górnym rogu
Lub: F5

2. WebSocket reconnect

F12 → Console
Szukaj: "WebSocket connected"
Jeśli "WebSocket failed" → odśwież stronę

3. Clear localStorage

F12 → Application → Local Storage → https://sgshub.eu
Right-click → Clear
Odśwież stronę (F5)

Problem: UI elementy nie klikają się / brak reakcji

Przyczyna: JavaScript errors lub browser compatibility.

Sprawdź wspierane przeglądarki:

• ✅ Chrome 90+
• ✅ Firefox 88+
• ✅ Edge 90+
• ✅ Safari 14+
• ❌ Internet Explorer (not supported)

Rozwiązanie:

1. Zaktualizuj przeglądarkę do najnowszej wersji
2. Wyłącz extensions (szczególnie ad blockers)
3. Try incognito/private mode
4. Sprawdź F12 Console errors → wyślij do supportu

Problemy z płatnościami

Problem: Płatność odrzucona

"Payment failed" lub "Card declined"

Możliwe przyczyny:

1. Niewystarczające środki

• Sprawdź saldo karty
• Uwzględnij opłaty bankowe (conversion fee jeśli nie PLN)

2. Karta zablokowana dla płatności online

Zadzwoń do banku → odblokkuj transakcje internetowe
Niektóre banki blokują domyślnie (security)

3. 3D Secure verification failed

• Sprawdź SMS od banku
• Wprowadź kod weryfikacyjny w czasie (timeout 2 min)

4. Nieprawidłowe dane karty

• Numer karty: 16 cyfr bez spacji
• CVV: 3 cyfry z tyłu (Amex: 4 cyfry z przodu)
• Expiry date: MM/YY format

Alternatywne metody płatności:

Dashboard → Subscription → Change Payment Method
Wybierz: BLIK / Przelewy24 / PayPal

Problem: Podwójna płatność

Widzisz 2 transakcje za ten sam miesiąc

Przyczyna: Browser timeout → retry → duplicate charge.

Rozwiązanie:

1. Sprawdź Dashboard → Billing → Invoices
2. Jeśli 2 faktury na ten sam okres → duplicate
3. Kontakt: billing@sgshub.eu
   Subject: "Duplicate charge - refund request"
   Include: Invoice IDs
4. Refund w ciągu 3-5 dni roboczych

Problem: Brak faktury VAT

Sprawdź:

1. Czy ustawiłeś dane firmy

Dashboard → Settings → Billing Information
NIP: [wpisz]
Nazwa firmy: [wpisz]
Adres: [wpisz]
Save

2. Czy płatność została przetworzona

Dashboard → Billing → Transactions
Status: "Completed" ✅ (nie "Pending")

3. Sprawdź email

• Faktura wysyłana automatycznie po płatności
• Sprawdź folder SPAM
• Sender: noreply@sgshub.eu

Jeśli brak faktury >24h po płatności:

Email: billing@sgshub.eu
Subject: "Missing invoice"
Include: Transaction ID, data płatności

Problemy z API

Problem: API zwraca 401 Unauthorized

Przyczyny:

1. Brak header Authorization

# ❌ ŹLE
curl https://sgshub.eu/api/servers

# ✅ DOBRZE
curl -H "Authorization: Bearer sgshub_sk_live_..." \
  https://sgshub.eu/api/servers

2. Nieprawidłowy klucz API

• Sprawdź czy klucz nie wygasł: Dashboard → Wellness → API Keys
• Status: "Active" ✅
• Expires: 2026-01-01 (w przyszłości)

3. Klucz revoked (unieważniony)

• Jeśli rotowałeś klucz: użyj NOWEGO klucza
• Stary klucz przestaje działać po 7 dniach

Problem: API zwraca 429 Too Many Requests

"Rate limit exceeded"

Sprawdź limity:

curl -I https://sgshub.eu/api/servers \
  -H "Authorization: Bearer YOUR_KEY"

# Response headers:
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 0  ← wyczerpany
X-RateLimit-Reset: 1698336060  ← kiedy reset (Unix timestamp)

Rozwiązanie:

1. Poczekaj do reset

Reset time: 1698336060
Current time: date +%s
Różnica = ile sekund czekać

2. Zmniejsz częstotliwość zapytań

// ❌ ŹLE - 100 requests na raz
for (let i = 0; i < 100; i++) {
  await api.get('/servers');
}

// ✅ DOBRZE - delay między requests
for (let i = 0; i < 100; i++) {
  await api.get('/servers');
  await sleep(200); // 200ms delay = max 300 req/min
}

3. Użyj cachowania

// Cache server list na 30 sekund
const cache = new Map();
const CACHE_TTL = 30000;

async function getServers() {
  const cached = cache.get('servers');
  if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
    return cached.data;
  }

  const data = await api.get('/servers');
  cache.set('servers', { data, timestamp: Date.now() });
  return data;
}

Problemy z konsolą

Problem: Konsola nie pokazuje logów (pusta)

Przyczyny:

1. Serwer nie działa

Dashboard → Status: STOPPED

Uruchom serwer → logi pojawią się.

2. WebSocket disconnected

F12 Console → szukaj "WebSocket connection failed"

Refresh strony (F5).

3. Firewall blokuje WebSocket

Sprawdź czy możesz połączyć się:
wss://sgshub.eu/ws

Jeśli nie: skontaktuj się z IT (corporate firewall issue).

Problem: Nie mogę wysyłać komend do konsoli

"Command execution disabled"

Przyczyna: Funkcja dostępna tylko dla Pro+ plans.

Alternatywa (wszystkie plany):

Dashboard → Files → create file: execute.txt
Zawartość: SaveWorld
Save

(Serwer wykona przy następnym restarcie)

Lub upgrade do Pro:

Dashboard → Subscription → Upgrade to Pro

Powiązane strony

• Troubleshooting: Serwery
• Troubleshooting: Mody
• Troubleshooting: Pliki
• FAQ
• Support