Hizmet ve depolama

Güncellenme: 10 Kasım 2026

konsolity serve, hesabın Claude bağlayıcısının isteklerini masaüstü uygulamasının yapacağı gibi, ancak arayüz olmadan işler: Claude, bilgisayarınız kapalıyken bile makinenin kapsamı ve kuralları dahilinde sunucularınızda işlem yapabilir. mcp alanını ve Studio planının Claude entegrasyonunu gerektirir; ayrıca Claude bağlayıcısı Claude'a önceden eklenmiş olmalıdır.

Ön planda deneme

konsolity serve

Komut ön planda kalır ve işlenen veya reddedilen her isteği gösterir. Ctrl+C onu durdurur. Gerçek bir sunucu için hizmet olarak kurun.

Linux: systemd

sudo konsolity service install

Komut:

  • kabuğu ve parolası olmayan konsolity sistem kullanıcısını oluşturur;
  • otomatik yeniden başlatma (Restart=always) ve systemd yalıtımıyla (ProtectSystem=strict, NoNewPrivileges=yes) konsolity.service birimini kurar;
  • yapılandırmayı /etc/konsolity/ içinde, durumu /var/lib/konsolity/ içinde saklar;
  • gizli bilgileri systemd-creds ile şifreler (aşağıya bakın);
  • programı /usr/local/bin/konsolity konumuna kopyalar (korumalı alan /home dizinini hizmetten gizler);
  • günde iki kez imzalı sürümü denetleyen, programı güncelleyen ve hizmeti yeniden başlatan konsolity-update.timer zamanlayıcısını kurar;
  • hizmeti etkinleştirir ve başlatır.

Hizmet sistemle birlikte başlar ve bir hatadan veya ağ kesintisinden sonra kendiliğinden yeniden başlar. Günlükleri:

journalctl -u konsolity
journalctl -u konsolity -f

Birden çok sunucu: ana aktarıcı ve yedek

Konsolity CLI'yi iki veya daha fazla sunucuda, her birinde service install ile etkinleştirin. Her Claude isteğini tek bir aktarıcı işler: önceliği en yüksek olan (Ayarlar › Claude › Claude aktarıcıları). Diğerleri, açık bir uygulama ya da Mac olmadan yedekte bekler.

Ana aktarıcı düzgün durursa sıradaki bir saniye içinde devralır. Haber vermeden düşerse sıradaki, yanıtsız kalan bir isteği 6 saniye sonra, üçüncüsü 12 saniye sonra devralır. Bir istek asla iki kez çalıştırılmaz. Günlük her makinenin rolünü gösterir: "Etkin aktarıcı" veya "Yedekte".

Yedek aktarıcının komutları da devralması için kurallarının komutlara izin vermesi gerekir (Ayarlar › CLI makineleri › makine › Kurallar). Aksi halde yalnızca okumaları devralır (sunucular, snippet'ler, oturumlar).

macOS: launchd

sudo konsolity service install

Otomatik olarak yeniden başlatılan (KeepAlive) com.konsolity.cli launchd hizmetini kurar. Gizli bilgiler anahtar zincirinde saklanır. Günlükler Konsol uygulamasındadır.

Windows: zamanlanmış görev

Yönetici olarak açılmış bir PowerShell'de:

konsolity service install

Windows başladığında konsolity serve komutunu başlatan ve bir hatadan sonra yeniden başlatan bir zamanlanmış görev oluşturur.

Doğrulama

konsolity status

status, makinenin erişilebilir olup olmadığını, belirtecin yaşını, kapsamı ve erişilebilir sunucu sayısını bildirir. Makine, son bir dakika içinde yaşam belirtisi verdiği sürece CLI makineleri listesinde çevrimiçi olarak görünür.

Klasörler

Yol İçerik
~/.config/konsolity/ Linux ve macOS, hizmetsiz kullanım: config.json ve gizli bilgiler
%APPDATA%\Konsolity\cli\ Windows: config.json ve credentials.bin
/etc/konsolity/ Linux hizmeti: yapılandırma
/var/lib/konsolity/ Linux hizmeti: şifreli gizli bilgiler ve durum

config.json (sunucu adresi, makinenin tanımlayıcısı ve adı, gösterilen kapsam) 0600 izinlidir. Hiçbir gizli bilgi içermez.

Gizli bilgilerin depolanması

Makinenin gizli bilgileri belirteci ve makine anahtarıdır. Sisteme göre şu şekilde saklanırlar:

Sistem Depolama
macOS Anahtar zinciri (com.konsolity.cli öğesi)
Linux, hizmet olarak systemd-creds encrypt, makinede varsa TPM ile, yoksa ana bilgisayar anahtarıyla
Linux, systemd-creds olmadan credentials.bin dosyası, 0600
Windows credentials.bin içinde DPAPI (geçerli kullanıcı), erişim yalnızca bu hesapla sınırlı

Her durumda içerik önce makine tanımlayıcısından türetilen bir anahtarla şifrelenir: başka bir bilgisayara kopyalandığında okunamaz. Gizli bilgiler hiçbir zaman bir günlükte, bir komut satırı bağımsız değişkeninde veya bir ortam değişkeninde görünmez; tek istisna, uzun ömürlü bir belirteç için sağlamayı seçtiğiniz KONSOLITY_TOKEN değişkenidir.

Belirtecin otomatik yenilenmesi

Bir makinenin belirteci kesinti olmadan her 24 saatte bir otomatik olarak yenilenir: eski belirteç, yenisiyle yapılan ilk çağrıya kadar, en fazla 10 dakika boyunca kabul edilmeye devam eder. Yenilemeyi zorlamak için (bir yedeği geri yükledikten sonra, makinede üçüncü bir kişi çalıştıktan sonra):

konsolity rotate

Uzun ömürlü belirteçler (setup-token) otomatik olarak yenilenmez; en geç bir yıl sonra sona ererler.

Hizmeti kaldırma

sudo konsolity service uninstall

Hizmet durdurulur ve kaldırılır. Makine hesabınızda etkin kalır: bağlantısını da kesmek için konsolity logout komutunu çalıştırın veya makineyi CLI makineleri listesinden iptal edin.