Sorun giderme

Sık karşılaşılan sorunlar ve çözümleri. Önce günlükleri kontrol edin — docker compose logs -f app — telefon numarası içermezler ama bağlantı durumunu gösterir; ve sağlık uç noktasını (curl -sf https://alan-adiniz/healthz → relay-ok).

Bir numara bağlanmıyor / "initializing"da takılı kalıyor

Numaralar'ı açın ve numarada Yeniden Bağla'ya tıklayın.
Takılı kalırsa, o numaranın günlüklerini kontrol edin; ana makinede yeterli boş RAM olduğunu (her numara ~400–800 MB gerektirir) ve docker-compose.yml içindeki app servisi için shm_size: "512mb" ayarlandığını doğrulayın (çok az paylaşımlı bellek Chromium'u çökertir).
Son çare olarak numarayı kaldırıp yeniden ekleyin (QR'ını yeniden tarayın).

QR kodu taranmıyor veya sürekli süresi doluyor

QR kodları kısa ömürlüdür — göründükten hemen sonra tarayın; süresi dolduysa, yenisini almak için Numaralar sayfasını yeniden yükleyin.
Numaranın sahibi olan telefondan tarayın: WhatsApp → Ayarlar → Bağlı cihazlar → Bir cihaz bağla.
Tarama başarılı olur ama hemen düşerse, telefon WhatsApp'ın bağlı-cihaz sınırına ulaşmış olabilir — eski bir bağlı cihazı kaldırıp yeniden deneyin.

Bir numara yeniden başlatmadan sonra çevrimdışı görünüyor

30–60 sn tanıyın — eşleşmeler wa_auth biriminden otomatik olarak yeniden bağlanır.
Çevrimdışı kalırsa Yeniden Bağla'ya tıklayın; bu başarısız olursa QR'ı yeniden tarayın. Bir eşleşme, sıcak yedekleme sırasında yazma aşamasındaysa bozulabilir.

Temsilci yanıt vermeye çalışırken "This number is offline"

Müşterinin numarasının bağlantısı kesiktir. Yanıtlar kasıtlı olarak müşterinin yazdığı numaradan çıkar (asla başka bir numaradan), bu yüzden o numarayı Numaralar altında yeniden bağlayın; yanıt gönderilecektir.

Yüksek bellek kullanımı / Chromium çökmeleri / uygulama kendini yeniden başlatıyor

Bağlı numara başına ~400–800 MB artı Node işlemi için bütçe ayırın. Ana makine yetersizse, daha az numara bağlayın veya RAM ekleyin.
app servisinde shm_size: "512mb" olduğundan emin olun. Chromium, çok az /dev/shm ile çöker.

Bir temsilci Raporları, Şablonları veya başka bir özelliği göremiyor

Bunlar temsilci başına verilen izinlerdir. Çalışma alanı yöneticisi olarak Ekip'i açın, temsilciyi düzenleyin ve yetkiyi verin (örn. Raporları gör, Şablonları yönet). Yeni temsilciler yalnızca yanıtla/kabul et/çöz ile başlar.

Gelen medya, görsel/dosya yerine bir yer tutucu gösteriyor

16 MB'tan büyük dosyalar indirilmez (tasarımı gereği yer tutucu).
60 günden eski medya, diskten tasarruf için budanmıştır (yer tutucu kalır).
Satır içi güvenli olmayan dosya türleri, satır içi gösterilmek yerine indirme olarak sunulur.

Gelen kutusu canlı güncellenmiyor

Canlı güncellemeler, 8 saniyelik bir yoklama yedeğiyle Server-Sent Events kullanır; böylece açık sohbet, SSE kesilse bile yenilenmeye devam eder. Hiçbir şey güncellenmiyorsa, nginx'in /inbox/events'i arabelleğe almadığını (gönderilen nginx.conf bunun için arabelleğe almayı devre dışı bırakır) ve tarayıcı sekmesinin hâlâ bağlı olduğunu doğrulayın (yeniden bağlanmak için sayfayı yeniden yükleyin).

Yeniden başlatmadan sonra herkes oturumdan çıkıyor / giriş döngüye giriyor

Bu, oturum imzalama gizli anahtarının değiştiği anlamına gelir. data/session-secret.txt kalıcı olmalı ve data/'nın geri kalanıyla birlikte geri yüklenmelidir. Var olduğunu ve yeniden oluşturulmadığını doğrulayın; kaybolduysa yedekten geri yükleyin (mevcut tüm oturumların yeniden giriş yapması gerekir).

Yönetici panelinden kilitlendiniz (parola veya TOTP kaybı)

Yönetici kimlik bilgileri data/auth.json içinde saklanır. İlk kurulumu yeniden çalıştırmak için:

docker compose exec app sh -c 'mv data/auth.json data/auth.json.bak'
docker compose restart app

Ardından /admin'e gidin — yeni bir yönetici parolası oluşturmanız ve yeni bir TOTP QR'ı taramanız istenecektir. (Çalışma alanı yöneticisi ve temsilci girişleri etkilenmez; bunlar users.json içinde bulunur.) Yeni girişin çalıştığını doğrulayana kadar .bak'ı saklayın.

Daha fazla ayrıntı almak

docker compose logs --since 1h app son bir saati gösterir. Bağlantı olayları, yeniden kuyruğa alma işlemleri ve medya/LID zaman aşımları günlüğe kaydedilir (asla telefon numarasıyla değil). Destek isterken ilgili satırları ekleyin.