dsh web: http://127.0.0.1:3080 ne demek?
dsh web, Web UI'yi yalnızca localhost'a bağladığı için http://127.0.0.1:3080 gösterir. SSH tüneliyle güvenli erişim ve 3080'i açmanın riski açıklanır.
dsh web: http://127.0.0.1:3080 ne anlama gelir
DeepSeek Harness web profilini bir VPS üzerinde başlattığınızda, aşağıdaki gibi bir satır yazdırır ve beklemeye geçer:
dsh web: http://127.0.0.1:3080/?token=...127.0.0.1, loopback adresidir. Bir makinenin kendi kendisiyle iletişim kurmak için kullandığı adrestir. 127.0.0.1 adresine bağlı bir soket, yalnızca aynı makine üzerindeki süreçlerden gelen bağlantıları kabul eder, başka hiçbir yerden bağlantı kabul etmez. Dolayısıyla bu satır size aynı anda iki şey söyler: Web arayüzünün nerede dinleme yaptığı ve ona kimin erişebileceği. Yalnızca dsh'nin çalıştığı makine. Sondaki ?token= kısmı, sürecin her başladığında oluşturduğu yeni ve rastgele bir kimlik bilgisidir. Bununla ilgili daha fazla bilgi aşağıdadır.
URL'yi dizüstü bilgisayarınızdaki tarayıcıya yapıştırdığınızda hiçbir şey olmamasının nedeni budur. Dizüstü bilgisayarınızın 127.0.0.1 adresi, dizüstü bilgisayarınızın kendisidir. Harness ise VPS'nizin 127.0.0.1 adresinde dinleme yapmaktadır; bu, farklı bir loopback yığınına sahip farklı bir makinedir. Bir sorun yoktur. Bağlantıyı taşımanız gerekir.
Resmi README dosyası varsayılan durumu açıkça belirtir: "Komut, Web arayüzünü varsayılan olarak http://127.0.0.1:3080 adresinde başlatır ve yerel bir başlatma için varsayılan tarayıcıda açar." SSH üzerinden açılacak bir tarayıcı bulunmadığından, URL'yi manuel olarak kullanmanız için size bırakır. Bağlama adresi, web sunucusu ana bilgisayar eklentisi olan @deepseek-ai/dsh-host-webserver'den gelir. Bu kılavuzun temel aldığı 0.2.0-rc.2 sürümünde, host anahtarı "Dinleme ana bilgisayarı; desteklenen iki değer loopback ve all-interfaces şeklindedir" şeklinde belgelenmiştir. Siz değiştirmedikçe varsayılan olarak loopback kullanılır. Portlar sizin için yeniyse, Linux'ta portlar nasıl çalışır bölümü, tüm bu yapının dayandığı adres artı port modelini açıklar.
Web arayüzünün neden yalnızca localhost üzerinde dinleme yaptığı
dsh bir aracı donanımıdır ve modelin etrafına sarılmış programdır: döngünün, araç çağrılarının ve bu çağrıların altında çalıştığı izinlerin sahibidir. Tarayıcı sekmesi; kabuk komutlarını çalıştıran, seçtiğiniz çalışma dizinindeki dosyaları okuyup yazan ve model API anahtarınızı harcayan bir sürecin kontrol yüzeyidir. O sayfayı yükleyebilen herkes, dsh'yi çalıştıran kullanıcı yetkileriyle tüm bunları yapabilir. Bu erişime giden tek yol ağ değildir: yüklediğiniz bir eklenti, aynı süreç içinde aynı izinlerle çalışır; bu yüzden bir dsh eklentisini yüklemeden önce incelemek, sunucunun hangi adreste dinleme yapacağına karar vermekle aynı özeni gerektirir.
Dolayısıyla 3080 numaralı port, salt okunur bir kontrol paneli değildir. O sayfayı yüklemek, sunucuda komut yürütme yetkisi verir.
Yazdırılan URL'yi açtığınızda doğrudan oturum listesine ulaşırsınız. Bir giriş ekranı veya kullanıcı hesabı yoktur. Sayfayı koruyan şey, URL'nin sonundaki belirteçtir (token): kök sayfa bunu imzalı bir oturum çerezi ile değiştirir ve temiz bir adrese yönlendirir. Bundan sonra, arayüzün geçerli bir çerez olmadan yaptığı her RPC çağrısı ve WebSocket akışı 401 Unauthorized hatası alır. Ancak port üzerindeki her şey korumalı değildir. Connection eklentisinin belgeleri, statik varlıkların herkese açık kaldığını belirtir ve web sunucusunun kendisinde sunucu genelinde bir kimlik doğrulama veya kaynak politikası yoktur; bu nedenle bir rotaya sahip olan her eklenti kendi kurallarını uygular. Bu korumalı rotalarda Connection eklentisi, Host başlığı loopback veya açıkça güvendiğiniz bir ana bilgisayar olmadığında 403 yanıtını da verir. Loopback üzerinde bu, işletim sisteminin yalnızca yerel süreçlerin geçişine izin vermesi şeklindeki gerçek erişim kontrolünün arkasında mantıklı bir ikinci katmandır. Bu, portu dış dünyaya açmak için bir neden değildir. Belirteç, terminal geçmişinizde ve başlangıç çıktısını yakalayan herhangi bir günlükte bulunur. Projenin kendi reverse proxy rehberi, ne Host kontrolünün ne de duyurulan URL'nin dinleme portunun kendisini korumadığını belirtir. Web sunucusu belgeleri, loopback olmayan bir adrese bağlamanın "korumasız rotaları ve statik varlıkları o ağa açık hale getirdiğini" konusunda uyarır. Ayrıca 0.2.0-rc.2 sürümünde web sunucusu eklentisi kendi TLS'sini taşımaz. Otomatik tarayıcılar alışılmadık portları sürekli olarak tarar, bu yüzden dışarıya açık bir 3080 portunu bulunmuş kabul edin.
Güvenlik duvarınızda 3080 numaralı portu açmayın ve halka açık bir VPS üzerinde web sunucusuhostdeğerini0.0.0.0veya genel IP adresiniz olarak ayarlamayın. Bu kombinasyon, sunucunuzdaki komut yürütme yetkisini, URL'yi ele geçiren herhangi birinin erişimine açık bırakır.
Mevcut sürümler sizi zaten bu yöne itmektedir: web uygulamasının kendi --host bayrağı, tüm arayüzlere bağlanmayı reddeder. Ancak 0.2.0-rc.2 sürümünde web sunucusu eklentisinin host yapılandırma anahtarı hala 0.0.0.0 değerini kabul eder, bu nedenle bir yapılandırma değişikliği onu hala açığa çıkarabilir. Projenin varsayılan dalındaki ve npm'in latest etiketinin işaret ettiği 0.2.1-rc.5 sürümündeki web sunucusu belgeleri daha da ileri gider: yükleme sırasında belirtilmemiş bir adresi reddeder ve isteğe bağlı bir tls ayarı ekler. Yine de yerel bir arayüzün herhangi bir somut adresini kabul eder, bu yüzden host değerini VPS'nizin genel IP'sine yönlendirmek arayüzü aynı şekilde açığa çıkarır.
Aynı mantık, bir sunucuya yerleştirdiğiniz her aracı çalışma zamanı için geçerlidir; bu yüzden bir kodlama aracını VPS üzerinde güvenli bir şekilde çalıştırmak aynı kuraldan başlar: aracın kontrol portu gizli kalmalı ve güvendiğiniz bir mekanizma sizi ona ulaştırmalıdır.
dsh Web arayüzünü dizüstü bilgisayarımdan nasıl açabilirim?
Bunun üç güvenilir yolu vardır ve her biri harness'ın loopback üzerinde kalmasını sağlar.
- Bir SSH tüneli. Genel arayüzde yeni bir port dinlenmez ve kimlik bilgilerine zaten sahipsinizdir. Kullanılması gereken yöntem budur.
- Özel bir overlay ağı; böylece arayüz kendi cihazlarınızdan erişilebilir olurken diğer herkes için görünmez kalır.
- TLS (transport layer security) sonlandırması yapan ve herhangi bir yönlendirme yapmadan önce parola talep eden bir reverse proxy.
Bu yöntemler arasındaki fark, tarayıcınızı loopback'e ulaştıran aracın ne olduğudur. Hiçbiri, harness'ın loopback üzerinden taşınmasını gerektirmemelidir.
SSH tüneli ile erişim
Bu komutu VPS üzerinde değil, dizüstü bilgisayarınızda çalıştırın:
ssh -N -L 3080:127.0.0.1:3080 you@your-vpsKomutu çalışır durumda bırakın, ardından dsh ile yazdırılan ve token bilgisini de içeren tam URL'yi http://127.0.0.1:3080/?token=... yerel tarayıcınızda açın. Web arayüzü yüklenir, token bilgisini bir oturum çerezi ile değiştirir ve token bilgisini adres çubuğundan kaldırır. Tarayıcınız Host olarak 127.0.0.1:3080 gönderir; bu loopback adresi olduğundan, tünel ek bir yapılandırma gerektirmeden Host denetimini geçer.
-L argümanı, iki nokta üst üste ile ayrılmış üç alan içerir. Birincisi, dizüstü bilgisayarınızda açılacak porttur. İkinci ve üçüncü alanlar, bağlantının yönlendirileceği adres ve porttur. Önemli olan detay şudur: Orta alandaki 127.0.0.1, trafiğiniz oraya ulaştıktan sonra VPS üzerindeki SSH sunucusu tarafından çözümlenir. Bu, sizin değil, VPS'in loopback adresi anlamına gelir. dsh ile yazdırılan adres tam olarak budur; doğrudan tarayıcı bağlantısı çalışmazken tünelin çalışmasının nedeni de budur.
-N, SSH'e uzak bir komut çalıştırmamasını söyler; böylece bir kabuk (shell) yerine sadece bir yönlendirici elde edersiniz. Sessizce değil, hata durumunda belirgin şekilde başarısız olan arka plan tüneli için:
ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps-f, kimlik doğrulamasından sonra süreci arka plana atar. ExitOnForwardFailure=yes göründüğünden daha önemlidir: bu bayrak olmadan, yönlendirme kurulamasa bile SSH başarılı bir şekilde bağlanır; bu da size çalışan bir oturum ancak uyarısız, ölü bir tünel bırakır. ServerAliveInterval=30, boşta duran bir tünelin kafe veya otel yönlendiricilerindeki NAT (ağ adresi çevirisi) zaman aşımlarından etkilenmemesi için her 30 saniyede bir keepalive paketi gönderir.
Ne görmelisiniz
VPS üzerinde, gerçekte neyin dinlemede olduğunu doğrulayın:
ss -ltnp | grep 3080Sağlıklı bir sonuç, loopback adresini gösterir:
LISTEN 0 511 127.0.0.1:3080 0.0.0.0:* users:(("node",pid=1042,fd=21))Yerel adres sütununda bunun yerine 0.0.0.0:3080 yazıyorsa, Web arayüzü genel arayüz dahil her yerde dinleme yapıyordur. Bu sütunda VPS'inizin genel IP adresinin olması da aynı açıklık anlamına gelir. Başka bir işlem yapmadan önce servisi durdurun ve bind ayarını düzeltin. ss soketi listeliyor ancak users: alanını boş bırakıyorsa, komutu sudo ile çalıştırın; aksi takdirde başka bir kullanıcıya ait soketin işlem adı gizli kalacaktır.
Tünel başlatılamadığında
SSH bu mesajı yazdırır ve sonlanır:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080Bu durum sunucuyla değil, dizüstü bilgisayarınızla ilgilidir. Yerel bir süreç zaten 3080 portunu tutuyordur; bu genellikle unuttuğunuz eski bir tüneldir. Bunun yerine boş bir yerel port seçin:
ssh -N -L 3081:127.0.0.1:3080 you@your-vpsSadece ilk alan değiştiği için, artık 3080 portunda dinlemeye devam eden araca rağmen http://127.0.0.1:3081/?token=... adresine, aynı token ile gidersiniz. İki sayının eşleşmesi gerekmez. Oturum çerezi adres çubuğundaki host ve porta bağlıdır, bu nedenle yeni bir yerel port için token içeren URL'yi tekrar kullanmanız gerekir.
Tünel kurulur ancak tarayıcı bağlantının reddedildiğini veya boş yanıt döndüğünü bildirirse, trafik VPS'e ulaşmış ancak karşı tarafta hiçbir şey bulamamıştır. Ya dsh sonlanmıştır ya da farklı bir portta dinleme yapıyordur. Sunucuda ss -ltnp | grep 3080 ile kontrol edin. Eğer sayfa bunun yerine 401 Unauthorized yanıtını veriyorsa, tünel düzgündür ancak tarayıcınız o adres için geçerli bir çerez tutmuyordur: token içeren yazdırılmış URL'yi tekrar açın. Yeniden başlatma sonrasında URL'yi yeni çıktıdan alın, çünkü her süreç yeni bir token üretir.
Burada kullanıcıları zorlayan bir diğer konu şudur: Ön planda çalışan bir npx @deepseek-ai/dsh web, kabuk kapandığında ölür; bu nedenle oturumu kapattığınız anda araç durur. Bunu tmux içinde veya VPS üzerinde kodlama aracını çalışır durumda tutma konusunda çözülen aynı problem olan bir systemd kullanıcı servisi altında başlatın. systemd altında dsh web: satırı, token ve diğer bilgilerle birlikte servis günlüğüne düşer; bu nedenle bilgileri oradan okuyun. SSH tarafında çalışırken, VPS üzerinde SSH güvenliğini sıkılaştırma işlemini öncelikle yapmanızda fayda vardır, çünkü tünel, SSH girişinizi araca açılan tek kapı haline getirir.
Özel bir overlay ağı üzerinden erişim
Bir overlay ağı, VPS'nize ve dizüstü bilgisayarınıza yalnızca kendi cihazlarınızın katılabildiği özel bir ağ üzerinde adresler atar. Tailscale yaygın bir tercihtir ve serve komutu bu durum için tam olarak uygundur: tailscaled, VPS üzerinde çalışır ve localhost:3080 ile kendisine bağlanır; böylece harness, loopback üzerinde kalır.
tailscale serve --bg localhost:3080
tailscale serve statusArayüze, tailnet'iniz içindeki makine adınız üzerinden, HTTPS ile ve genel arayüzde hiçbir port açmadan erişilebilir. Bunun için tailnet'inizde HTTPS sertifikalarının etkinleştirilmiş olması gerekir, aksi takdirde serve sunacak bir sertifika bulamaz. Tarayıcınız artık o tailnet adını Host olarak gönderdiğinden, harness'ı bu adı güvenilir kabul edecek şekilde başlatın; aksi takdirde API çağrıları 403 hatası alır. Port belirtilmeyen bir girdi, tüm portlarla eşleşir:
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.netArdından, yazdırılan satırdaki token'ı kullanarak https://your-vps.your-tailnet.ts.net/?token=... adresini açın. Servisi tekrar kapatmak için komutu off bayrağı ile tekrarlayın:
tailscale serve --https=443 offserve kullanın, asla funnel kullanmayın. Funnel, aynı hedefi genel internete açar; bu da bir agent runtime'ı, önünde yalnızca bir URL token'ı olacak şekilde açık bir porta yerleştirir. İki komut neredeyse aynı görünür ancak zıt işlevlere sahiptir; bu nedenle herhangi birini yazmadan önce Tailscale Serve ve Funnel arasındaki fark konusunu okuyun. Özel bir ağ olarak Tailscale kurulumun kendisini kapsar.
Parola denetimi yapan bir reverse proxy üzerinden erişim
Bu seçenek, bir portu doğrudan internete açtığı için, sunucunuzdaki komut yürütme yetkisi ile yabancılar arasındaki tek engel kimlik doğrulamadır. Arayüze birden fazla kişinin erişmesi gerektiğinde ve herkes için ayrı bir tünel kurmak pratik olmadığında bu yöntemi tercih edin.
Harness, 127.0.0.1:3080 üzerinde çalışmaya devam eder. nginx aynı makinede çalıştığı için loopback adresine erişebilir; 443 numaralı portu bir sertifika ve parola dosyası ile dinler.
server {
listen 443 ssl;
server_name dsh.example.com;
ssl_certificate /etc/letsencrypt/live/dsh.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/dsh.example.com/privkey.pem;
auth_basic "dsh";
auth_basic_user_file /etc/nginx/dsh.htpasswd;
location / {
proxy_pass http://127.0.0.1:3080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_read_timeout 3600s;
proxy_buffering off;
}
}Parola dosyasını oluşturun ve yapılandırmayı yeniden yükleyin:
sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginxnginx -t komutu, syntax is ok ve ardından test is successful çıktısını vermelidir. Hatalı bir dosya ile yapılan yeniden yükleme işlemi başarısız olur ve mevcut yapılandırmayı korur; bu nedenle körü körüne yeniden başlatmak yerine hata mesajını okuyun.
Proxy satırlarındaki üç ifade süsleme değildir. Upgrade ve Connection başlıkları, WebSocket el sıkışmasına izin verir; bunlar olmadan sayfa yüklenir ancak hiçbir zaman güncellenmez. proxy_read_timeout 3600s, nginx'in işlem yapmama zaman aşımını 60 saniyeden bir saate çıkarır; bu ayar, bir agent çalıştırma süresinin toplam uzunluğunu sınırlamaz. Sabitlenmiş 0.2.0-rc.2 sürümü, varsayılan olarak her iki saniyede bir WebSocket ping'i göndererek uzun bir agent adımı sırasında bağlantıyı aktif tutar. proxy_buffering off, proxy üzerinden iletilen HTTP yanıtları için arabelleğe almayı devre dışı bırakır; WebSocket çerçevelerini kontrol etmez. Satır satır bir nginx reverse proxy yapılandırması geri kalanını açıklar ve nginx, Caddy ve Traefik arasında seçim yapma konusu, aynı işlemin otomatik sertifikalarla nasıl yapılacağını ele alır.
Harness'ın da proxy'den haberdar olması gerekir. proxy_set_header Host $host, tarayıcıya dönük ismi değiştirmeden iletir; projenin proxy kılavuzunun istediği de budur. Bu nedenle dsh komutunu bu ismi güvenilir olarak tanımlayarak başlatın, aksi takdirde 403 hatası alırsınız:
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.comHer kullanıcı, dsh web: satırındaki token ile https://dsh.example.com/?token=... adresini bir kez açar; tarayıcı oturum çerezini bundan sonra saklar. Backend, bu çerezi Secure bayrağı olmadan ayarlar; proxy kılavuzu, proxy'nin bunu HTTPS üzerinde eklemesini ister. nginx 1.19.3 veya daha yeni sürümlerde, location bloğu içindeki proxy_cookie_flags ~ secure; bunu sağlar.
Hangi proxy'yi seçerseniz seçin, 3080 numaralı portu güvenlik duvarında kapalı tutun; böylece içeriye giden tek yol kimlik doğrulamalı olan kalır. ufw güvenlik duvarı temelleri kuralları kapsar. TLS üzerinden temel kimlik doğrulama bir taban seviyesidir, eksiksiz bir güvenlik modeli değildir: o parolaya ve token URL'sine sahip olan herkes sunucunuzda bir kabuk (shell) erişimine sahip olur. Mümkün olduğunda tünel yöntemini tercih edin.
dsh web arayüzünün dinlediği portu nasıl değiştirebilirim?
--port, başlatıcıya değil web uygulamasına aittir. CLI dokümantasyonu bu örneği doğrudan vermektedir:
dsh --profile web --port 8080dsh web, --profile web komutunun bir takma adıdır, dolayısıyla dsh web --port 8080 aynı komuttur. Başlatıcı yalnızca kendi bayraklarını ayrıştırır ve bunların ardından gelen her şeyi başlatılan profile aktarır. Bu nedenle başlatıcı bayrakları en başta yer almalıdır; başlatıcının tanımadığı ilk belirteç, uygulamanın argümanlarını başlatır. --port ifadesini profilin sonrasına yerleştirin, asla öncesine koymayın.
Varsayımda bulunmak yerine komutun yazdırdığı URL'yi okuyun; bu satır, sunucunun gerçekten bağlandığı adresi ve ihtiyacınız olan belirteci raporlar. Ardından tünelinizin son alanını buna uyacak şekilde güncelleyin:
ssh -N -L 3080:127.0.0.1:8080 you@your-vpsKalıcı bir değişiklik için port, komut satırı yerine profil yapılandırmasında yer alır. web ve headless profilleri, ilk kullanımda ~/.dsh altındaki hazır şablonlardan otomatik olarak başlatılır. API anahtarınız ve model uç noktası ayarlarınız da aynı dizinde bulunduğundan, bu dosyaları düzenlerken dsh anahtarlarını, modellerini ve uç noktalarını yapılandırma rehberi tamamlayıcı bir okuma olacaktır. Tüm katmanlar birleştirildikten sonra nelerin geçerli olduğunu görmek için:
dsh --dump-configDinleme adresi, web sunucusu eklentisindeki host ve port olmak üzere iki anahtardan gelir. 0.2.0-rc.2 sürümünde diğer anahtarlar yalnızca yanıt sıkıştırmasını ayarlar; 0.2.1-rc.2 ve varsayılan dal ise isteğe bağlı bir tls anahtarı ekler. port değerini 0 olarak ayarlamak, işletim sisteminden boş bir port talep eder; bu durum "sıfır, işletim sistemi tarafından atanan bir port talep eder" şeklinde belgelenmiştir. Bu, hiçbir zaman çakışma yaşamamanızı garanti eder ancak port numarası her yeniden başlatmada değişeceği için tünel kullanımı için uygun bir yöntem değildir.
dsh neden "address already in use" hatası veriyor?
Başka bir süreç halihazırda ilgili adresi ve portu kullandığı için çekirdek ikinci bind işlemini reddeder. Node bu durumu şu şekilde raporlar:
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080Herhangi bir değişiklik yapmadan önce portu tutan süreci bulun:
sudo ss -ltnp | grep 3080users:(("node",pid=1042,fd=21)) alanı süreci ve PID bilgisini belirtir. Genellikle karşılaşılan durum, durdurulduğu düşünülen ancak arka planda çalışan bir dsh sürecinin, sıklıkla da kopuk bir tmux penceresinde yaşamaya devam etmesidir. Bu süreci kill 1042 ile durdurun veya yeni örneği farklı bir port üzerinde başlatın. 127.0.0.1:3080 ve 0.0.0.0:3080 süreçlerinin de birbiriyle çakıştığını unutmayın; çünkü tüm arayüzlere bind işlemi zaten loopback adresini de kapsar.
Sürümü sabitleyin, çünkü bu bir geliştirici önizlemesidir
README dosyası bu konuda nettir: DeepSeek Harness bir geliştirici önizlemesidir ve hızla gelişmektedir; bu süreçte uyumluluğu bozan değişiklikler olacaktır. Eğer bu hız tereddüt etmenize neden oluyorsa, dsh'nin Claude Code ve Omnigent ile karşılaştırması bölümü, bu aracı aynı eğri üzerindeki farklı noktalarda bulunan iki farklı araçla kıyaslar.
Sabitlenmemiş bir npx @deepseek-ai/dsh web herhangi bir sürüm belirtmez, bu nedenle hangi yapının (build) başlayacağını kontrol edemezsiniz. npm belgelerine göre, belirtici içermeyen bir paket adı "yerel projede mevcut olan herhangi bir sürümle eşleştirilir" ve projede bulunmayan bir paket, npm önbelleğindeki bir klasöre kurulur. Hangi yapının başlayacağı o makinede o an neyin bulunduğuna bağlıdır; bu nedenle bir yeniden başlatma, test ettiğinizden farklı bayraklara sahip bir CLI sürümünü çalıştırabilir. Yeniden başlatmanın bir yükseltme işlemine dönüşmemesi için sürümü sabitleyin:
npx @deepseek-ai/dsh@0.2.0-rc.2 webKasım 2026 itibarıyla (2026-11-01 tarihinde kontrol edilmiştir), npm latest etiketi, 2026-10-30 tarihinde GitHub üzerinde yayınlanan 0.2.1-rc.5 sürümünü işaret etmektedir. GitHub kayıtlarına göre 0.2.1-rc.4, 2026-10-28 tarihinde saat 02:49 UTC'de, 0.2.1-rc.3 sürümünden yaklaşık dört gün on bir saat sonra (2026-10-23, 15:26 UTC) yayınlanmıştır. Dolayısıyla, yerel kopyası olmayan bir makinede, yalın bir npx @deepseek-ai/dsh komutu artık bu rehberin sabitlediği yapıyı değil, 0.2.1 sürüm adayını çeker. Sabitlenen 0.2.0-rc.2 sürümü 2026-09-29 tarihinde GitHub üzerinde yayınlanmıştır. Bu rehberin Ağustos ayında sabitlediği 0.1.0-rc.7 yapısı, 0.1 serisinin geri kalanı ve 0.2 serisi boyunca birçok önizleme sürümünün gerisinde kalmıştır. Kabul etmeden önce yalın bir npx komutunun ne çekeceğini kontrol edin:
npm view @deepseek-ai/dsh versionnpm view @deepseek-ai/dsh dist-tags tüm etiketleri aynı anda listeler; bir sürüm adayını sabitlemeden önce alfa sürümünden nasıl ayırt edeceğinizi bu şekilde anlarsınız.
Eğer sabitleme işlemi kuruluma izin vermiyorsa veya yeni bir sürüm sabitledikten sonra npx eski yapıyı başlatmaya devam ediyorsa, bu durumun yol açtığı kurulum ve sürüm hataları bölümü, npx önbelleğinin temizlenmesini ve Node paketinizin hangi npm sürümünü kullandığının kontrol edilmesini açıklar.
Önizleme sürümleri arasında bayraklar, başlatıcı (launcher) ile web uygulaması arasında yer değiştirebilir. Eğer --port bu rehberde anlatıldığı gibi davranmayı bırakırsa, tahmin yürütmek yerine uygulamadan kendi bayrak listesini isteyin:
dsh --profile web --helpKurulumun kendisi, çalışma alanı ayarları ve model anahtarı için DeepSeek Harness'in bir VPS üzerine kurulması bölümüne bakın. Yalnızca erişim adımı için daha kısa bir kılavuz isterseniz, bir VPS üzerinde dsh Web arayüzüne erişim bölümü, mantıksal açıklamalar olmaksızın tünel kurulumunu ele alır.
FAQ
Neden dizüstü bilgisayarımın tarayıcısında http://127.0.0.1:3080 adresini açamıyorum?
Çünkü 127.0.0.1, üzerinde işlem yaptığınız makineyi ifade eder. DeepSeek Harness Web arayüzü, VPS'in loopback adresine bağlıdır; bu nedenle yalnızca VPS üzerindeki süreçler ona bağlanabilir. Dizüstü bilgisayarınızın kendine ait ayrı bir loopback adresi vardır ve orada 3080 numaralı portu dinleyen herhangi bir servis bulunmamaktadır. Portu ssh -N -L 3080:127.0.0.1:3080 you@your-vps ile SSH üzerinden yönlendirin ve ardından yazdırılan tam URL'yi, yani http://127.0.0.1:3080/?token=... adresini yerel olarak tarayıcınızda açın. -L argümanının orta alanı sunucu tarafında çözümlenir; bu da onun harness'ı işaret etmesini sağlar. Token kısmını boş bırakırsanız, tarayıcınız bir oturum çerezi tutana kadar 401 Unauthorized hatası alırsınız.
dsh Web arayüzünü halka açık bir VPS üzerinde 0.0.0.0 adresine bağlamak güvenli midir?
Hayır. Web arayüzü, dsh komutunu çalıştıran kullanıcı yetkileriyle shell komutları yürüten ve dosyaları düzenleyen bir ajanın kontrol yüzeyidir. Kullanıcı hesapları veya bir giriş ekranı yoktur: tek kimlik bilgisi, yazdırılan URL içindeki tokendır; statik varlıklar bu token olmadan sunulur ve projenin kendi belgeleri, dinleme portunun kendisinin korunmasız olduğunu belirtir. Halka açık bir IP üzerinde tüm arayüzlere bağlanmak, sunucunuzdaki komut yürütme yetkisini, 3080 numaralı porta ulaşan herkes için sızdırılmış bir URL mesafesine indirger. Doğrudan halka açık IP'ye bağlanmak da aynı riski taşır. Bağlantıyı 127.0.0.1 üzerinde tutun, 3080 numaralı portu güvenlik duvarında kapalı bırakın ve bir SSH tüneli, özel bir overlay ağı veya parola gerektiren bir reverse proxy kullanın.
SSH oturumumu kapattıktan sonra dsh Web arayüzünün çalışmaya devam etmesini nasıl sağlarım?
Ön planda çalışan bir npx @deepseek-ai/dsh web, giriş shell'inizin bir alt sürecidir; bu nedenle shell kapandığında süreç sonlandırılır. Uygulamayı bir tmux oturumu içinde başlatıp Ctrl-b d ile ayırın veya "lingering" özelliği etkinleştirilmiş bir systemd kullanıcı servisi olarak çalıştırın. Tünel ve harness birbirinden bağımsızdır: harness'ın kendisi giriş oturumunuzdan daha uzun ömürlü bir ebeveyne sahip olduğu sürece, çalışan harness'a dokunmadan SSH tünelini istediğiniz sıklıkta kapatıp yeniden oluşturabilirsiniz.
Nginx arkasında uzun süren bir ajan çalışması sırasında dsh Web arayüzü neden donuyor?
WebSocket bağlantısını ve nginx hata günlüklerini kontrol edin. Nginx'in varsayılan proxy_read_timeout değeri okumalar arasında 60 saniyedir, ancak sabitlenmiş 0.2.0-rc.2 sürümü varsayılan olarak her iki saniyede bir WebSocket ping'i gönderir; bu nedenle tek başına uzun bir ajan adımı bu zaman aşımını tetiklemez. proxy_read_timeout 3600s;, hareketsizlik süresini bir saate çıkarır. proxy_buffering off;, WebSocket çerçeveleri için değil, HTTP yanıtları için arabelleğe almayı devre dışı bırakır. WebSocket el sıkışmasının başarılı olması için proxy_http_version 1.1; ile Upgrade ve Connection başlıklarını iletin. Bu başlıklar olmadan sayfa yüklenir ancak hiçbir güncelleme almaz.