Uzak Bağlantı

Makine bağlantısı, bir OpenCodex Home bilgisayarını bir Child bilgisayarına SSH üzerinden bağlar. Home, Child’a SSH tüneli üzerinden hizmet verir; iki bilgisayar da yerel OpenCodex hizmetini 10100 portunda tutar. Kontrol paneli Child’a özel bağlantı anahtarını SSH üzerinden aktarır, bu nedenle bir belirteç yazmanız gerekmez.

Gereksinimler

Home bilgisayarı, Child bilgisayarına OpenSSH anahtarıyla giriş yapabilir.
Child tarafından başlatılan bağlantı için Child, Home bilgisayarına OpenSSH anahtarıyla giriş yapabilmelidir (parola girişi desteklenmez).
Child bilgisayarında OpenCodex 2.66.0 veya sonrası kuruludur (Child tarafından başlatılan bağlantıda Home üzerinde de).
Her iki bilgisayar da macOS veya Linux çalıştırır.
Bağlantıyı başlatan kontrol paneli o bilgisayarın kendisinde (bağımsız kurulumda tarayıcı veya masaüstü uygulaması) ya da eşleştirilmiş bir Hub oturumu üzerinden açılır.

Parolalı SSH ve Windows mevcut akışın dışındadır. Bağlantı iki taraftan da başlatılabilir: aşağıda anlatıldığı gibi Home tarafından ya da “Bu bilgisayarı Child olarak bağlama” bölümünde anlatıldığı gibi Child tarafından.

`#remote` üzerinden Child ekleme

Kontrol panelinde #remote sayfasını açın ve Remote Link’i açın.
Home seçeneğini seçin, ardından Continue düğmesine basın. SSH ana bilgisayar listesi açılır.
SSH adaylarından bir ana bilgisayar seçin veya SSH yapılandırmasındaki diğer adı girin.
Bağlantı testini çalıştırın ve gösterilen ana bilgisayar parmak izini bağlanmak istediğiniz bilgisayarın parmak iziyle karşılaştırın. Karşılaştırma, SSH ana bilgisayara güvenmeden önce yanlış bilgisayarı veya değişmiş anahtarını fark etmenize yardımcı olur.
Parmak izini onaylayın, ardından Child’ı bağlayın.

Kontrol paneli belirteç girmenizi istemez. Önce ana bilgisayarı yoklar ve parmak izini açıkça onaylamadan bağlantıyı uygulamaz.

Bu bilgisayarı Child olarak bağlama

Home’un sağlayıcılarını kullanacak bilgisayarda:

Kontrol panelinde #remote sayfasını açın ve Remote Link’i açın.
Child seçeneğini seçin. SSH ana bilgisayar listesi açılır.
Home’un SSH ana bilgisayarını seçin, bağlantı testini çalıştırın, ardından ana bilgisayar parmak izini karşılaştırıp onaylayın.
Uyarıyı okuyun ve Connect as Child seçeneğini seçin.

Bağlanmak bu bilgisayardaki OpenCodex’i yeniden başlatır. Zaten çalışan Codex istekleri önce tamamlanır ve yeniden başlatma sırasında yeni istekler bir dakikaya kadar başarısız olabilir. Ardından kontrol paneli kendiliğinden yeniden yüklenir ve Child bağlantısını gösterir. Codex bu bilgisayarda http://127.0.0.1:<port>/v1 adresini kullanmaya devam eder ve belirteç veya ortam değişkeni ayarlamanız gerekmez: yerel OpenCodex her isteği Home’a aktarır, Home da kendi sağlayıcıları ve hesaplarıyla yanıt verir.

Child rolü yalnızca OpenCodex yapılandırılmış bağlantı noktasında çalışırken kullanılabilir, çünkü Child tam olarak o bağlantı noktasında yeniden başlar. Kontrol paneli OpenCodex’in yapılandırılmış bağlantı noktasında çalışmadığını söylerse önce onu o bağlantı noktasında yeniden başlatın.

Bağlantı durumu

Connected, SSH tünelinin hazır ve Child’ın Home bağlantısını kullanabilir olduğu anlamına gelir.
Reconnecting, tünelin yeniden denendiği anlamına gelir. Yeniden deneme sırasında istekler geçici olarak Retry-After ile birlikte 503 döndürebilir. Kendi panosundan bağlanan bir Child üzerinde istek önce tünelin geri gelmesi için en fazla 15 saniye bekler.
Failed, bağlantının ilgilenilmesi gerektiği anlamına gelir. SSH kimlik doğrulamasını, onaylanan ana bilgisayar anahtarını, yönlendirmeyi veya zaman aşımı nedenini kontrol edin. Kendi panosundan bağlanan bir Child; uyku, kesinti veya yeniden başlatmadan sonra kendiliğinden yeniden dener: zaman aşımı veya yönlendirme hatasından sonra yaklaşık dakikada bir, kimlik doğrulama hatasından sonra beş dakikada bir. Değişmiş bir ana bilgisayar anahtarı asla yeniden denenmez.

Bağlantı başarısız olduğunda sistem sessizce yerel bir sağlayıcıya geçmez.

Child’ı kaldırma

Child için Disconnect seçeneğini seçin ve diğer adı onaylayın. Home tüneli durdurur, Child’ın bağlantı anahtarını iptal eder ve kayıtlı bağlantı kaydını kaldırır.

Home, bağlantıyı kesme komutunu çalıştırmak için Child’a ulaşamıyorsa Remove here only seçeneğini seçin. Bu işlem yalnızca bu bilgisayardaki tüneli, anahtarı ve kaydı kaldırır. Ardından Child’a giriş yapıp şunu çalıştırın:

ocx disconnect

Child tarafından başlatılan bağlantıyı kesmek için Child üzerinde ocx disconnect komutunu çalıştırın. Komut istemci tünelinin bağlantısını keser ve SSH üzerinden Home üzerindeki bağlantıyı iptal eder. Home üzerindeki iptal başarısız olursa şu mesajı yazdırır: Home revoke failed; run ocx link revoke --link-id <linkId> on the home.

Güvenlik

Child, bağlantı üzerinden Home bilgisayarının sağlayıcılarını ve sağlayıcı kimlik bilgilerini kullanır. Home her Child için ayrı bir bağlantı anahtarı oluşturur; bağlantıyı kaldırmak bu anahtarı iptal eder. Onaylamadan önce ana bilgisayar parmak izini karşılaştırarak yanlış bilgisayarı veya değiştirilmiş anahtarı kabul etmediğinizden emin olun. Tailscale kimliğiyle verilen kontrol paneli oturumları makine bağlantılarını yönetemez. Child üzerinde anahtar OpenCodex içinde kalır: Codex veya Claude Code’un Child üzerinde gönderdiği kimlik bilgileri Home’a iletilmez ve Child üzerinde 127.0.0.1:<port> adresine ulaşan her program Home’u anahtarsız kullanır; bu, bağımsız bir kurulumun yerel programlara verdiği güvenle aynıdır. Başka sitelerden gelen web sayfaları reddedilir.

CLI başvurusu

ocx link port [--json]
ocx link issue --alias <alias> --tunnel-port <port> [--json]
ocx link status [--json]
ocx link revoke --link-id <id> [--json]