Connector çevrimdışı görünüyor

Kurulum komutu çalıştı ama konsolda hiç Online olmadı — ya da bir süre çevrimiçiydi, sonra düştü.

Belirti

Infrastructure → Connectors altında connector Offline kalıyor ya da Pending pairing görünüyor. Bu connector üzerinden yayınlanan bir kaynağı açan tedarikçi 502 alıyor. Daha önce çevrimiçi olan bir connector'ın Last seen zamanı ilerlemiyor olabilir.

Önce şunlara bakın

Connector'ın çalıştığı makinede kendi günlüğünü okuyun: docker logs --tail 50 access-connector. Bu sayfadaki sebeplerin neredeyse hepsi orada adıyla görünür.
Üç konteynerin de ayakta olduğunu doğrulayın: docker ps çıktısında access-connector, captivo-guacd ve captivo-kasm görünmeli.
Aynı makineden tünel adresinin HTTPS üzerinden yanıt verdiğini doğrulayın: Cloud'da curl -sI https://connect.cloud.captivo.io, kendi sunucunuzda curl -sI https://connect.access.<alan-adınız>.

Olası sebepler

Tünel adresi yanlış (ws yerine wss)

Nasıl anlaşılır: Günlükte DATAPLANE_URL'ye yapılan bağlantı hatası var: bağlantı reddi, TLS hatası ya da düz metin ws:// adresinin kabul edilmediği yazıyor. Konsol connector'ı hiç görmemiş.

Çözüm: Tünel adresi wss:// ile başlamalı ve connect adresine gitmeli: Cloud'da wss://connect.cloud.captivo.io, kendi sunucunuzda wss://connect.access.<alan-adınız>. ws:// tüneli trafiği şifresiz taşır ve kabul edilmez. Komutu elle yazmayın; Infrastructure → Connectors sayfasından hazır doldurulmuş hâliyle yeniden kopyalayın (bkz. komutu çalıştırma).

Makine dışarıya 443 çıkamıyor

Nasıl anlaşılır: Yukarıdaki curl denemesi askıda kalıyor ya da başarısız oluyor; günlükte red değil zaman aşımı var. Makine kurumsal bir proxy ya da yalnızca listeli hedeflere izin veren bir çıkış güvenlik duvarının arkasında.

Çözüm: Connector içeri doğru hiçbir şeye ihtiyaç duymaz ama iki ada dışarı doğru TCP 443 ister: tünel adresi (connect.…) ve konsol (MANAGER_URL). Ağ ekibinden ikisini de connector makinesinden serbest bırakmasını isteyin. TLS içeriğine bakan bir proxy WebSocket tünelini bozar; bu iki adresi incelemeden muaf tutun.

Eşleme kodu kullanılmış ya da süresi dolmuş

Nasıl anlaşılır: Günlükte kaydın başarısız olduğu ya da eşleme kodunun reddedildiği yazıyor. Genelde komut ikinci kez, ikinci bir makinede ya da kopyalandıktan günler sonra çalıştırılmıştır.

Çözüm: Eşleme kodu tam olarak bir kez çalışır. Infrastructure → Connectors altında connector'ı açın, Re-pair ile yeni bir komut alın ve onu çalıştırın. Niyetiniz ikinci bir connector ise yenisini ekleyin; her birinin kendi kodu ve kendi token hacmi vardır.

Veri hacmi kayboldu, token gitti

Nasıl anlaşılır: Çevrimiçi olan bir connector, biri konteyneri yeniden oluşturduktan sonra çevrimdışı kaldı. Günlükte saklı token olmadığı ve kayıt için eşleme kodu bulunmadığı yazıyor.

Çözüm: Token, access_connector_data hacminde /data/token yolunda durur. Bu hacim olmadan yapılan docker rm ya da farklı bir hacim adı veren bir çalıştırma komutu onu kaybeder. Konsoldan yeniden eşleyin ve hacim adını konsolun komutundaki gibi bırakın. Aynı hacim oturum kayıtlarını ve recording.key dosyasını da taşır; hacim gittiyse onlar da gitmiştir (bkz. veri dizini ve yedek).

Konteynerin biri çalışmıyor

Nasıl anlaşılır: docker ps üçten az konteyner gösteriyor. access-connector yoksa konsol Offline der. Yalnızca captivo-guacd ya da captivo-kasm eksikse connector Online kalır ama uzak masaüstü veya izole tarayıcı oturumları açılmaz.

Çözüm: Duran konteyneri docker start <ad> ile başlatın ve neden çıktığını günlüğünden okuyun (disk dolu, makinede port çakışması, gerekli özelliği olmayan bir çekirdek). Bir konteyner silinmişse konsolun kurulum komutunu yeniden çalıştırın; üçünü de ortak ağda yeniden oluşturur. Yalnızca motor sorunları için bkz. uzak masaüstü oturumu açılmıyor.

Sürüm eski (Outdated)

Nasıl anlaşılır: Konsolda connector'ın yanında Outdated rozeti var. Konsol güncellendikten sonra eski bir connector bağlanabilir ama yeni kontrol mesajlarını reddeder ya da sürekli düşüp yeniden bağlanır.

Çözüm: Güncel imajı çekip konteyneri yeniden oluşturun: docker pull ghcr.io/captivo-io/captivo-access-connector:latest, ardından Infrastructure → Updates altında gösterilen yeniden oluşturma komutu. Hacimdeki token kalır, yeniden eşleme gerekmez (bkz. güncelleme). Bu arada makinenin saatine de bakın: dakikalarca sapmış bir saat TLS el sıkışmasını bozar.

İstek düzeyinde ayrıntı için connector'ın sayfasını açıp Logging ayarını Debug yapın; Recent logs kuyruğu her bağlantı denemesini gösterir. İşiniz bitince Info'ya geri alın.

Hâlâ çözülmediyse

docker logs access-connector çıktısının son 50 satırı
Connector makinesinde docker ps çıktısı
connect adresine yapılan curl denemesinin sonucu
Makinenin proxy ya da TLS incelemesi arkasında olup olmadığı
Live telemetry altında görünen connector sürümü