49 lines
1.8 KiB
Markdown
49 lines
1.8 KiB
Markdown
# 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:**
|
|
```bash
|
|
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`:
|
|
```bash
|
|
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:
|
|
```bash
|
|
sha256sum plik.apk
|
|
```
|
|
2. Sprawdź zarejestrowany hash w API:
|
|
```bash
|
|
curl https://app.thecr3wnet.com/api/v1/apps/{app_id}/releases/{release_id}
|
|
```
|
|
3. Odpytaj endpoint klucza publicznego:
|
|
```bash
|
|
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`.
|
|
|