Destek taleplerinde sık gördüğümüz bir grup hata: ERR_CONNECTION_RESET, ECONNRESET, “Client network socket disconnected before secure TLS connection was established” ve “stream disconnected before completion”. Bu hataların büyük çoğunluğu sunucu tarafında değil, cihazınız ile sunucu arasındaki ağ yolunda oluşur. Bu yazıda nedenlerini ve sistematik çözüm adımlarını bulacaksınız.
Bu hatalar ne anlama gelir?
- ECONNRESET / ERR_CONNECTION_RESET: Bağlantı, güvenli TLS el sıkışması tamamlanmadan koptu. Genellikle aradaki bir güvenlik katmanı (firewall, antivirüs, VPN, kurum ağı) bağlantıyı kesiyor.
- stream disconnected: İstek başladı, yanıt akışı (stream) tamamlanmadan bağlantı düştü. Uzun yanıtlarda ve araç çağrılarında ağ kopmalarına karşı hassastır.
- ERR_CONNECTION_TIMED_OUT: Paketler hiç ulaşmıyor — DNS, firewall veya ağ erişimi engelli.
- 502 / 503 / 504: Sunucu tarafı geçici yoğunluk. Nadirdir ve genelde kısa sürede düzelir.
1. Ağ değiştirerek test edin (en hızlı teşhis)
Telefonunuzdan mobil hotspot açıp aynı isteği deneyin. Sorun kayboluyorsa neden cihazınızın bağlı olduğu ağdadır (kurumsal/okul firewall’u, ISS, VPN). Bu, bize yazmadan önce sorunu doğru adrese yönlendirmenizi sağlar.
2. VPN ve proxy’yi kapatın (veya tersini deneyin)
VPN ve proxy’ler TLS bağlantısını kesip yeniden kurabilir. Sırayla deneyin:
- VPN açıksa kapatın, kapalıysa alternatif bir ağ deneyin.
- Sistem proxy’si varsa agent/CLI aracınızda
HTTP_PROXY/HTTPS_PROXYdeğişkenlerini geçici olarak devre dışı bırakın. - Şirket ağınız TLS denetimi (SSL inspection) yapıyorsa bu tür kopmalar çok yaygındır; kişisel ağda test edin.
3. Güvenlik yazılımları ve firewall
Antivirüs, ebeveyn kontrolü veya firewall yazılımları uzun süren bağlantıları kesebilir. Test için geçici olarak devre dışı bırakın veya istisna ekleyin:
api.noxery.net (443)
cdn.noxery.net (443)4. DNS ve IPv6 kaynaklı sorunlar
Bazı ağlarda IPv6 bağlantısı yarım çalışır ve kopmalara yol açar. Deneyebilecekleriniz:
- DNS’i
1.1.1.1veya8.8.8.8olarak değiştirin. - Sorun devam ederse istemci tarafında IPv6’yı geçici kapatıp test edin.
5. İstemci ayarlarını sağlamlaştırın
Ağınızda ara sıra kopma oluyorsa istemci tarafında dayanıklılığı artırın:
- Timeout’u artırın: uzun yanıtlarda varsayılan süre yetmeyebilir (örn. 300 saniye).
- Streaming açık kalsın, buffering kapalı olsun: SSE akışı, kopma olduğunda kaldığınız yeri daha iyi yönetir.
- Otomatik yeniden deneme ekleyin: ağ hatalarında 1-2 saniye bekleyip isteği tekrarlamak, tek seferlik kopmaların kullanıcıya yansımasını önler.
- Uzun sohbetleri bölün: çok büyük bağlamlar hem daha uzun sürer hem de kopma olasılığını artırır. Ajan dokümanlarındaki oturum yönetimi önerilerine göz atın.
6. Hatanın bizim tarafta olup olmadığını nasıl anlarız?
Bizde kayıt olup olmadığını ancak isteğin bize ulaşmasıyla görebiliriz. Kopma TLS el sıkışması aşamasındaysa sunucu loglarına hiç düşmez — bu da sorunun ağ yolunda olduğunu doğrular. Bize yazarken şunları ekleyin:
- Hatanın tam metni ve request id / Client Request Id (varsa)
- Hatanın oluştuğu saat ve saat dilimi
- Kullandığınız ağ (ev/okul/iş, VPN var mı) ve araç (Codex, OpenCode, kendi betiğiniz)
- Aynı ağda mobil hotspot ile test sonucu
Sorun devam ederse destek talebi açın veya Telegram grubumuza yazın. 429 hataları için ayrıca rate limit rehberimize bakabilirsiniz.