SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

VPS uzerinde DeepSeek Harness kurulumu ve guvenlik

DeepSeek Harness aracini Linux VPS uzerinde guvenli sekilde calistirin. npm surumunu sabitleyin, eklenti mimarisini anlayin ve 3080 portuna SSH tuneli ile erisim saglayin.

DeepSeek Harness nedir

DeepSeek Harness (dsh), bir VPS (sanal özel sunucu) üzerinde çalıştırabileceğiniz bir Node.js aracı çalışma zamanıdır. Bunu çalıştırmanın güvenli yolu, 127.0.0.1 adresine bağlamak ve tarayıcınızla bir SSH (secure shell) tüneli üzerinden erişmektir. Terminalde çalışmak yerine 3080 numaralı portta bir web arayüzü (user interface) sunar. Bu kılavuzun temel aldığı 0.1.0-rc.6 sürümünde, web sunucusu kendi başına bir parola istemez. Bu nedenle, dış dünyaya açılan 3080 numaralı port, onu bulan herkese dosyalarınızı okuyan ve Linux kullanıcınız yetkileriyle komut çalıştıran bir aracı sunar. 0.2.0-rc.2 sürümünden 11 Kasım 2026 tarihli 0.2.2-rc.2 sürümüne kadar olan daha yeni sürümler (GitHub'ın 12 Kasım 2026'da listelediği en güncel sürüm), süreç için yeni bir token içeren bir başlangıç URL'si yazdırır ve bunu bir oturum çerezi ile değiştirir; ancak yine de varsayılan olarak loopback üzerinde dinleme yaparlar ve tüm arayüzlere bağlanmayı reddederler.

DeepSeek, bunu MIT lisansı altında @deepseek-ai/dsh npm paketi olarak yayınlamaktadır. Proje kendisini bir geliştirici önizlemesi olarak tanımlamakta ve uyumluluğu bozan değişikliklerin beklendiğini belirtmektedir. Aşağıda sabitlenen sürüm, Ağustos 2026 sürümüdür. 12 Kasım 2026 itibarıyla npm üzerindeki latest etiketi 0.2.2-rc.1 sürümünü işaret etmektedir. GitHub, 11 Kasım 2026'da yayınlanan ve dsh-v0.2.2-rc.2 etiketiyle sunulan daha yeni bir ön sürüm olan 0.2.2-rc.2 sürümünü listelemektedir. Önemli bir sunucuya kopyalamadan önce depoyu kontrol edin.

Tüm tasarımın temelinde tek bir fikir yatar: her şey bir eklentidir. Model bağdaştırıcısı, araç kayıt defteri, oturum günlüğü, sandbox, zamanlayıcı ve aracı döngüsünün kendisi, paylaşılan tek bir bağlama yüklenen eklentilerdir ve bunlardan herhangi biri değiştirilebilir. Eklentilerin sadece süslediği ayrıcalıklı bir çekirdek yoktur. Harness'ı denemeye değer kılan şey budur ve gerçek riskin bulunduğu yer de burasıdır. Bu değiş tokuşun doğru olup olmadığı, neyle kıyasladığınıza bağlıdır ve Claude Code ve Omnigent ile karşılaştırması, bu "her şey eklenti" tasarımını model eşleştirme, lisans ve her birinin VPS'ten talep ettiği kaynak miktarı açısından diğer iki çözümle yan yana koymaktadır.

Harness bir model değildir

Harness, aracı döngüsünü çalıştırır. Muhakeme süreci başka bir yerdeki modelde gerçekleşir; bu nedenle bir API (application programming interface) anahtarı veya kendi barındırdığınız bir model uç noktası adresi sağlamadığınız sürece hiçbir şey çalışmaz. Bu yazıdaki her şey model davranışından ziyade harness yapılandırması ile ilgilidir ve ikisi arasındaki çizgi, bir sorunun hangi taraftan kaynaklandığını hata ayıklayarak geçireceğiniz bir öğleden sonradan önce netleştirilmelidir.

Bunu arayüzde Settings ve ardından Models altında yapılandırırsınız. DeepSeek'in kendi kartı vardır ve güncel sürümlerde altındaki "Add model provider" düğmesi iki mod açar. "Third-party model provider", harness'ın katalog sağladığı OpenAI ve Anthropic gibi sağlayıcıları kapsar; burada bir anahtar yapıştırırsınız ve katalog, uç noktayı ve model listesini sağlar. "Custom model API" ise ilginç olan seçenektir: küçük harfli bir sağlayıcı kimliği, görünen ad, temel URL, API protokolü, kimlik bilgisi ve en az bir model gerektirir. Protokol seçici; OpenAI Chat Completions, OpenAI Responses, Anthropic Messages ve Gemini API seçeneklerini sunar; böylece bunlardan birini konuşan bir ağ geçidi veya yerel sunucu yapılandırabilirsiniz; istek formatı farklılıkları olan uç noktalar uyumluluk ayarları gerektirir. Özel sağlayıcılar, model listesini sizin için doldurmak üzere OpenAI uyumlu GET /models uç noktasını da sorgulayabilir.

Harness'ı aynı VPS üzerindeki bir modele bu şekilde yönlendirirsiniz. Ollama, http://127.0.0.1:11434/v1/ adresinde OpenAI uyumlu bir API sunar ve API anahtarı alanı herhangi bir dizgeyi kabul eder; OpenAI tarzı istemci bir değer gerektirdiği ve Ollama bunu görmezden geldiği için geleneksel olarak ollama kullanılır. Ollama'nın kendi belgeleri de ollama launch dsh'yi açıklar; bu, eksikse @deepseek-ai/dsh'i kurar ve bir Ollama modeli üzerinde başlatır, bu nedenle aşağıdaki sabitlemeye güvenmeden önce hangi sürümü kurduğunu kontrol edin. VPS'nize sığacak kadar küçük bir modelin bir aracı yönetmek için yeterince iyi olup olmadığı daha zor bir sorudur ve Ollama ile vLLM'in yerel model sunucusu olarak farkı, cevabın ne kadar RAM tüketeceğine karar verir.

Arayüze yazılan anahtarlar salt yazılırdır. Harness bunları $DSH_HOME/.credentials.yaml içinde saklar ve ayarlar yalnızca bir kimlik bilgisi referansı tutar; güncel sürümler bunu aktif profilin yama dosyası olan $DSH_HOME/profiles/<profile>/cordis.patch.yml'e yazar (profil dsh web için web'tür). $DSH_HOME varsayılan olarak ~/.dsh'dir. Kimlik bilgileri dosyasını bir parola dosyası gibi değerlendirin, çünkü öyledir: onu okuyan herkes API bütçenizi harcayabilir. Bu dosyaları arayüz üzerinden tıklamak yerine doğrudan düzenlemek isterseniz, dsh yapılandırma dosyaları, anahtarlar ve model uç noktaları kılavuzu, her anahtarın ne işe yaradığını ve her modda sunucunuzdan nelerin çıktığını gösterir.

Kurulum öncesi gereksinimler

  • SSH erişimine sahip, Ubuntu 24.04 veya güncel bir Linux dağıtımı çalıştıran bir VPS
  • Node.js 24.9 veya daha yeni bir sürüm; projenin ana dalı ve 0.2.2-alpha.2 artık >=24.9.0 bildiriminde bulunuyor ve CI testleri, Node 22 işi olmaksızın Node 24.9 ve Node 26 uyumluluk denetimi ile Node 24 üzerinde gerçekleştiriliyor; 0.2.1-rc.4 üzerinden yayınlanan sürümlerde Node 22.19 kabul edilebilir olarak listelenmiş olsa da, bu artık projenin derleme için temel aldığı alt sınır değildir
  • root olmayan normal bir kullanıcı hesabı; çünkü aracı, süreci başlatan kullanıcı yetkileriyle shell komutlarını çalıştırır
  • Eklenti kurmayı planlıyorsanız PATH üzerinde pnpm bulunmalıdır; çünkü eklenti komutu bu araca çağrı yapar
  • 3080 numaralı portun güvenlik duvarınızda ve sağlayıcınızın ayrı ağ güvenlik duvarında kapalı olması

Ubuntu 24.04'ün kendi nodejs paketi, gerekli altyapının ihtiyaç duyduğundan daha eskidir; bu nedenle ilgili sürümde Node kurulumunu apt install nodejs yerine NodeSource veya nvm üzerinden gerçekleştirin. Ubuntu 26.10'un resmi deposu, Node 24.9 minimum gereksinimini karşılayan Node 24.19.0 sürümünü listeler. VPS yeni kurulmuşsa, başka hiçbir işlem yapmadan önce SSH güvenliğini sıkılaştırmak on dakikanızı ayırmaya değer; çünkü bağımlı olacağınız tünel, ancak arkasındaki SSH sunucusu kadar güvenlidir.

DeepSeek Harness'i bir VPS üzerine sabitleme yaparak kurma

node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 web

npx paketi indirir ve dsh ikili dosyasını çalıştırır. web, tarayıcı uygulamasını başlatan --profile web için bir takma addır ve süreç, dinlediği adresi çıktı olarak verir. Varsayılan değer http://127.0.0.1:3080 şeklindedir. Bu sayılar kozmetik bir varsayılan olmaktan ziyade bir bağlama kararıdır; dsh neden loopback adresi yazdırır bölümü, dizüstü bilgisayarınızdan erişmeden önce harness'in nelere yanıt verip nelere vermeyeceğini açıklar.

Sürümü sabitleyin. npx @deepseek-ai/dsh web, siz çalıştırdığınız anda latest etiketinin işaret ettiği her neyse onu çözer; ancak çalıştırdığınız projede zaten yüklü bir kopya varsa, npx sessizce o kopyayı kullanır. Her iki durumda da sürümü seçen siz değilsinizdir ve proje halihazırda birkaç sürüm adayı yayınlamıştır; ayrıca köklü değişikliklerin geleceği belirtilmektedir. 0.1.0-rc.6, burada sabitlenen Ağustos 2026 sürümüdür. 12 Kasım 2026 itibarıyla latest, token içeren bir başlangıç URL'si yazdıran 0.2.2-rc.1 sürümünü işaret eder; GitHub daha yeni bir ön sürüm olan 0.2.2-rc.2'i listeler, bu nedenle başka bir sürüme geçmek, depoyu okuduktan sonra bilinçli olarak yapılması gereken bir yükseltme türüdür. Sabitlenmiş bir sürüm, bugün kurduğunuz sunucunun gelecek ay da aynı şekilde davranacağı anlamına gelir; böylece yükseltme, keşfettiğiniz bir kaza değil, verdiğiniz bir karar haline gelir. Sabitlenmiş bir komut hala yanlış derlemeyi başlatıyorsa veya hiç kurulmuyorsa, yaygın dsh kurulum ve sürüm hataları bölümü npx önbelleğini temizlemeyi ve Node paketlerinizin hangi npm'i kullandığını kontrol etmeyi kapsar.

Günlük kullanım için, her başlatmada yeniden çözümlemek yerine bir kez kurun.

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

İkinci satırı çalıştırmak faydalıdır, çünkü başlatıcı ve web uygulaması ayrı bayrak setlerine sahiptir. dsh --help, başlatıcının kendi seçeneklerini gösterir. dsh --profile web --help, web uygulamasının kabul ettiği bayrakları gösterir; --port, --host ve tekrarlanabilir --trusted-host burada bulunur.

Şimdi neyi dinlediğini doğrulayın.

ss -tlnp | grep 3080

Yerel adres sütunu 127.0.0.1:3080 değerini göstermelidir. Eğer 0.0.0.0:3080 yazıyorsa, arayüz tüm arayüzleri dinliyor demektir; bu durumda internet ile aranızda yalnızca güvenlik duvarlarınız kalır ve başka bir şey yapmadan önce süreci durdurmalısınız.

Neden 3080 numaralı portu asla dış dünyaya açmamalısınız

0.1.0-rc.6 içindeki web sunucusunun herhangi bir kimlik doğrulama katmanı bulunmamaktadır. Yapılandırması yalnızca dinlenecek ana bilgisayarı ve portu belirler; tüm güvenlik yüzeyi bundan ibarettir. Loopback dışı dağıtımlar için erişim kontrolü, bir giriş ekranı değil, ayrı bir güvenilir ana bilgisayar (trusted-host) ayarıdır.

Daha yeni sürümlere bir kimlik doğrulama mekanizması eklenmiştir. 0.2.0-rc.2 sürümünden itibaren, başlatma sırasında konsola o işleme özel, yeni bir token içeren bir URL yazdırılır. Bu URL ile açılan tarayıcı, imzalı bir oturum çerezi alır ve token içermeyen aynı adrese yönlendirilir. /api önündeki bir Host/Origin filtresi, yalnızca loopback adresini, dinleyicinin kendi bind adresini ve --trusted-host ile belirttiğiniz yetkili adresleri kabul eder. Bu gerçek bir kimlik bilgisi olsa da, projenin kendi belgeleri, yazdırılan URL'nin yalnızca hedeflenen kullanıcılarla paylaşılması gereken bir kimlik bilgisi olduğu ve düz HTTP üzerinden şifrelenmeden gönderildiği konusunda uyarıda bulunur. 0.2.1-alpha.2 sürümünden itibaren web uygulaması, belirli bir yerel adrese bağlanabilir ve --tls-cert ile --tls-key kullanarak HTTPS üzerinden hizmet verebilir. Bu, düz metin sorununu çözer ancak dışa açıklık sorununu çözmez. Açık bir portun kötüye kullanımını zorlaştırır, ancak portun dış dünyaya açılmasını güvenli kılmaz.

Şimdi bu portun arkasında ne olduğuna bakalım. Ajan, çalışma alanındaki dosyaları düzenler ve shell komutlarını çalıştırır; sağlayıcı kimlik bilgileriniz de hemen yanında diskte durur. Dolayısıyla, sabitlenmiş sürümde açık bir 3080 numaralı port, onu başlatan kullanıcı yetkileriyle çalışan ve API anahtarınızın ekli olduğu, sohbet arayüzüne sahip bir uzak shell'dir. Bunun için bir exploit gerekmez; sadece port numarasına ihtiyaç vardır. Başlatma token'ı içeren sürümlerde ise token'a ihtiyaç duyarlar; terminalinizi, servis günlüklerinizi veya şifrelenmemiş trafiğinizi okuyabilen herkes bu token'a zaten erişebilir.

CLI (komut satırı arayüzü) bu yaklaşımı destekler. 0.1.0-rc.6 sürümü itibarıyla, --host 0.0.0.0 kullanımı kasıtlı olarak desteklenmez ve başlatma yerine bir kullanım hatası vererek sonlanır; daha yeni 0.2.2-alpha.2 sürümü de bunu başlatma sırasında reddeder. Bu reddetme bir güvenlik özelliğidir, bu yüzden onu kaldıran bir yama aramayın.

Tünel kullanmanın uygun olmadığı durumlarda iki dağıtım yöntemi makuldür. Sunucuyu, yalnızca kendi cihazlarınızın yönlendirebileceği bir adrese sahip olduğu özel bir overlay ağına yerleştirin; kendi kendine barındırılan bir Headscale kontrol sunucusu bunu sağlar. Veya isteği 3080 numaralı porta ulaşmadan önce doğrulayan bir reverse proxy kullanın; örneğin forward auth yapan bir Authentik tek oturum açma (SSO) sunucusu. Önünde kimlik doğrulama olmayan bir reverse proxy, bir güvenlik kontrolü değil, yalnızca daha uzun bir URL'dir.

SSH tüneli üzerinden web arayüzüne erişme

Bu komutu sunucuda değil, dizüstü bilgisayarınızda çalıştırın.

ssh -N -L 3080:127.0.0.1:3080 you@your-server

-L, dizüstü bilgisayarınızda 3080 portunu açar ve bu porta gelen tüm bağlantıları şifreli SSH oturumu üzerinden iletir. 127.0.0.1:3080 bölümü sunucuda çözümlenir. Bu nedenle bağlantı, makinenin başındaymışsınız gibi loopback üzerinden harness'e ulaşır. -N, uzak bir shell başlatılmamasını belirtir. Çünkü yalnızca port yönlendirmesine ihtiyaç vardır.

Ardından yerel tarayıcınızda http://127.0.0.1:3080 adresini açın. Launch token içeren bir sürümde bunun yerine sunucunun yazdırdığı tam startup URL'sini token dahil olacak şekilde açın. Harness SSH üzerinden başlatıldığında startup satırını yine yazdırır, ancak sizin için tarayıcı açmayı denemez. Dizüstü bilgisayarınızda 3080 portu zaten kullanılıyorsa sol taraftaki numarayı değiştirin: ssh -N -L 3180:127.0.0.1:3080 you@your-server. Ardından http://127.0.0.1:3180 adresine gidin. Token içeren URL'de de portu aynı şekilde değiştirin. Soldaki numara yerel bilgisayara, sağdaki numara ise sunucuya aittir. Bu nedenle yalnızca soldaki numara değişir.

Bunu ~/.ssh/config içine kaydedin ve tekrar yazmayı bırakın.

Host dsh
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/id_ed25519
  LocalForward 3080 127.0.0.1:3080

Bundan sonra ssh -N dsh tüneli başlatır. Tarayıcı bağlantının reddedildiğini bildiriyorsa genellikle tünel çalışıyor, ancak uzak tarafta hiçbir şey dinlemiyor demektir. Çünkü SSH, harness çalışıyor olsun veya olmasın portu yönlendirir. Sunucuyu yukarıdaki ss komutuyla kontrol edin.

Harness yapısının oturumu kapattıktan sonra çalışmaya devam etmesi

Bir npx komutu, shell oturumunuz kapandığında sonlanır. Bir systemd kullanıcı servisi ise varlığını sürdürür ve bir çökme veya yeniden başlatma sonrasında harness yapısını tekrar ayağa kaldırır. Buradaki birim kasıtlı olarak minimal tutulmuştur; eğer harness yapısının kendi kısıtlı hesabı altında, sürümü birim içinde sabitlenmiş şekilde ve gerçekten arama yapabileceğiniz loglarla çalışmasını istiyorsanız, dsh için başsız systemd kurulumu bunu tüm detaylarıyla ele almaktadır.

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger önemlidir çünkü kullanıcı servisleri normalde son oturumunuz kapandığında durur; bu nedenle bu ayar olmadan harness yapısı, tüneli kapattığınız anda sonlanır. command -v dsh tarafından yazdırılan mutlak yolu alın ve birim dosyasına yerleştirin; çünkü systemd, login shell'inizin oluşturduğu PATH değişkenini aramaz.

[Unit]
Description=DeepSeek Harness web UI
After=network-online.target

[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

WorkingDirectory kozmetik bir ayar değildir. dsh süreci, varsayılan dosya sistemi konumu olarak çağrıldığı dizini kullanır; bu nedenle yanlış bir yerde başlatılan servis, ajanı yanlış klasöre yönlendirir. Ancak bu dizin yalnızca bir varsayılandır: yeni bir Web UI, siz "Choose workspace" altında bir tane ekleyene kadar seçili bir çalışma alanına sahip değildir ve projenin kılavuzu, dsh komutunu başlattığınız dizini eklemenizi söyler. Kılavuz herhangi bir sürüm işareti taşımaz ve aynı ifade 0.1.0-rc.7 içinde de yer almaktadır, bu yüzden sabitlenmiş sürümde de aynı durumla karşılaşmayı bekleyin. Birimin dizinini proje dizini olarak ayarlayın, ardından arayüzde bu çalışma alanını seçin.

systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dsh

Başlatılamayan bir birimin nedeni neredeyse her zaman yanlış bir ExecStart yolu veya ikili dosyanın reddettiği bir Node sürümüdür; journalctl --user -u dsh -n 50 ise hatanın nedenini belirtir. Başlatma token'ına sahip bir sürümde, token içeren başlangıç URL'si de journal kayıtlarına düşer ve her yeniden başlatma işlemi yeni bir URL yazdırır. Aynı model herhangi bir kodlama ajanını VPS üzerinde canlı tutma konusu için de geçerlidir ve hata modları aynıdır.

Bir eklentinin yapabilecekleri

Eklenti, paylaşılan bir bağlama servisler, türü belirlenmiş olaylar ve geri alınabilir etkiler sağlayan bir modüldür. Uzantı noktaları, dikkatle incelenmesi gereken kısımdır:

  • ctx.llm üzerinde bir model sağlayıcısı kaydetme
  • ctx.tools üzerinde modele yönelik araçlar ekleme
  • ctx.shell arkasındaki kabuk (shell) arka ucunu sağlama
  • ctx.fs arkasında dosya sistemi erişimi veya politikası sağlama
  • ctx.commands üzerinde kullanıcı komutlarını kaydetme
  • ctx.jobs aracılığıyla arka plan işleri çalıştırma
  • Başlatılan süreçleri bir ctx.sandbox arka ucu ile sarmalama
  • agent/* ve tools/* olayları aracılığıyla istekleri ve araç çağrılarını yakalama
  • Kalıcı oturum durumunu genişletme
  • ctx.agents aracılığıyla kullanıcı arayüzünü yönetme

Bu listeyi bir saldırganın bakış açısıyla okuyun. Bir eklenti, dosya sistemi katmanını ve kabuk katmanını sağlayabilir; ayrıca modelin yaptığı her araç çağrısının arasına girebilir. Bir eklenti ile bu bağlantı noktaları arasında herhangi bir izin diyaloğu bulunmaz; çünkü eklenti, diğer her şeyle aynı süreç içine yüklenen sıradan bir Node kodudur. Bir eklenti yüklemek, yabancı bir kodu kendi temsilcinizin (agent) izinleriyle çalıştırmak demektir; temsilcinizin izinleri ise sizin Unix kullanıcı izinlerinizdir.

Bu, bir VPS üzerinde bir temsilciye MCP sunucusu bağlarken verdiğiniz güven kararıyla aynıdır; burada MCP, model bağlam protokolüdür (model context protocol). Ayrıca bir kodlama temsilcisini VPS üzerinde güvenli bir şekilde çalıştırmanın modelden ziyade temsilcinin altında çalıştığı hesapla başlamasının ve npm tedarik zinciri saldırılarının sunucuları neden bu kadar ağır etkilediğinin nedeni budur: yükleme adımı bir ihlaldir ve hiçbir şey sizi bu konuda uyarmaz.

Eklentilerin kaynağı

Eklentiler profiller içinde barınır. Profil, $DSH_HOME altında saklanan ve varsayılan değeri ~/.dsh olan isimlendirilmiş bir yapıdır; her profil dizini, kendi bünyesinde kurulan ağaç dışı (out-of-tree) eklentileri tutar. CLI, argümanlarınızı doğrudan pnpm adresine ileterek ve profil dizinini çalışma dizini olarak kullanarak bu eklentileri yönetir.

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

Argümanlar pnpm adresine değiştirilmeden ulaştığı için add, remove, update ve why herhangi bir pnpm projesindeki gibi davranır; bir eklenti, bir npm paketi veya bir GitHub referansı olabilir. pnpm öncelikle PATH üzerinde bulunmalıdır. Node 24 sürümünde corepack enable pnpm bunu otomatik yapar. Node 25 sürümü Corepack dağıtımını durdurduğu için, Node 25 ve sonraki sürümlerde bunun yerine npm install -g pnpm ile kurulum yapın.

Keşif süreci bir GitHub konusu (topic) üzerinden işler. Eklenti yazarları, depolarına dsh-plugin konusunu ekler ve bu konuya göz atarak mevcut eklentileri bulabilirsiniz. Konu, yazarın kendi deposuna uyguladığı bir etikettir. Kimse bu etiketleri incelemez veya onaylamaz; konu sayfası popülerliği ölçen yıldız sayısına göre sıralanır, bu da güvenlikten ziyade popülerliği yansıtır.

Mevcut sürümler ayrıca deneysel bir Özel eklenti dizinleri paketi içerir. Bunu Eklentiler altında etkinleştirdiğinizde, bir Keşif sekmesi üzerinden dizin ekleyebilirsiniz; bu dizin, sağladığınız bir URL'den çekilen bir JSON dosyasıdır. Altyapı kendi başına bir dizin sunmaz; dosyanın biçimini kontrol eder ancak bir pazar yerinin iddia ettiği başlıkları, yazarları veya kaynakları doğrulamaz. Ayrıca, düz http: üzerinden sunulan bir dizin, ağ yolundaki herhangi biri tarafından değiştirilebilir. Pazar yeri, başkası tarafından yazılmış bir katalogdur, bir inceleme veya onay mekanizması değildir.

Dört alışkanlık bu süreci yönetilebilir kılar. Kurulumdan önce kaynak kodunu okuyun; çoğu eklenti on dakikada okunabilecek kadar küçüktür. Bir dalı (branch) takip etmek yerine tam sürümü veya commit değerini sabitleyin. Altyapıyı, başka hiçbir varlığı bulunmayan bir kullanıcı altında ve yeniden oluşturmaya hazır olduğunuz bir VPS üzerinde çalıştırın. Aracın kendisine ait bir API anahtarı tanımlayın ve bu anahtara, üretim servislerinizin kullandığı anahtardan ayrı, kendi harcama limitini atayın. Bir eklentiyi incelemek istediğinizde hangi dosyaların risk taşıdığını anlamak için dsh eklentisi inceleme kılavuzu, eklentinin manifest dosyasını, giriş noktasını ve kaydettiği genişletme noktalarını detaylandırır.

Bir karar vermeden önce tasarımları karşılaştırmak isterseniz, Omnigent çoklu ajan altyapısı aynı sorunu farklı bir yapıyla çözer; eklentiler devreye girdiğinde aradaki farklar belirginleşir. Eğer bir kazanan seçmek yerine iki veya üç tanesini aynı sunucuda tutmaya karar verirseniz, her altyapıyı tek bir self-hosted API arkasına almak, port başına tünel açma zahmetinden kurtarır; ancak bunun bedeli, loopback arayüzüne bağlanması ve ilk günden gerçek bir parola ile korunması gereken bir servis daha eklemektir.

İlk ne bozulur

Node sürümü çok eski. Projenin ana dalı ve 0.2.2-alpha.2, Node 24.9 veya daha yeni bir sürüm gerektirir. CI süreçleri Node 24 üzerinde test edilir ve Node 24.9 ile Node 26 üzerinde uyumluluk denetimi yapılır; Node 22 için herhangi bir destek yoktur. 0.2.1-rc.4 üzerinden etiketlenmiş eski sürümlerde Node 22.19 kabul edilebilir olarak listelenmiş olsa da, proje artık bu sürümle derlenmemektedir. Kod, sahip olmadığı sözdizimi ve API'leri kullandığı için eski bir çalışma zamanı başlatma sırasında başarısız olur. Başka bir işlem yapmadan önce node --version komutunu çalıştırın.

3080 numaralı port zaten kullanımda. İkinci bir harness, askıda kalmış bir süreç veya 3080 portunu kullanan ilgisiz bir uygulama olabilir. ss -tlnp | grep 3080 ile bunu bulun, ardından süreci durdurun veya dsh web --port 3180 ile harness'ı başka bir yerde başlatın. --port web uygulamasına aittir, bu nedenle web komutundan sonra gelmelidir.

Tarayıcı tünel üzerinden bağlantı kuramıyor. Sunucunun genel adresi yerine 127.0.0.1 adresine gittiğinizi doğrulayın; çünkü yönlendirilen port yalnızca dizüstü bilgisayarınızda mevcuttur. Ardından, SSH karşı tarafta bir yanıt olup olmadığına bakılmaksızın yönlendirmeyi kurduğundan, harness'ın sunucuda dinleme yapıp yapmadığını kontrol edin.

dsh plugin hemen başarısız oluyor. Komut, pnpm etrafında bir sarmalayıcıdır; bu nedenle eksik bir pnpm ikili dosyası, herhangi bir eklenti çalışması başlamadan önce süreci durdurur. Corepack artık Node ile birlikte gelmediğinden, Node 25 ve sonraki sürümlerde varsayılan durum budur.

Ajan projenizi göremiyor. Yeni bir Web arayüzünde, siz bir çalışma alanı ekleyene kadar hiçbir çalışma alanı seçili değildir ve siz ekleyene kadar oturum oluşturucu kullanılamaz. Süreç, başladığı dizini yalnızca varsayılan dosya sistemi konumu olarak kullanır; bu nedenle WorkingDirectory değeri ana dizininiz olan bir birim, ajanı ana dizininize yönlendirir. Arayüzden çalışma alanını seçin veya birimi düzeltip yeniden yükleyin.

FAQ

DeepSeek Harness web arayüzünü 3080 numaralı port üzerinden dış dünyaya açmak güvenli midir?

Hayır. Sabitlenmiş 0.1.0-rc.6 içerisinde web sunucusunun kendi kimlik doğrulama mekanizması bulunmamaktadır. Arkasındaki aracı, süreci başlatan kullanıcı yetkileriyle dosya düzenleyip kabuk komutları çalıştırabilmekte ve sağlayıcı API anahtarınız aynı diskte saklanmaktadır. 0.2.0-rc.2 sürümünden itibaren, 0.2.2-rc.1 dahil olmak üzere, npm'in 12 Kasım 2026 tarihli latest sürümü ve daha yeni 0.2.2-rc.2 ön sürümünde, başlatma sırasında yazdırılan URL, tarayıcının oturum çereziyle takas ettiği bir başlatma belirteci içerir. Ancak bu URL, şifrelenmemiş HTTP üzerinden gönderilen bir kimlik bilgisi niteliğindedir; bu nedenle tavsiye değişmemektedir. Dinleyiciyi 127.0.0.1 üzerinde tutun ve erişimi bir SSH tüneli üzerinden sağlayın. Özel bir overlay ağı veya porta ulaşmadan önce her isteği doğrulayan bir reverse proxy de kullanılabilir. 0.1.0-rc.6 sürümü itibarıyla CLI, --host 0.0.0.0 kullanımını reddedip bir kullanım hatasıyla sonlanmaktadır; 0.2.2-alpha.2 de bunu reddetmektedir. Bu durum, yazarların bu fikre bakış açısını göstermektedir.

DeepSeek API anahtarına mı ihtiyacım var, yoksa yerel bir model kullanabilir miyim?

Her ikisi de mümkündür; çünkü harness bir model değil, bir çalışma zamanıdır. Settings ve ardından Models menüsü altından DeepSeek kartına veya bir katalog sağlayıcısına anahtar yapıştırabilir ya da "Add model provider" seçeneğini kullanarak "Custom model API" kısmına OpenAI Chat Completions, OpenAI Responses, Anthropic Messages veya Gemini API ile uyumlu bir temel URL girebilirsiniz. Yerel bir Ollama sunucusu http://127.0.0.1:11434/v1/ adresinde yanıt verir ve API anahtarı alanındaki herhangi bir metni kabul eder. Anahtarlar, varsayılan olarak ~/.dsh/.credentials.yaml olan $DSH_HOME/.credentials.yaml dizininde saklanır.

DeepSeek Harness eklentisi yüklemek, eklentiye tam olarak hangi yetkileri verir?

Harness'ı çalıştıran hesabın yetkilerini verir. Eklenti, aynı süreç içine yüklenen Node kodudur; genişletme noktaları arasında kabuk arka ucu, dosya sistemi katmanı, araç kayıt defteri ve her araç çağrısını saran olaylar bulunur. Eklenti kendi korumalı alanını (sandbox) sağlamadığı sürece, bu noktalardan hiçbir şey eklentiyi kısıtlamaz. Yüklemeden önce kaynak kodunu inceleyin ve harness'ı, kaybetmeyi göze alamayacağınız hiçbir veriye erişimi olmayan bir kullanıcı ile çalıştırın.

Hangi sürümü yüklemeliyim ve çalışmaya devam edecek mi?

Örneğin npx @deepseek-ai/dsh@0.1.0-rc.6 web gibi belirli bir sürümü yükleyin. Bu, burada sabitlenmiş olan Ağustos 2026 sürümüdür. 12 Kasım 2026 itibarıyla npm'in latest etiketi 0.2.2-rc.1 sürümünü işaret etmektedir; GitHub üzerinde 11 Kasım'da yayınlanan daha yeni 0.2.2-rc.2 ön sürümü listelenmektedir ve mevcut CLI, Node 24.9 veya daha yeni bir sürüm gerektirmektedir. Proje kendisini bir geliştirici önizlemesi olarak tanımlamakta ve uyumluluğu bozan değişikliklerin beklendiğini belirtmektedir; bu nedenle sabitlenmemiş bir komut günden güne farklı davranabilir. Yükseltme yapmadan önce depoyu kontrol edin ve sürüm numarası 0 ile başladığı sürece yapılandırma anahtarlarının ve eklenti arayüzlerinin değişebileceğini göz önünde bulundurun.

Bu yazı işinize yaradı mı?