thecr3w-dev/docs/TROUBLESHOOTING.md

THECR3W-DEV — PRZEWODNIK ROZWIĄZYWANIA PROBLEMÓW (TROUBLESHOOTING)

Wersja: 1.0.0 | Data: 2026-10-31

---

1. Problemy z Połączeniem i Caddy Reverse Proxy

Objaw: Błąd 502 Bad Gateway pod app.thecr3wnet.com lub download.thecr3wnet.com

• Przyczyna: Kontener thecr3w-backend lub thecr3w-download-center nie jest uruchomiony albo nie jest podłączony do sieci Docker proxy.
• Diagnostyka:

  docker ps -a --filter "name=thecr3w"
  docker network inspect proxy --format '{{range $k, $v := .Containers}}{{$v.Name}} {{end}}'
  

• Rozwiązanie: Upewnij się, że usługa działa i jest w sieci proxy:

  docker network connect proxy thecr3w-backend
  

---

2. Błędy Weryfikacji Podpisu Ed25519 w Aplikacjach Klienckich

Objaw: SDK wyrzuca wyjątek CryptographicException: Błąd integralności pliku

• Przyczyna: Pobrany plik z R2 ma inny hash SHA256 niż zarejestrowany w bazie lub klucz publiczny w aplikacji nie zgadza się z kluczem prywatnym serwera.
• Diagnostyka:
  1. Pobierz plik ręcznie i wylicz SHA256:

     sha256sum plik.apk
     

  2. Sprawdź zarejestrowany hash w API:

     curl https://app.thecr3wnet.com/api/v1/apps/{app_id}/releases/{release_id}
     

  3. Odpytaj endpoint klucza publicznego:

     curl https://app.thecr3wnet.com/api/v1/keys/signing-public-key
     

---

3. Błędy Wygasania Adresów Pobierania Cloudflare R2

Objaw: Błąd HTTP 403 Forbidden lub Expired przy pobieraniu artefaktu

• Przyczyna: Pre-signed S3 URL wygasł (standardowy czas ważności wynosi 15 minut) lub zegar systemowy serwera/klienta ma desynchronizację czasową.
• Rozwiązanie:
  • Ponowne wywołanie endpointu pobierania w celu wygenerowania świeżego URL.
  • Weryfikacja synchronizacji NTP na serwerze: timedatectl status.