SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor · Güncellendi 2026-11-06

VPS uzerinde dsh servisi nasil calistirilir

dsh aracini systemd servisi olarak VPS uzerinde calistirmanin yollarini ogrenin. Ozel kullanici tanimlama, Restart kurallari ve journalctl ile log takibi adimlarini inceleyin.

dsh aracını bir terminalde değil, VPS üzerinde başıboş (headless) çalıştırma

dsh aracını bir VPS üzerinde başıboş çalıştırmak için tek bir systemd birim dosyası ve bu dosyaya sahip olacak özel bir kullanıcı yeterlidir. dsh, DeepSeek'in Ağustos 2026'da geliştirici önizlemesi olarak MIT lisansı altında yayımlanan aracı çalışma zamanı DeepSeek Harness için komut satırı başlatıcısıdır. Harness, modelin kendisinden ziyade modelin etrafındaki programdır; dolayısıyla systemd altına aldığınız şey DeepSeek çıkarımı değil, döngü, araçlar ve izinlerdir. Hızlı başlangıç kılavuzu size npx @deepseek-ai/dsh web komutunu girmenizi söyler; bu doğrudur ancak SSH (secure shell) oturumunuzu kapattığınız anda süreç sonlanır.

Bir birim dosyası aynı anda dört sorunu çözer. Servis, yeniden başlatma sonrasında tekrar ayağa kalkar. Çıktısı, gözünüzün önünden akıp gitmek yerine journal içerisine kaydedilir. root olmayan bir hesapla çalışır. Ayrıca çalıştırılan sürüm, sizin seçtiğiniz sürümdür; bu durum burada normalden daha önemlidir çünkü geliştirici ekip büyük harflerle şunu belirtmektedir:

DeepSeek Harness şu anda geliştirici önizlemesi aşamasındadır ve hızla güncellenmektedir. UYUMLULUĞU BOZAN DEĞİŞİKLİKLER OLACAKTIR.

Bu kılavuz, dsh aracının halihazırda manuel olarak çalıştığını varsayar. Eğer çalışmıyorsa, DeepSeek Harness'ın bir VPS üzerine kurulması ile başlayın ve npx @deepseek-ai/dsh web bir sayfa sunduğunda geri dönün.

Önce Node, çünkü npm uyarıları yeterli değildir

node -v

Ubuntu 24.04'ün kendi paket deposundaki Node sürümü 18'dir (Ağustos 2026 itibarıyla 18.19.1); bu, bu yıl yayımlanan bir paket için eskidir. npm'in kendisi Node sürümlerini kontrol eder: dokümantasyonu, bir paketin engines alanının, engine-strict etkinleştirilmediği sürece "yalnızca uyarı üreteceğini" belirtir. Yayımlanan @deepseek-ai/dsh manifestleri, depo içerisinde bir alan tanımlanmış olmasına rağmen hiçbir engines alanı içermez (27 Ekim 2026 tarihinde 0.1.0-rc.7, 0.2.1-rc.2 ve 0.2.1-rc.4 için kontrol edilmiştir); ancak npm, bağımlılıkların motor gereksinimlerini de denetler. Sabitlenmiş 0.2.1-rc.2 sürümü commander: ^15.0.0 gereksinimini beyan eder ve Commander 15, Node >=22.12.0 gerektirir; bu nedenle Ubuntu'nun Node 18 sürümü üzerine kurulum yapmak, normal npm ayarlarında bir EBADENGINE uyarısı üretir. Bu uyarı varsayılan olarak kurulumu durdurmaz, bu yüzden çalışma zamanı hatasıyla karşılaşmadan önce Node sürümünü kontrol edin.

Deponun alt sınırı da değişmiştir. 0.2.1-rc.2 kaynağı ^22.19.0 || >=24.0.0 sürümünü kabul eder, ancak master dalındaki CLI paketi artık >=24.9.0 gereksinimi beyan etmektedir ve Node 22 bunu karşılamaz. Node 24'ü NodeSource üzerinden kurun. Bu, 20 Ekim 2026'dan beri bakım aşamasında olan bir uzun süreli destek (LTS) hattıdır ve mevcut yapıları her iki aralığı da karşılar. Node.js sürüm takvimine göre Node 26, 28 Ekim 2026 tarihinde LTS olmuştur.

curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -v

node -v komutu artık 24.9.0 veya daha yeni bir v24 sürümü yazdırmalıdır. less satırı, uzak bir betiği doğrudan bash komutuna yönlendirmenin (pipe), okumadığınız bir kodu çalıştırması nedeniyle oradadır.

Bir unit dosyası yazmadan önce çalıştığını doğrulayın

npx @deepseek-ai/dsh@0.2.1-rc.2 web

Bu süreci çalışır durumda bırakın. İkinci bir SSH oturumundan şu komutu çalıştırın:

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/

Herhangi bir HTTP durum kodu, web profilinin varsayılan olarak bağlandığı loopback arayüzünde dinleme yaptığını gösterir. Bir 401 yanıtı bekleyin ve bunu başarılı olarak kabul edin: Arayüz, tarayıcıları yazdırılan URL içindeki bir başlatma belirteci (launch token) ile doğrular ve bunu imzalı bir oturum çerezi ile takas eder; bu belirteçleri içermeyen bir istek 401 hatası alır. 000 ile birlikte gelen curl: (7) Failed to connect to 127.0.0.1 port 3080, servisin dinleme yapmadığı anlamına gelir; bu durumda ilk terminaldeki hata mesajı nedenini açıklayacaktır. Devam etmeden önce manuel çalışmayı Ctrl+C ile durdurun: Başka bir sürecin halihazırda kullandığı bir porta bağlanmaya çalışan bir unit, Error: listen EADDRINUSE: address already in use 127.0.0.1:3080 hatası ile başarısız olur.

0.1.0-rc.7, 18 Ağustos 2026 tarihinde yayınlanan sürümdü ve bu kılavuzun dayandığı tarayıcı tabanlı kimlik doğrulamasından önceye aittir: Bağlantı README dosyası, korumanın bir erişilebilirlik politikası olduğunu ve "Web taşıyıcısının herhangi bir kimlik doğrulama katmanı sağlamadığını" belirtir. 11 Ekim 2026 tarihinde latest etiketi 0.2.0-rc.2 sürümünü işaret ediyordu. 27 Ekim 2026 tarihinde latest etiketi 0.2.1-rc.2 sürümünü, next etiketi ise 0.2.1-rc.4 sürümünü işaret ediyordu; bu nedenle buradaki komutlar 0.2.1-rc.2 sürümünü sabitlemektedir. 4 Kasım 2026 tarihinde, npm sürüm listesi, hem latest hem de next sürümlerini 0.2.1-rc.5 olarak göstermektedir; buradaki komutlar mevcut sabitlemeyi korur. npm view @deepseek-ai/dsh version komutu ile güncel sürümü kontrol edin ve çalıştırmaya karar verdiğiniz sürümü sabitleyin.

Sabitlediğiniz sürümü global olarak kurun

npx, unit dosyası içerisinde kullanılacak doğru araç değildir. Bir sürüm belirtilmediğinde veya eşleşen bir yerel kurulum bulunmadığında, süreç başladığı anda paket sürümünü çözümler; bu durum, üç ay sonra yapılacak bir yeniden başlatmada, tarafınızda hiçbir değişiklik olmamasına rağmen önizleme aşamasındaki bir aracın farklı bir derlemesinin çalışmasına neden olabilir. Eksik paketler veya önbellek verileri de npm kayıt defterine ihtiyaç duyar; bu nedenle yavaş bir kayıt defteri başlatmayı geciktirebilir veya başarısızlığa uğratabilir; npm, önbellekli ve çevrimdışı çalışmayı da destekler. Kurulumu, not ettiğiniz bir sürümle bir kez yapın:

sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh

command -v dsh, npm NodeSource üzerinden geldiğinde /usr/bin/dsh, Ubuntu'nun kendi paketinden geldiğinde ise /usr/local/bin/dsh çıktısını verir. Unit dosyasında, komutun döndürdüğü gerçek yolu kullanın. npm ls -g, davranış değişikliği olduğunda ve ne kurduğunuzu hatırlamadığınızda altı hafta sonra ihtiyacınız olacak tam sürüm bilgisini yazdırır. Kurulum başarısız olursa, command -v dsh sonrasında hiçbir çıktı vermezse veya aldığınız sürüm talep ettiğiniz sürüm değilse, unit dosyasını yazmadan önce yaygın dsh kurulum ve sürüm hataları bölümünü inceleyin.

Servisin sahibi olan ve başka hiçbir yetkisi bulunmayan bir kullanıcı

Aracı (agent), shell komutlarını çalıştırır. Görevi budur. Aracı root olarak çalıştırıldığında, her araç çağrısı bir root çağrısına dönüşür. Bu nedenle, araca giriş shell'i olmayan özel bir hesap tanımlayın.

sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh

/var/lib/dsh/harness, dsh'ın profilleri tuttuğu dizin olan DSH_HOME haline gelir. Profil, kendi yama katmanınızın üzerinde yer alan, isimlendirilmiş bir eklenti paketleri yığınıdır. web ve headless profilleri, ilk kez başlattığınızda sunulan şablonlardan kendilerini oluşturur. Daha sonra bu yığına eklediğiniz her şey, aracın kendi dosya ve shell erişimiyle bu kullanıcı altında çalışır; bu nedenle bir eklentiyi yüklemeden önce incelemek, hesabı oluşturmakla aynı işin parçasıdır. İlk başlatma işlemi dosyalar yazar ve paketleri indirebilir; bu yüzden işlemi izleyebileceğiniz bir ortamda manuel olarak gerçekleştirin.

sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile web

sudo'nın ne yaptığına güvenmek yerine HOME değerini açıkça belirtin. Çünkü sudo'nin HOME'i koruyup korumayacağı veya yeniden yazıp yazmayacağı, /etc/sudoers içindeki env_reset, env_keep ve always_set_home gibi ayarlara bağlıdır. Hatalı yapılandırma durumunda, ilk çalıştırma önbellek ve durum dosyaları için sizin ev dizininizi kullanmaya çalışır. Bu durum, izin hatalarına yol açar veya durum verilerini servisin daha sonra erişemeyeceği bir yere yazar. curl kontrolü bir durum kodu yazdırdığında Ctrl+C ile işlemi durdurun.

Unit dosyası

/etc/systemd/system/dsh.service yazın:

[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5

[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true

[Install]
WantedBy=multi-user.target

ExecStart=, command -v dsh komutundan aldığınız mutlak yolu kullanır. systemd, yalın bir komut adı için sabit bir yol listesinde arama yapar; ancak bu liste kabuğunuzun PATH değişkeni değildir, bu nedenle mutlak yol kullanmak belirsizliği ortadan kaldırır.

WorkingDirectory=, göreli yolların çözümlendiği ve ls komutunun argümansız çalıştırıldığında başladığı yerdir. Burayı, aracıya (agent) atadığınız çalışma dizinine yönlendirin. Dizin eksikse veya servis kullanıcısı dizine erişemiyorsa, birim dsh çalışmadan önce status=200/CHDIR hatasıyla başarısız olur.

ProtectHome=true, /home ve /root dizinlerini süreçten gizler. Servisin eriştiği her şey /var/lib/dsh altında bulunduğu için bu güvenlidir. Çalışma dizinini /home altında bir yola yönlendirirseniz, aracı dizinin mevcut olmadığını bildirecektir; bu durum, ilgili satırı hatırlayana kadar kafa karıştırıcı olabilir. ProtectSystem=full, servisin yazma ihtiyacı duymadığı /usr, /boot ve /etc dizinlerini salt okunur hale getirir.

Daha ileri gitmek cazip gelse de genellikle yanlıştır. ProtectSystem=strict, çekirdek sözde dosya sistemleri ve bu birimin PrivateTmp=true, /tmp ve /var/tmp ayarları haricinde tüm dosya sistemini salt okunur yapar; bu nedenle çalışma dizinine yapılan yazma işlemleri EROFS: read-only file system hatasıyla başarısız olur. Bu seviyede bir kısıtlama istiyorsanız, aynı düzenleme içerisinde ReadWritePaths=/var/lib/dsh satırını ekleyin.

Burada hangi Type= kullanılmalı

Type=exec, çünkü dsh ön planda kalır ve asla fork işlemi gerçekleştirmez. Bunun varsayılan ayara göre sağladığı avantaj, gerçek bir hata mesajı alabilmenizdir. Type=simple ile systemd, ikili dosyanın var olup olmadığını bile bilmeden, fork işlemi gerçekleştiği anda başlatma işlemini başarılı kabul eder; bu nedenle systemctl start dsh temiz bir şekilde döner ve hata yalnızca günlük kayıtlarında (journal) görünür. Type=exec ile systemd, execve() işleminin başarılı olmasını bekler; böylece ExecStart= içindeki bir yazım hatası, komutu girdiğiniz anda başarısız olur ve hatayı doğrudan görürsünüz.

Diğer iki yanlış cevapta da sistem yanıt vermeyi durdurur (hang). Type=forking, systemd'ye bir üst sürecin (parent process) sonlanmasını beklemesini söyler; dsh asla sonlanmadığı için başlatma işlemi TimeoutStartSec süresi dolana kadar (varsayılan olarak 90 saniye) bekler ve ardından Job for dsh.service failed because a timeout was exceeded. hatasını raporlar. Type=notify, sd_notify üzerinden bir READY=1 mesajı bekler; bu mesajı asla göndermeyen bir Node süreci de aynı şekilde kilitlenir. systemd servis türlerinin tam karşılaştırması, notify yapılandırmasının ne zaman zahmete değer olduğu da dahil olmak üzere geri kalan detayları kapsar.

Hata durumunda yeniden başlatma kuralları

Restart=on-failure, sıfır olmayan bir çıkış kodunda veya temiz olmayan bir sinyalde yeniden başlatma yapar ve temiz bir çıkıştan sonra birimi olduğu gibi bırakır; systemd, bu servis türü için SIGHUP, SIGINT, SIGTERM ve SIGPIPE sinyallerini temiz sinyaller olarak kabul eder. Bir önizleme sürümünden beklediğiniz davranış budur. Eğer dsh, beğenmediği bir yapılandırmayı okuduğu için 0 koduyla çıkış yaparsa, birim durur ve durmuş halde kalır; systemctl status dsh üzerinde inactive (dead) durumunu görebilirsiniz. Restart=always ise aynı olayı, uzaktan bakıldığında sağlıklı görünen bir yeniden başlatma döngüsüne dönüştürür.

Hız sınırlaması, insanların göz ardı ettiği kısımdır. systemd'nin varsayılan ayarları on saniye içinde beş başlatmadır ve RestartSec=5s ile on saniyelik bir pencerede asla beş başlatmaya ulaşamazsınız; bu nedenle başlangıçta çöken bir birim sonsuza kadar yeniden başlar ve bunu yalnızca journal kaydeder. StartLimitIntervalSec=300 ve StartLimitBurst=5 kullanımı, beş dakika içinde beş başlatmaya izin verir, ardından bu aralıkta başka bir başlatmayı reddeder. systemd pes eder ve birimi failed durumuna getirerek Start request repeated too quickly. kaydını düşer. Sorunun nedenini giderdikten sonra sudo systemctl reset-failed dsh ile bu durumu temizleyin. Her iki ayar da [Service] içine değil, [Unit] içine eklenmelidir; tanınmayan seçenekler sessizce göz ardı edilmek yerine uyarı günlükleri oluşturur.

Servisi başlatın ve kontrol edin

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

enable --now iki işlevi yerine getirir. enable, yeniden başlatma sonrasında servisin tekrar ayağa kalkmasını sağlar; --now ise servisi mevcut oturumda başlatır. Yalnızca systemctl start komutunun etkisi bir sonraki yeniden başlatmada kaybolur; çekirdek güncellemeleri ise yeniden başlatma gerektirir.

systemctl status dsh komutu Active: active (running), bir Main PID ve bir Memory: satırı göstermelidir. Ardından servisin hangi adreste dinleme yaptığını doğrulayın:

sudo ss -lntp | grep 3080

127.0.0.1:3080 çıktısını görmeniz gerekir. Başka bir adres görürseniz, bir --host bayrağı dinleyiciyi ilgili ağa taşımış demektir; bu durumda TLS yapılandırılmadığı sürece düz HTTP sunulur. Çıktıdaki süreç adı dsh değil, node olarak görünür; çünkü dsh ikili dosyası bir Node betiğidir ve bu nedenle pgrep -x dsh hiçbir sonuç döndürmez. Bunun yerine systemctl show -p MainPID dsh kullanın.

Ardından sistemi bir kez yeniden başlatın. Yeniden başlatma sonrasında çalışmayan bir servis, henüz tam anlamıyla bir servis sayılmaz.

sudo reboot

Tekrar bağlanın ve systemctl is-active dsh komutunu çalıştırın. Bu komut active çıktısını verecektir.

journalctl ile günlük kayıtlarını okuma

dsh tarafından stdout ve stderr'e yazılan her şey, birim adı altında journal içinde saklanır.

journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err

-f yeni satırları takip eder, -n son N satırı gösterir, -p err ise önceliğe göre filtreleme yapar. Birim içindeki SyslogIdentifier=dsh, bu satırların neden node yerine dsh olarak etiketlendiğini açıklar; bu durum, birim bazlı filtrelenmemiş journal çıktısını ilk kez okurken önem arz eder.

İhtiyaç duymadan önce journal kayıtlarının yeniden başlatmalardan sonra kalıcı olup olmadığını kontrol edin:

journalctl -u dsh -b -1

Eğer bu komut Specifying boot ID or boot offset has no effect, no persistent journal was found çıktısını verirse, journal /run dizininde tutuluyor demektir ve her yeniden başlatmada silinir. Storage=auto ile dizini oluşturun ve servisi yeniden başlatın; eğer Storage=volatile yapılandırılmışsa, önce bunu persistent olarak değiştirin:

sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald

Kalıcı depolamaya geçmek ve mevcut önyükleme sürecine ait günlük kayıtlarını diske yazmak için sudo journalctl --flush komutunu çalıştırın.

UI'ye public port yerine SSH tüneli üzerinden erişin

dsh, web UI'yi (kullanıcı arayüzünü) varsayılan olarak 127.0.0.1:3080 üzerinde sunar. Loopback varsayılandır, ancak tek seçenek değildir: --host, yerel bir interface'e ait tek bir IPv4 veya IPv6 adresini kabul eder. Loopback dışındaki herhangi bir adres, başlangıçta bir uyarı göstererek ait olduğu ağa düz HTTP üzerinden hizmet verir; bunun istisnası, ayrıca --tls-cert ve --tls-key parametrelerinin geçirilmesidir. dsh'nin reddettiği şey wildcard kullanımıdır. --host 0.0.0.0 istendiğinde hata şu şekilde başlar:

webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:

Devamında, "her interface'e bağlanmanın uzaktan kod yürütmeyi ağa açacağını" belirtir ve bunun yerine "yerel bir interface'e ait tek bir IPv4 veya IPv6 adresine bağlanılmasını" söyler. Hostname gibi hiç IP literal olmayan bir değer ise is not a concrete IPv4 or IPv6 address literal ile başarısız olur.

Yine de varsayılanı koruyun. Web API (uygulama programlama arayüzü) agent'ı çalıştırır ve agent shell komutlarını yürütür. dsh, bu API'nin önüne kimlik doğrulama ekler: Host ve Origin kontrolleri ile UI'nin imzalı bir session cookie almak için kullandığı, yazdırılan URL'deki launch token. Ancak düz HTTP üzerinden bu token ağdan cleartext olarak geçer ve upstream'in kendi belgeleri, Host kontrolünün listening port'un kendisini korumadığını belirtir. UI'ye gerçek bir hostname üzerinden erişmeniz gerekiyorsa DeepSeek'in public deployments guide belgesi, --public-url ve --trusted-host ile reverse proxy kullanımını veya --tls-cert ve --tls-key ile native TLS kullanımını açıklar. Başlangıç çıktısındaki 127.0.0.1:3080 satırının gerçekte ne anlama geldiğini dsh'yi taşımayı denemeden önce okumakta yarar vardır. Yalnızca sizin kullandığınız bir makine için portu kendi makinenizden forward edin:

ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10

-L 3080:127.0.0.1:3080, laptop'ınızda 3080 portunu açar ve buraya gelen her şeyi 127.0.0.1:3080 adresine, VPS üzerinde çözümlendiği haliyle gönderir. -N uzak bir komut çalıştırılmaması anlamına gelir; bu nedenle session yalnızca tüneli açık tutar. Çalışır durumda bırakın, dsh'nin başlangıçta yazdırdığı URL'yi journalctl -u dsh -n 100 --no-pager ile bulun ve tarayıcınızda açın. Bu URL launch token'ını taşır. Giriş yapılmamış bir tarayıcıda çıplak http://127.0.0.1:3080/ açıldığında 401 alırsınız. Token çalışan prosese aittir, ancak token karşılığında alınan session cookie süreçten uzun süre geçerlidir: cookie, dsh'nin $DSH_HOME/.credentials.yaml içinde tuttuğu bir secret ile imzalanır ve varsayılan olarak 30 gün geçerli olur. Bu nedenle daha önce giriş yapılmış bir tarayıcı, yeniden başlatma sonrasında bile çıplak URL'yi tekrar açabilir. Journal'dan yalnızca yeni bir tarayıcı için veya cookie süresi dolduğunda yeni bir URL almanız gerekir. URL'yi bir kimlik bilgisi olarak değerlendirin: upstream, URL'nin yalnızca hedeflenen kullanıcılarla paylaşılmasını söyler ve system journal'ı okuyabilen herkes URL'yi okuyabilir. Giriş yaptıktan sonra DeepSeek API key'i Settings, ardından Models bölümünde girersiniz ve workspace directory'yi burada seçersiniz. Workspace'i, service user'ın sahip olduğu /var/lib/dsh/workspace dizinine yönlendirin; aksi halde agent'ın file tools araçları EACCES: permission denied ile başarısız olur.

Laptop'ınızda 3080 portu meşgulse ssh bunu bildirir:

bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080

ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10 ile farklı bir local port seçin ve 3080 değeri 3081 olarak değiştirilmiş yazdırılan URL'yi açın. Yazma işlemini kendi makinenizde ~/.ssh/config içine kaydedin:

Host dsh-vps
  HostName 203.0.113.10
  User you
  LocalForward 3080 127.0.0.1:3080

Bundan sonra ssh -N dsh-vps komutun tamamıdır. Bu tünel artık agent'ınıza açılan tek kapıdır; dolayısıyla onu koruyan bileşen SSH daemon'dır: yalnızca key kullanımı, password authentication olmaması ve VPS'nizde SSH'yi harden etme bölümünün geri kalanındaki uygulamalar burada normalden daha büyük önem taşır. VPS, arkasında bir database veya staging box bulunan küçük bir private network'e dönüşürse bu adresleri bir subnet router ile tailnet'inize duyurmak her servis için ayrı bir forward gereksinimini ortadan kaldırır. Ancak dsh loopback varsayılanıyla çalıştığında UI yine bir tünel üzerinden gelir.

Key, unit file içinde bulunmamalıdır. Environment= değerleri, makinedeki herhangi bir kullanıcının çalıştırabileceği systemctl show dsh -p Environment tarafından yazdırılır. Kurduğunuz bir plugin'in environment içinde key'e ihtiyacı varsa key'i /etc/dsh.env içine, root'un sahibi olduğu ve mode değeri 600 olan bir dosya olarak koyun ve EnvironmentFile=/etc/dsh.env ile referans verin. systemd bu dosyayı exec zamanında root olarak okur ve systemctl show içeriğini yazdırmaz. Her ayarın diskte gerçekte hangi dosyaya yazıldığı ve dsh'yi DeepSeek API yerine yerel bir Ollama endpoint'ine yönlendirdiğinizde makinenizden nelerin çıktığı, dsh'nin key, model ve endpoint ayarlarını yapılandırma bölümünün konusudur.

Çalıştırma maliyeti

Çıkarım işlemleri VPS üzerinde değil, DeepSeek API tarafında gerçekleşir. Sunucunuz Node sürecini, sunduğu arayüzü ve ajanın çalıştırmaya karar verdiği her komutu karşılar. İlk ikisi sabit ve düşüktür. Üçüncüsü ise bu birim dosyasında herhangi bir sınıra tabi değildir.

Başkalarının verdiği rakamlara güvenmek yerine, kendi sunucunuzdaki taban değerleri ölçün:

systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2

MemoryCurrent bayt cinsindendir. Değeri, ajan boşta beklerken değil, çalışırken izleyin.

Araç çağrıları servisin alt süreçleridir; bu nedenle aynı kontrol grubuna dahil edilirler ve aynı sınırlara tabi tutulurlar. Çalışma alanı içerisinde npm install veya bir test paketi çalıştıran bir ajan, ana süreçten çok daha fazla bellek tüketebilir. 1 GB RAM'e sahip bir VPS üzerinde sorun burada başlar: çekirdek bir süreci seçer ve sonlandırır; journalctl -k | grep -i "out of memory" çıktısında, seçilen süreci belirten Out of memory: Killed process satırı görülür. Bu süreç genellikle soruna neden olan süreç değildir.

Çözüm, bilinçli olarak belirleyeceğiniz bir sınırdır. [Service] bölümündeki MemoryMax= ve CPUQuota= ayarları, hasarı birim içerisinde tutar; böylece kontrolden çıkan bir derleme işlemi tüm sunucuyu kilitlemek yerine sadece ilgili birimi sonlandırır. systemd ile bellek ve CPU sınırlama bölümü, sayısal değerleri ve hata davranışlarını açıklar. Disk kullanımı da DSH_HOME altındaki oturum geçmişi ve ajanın çalışma alanına yazdığı veriler nedeniyle artar; bu yüzden du -sh /var/lib/dsh değerini disk izleme araçlarınıza dahil edin.

Eğer etkileşimli, bağlanıp ayrılabileceğiniz bir ajan istiyorsanız, servis yapısı uygun değildir; kalıcı bir tmux oturumunda ajan çalıştırma yöntemi daha uygundur. dsh aracını, her zaman ayakta kalmasını ve bir tünel üzerinden erişilebilir olmasını istediğiniz durumlarda birim olarak çalıştırın.

Başarısızlık durumları ve göreceğiniz ifadeler

status=203/EXEC. systemd dosyayı çalıştıramadı ve günlük kayıtları Failed to locate executable /usr/local/bin/dsh: No such file or directory. ExecStart= içindeki yol, command -v dsh çıktısındakiyle eşleşmiyor. Bu, Type=exec tarafından systemctl start zamanında bildirilen hatadır; hata gizlenmez.

status=217/USER. systemd, User= ve Group= içindeki kullanıcı kimlik bilgilerini belirleyemedi veya değiştiremedi ya da kullanıcı ad alanını kuramadı. Bu unit için olağan neden, mevcut olmayan bir hesaptır. id dsh ile doğrulayın.

status=200/CHDIR. WorkingDirectory= eksik veya servis kullanıcısı bu dizine giremiyor. sudo -u dsh ls /var/lib/dsh/workspace sorunu doğrudan yeniden oluşturur.

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. Portu başka bir süreç zaten kullanıyor; genellikle npx, başka bir terminalde açık bırakılmış çalıştırmadır. sudo ss -lntp | grep 3080 sürecin adını gösterir.

EACCES: permission denied ve ardından bir yol. /var/lib/dsh altındaki sahiplik hatalıdır. Bunun olağan nedeni, ilk çalıştırmanın root olarak veya yanlış HOME ile yapılmış olmasıdır. sudo chown -R dsh:dsh /var/lib/dsh sorunu düzeltir.

Start request repeated too quickly. Unit, başlatma hızı sınırına ulaştı ve vazgeçti. Gerçek hata, üstündeki satırlardadır. Yeniden denemeden önce sudo systemctl reset-failed dsh çalıştırın.

Unit active (running) durumunda, ancak tarayıcıda hiçbir şey görünmüyor. Denetimi VPS üzerinde çalıştırın: curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ burada bir durum kodu yazdırıyorsa listener VPS üzerinde yanıt veriyor demektir; bu nedenle sıradaki adımda port yönlendirmesini inceleyin. Bu kod, her şeyin yüklendiğini kanıtlamaz: upstream, isteğe bağlı plugin hatalarının hazır olma durumunu bastırmadığını belirtir; bu nedenle plugin hataları için journalctl -u dsh -n 200 --no-pager çıktısını da okuyun. Tarayıcıdaki 401, geçerli bir session cookie bulunmadığı ve URL'nin geçerli bir launch token taşımadığı anlamına gelir. Bunun nedeni bare URL'yi açmanız veya token'ın son yeniden başlatmadan önceki çalıştırmaya ait olması olabilir. Geçerli sürecin yazdırdığı URL'yi açın.

Bilerek yükseltme

Sürüm sabitleme, yükseltmenin başınıza gelen bir işlem değil, sizin gerçekleştirdiğiniz bir işlem olmasını sağlar. Önce release notes belgelerini okuyun; upstream tarafından uyumluluğu bozan değişikliklerle ilgili yapılan uyarı, sürümü sabitlemenin temel nedenidir. State directory yedeğini alın, ardından sürümü değiştirin:

sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pager

Geri alma işlemi, eski sürümle aynı npm install -g işleminin uygulanmasına ve ilgili tarball'ın geri yüklenmesine dayanır. Bu işlem yalnızca tarball'ı önceden aldıysanız çalışır. Preview aşamasındaki bir agent runtime, yükseltmenin config formatını siz fark etmeden değiştirebileceği yazılım türüdür.

FAQ

SSH oturumumu kapattığımda dsh neden duruyor?

npx @deepseek-ai/dsh web, oturumunuza bağlı bir ön plan süreci olduğu için oturum sonlandığında kapatılır. Bir systemd birimi ise init sistemine aittir; bu nedenle bağlantıyı kestiğinizde çalışmaya devam eder ve yeniden başlatma sonrasında tekrar ayağa kalkar. sudo systemctl enable --now dsh, size her ikisini de sağlayan iki adımlı işlemdir: yeniden başlatma için enable, mevcut önyükleme için --now.

dsh için Type=simple mı yoksa Type=exec mi kullanmalıyım?

Type=exec. dsh ön planda çalışır ve hiçbir zaman fork işlemi yapmaz, bu yüzden her ikisi de çalışır; ancak Type=exec, systemd'nin başlatmanın başarılı sayılması için execve() işleminin tamamlanmasını beklemesini sağlar. ExecStart= içindeki hatalı bir yol, systemctl start işleminin status=203/EXEC hatasıyla başarısız olmasına neden olur. Type=simple ile aynı hata başarı döndürür ve günlük kayıtlarında gizli kalır. Type=forking ve Type=notify burada yanlıştır ve her ikisi de varsayılan olarak 90 saniye sonra TimeoutStartSec zaman aşımına uğrayana kadar askıda kalır.

dsh web arayüzünü dizüstü bilgisayarımdan nasıl açarım?

Portu SSH üzerinden yönlendirin: ssh -N -L 3080:127.0.0.1:3080 you@your-vps, ardından dsh'nin başlangıçta yazdırdığı ve journalctl -u dsh ile bulabileceğiniz URL'yi tarayıcınızda açın. Bu URL başlatma belirtecini (launch token) taşır; giriş yapmamış bir tarayıcı bu belirteç olmadan 401 hatası alır. Giriş yapıldıktan sonra oturum çerezi varsayılan olarak 30 gün geçerlidir ve servis yeniden başlatmalarından etkilenmez. Servisi varsayılan loopback ayarında bırakın. dsh, --host 0.0.0.0 gibi joker karakterleri belirtilmemiş adres olarak reddeder; somut bir yerel adresi kabul etse de, loopback dışı bir bind işlemi TLS yapılandırmadığınız sürece düz HTTP üzerinden hizmet verir. Bu durum, ağ üzerinde kabuk komutları çalıştıran bir aracı için başlatma belirtecinin açık metin olarak gönderilmesine neden olur.

İzinleri basit tutmak için dsh'yi root olarak çalıştırabilir miyim?

Hayır. Harness, komut çalıştırmak ve dosya yazmak için vardır; dolayısıyla servisin sahip olduğu tüm ayrıcalıklar, aracının da ayrıcalıklarıdır. useradd --system --shell /usr/sbin/nologin dsh ile bir sistem hesabı oluşturun, /var/lib/dsh dizininin sahipliğini bu hesaba verin ve birime NoNewPrivileges=true ekleyin. Daha sonra EACCES: permission denied hatası alırsanız, bunun yaygın nedeni daha önce root olarak yapılan bir çalıştırmanın root sahipliğinde dosyalar bırakmasıdır; sudo chown -R dsh:dsh /var/lib/dsh bu dosyaları temizler.

Birimde dsh'nin hangi sürümünü sabitlemeliyim?

Servisi kurarken npm view @deepseek-ai/dsh version ne bildiriyorsa, npm install -g @deepseek-ai/dsh@<that version> ile kurduğunuz ve bulabileceğiniz bir yere kaydettiğiniz sürümü kullanın. 18 Ağustos 2026 tarihinde 0.1.0-rc.7, 11 Ekim 2026 tarihinde 0.2.0-rc.2 ve 27 Ekim 2026 tarihinde 0.2.1-rc.2 günceldi; next ise halihazırda 0.2.1-rc.4 sürümündeydi. 4 Kasım 2026 itibarıyla hem latest hem de next, 0.2.1-rc.5 sürümünü işaret etmektedir. 0.1.0-rc.7 kadar eski sürümlerde tarayıcı kimlik doğrulaması yoktur, bu yüzden web profili için bu sürümlerden birini sabitlemeyin. Önemli olan numara değil, sürüm belirtilmeden yapılan npx işleminin paketi başlatma anında çözümlemesidir; bu durum, gözetimsiz bir yeniden başlatmanın sizi sessizce farklı bir yapılandırma formatına sahip bir sürüme taşımasına neden olabilir.

Bu yazı işinize yaradı mı?