SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor

VPS पर DeepSeek Harness कैसे सुरक्षित रूप से सेटअप करें

Linux VPS पर DeepSeek Harness इंस्टॉल करने का सुरक्षित तरीका जानें। npm वर्शन पिन करें और पोर्ट 3080 के वेब UI को SSH टनल के जरिए एक्सेस करें ताकि आपका डेटा निजी रहे।

DeepSeek Harness क्या है

DeepSeek Harness (dsh) एक Node.js एजेंट रनटाइम है जिसे आप VPS (virtual private server) पर चला सकते हैं। इसे चलाने का सुरक्षित तरीका यह है कि इसे 127.0.0.1 से bind किया जाए और आपका ब्राउज़र SSH (secure shell) टनल के माध्यम से उस तक पहुँचे। यह टर्मिनल के बजाय पोर्ट 3080 पर एक वेब UI (user interface) प्रदान करता है। 0.1.0-rc.6 रिलीज़ में, जिसे यह गाइड आधार मानती है, वह वेब सर्वर अपना कोई पासवर्ड नहीं मांगता है। इसलिए, यदि पोर्ट 3080 को public कर दिया जाए, तो कोई भी व्यक्ति जो इसे ढूँढ लेता है, उसे एक ऐसा एजेंट मिल जाता है जो आपकी फाइलों को पढ़ सकता है और आपके Linux यूजर के रूप में कमांड चला सकता है। नई रिलीज़ में, 0.2.0-rc.2 से लेकर 11 नवंबर 2026 की 0.2.2-rc.2 तक (जो 12 नवंबर 2026 को GitHub पर सूचीबद्ध सबसे नई रिलीज़ है), स्टार्टअप के समय एक URL प्रिंट होता है जिसमें उस प्रोसेस के लिए एक नया टोकन होता है जिसे बाद में session cookie से बदल दिया जाता है। हालाँकि, ये अभी भी डिफ़ॉल्ट रूप से loopback पर ही listen करते हैं और हर इंटरफ़ेस पर bind होने से इनकार करते हैं।

DeepSeek इसे MIT लाइसेंस के तहत, npm पैकेज @deepseek-ai/dsh के रूप में प्रकाशित करता है। प्रोजेक्ट खुद को एक डेवलपर प्रीव्यू बताता है और स्पष्ट करता है कि इसमें ऐसे बदलाव अपेक्षित हैं जो कम्पैटिबिलिटी को तोड़ सकते हैं। नीचे दी गई पिन की गई वर्ज़न अगस्त 2026 की रिलीज़ है। 12 नवंबर 2026 को npm का latest टैग 0.2.2-rc.1 को दर्शाता है। GitHub पर नई प्री-रिलीज़ 0.2.2-rc.2 सूचीबद्ध है, जिसे dsh-v0.2.2-rc.2 टैग किया गया है और 11 नवंबर 2026 को रिलीज़ किया गया है। किसी भी महत्वपूर्ण सर्वर पर इसे कॉपी करने से पहले रिपॉजिटरी की जाँच अवश्य करें।

इसके पूरे डिज़ाइन में एक ही विचार काम करता है: सब कुछ एक प्लगइन है। मॉडल एडाप्टर, टूल रजिस्ट्री, सेशन लॉग, सैंडबॉक्स, शेड्यूलर और खुद एजेंट लूप, ये सभी एक साझा संदर्भ (shared context) में लोड किए गए प्लगइन्स हैं, और इनमें से किसी को भी बदला जा सकता है। इसमें कोई ऐसा विशेषाधिकार प्राप्त कोर (privileged core) नहीं है जिसे प्लगइन्स केवल सजाते हों। यही वह विशेषता है जो इस हार्नेस को आज़माने लायक बनाती है, और यही वह जगह है जहाँ एकमात्र वास्तविक जोखिम भी निहित है। यह सौदा सही है या नहीं, यह इस पर निर्भर करता है कि आप इसकी तुलना किससे कर रहे हैं। Claude Code और Omnigent के मुकाबले यह कैसा है लेख इस 'प्लगइन-एवरीथिंग' डिज़ाइन की तुलना मॉडल कपलिंग, लाइसेंस और VPS की आवश्यकता के आधार पर अन्य दो विकल्पों से करता है।

Harness एक मॉडल नहीं है

Harness एजेंट लूप को चलाता है। रीजनिंग (reasoning) कहीं और किसी मॉडल में होती है, इसलिए जब तक आप इसे API (application programming interface) की (key) या अपने द्वारा होस्ट किए गए मॉडल एंडपॉइंट का पता नहीं देते, तब तक कुछ भी काम नहीं करेगा। इस पोस्ट में सब कुछ harness कॉन्फ़िगरेशन है, न कि मॉडल का व्यवहार, और इन दोनों के बीच की रेखा को स्पष्ट समझना आवश्यक है, ताकि आप यह डीबग करने में अपना समय बर्बाद न करें कि समस्या किस तरफ से आ रही है।

आप इसे UI में Settings और फिर Models के अंतर्गत कॉन्फ़िगर करते हैं। DeepSeek का अपना कार्ड है, और वर्तमान releases में इसके नीचे दिया गया "Add model provider" बटन दो मोड खोलता है। "Third-party model provider" उन प्रदाताओं को कवर करता है जिनके लिए harness एक कैटलॉग प्रदान करता है, जैसे कि OpenAI और Anthropic, जहाँ आप एक की (key) पेस्ट करते हैं और कैटलॉग एंडपॉइंट और मॉडल सूची प्रदान करता है। "Custom model API" एक दिलचस्प विकल्प है: यह एक लोअरकेस प्रदाता ID, एक डिस्प्ले नाम, एक बेस URL, एक API प्रोटोकॉल, एक क्रेडेंशियल और कम से कम एक मॉडल लेता है। प्रोटोकॉल पिकर OpenAI Chat Completions, OpenAI Responses, Anthropic Messages और Gemini API प्रदान करता है, इसलिए आप एक गेटवे या लोकल सर्वर कॉन्फ़िगर कर सकते हैं जो इनमें से किसी एक का उपयोग करता हो; जिन एंडपॉइंट्स के रिक्वेस्ट-फॉर्मेट में अंतर होता है, उनके लिए कम्पैटिबिलिटी सेटिंग्स की आवश्यकता होती है। कस्टम प्रदाता आपके लिए मॉडल सूची भरने हेतु OpenAI-compatible GET /models एंडपॉइंट को भी क्वेरी कर सकते हैं।

इसी तरह आप harness को उसी VPS पर मौजूद मॉडल की ओर निर्देशित करते हैं। Ollama http://127.0.0.1:11434/v1/ पर एक OpenAI-compatible API को expose करता है, और API की (key) फ़ील्ड कोई भी स्ट्रिंग ले सकती है, जिसे कन्वेंशन के अनुसार ollama रखा जाता है, क्योंकि OpenAI-style क्लाइंट को एक वैल्यू की आवश्यकता होती है और Ollama इसे अनदेखा कर देता है। Ollama के अपने दस्तावेज़ ollama launch dsh का भी वर्णन करते हैं, जो अनुपस्थित होने पर @deepseek-ai/dsh को इंस्टॉल करता है और इसे एक Ollama मॉडल के विरुद्ध शुरू करता है, इसलिए नीचे दिए गए पिन पर भरोसा करने से पहले जांच लें कि यह कौन सा वर्ज़न इंस्टॉल करता है। क्या आपके VPS पर फिट होने वाला मॉडल एक एजेंट को चलाने के लिए पर्याप्त अच्छा है, यह एक कठिन प्रश्न है, और Ollama और vLLM के बीच एक लोकल मॉडल सर्वर के रूप में अंतर यह तय करता है कि इसका उत्तर आपकी कितनी RAM खर्च करेगा।

UI में टाइप की गई कीज़ (keys) केवल राइट-ओनली (write-only) होती हैं। Harness उन्हें $DSH_HOME/.credentials.yaml में स्टोर करता है, और सेटिंग्स केवल एक क्रेडेंशियल रेफरेंस रखती हैं, जिसे वर्तमान releases सक्रिय प्रोफ़ाइल की पैच फ़ाइल, $DSH_HOME/profiles/<profile>/cordis.patch.yml में लिखते हैं (प्रोफ़ाइल dsh web के लिए web है)। $DSH_HOME डिफ़ॉल्ट रूप से ~/.dsh पर सेट होता है। क्रेडेंशियल्स फ़ाइल को पासवर्ड फ़ाइल की तरह ही समझें, क्योंकि यह वही है: जो कोई भी इसे पढ़ सकता है, वह आपके API बजट का उपयोग कर सकता है। यदि आप सेटिंग्स में क्लिक करने के बजाय सीधे उन फ़ाइलों को एडिट करना चाहते हैं, तो dsh कॉन्फ़िगरेशन फ़ाइलों, कीज़ (keys) और मॉडल एंडपॉइंट्स का वॉकथ्रू दिखाता है कि प्रत्येक की (key) क्या करती है और प्रत्येक मोड में आपके बॉक्स से क्या बाहर जाता है।

इंस्टॉलेशन से पहले आपकी आवश्यकताएं

  • Ubuntu 24.04 या किसी अन्य आधुनिक Linux पर चल रहा एक VPS, जिसमें SSH एक्सेस हो
  • Node.js 24.9 या उससे नया वर्ज़न, क्योंकि प्रोजेक्ट की मुख्य ब्रांच और 0.2.2-alpha.2 अब >=24.9.0 को घोषित करते हैं और इसके CI टेस्ट Node 24 के साथ Node 24.9 और Node 26 पर कम्पैटिबिलिटी चेक करते हैं, जिसमें Node 22 के लिए कोई जॉब नहीं है; 0.2.1-rc.4 के माध्यम से टैग किए गए रिलीज़ में Node 22.19 को स्वीकार्य बताया गया था, लेकिन अब यह वह न्यूनतम स्तर नहीं है जिस पर प्रोजेक्ट बिल्ड होता है
  • एक सामान्य यूजर अकाउंट, न कि root, क्योंकि एजेंट उन शेल कमांड्स को चलाता है जो प्रोसेस शुरू करने वाले यूजर के अधिकार से चलते हैं
  • यदि आप प्लगइन्स इंस्टॉल करने की योजना बना रहे हैं तो PATH पर pnpm होना चाहिए, क्योंकि प्लगइन कमांड इसे शेल आउट करता है
  • आपके फायरवॉल और आपके प्रोवाइडर के अलग नेटवर्क फायरवॉल पर पोर्ट 3080 बंद होना चाहिए

Ubuntu 24.04 का अपना nodejs पैकेज उस हार्नेस की आवश्यकता से पुराना है, इसलिए उस रिलीज़ पर apt install nodejs का उपयोग करने के बजाय NodeSource या nvm से Node इंस्टॉल करें। Ubuntu 26.10 की आधिकारिक रिपॉजिटरी में Node 24.19.0 लिस्टेड है, जो Node 24.9 की न्यूनतम आवश्यकता से अधिक है। यदि VPS नया है, तो किसी भी अन्य काम से पहले SSH को हार्डन करना दस मिनट का एक सार्थक निवेश है, क्योंकि जिस टनल पर आप निर्भर होने वाले हैं, उसकी मजबूती उसके पीछे चल रहे SSH सर्वर पर ही निर्भर करती है।

VPS पर DeepSeek Harness इंस्टॉल करें, एक विशिष्ट वर्ज़न पर पिन करें

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

npx पैकेज को डाउनलोड करता है और इसके dsh बाइनरी को चलाता है। web, --profile web के लिए एक उपनाम (alias) है, जो ब्राउज़र एप्लिकेशन को बूट करता है, और यह प्रक्रिया उस पते को प्रिंट करती है जिस पर यह लिसन (listen) कर रही है। डिफ़ॉल्ट पता http://127.0.0.1:3080 है। ये नंबर केवल दिखावटी डिफ़ॉल्ट नहीं बल्कि एक बाइंडिंग निर्णय हैं, और dsh लूपबैक एड्रेस क्यों प्रिंट करता है यह बताता है कि आपके लैपटॉप से इसे एक्सेस करने से पहले हार्नेस किन अनुरोधों का उत्तर देगा और किनका नहीं।

वर्ज़न को पिन करें। npx @deepseek-ai/dsh web उस समय के किसी भी वर्ज़न को रिज़ॉल्व करता है जिस पर latest टैग पॉइंट कर रहा होता है, जब तक कि जिस प्रोजेक्ट से आप इसे चला रहे हैं उसमें पहले से ही एक कॉपी इंस्टॉल न हो; यदि ऐसा है, तो npx चुपचाप उस कॉपी का उपयोग करता है। किसी भी स्थिति में, वर्ज़न का चुनाव आप नहीं कर रहे होते हैं, और प्रोजेक्ट ने पहले ही कई रिलीज़ कैंडिडेट जारी कर दिए हैं और चेतावनी दी है कि इसमें ब्रेकिंग बदलाव आने वाले हैं। 0.1.0-rc.6 यहाँ अगस्त 2026 का वर्ज़न है जिसे पिन किया गया है। 12 नवंबर 2026 को latest, 0.2.2-rc.1 पर पॉइंट करता है, जो एक ऐसा रिलीज़ है जो टोकनाइज़्ड स्टार्टअप URL प्रिंट करता है; GitHub पर नया प्री-रिलीज़ 0.2.2-rc.2 सूचीबद्ध है, इसलिए किसी अन्य वर्ज़न पर जाना एक ऐसा अपग्रेड है जिसे रिपॉजिटरी पढ़ने के बाद जानबूझकर किया जाना चाहिए। एक पिन किए गए वर्ज़न का मतलब है कि आज जो सर्वर आपने सेटअप किया है, वह अगले महीने भी वैसा ही व्यवहार करेगा, जिससे अपग्रेड एक ऐसा निर्णय बन जाता है जिसे आप स्वयं लेते हैं, न कि कोई ऐसी दुर्घटना जिसका पता आपको बाद में चले। जब कोई पिन किया गया कमांड गलत बिल्ड शुरू करता है या इंस्टॉल होने से मना कर देता है, तो सामान्य dsh इंस्टॉल और वर्ज़न त्रुटियाँ npx कैश को क्लियर करने और यह जाँचने में मदद करती हैं कि आपका Node कौन सा npm बंडल कर रहा है।

दैनिक उपयोग के लिए, इसे हर बार स्टार्ट पर रि-रिज़ॉल्व करने के बजाय एक बार इंस्टॉल करें।

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

दूसरी लाइन को चलाना महत्वपूर्ण है, क्योंकि लॉन्चर और वेब ऐप के फ्लैग सेट अलग-अलग होते हैं। dsh --help लॉन्चर के अपने विकल्प दिखाता है। dsh --profile web --help उन फ्लैग्स को दिखाता है जिन्हें वेब एप्लिकेशन स्वीकार करता है, जहाँ --port, --host और बार-बार उपयोग होने वाला --trusted-host मौजूद होते हैं।

अब पुष्टि करें कि यह किस पर लिसन कर रहा है।

ss -tlnp | grep 3080

लोकल एड्रेस कॉलम में 127.0.0.1:3080 दिखना चाहिए। यदि इसमें 0.0.0.0:3080 दिखाई देता है, तो UI हर इंटरफ़ेस पर लिसन कर रहा है, जिसका अर्थ है कि इसके और इंटरनेट के बीच केवल आपके फायरवॉल हैं, और आपको कुछ भी और करने से पहले इस प्रक्रिया को रोक देना चाहिए।

आपको port 3080 को कभी भी public क्यों नहीं करना चाहिए

0.1.0-rc.6 में मौजूद वेब सर्वर में कोई authentication layer नहीं है। इसका configuration केवल एक listen host और listen port को expose करता है, और यही इसकी पूरी surface है। Non-loopback deployments के लिए access control एक अलग trusted-host setting है, जो कि login screen नहीं है।

नए releases में एक authentication layer जोड़ा गया है। 0.2.0-rc.2 के बाद से, startup पर एक URL print होता है जिसमें उस process के लिए एक नया token होता है; जो browser इसे खोलता है, उसे एक signed session cookie मिलती है और उसे बिना token के उसी address पर redirect कर दिया जाता है। /api के सामने एक Host/Origin fence केवल loopback, listener के अपने bind address और उन authorities को स्वीकार करता है जिन्हें आप --trusted-host के साथ नाम देते हैं। यह एक वास्तविक credential है, लेकिन project के अपने docs चेतावनी देते हैं कि print किया गया URL केवल इच्छित users के साथ साझा करने के लिए एक credential है, और plain HTTP इसे बिना encryption के भेजता है। 0.2.1-alpha.2 के बाद से वेब ऐप एक concrete local address को bind कर सकता है और --tls-cert तथा --tls-key के साथ स्वयं HTTPS serve कर सकता है। यह plaintext की समस्या को ठीक करता है, exposure की समस्या को नहीं। यह एक exposed port का दुरुपयोग करना कठिन बनाता है, लेकिन इसे public करने योग्य नहीं बनाता।

अब विचार करें कि उस port के पीछे क्या है। agent workspace में files edit करता है और shell commands चलाता है, और आपके provider credentials disk पर उसके बगल में ही होते हैं। इसलिए, pinned release पर एक open port 3080 वास्तव में एक chat interface के साथ एक remote shell है, जो उस user के रूप में चल रहा है जिसने इसे शुरू किया है, और आपके API key के साथ जुड़ा हुआ है। इसके लिए किसी exploit की आवश्यकता नहीं है। उन्हें केवल port number की आवश्यकता है। launch token वाले release पर उन्हें token की भी आवश्यकता होती है, जो किसी के पास भी हो सकता है जो आपके terminal, service logs या unencrypted traffic को पढ़ सकता है।

CLI (command line interface) भी इससे सहमत है। 0.1.0-rc.6 के अनुसार, यह जानबूझकर --host 0.0.0.0 को support नहीं करता है और शुरू होने के बजाय usage error के साथ exit हो जाता है, और नया 0.2.2-alpha.2 भी startup पर इसे reject कर देता है। यह इनकार एक feature है, इसलिए इसे हटाने के लिए किसी patch की तलाश न करें।

जब tunnel आपके लिए उपयुक्त न हो, तो दो अन्य deployments उचित हैं। box को एक private overlay network पर रखें ताकि उसके पास केवल ऐसा address हो जिस तक आपके अपने devices route कर सकें, जो कि एक self-hosted Headscale control server आपको प्रदान करता है। या फिर इसके सामने एक reverse proxy रखें जो port 3080 तक पहुँचने से पहले request को authenticate करे, उदाहरण के लिए एक Authentik single sign-on server जो forward auth करता हो। बिना authentication वाला reverse proxy कोई security control नहीं है। यह केवल एक लंबा URL है।

SSH tunnel के माध्यम से web UI तक पहुँचें

इसे अपने laptop पर चलाएं, सर्वर पर नहीं।

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

-L आपके laptop पर port 3080 खोलता है और इससे जुड़ने वाले किसी भी traffic को encrypted SSH session के माध्यम से आगे भेजता है। 127.0.0.1:3080 भाग सर्वर पर resolve होता है, इसलिए connection loopback से harness तक पहुँचता है, ठीक वैसे ही जैसे आप उस मशीन पर बैठे हों। -N यह निर्देश देता है कि remote shell शुरू न करें, क्योंकि आपको केवल port forwarding की आवश्यकता है।

इसके बाद अपने local browser में http://127.0.0.1:3080 खोलें। launch token वाले release पर, सर्वर द्वारा print किए गए पूर्ण startup URL को खोलें, जिसमें token भी शामिल हो; जब harness को SSH पर शुरू किया जाता है, तो यह startup line तो print करता है लेकिन आपके लिए browser खोलने का प्रयास नहीं करता है। यदि आपके laptop पर port 3080 पहले से व्यस्त है, तो बाईं ओर की संख्या बदलें: ssh -N -L 3180:127.0.0.1:3080 you@your-server, फिर http://127.0.0.1:3180 पर जाएं, और tokenized URL में भी उसी तरह port बदलें। बाईं ओर की संख्या local है और दाईं ओर की संख्या सर्वर की है, इसलिए केवल बाईं संख्या ही बदलती है।

इसे ~/.ssh/config में save करें ताकि आपको इसे बार-बार टाइप न करना पड़े।

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

इसके बाद, ssh -N dsh tunnel शुरू कर देता है। यदि browser यह रिपोर्ट करता है कि connection refused है, तो इसका आमतौर पर मतलब है कि tunnel सक्रिय है लेकिन दूसरी तरफ कोई service listening मोड में नहीं है, क्योंकि SSH port को तब भी forward करता है चाहे harness चल रहा हो या नहीं। ऊपर दिए गए ss command के साथ सर्वर की स्थिति की जाँच करें।

लॉग आउट करने के बाद भी harness को चालू रखें

एक npx कमांड आपके शेल के बंद होते ही समाप्त हो जाती है। एक systemd user service बनी रहती है, और यह क्रैश या रीबूट के बाद harness को वापस चालू कर देती है। यहाँ दी गई unit जानबूझकर न्यूनतम रखी गई है; यदि आप चाहते हैं कि harness अपने स्वयं के सुरक्षित अकाउंट के अंतर्गत चले, जिसमें version unit के भीतर पिन किया गया हो और logs जिन्हें आप वास्तव में खोज सकें, तो the headless systemd setup for dsh में इसका पूरा विवरण दिया गया है।

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

enable-linger महत्वपूर्ण है क्योंकि user services सामान्यतः आपके अंतिम सेशन के समाप्त होते ही रुक जाती हैं, इसलिए इसके बिना आपके tunnel बंद करते ही harness समाप्त हो जाएगा। command -v dsh द्वारा प्रिंट किए गए absolute path को लें और उसे unit में डालें, क्योंकि systemd उस PATH को नहीं खोजता है जिसे आपका login shell बनाता है।

[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 केवल दिखावे के लिए नहीं है। dsh प्रक्रिया अपने invoking directory का उपयोग default filesystem location के रूप में करती है, इसलिए गलत जगह पर शुरू की गई service agent को गलत फोल्डर की ओर निर्देशित करती है। हालाँकि, वह directory केवल एक default है: एक नए Web UI में तब तक कोई workspace चयनित नहीं होता जब तक आप 'Choose workspace' के अंतर्गत एक नहीं जोड़ते, और project की guide आपको वह directory जोड़ने के लिए कहती है जिसमें आपने dsh शुरू किया था। guide में कोई version marker नहीं है, और यही शब्दावली 0.1.0-rc.7 में भी मौजूद है, इसलिए pinned release पर भी इसकी अपेक्षा रखें। unit की directory को project पर सेट करें, फिर UI में उस workspace को चुनें।

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

जो unit शुरू होने से इनकार करती है, उसका कारण लगभग हमेशा गलत ExecStart path या Node का वह version होता है जिसे binary अस्वीकार कर देती है, और journalctl --user -u dsh -n 50 यह बताता है कि कौन सा। launch token वाले release पर, journal वह स्थान भी है जहाँ tokenized startup URL आता है, और हर restart एक नया URL प्रिंट करता है। यही पैटर्न keeping any coding agent alive on a VPS पर भी लागू होता है, और failure modes बिल्कुल समान हैं।

एक प्लगइन क्या करने के लिए अधिकृत है

प्लगइन एक ऐसा मॉड्यूल है जो एक साझा संदर्भ (shared context) में सेवाएं, टाइप किए गए इवेंट और प्रतिवर्ती प्रभाव (reversible effects) प्रदान करता है। इसके एक्सटेंशन पॉइंट वे हिस्से हैं जिन्हें ध्यान से पढ़ना आवश्यक है:

  • ctx.llm पर एक मॉडल प्रदाता (model provider) रजिस्टर करना
  • ctx.tools पर मॉडल-फेसिंग टूल्स जोड़ना
  • ctx.shell के माध्यम से शेल बैकएंड प्रदान करना
  • ctx.fs के माध्यम से फाइलसिस्टम एक्सेस या पॉलिसी प्रदान करना
  • ctx.commands पर ह्यूमन कमांड्स रजिस्टर करना
  • ctx.jobs के माध्यम से बैकग्राउंड कार्य चलाना
  • ctx.sandbox बैकएंड के साथ स्पॉन की गई प्रक्रियाओं (spawned processes) को रैप करना
  • agent/* और tools/* इवेंट्स के माध्यम से अनुरोधों और टूल कॉल्स को इंटरसेप्ट करना
  • टिकाऊ सत्र स्थिति (durable session state) का विस्तार करना
  • ctx.agents के माध्यम से UI को संचालित करना

इस सूची को उस नजरिए से पढ़ें जैसे एक हमलावर पढ़ता है। एक प्लगइन फाइलसिस्टम लेयर और शेल लेयर की आपूर्ति कर सकता है, और यह मॉडल द्वारा की जाने वाली हर टूल कॉल के बीच में बैठ सकता है। प्लगइन और इन सीम्स (seams) के बीच कोई अनुमति संवाद (permission dialog) नहीं होता, क्योंकि प्लगइन सामान्य Node कोड होता है जिसे बाकी सब चीजों के साथ उसी प्रोसेस में लोड किया जाता है। प्लगइन इंस्टॉल करना किसी अजनबी के कोड को आपके एजेंट की अनुमतियों के साथ चलाना है, और आपके एजेंट की अनुमतियाँ आपके Unix यूजर की अनुमतियाँ होती हैं।

यह वही विश्वास का निर्णय है जो आप VPS पर एजेंट से MCP सर्वर को कनेक्ट करते समय लेते हैं, जहाँ MCP का अर्थ मॉडल कॉन्टेक्स्ट प्रोटोकॉल है। यही कारण है कि VPS पर कोडिंग एजेंट को सुरक्षित रूप से चलाना मॉडल के बजाय उस अकाउंट से शुरू होता है जिसके तहत वह चलता है, और यही कारण है कि npm सप्लाई चेन हमले सर्वर पर इतने गंभीर होते हैं: इंस्टॉल करने का चरण ही समझौता (compromise) है, और आपको कोई चेतावनी नहीं मिलती।

प्लगइन्स कहाँ से आते हैं

प्लगइन्स प्रोफाइल्स में रहते हैं। प्रोफाइल एक नामित संरचना है जो $DSH_HOME के अंतर्गत संग्रहीत होती है, जिसका डिफ़ॉल्ट मान ~/.dsh है, और प्रत्येक प्रोफाइल डायरेक्टरी उन आउट-ऑफ-ट्री प्लगइन्स को रखती है जिन्हें वह इंस्टॉल करती है। CLI आपके तर्कों (arguments) को सीधे pnpm पर फॉरवर्ड करके उन्हें प्रबंधित करता है, जिसमें प्रोफाइल डायरेक्टरी का उपयोग वर्किंग डायरेक्टरी के रूप में किया जाता है।

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

चूंकि तर्क pnpm तक अपरिवर्तित पहुँचते हैं, इसलिए add, remove, update और why वैसे ही व्यवहार करते हैं जैसे वे किसी भी pnpm प्रोजेक्ट में करते हैं, और एक प्लगइन एक npm पैकेज या GitHub रेफरेंस हो सकता है। pnpm का PATH पर पहले से मौजूद होना आवश्यक है। Node 24 पर, corepack enable pnpm इसे वहाँ डाल देता है। Node 25 ने Corepack को वितरित करना बंद कर दिया है, इसलिए Node 25 और नए वर्ज़न पर इसे इसके बजाय npm install -g pnpm के साथ इंस्टॉल करें।

डिस्कवरी एक GitHub टॉपिक के माध्यम से काम करती है। प्लगइन लेखक अपने रिपॉजिटरी में dsh-plugin टॉपिक जोड़ते हैं, और उस टॉपिक को ब्राउज़ करना ही वह तरीका है जिससे आप पता लगा सकते हैं कि क्या उपलब्ध है। टॉपिक एक लेबल है जिसे लेखक अपनी रिपॉजिटरी पर लागू करता है। कोई भी इसकी समीक्षा नहीं करता और कोई भी इस पर हस्ताक्षर नहीं करता है, और टॉपिक पेज स्टार्स के आधार पर रैंक करता है, जो सुरक्षा के बजाय लोकप्रियता को मापता है।

वर्तमान रिलीज़ में एक प्रयोगात्मक Custom plugin indexes बंडल भी शामिल है। इसे Plugins के अंतर्गत चालू करें और एक Discover टैब आपको एक इंडेक्स जोड़ने की सुविधा देता है, जो आपके द्वारा प्रदान किए गए URL से प्राप्त एक JSON फ़ाइल है। हार्नेस अपना कोई इंडेक्स शिप नहीं करता है, यह फ़ाइल के फॉर्मेट की जाँच करता है लेकिन उन शीर्षकों, लेखकों या स्रोतों की नहीं जिनका कोई मार्केट दावा करता है, और नेटवर्क पाथ पर कोई भी व्यक्ति सादे http: पर सर्व किए गए इंडेक्स को फिर से लिख सकता है। मार्केट किसी और द्वारा लिखा गया कैटलॉग है, समीक्षा नहीं।

चार आदतें इसे प्रबंधनीय रखती हैं। इंस्टॉल करने से पहले सोर्स पढ़ें, क्योंकि अधिकांश प्लगइन्स इतने छोटे होते हैं कि उन्हें दस मिनट में पढ़ा जा सकता है। किसी ब्रांच को ट्रैक करने के बजाय सटीक वर्ज़न या कमिट को पिन करें। हार्नेस को ऐसे यूज़र के अंतर्गत चलाएँ जिसके पास कुछ और न हो, ऐसे VPS पर जिसे आप फिर से बनाने के लिए तैयार हों। एजेंट को उसकी अपनी API key दें जिसकी अपनी खर्च सीमा हो, जो उस की (key) से अलग हो जिसका उपयोग आपकी प्रोडक्शन सर्विसेज करती हैं। जब आप किसी प्लगइन को पढ़ने के लिए बैठते हैं और यह जानना चाहते हैं कि कौन सी फाइलें जोखिम पैदा करती हैं, तो dsh प्लगइन की जाँच करने का वॉकथ्रू मैनिफेस्ट, एंट्री पॉइंट और उन एक्सटेंशन पॉइंट्स से गुजरता है जिन्हें एक प्लगइन रजिस्टर करता है।

यदि आप किसी एक को चुनने से पहले डिज़ाइनों की तुलना करना पसंद करते हैं, तो Omnigent मल्टी-एजेंट हार्नेस एक अलग संरचना के साथ उसी समस्या का उत्तर देता है, और प्लगइन्स के उपयोग में आने के बाद ट्रेड-ऑफ स्पष्ट हो जाते हैं। यदि आप किसी एक को चुनने के बजाय दो या तीन को एक ही बॉक्स पर रखना चाहते हैं, तो प्रत्येक हार्नेस को एक सेल्फ-होस्टेड API के पीछे रखना आपको प्रति पोर्ट टनल बनाने से बचाता है, लेकिन इसके बदले एक और सर्विस का खर्च आता है जिसे लूपबैक पर बाइंड करना होगा और पहले दिन ही एक वास्तविक पासवर्ड देना होगा।

सबसे पहले क्या खराब होता है

Node बहुत पुराना है। प्रोजेक्ट की मुख्य ब्रांच और 0.2.2-alpha.2 के लिए Node 24.9 या उससे नया वर्ज़न आवश्यक है। इसके CI में Node 24 का परीक्षण होता है, साथ ही Node 24.9 और Node 26 पर कम्पैटिबिलिटी चेक की जाती है, जबकि Node 22 पर कोई परीक्षण नहीं होता। 0.2.1-rc.4 तक के पुराने टैग किए गए रिलीज़ में Node 22.19 को स्वीकार्य बताया गया था, लेकिन अब प्रोजेक्ट इसके साथ बिल्ड नहीं होता। पुराना रनटाइम स्टार्टअप पर विफल हो जाता है क्योंकि कोड ऐसी सिंटैक्स और API का उपयोग करता है जो उसमें मौजूद नहीं हैं। किसी भी अन्य कार्य से पहले node --version चलाएँ।

Port 3080 पहले से ही उपयोग में है। कोई दूसरा हार्नेस, कोई पुराना प्रोसेस, या कोई असंबंधित एप्लिकेशन जो 3080 का उपयोग करता है। इसे ss -tlnp | grep 3080 के साथ ढूँढें, फिर उसे रोकें या dsh web --port 3180 के साथ हार्नेस को कहीं और शुरू करें। --port वेब ऐप का हिस्सा है, इसलिए यह web के बाद आता है।

ब्राउज़र टनल के माध्यम से कनेक्ट नहीं हो पा रहा है। पुष्टि करें कि आपने 127.0.0.1 पर ब्राउज़ किया है, न कि सर्वर के पब्लिक एड्रेस पर, क्योंकि फॉरवर्ड किया गया पोर्ट केवल आपके लैपटॉप पर मौजूद होता है। फिर पुष्टि करें कि हार्नेस सर्वर पर लिसन कर रहा है, क्योंकि SSH फॉरवर्डिंग को तब भी सेट कर देता है चाहे दूर के छोर पर कोई जवाब दे रहा हो या नहीं।

dsh plugin तुरंत विफल हो जाता है। यह कमांड pnpm के चारों ओर एक रैपर है, इसलिए pnpm बाइनरी के न होने पर यह किसी भी प्लगइन के काम शुरू करने से पहले ही रुक जाता है। Node 25 और उससे नए वर्ज़न में यह डिफ़ॉल्ट स्थिति है, क्योंकि Corepack अब Node के साथ नहीं आता है।

एजेंट आपके प्रोजेक्ट को नहीं देख पा रहा है। एक नए Web UI में तब तक कोई वर्कस्पेस सिलेक्ट नहीं होता जब तक आप उसे जोड़ते नहीं हैं, और जब तक आप ऐसा नहीं करते, सेशन कंपोज़र अनुपलब्ध रहता है। प्रोसेस जिस डायरेक्टरी में शुरू होती है, उसे केवल अपने डिफ़ॉल्ट फाइलसिस्टम लोकेशन के रूप में उपयोग करती है, इसलिए एक यूनिट जिसका WorkingDirectory आपकी होम डायरेक्टरी है, वह एजेंट को आपकी होम डायरेक्टरी की ओर पॉइंट करती है। UI में वर्कस्पेस चुनें, या यूनिट को ठीक करके उसे रीलोड करें।

FAQ

क्या DeepSeek Harness web UI को port 3080 पर expose करना सुरक्षित है?

नहीं। pinned 0.1.0-rc.6 में web server का अपना कोई login नहीं है। इसके पीछे का agent files को edit करता है और shell commands को उस user के रूप में चलाता है जिसने process शुरू की है, साथ ही आपका provider API key भी उसी disk पर store होता है। 0.2.0-rc.2 के बाद से, जिसमें 0.2.2-rc.1, 12 November 2026 का npm का latest release, और नया 0.2.2-rc.2 prerelease शामिल हैं, startup URL में एक launch token होता है जिसे browser एक session cookie के लिए trade करता है। लेकिन वह URL एक credential है जिसे plain HTTP बिना encrypt किए भेजता है, इसलिए सलाह नहीं बदलती। listener को 127.0.0.1 पर रखें और इसे SSH tunnel के माध्यम से access करें। एक private overlay network, या एक reverse proxy जो port तक पहुँचने से पहले हर request को authenticate करता है, वह भी काम करेगा। version 0.1.0-rc.6 से, CLI --host 0.0.0.0 को अस्वीकार कर देता है और usage error के साथ exit हो जाता है, और 0.2.2-alpha.2 भी इसे reject करता है, जो आपको बताता है कि लेखक इस विचार के बारे में क्या सोचते हैं।

क्या मुझे DeepSeek API key की आवश्यकता है, या मैं local model का उपयोग कर सकता हूँ?

दोनों काम करते हैं, क्योंकि harness एक runtime है, model नहीं। Settings और फिर Models के अंतर्गत आप DeepSeek card या catalog provider में key paste कर सकते हैं, या "Add model provider" चुनकर "Custom model API" का चयन कर सकते हैं और उसे एक base URL दे सकते हैं जो OpenAI Chat Completions, OpenAI Responses, Anthropic Messages या Gemini API का समर्थन करता हो। एक local Ollama server http://127.0.0.1:11434/v1/ पर उत्तर देता है और API key field में किसी भी string को स्वीकार करता है। Keys $DSH_HOME/.credentials.yaml में store होती हैं, जो default रूप से ~/.dsh/.credentials.yaml पर होती है।

DeepSeek Harness plugin install करने से plugin को वास्तव में क्या मिलता है?

harness चलाने वाले account की अनुमतियाँ (permissions)। एक plugin उसी process में load किया गया Node code है, और extension points में shell backend, filesystem layer, tool registry और हर tool call को wrap करने वाले events शामिल हैं। जब तक कोई plugin खुद sandbox प्रदान न करे, तब तक उसे इन seams से अलग करने के लिए कोई sandbox नहीं होता। install करने से पहले source code पढ़ें, और harness को ऐसे user के रूप में चलाएँ जिसके पास आपकी कोई महत्वपूर्ण चीज़ न हो।

मुझे कौन सा version install करना चाहिए, और क्या यह काम करता रहेगा?

एक सटीक version install करें, उदाहरण के लिए npx @deepseek-ai/dsh@0.1.0-rc.6 web। यह यहाँ pinned August 2026 का version है। 12 November 2026 को npm का latest tag 0.2.2-rc.1 की ओर इशारा करता है; GitHub पर 11 November को release हुआ नया prerelease 0.2.2-rc.2 सूचीबद्ध है, और वर्तमान CLI के लिए Node 24.9 या उससे नया version आवश्यक है। यह project खुद को developer preview कहता है और कहता है कि compatibility तोड़ने वाले बदलाव अपेक्षित हैं, इसलिए एक unpinned command एक दिन से दूसरे दिन अलग तरह से व्यवहार कर सकती है। upgrade करने से पहले repository की जाँच करें, और उम्मीद रखें कि जब तक version 0 से शुरू होता है, तब तक config keys और plugin interfaces बदलते रहेंगे।

क्या यह लेख उपयोगी था?