SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

VPS वर DeepSeek Harness खाजगीपणे कसे चालवावे

Linux VPS वर DeepSeek Harness install करा, npm version pin करा, plugin काय करू शकते ते समजा आणि SSH tunnel वापरून port 3080 वरील web UI सुरक्षितपणे उघडा.

DeepSeek Harness म्हणजे काय

DeepSeek Harness (dsh) हा Node.js agent runtime आहे. तो VPS (virtual private server) वर चालवता येतो. तो सुरक्षितपणे चालवण्यासाठी त्याला 127.0.0.1 शी बांधून ठेवावे आणि browser मधून SSH (secure shell) tunnel द्वारे त्याच्यापर्यंत पोहोचावे. तो terminal मध्ये चालण्याऐवजी port 3080 वर web UI (user interface) उपलब्ध करून देतो. या मार्गदर्शकात निश्चित केलेल्या 0.1.0-rc.6 release मध्ये हा web server स्वतःचा कोणताही password मागत नाही. त्यामुळे port 3080 सार्वजनिक केल्यास तो शोधणाऱ्या कोणालाही तुमच्या Linux user म्हणून तुमच्या files वाचता आणि commands चालवता येतात. 11 November 2026 रोजीच्या 0.2.0-rc.2 पासून 0.2.2-rc.2 पर्यंतच्या newer releases मध्ये, 12 November 2026 रोजी GitHub ने सूचीबद्ध केलेल्या नवीनतम release सह, त्या process साठी नवीन token असलेली startup URL दाखवली जाते आणि तो session cookie ने बदलला जातो. तरीही ते loopback वर default ने listen करतात आणि सर्व interfaces शी bind होण्यास नकार देतात.

DeepSeek हे MIT licence अंतर्गत, npm package @deepseek-ai/dsh म्हणून प्रकाशित करते. हा project स्वतःचे वर्णन developer preview असे करतो आणि compatibility-breaking changes अपेक्षित असल्याचे सांगतो. खाली निश्चित केलेली version ही August 2026 release आहे. 12 November 2026 रोजी npm चा latest tag 0.2.2-rc.1 असे नाव देतो. GitHub वर dsh-v0.2.2-rc.2 tag केलेली आणि 11 November 2026 रोजी released झालेली नवीन prerelease 0.2.2-rc.2 सूचीबद्ध आहे. महत्त्वाच्या box वर यातील काहीही copy करण्यापूर्वी repository तपासा.

संपूर्ण design मध्ये एकच कल्पना केंद्रस्थानी आहे: सर्वकाही plugin आहे. Model adapter, tool registry, session log, sandbox, scheduler आणि agent loop स्वतः हे सर्व एका shared context मध्ये load केलेले plugins आहेत आणि त्यांपैकी कोणतेही बदलता येते. Plugins फक्त सजावट करत असतील असा कोणताही privileged core नाही. त्यामुळे हा harness वापरून पाहण्यासारखा ठरतो. पण खरा धोका देखील याच ठिकाणी आहे. हा trade-off योग्य आहे की नाही, हे तुम्ही त्याची तुलना कशाशी करता यावर अवलंबून आहे. Claude Code आणि Omnigent यांच्या तुलनेत त्याची कामगिरी कशी आहे हा plugin-everything design, model coupling, licence आणि प्रत्येक पर्यायाला VPS मधील किती संसाधने आवश्यक आहेत याबाबतच्या दोन इतर उत्तरांच्या बाजूला ठेवतो.

Harness म्हणजे model नाही

Harness agent loop चालवते. Reasoning दुसरीकडे असलेल्या model मध्ये होते. त्यामुळे तुम्ही तिला API (application programming interface) key किंवा स्वतः host केलेल्या model endpoint चा पत्ता दिल्याशिवाय काहीही कार्य करत नाही. या post मधील सर्व गोष्टी harness configuration शी संबंधित आहेत, model behaviour शी नाहीत. समस्या कोणत्या बाजूने आली हे शोधण्यासाठी दुपारभर debugging करण्यापूर्वी या दोन्हीमधील फरक स्पष्ट समजून घेणे उपयुक्त ठरते.

हे configuration तुम्ही UI मधील Settings आणि त्यानंतर Models येथे करता. DeepSeek साठी स्वतंत्र card आहे. सध्याच्या releases मध्ये त्याखालील "Add model provider" button दोन modes उघडते. "Third-party model provider" मध्ये harness ज्या providers साठी catalog देते त्यांचा समावेश होतो, जसे OpenAI आणि Anthropic. येथे तुम्ही key paste करता आणि catalog endpoint व model list पुरवते. "Custom model API" हा अधिक उपयुक्त पर्याय आहे. त्यात lowercase provider ID, display name, base URL, API protocol, credential आणि किमान एक model द्यावा लागतो. Protocol picker मध्ये OpenAI Chat Completions, OpenAI Responses, Anthropic Messages आणि Gemini API हे पर्याय आहेत. त्यामुळे यांपैकी एखादा protocol वापरणारा gateway किंवा local server configure करता येतो. Request format मध्ये फरक असलेल्या endpoints साठी compatibility settings आवश्यक असतात. Custom providers OpenAI-compatible GET /models endpoint ला query करून model list आपोआप भरू शकतात.

यामुळे त्याच VPS वरील model कडे harness निर्देशित करता येते. Ollama http://127.0.0.1:11434/v1/ येथे OpenAI-compatible API उपलब्ध करून देते. API key field मध्ये कोणतीही string देता येते; ollama ही convention आहे. OpenAI-style client ला value आवश्यक असते, पण Ollama ती दुर्लक्षित करते. Ollama च्या documentation मध्ये ollama launch dsh चेही वर्णन आहे. तो @deepseek-ai/dsh उपलब्ध नसल्यास install करतो आणि Ollama model विरुद्ध सुरू करतो. त्यामुळे खालील pin वर अवलंबून राहण्यापूर्वी तो कोणती version install करतो ते तपासा. तुमच्या VPS मध्ये बसणारा लहान model agent चालवण्यासाठी पुरेसा आहे का, हा अधिक कठीण प्रश्न आहे. स्थानिक model server म्हणून Ollama आणि vLLM मधील फरक या उत्तरासाठी तुमच्या RAM पैकी किती भाग लागेल हे ठरवतो.

UI मध्ये टाइप केलेल्या keys पुन्हा वाचता येत नाहीत. Harness त्या $DSH_HOME/.credentials.yaml मध्ये साठवते. Settings मध्ये फक्त credential reference ठेवला जातो. सध्याच्या releases मध्ये तो active profile च्या patch file मध्ये लिहिला जातो: $DSH_HOME/profiles/<profile>/cordis.patch.yml (profile web साठी dsh web आहे). $DSH_HOME ची default value ~/.dsh आहे. Credentials file कडे password file प्रमाणे पाहा, कारण ते प्रत्यक्षात password fileच आहे. ती वाचू शकणारी कोणतीही व्यक्ती तुमचा API budget वापरू शकते. Settings मधून क्लिक करण्याऐवजी तुम्हाला या files थेट edit करायच्या असतील, तर dsh config files, keys आणि model endpoints यांचे walkthrough प्रत्येक key काय करते आणि प्रत्येक mode मध्ये तुमच्या box मधून काय बाहेर जाते हे दाखवते.

स्थापना करण्यापूर्वी आवश्यक गोष्टी

  • SSH access असलेला Ubuntu 24.04 किंवा अन्य सध्याच्या Linux वर चालणारा VPS
  • Node.js 24.9 किंवा त्याहून नवीन आवृत्ती, कारण प्रकल्पाची main branch आणि 0.2.2-alpha.2 आता >=24.9.0 घोषित करतात आणि त्याच्या CI मध्ये Node 24 ची चाचणी तसेच Node 24.9 आणि Node 26 वरील compatibility check आहे; Node 22 साठी कोणतेही job नाही. 0.2.1-rc.4 पर्यंतच्या tagged releases मध्ये Node 22.19 स्वीकार्य असल्याचे अजूनही नमूद होते, परंतु प्रकल्प ज्या किमान आवृत्तीवर build केला जातो ती आता Node 22.19 राहिलेली नाही
  • root नसलेले सामान्य user account, कारण agent प्रक्रिया सुरू करणाऱ्या user म्हणून shell commands चालवतो
  • plugins install करण्याची योजना असल्यास PATH वर pnpm, कारण plugin command त्याला shell मधून चालवते
  • तुमच्या firewall वर आणि provider च्या स्वतंत्र network firewall वर port 3080 बंद असणे

Ubuntu 24.04 मधील स्वतःचे nodejs package harness साठी आवश्यक असलेल्या आवृत्तीपेक्षा जुने आहे. त्यामुळे त्या release वर apt install nodejs वापरण्याऐवजी NodeSource किंवा nvm मधून Node install करा. Ubuntu 26.10 च्या official repository मध्ये Node 24.19.0 उपलब्ध आहे. ही आवृत्ती Node 24.9 च्या किमान आवश्यकतेपेक्षा नवीन आहे. VPS नुकताच तयार केला असल्यास, इतर सर्व गोष्टींपूर्वी SSH hardening करणे यासाठी दहा मिनिटे देणे योग्य आहे. कारण तुम्ही वापरणार असलेला tunnel त्यामागील SSH server इतकाच सुरक्षित असतो.

VPS वर DeepSeek Harness स्थापित करा आणि एका आवृत्तीवर स्थिर ठेवा

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

npx पॅकेज डाउनलोड करते आणि त्याची dsh बायनरी चालवते. web हे --profile web चे alias आहे. ते browser application सुरू करते आणि process ज्या पत्त्यावर listening करते तो पत्ता दाखवते. Default http://127.0.0.1:3080 आहे. हे क्रमांक केवळ cosmetic default नसून binding decision आहेत. तुम्ही laptop वरून ते शोधण्यापूर्वी harness कोणत्या विनंत्यांना उत्तर देईल आणि कोणत्या देणार नाही, हे dsh loopback पत्ता का दाखवते येथे स्पष्ट केले आहे.

आवृत्ती निश्चित करा. तुम्ही command चालवता त्या क्षणी npx @deepseek-ai/dsh web, latest tag ज्या आवृत्तीकडे निर्देश करतो ती आवृत्ती resolve करते. मात्र तुम्ही ते ज्या project मधून चालवता त्यामध्ये ती package आधीच स्थापित असेल, तर npx शांतपणे तीच copy वापरते. दोन्ही परिस्थितींमध्ये आवृत्ती निवडणारे तुम्ही नसता. Project ने आधीच अनेक release candidates जारी केले आहेत आणि breaking changes येणार असल्याचे सांगितले आहे. येथे 0.1.0-rc.6 ही August 2026 ची निश्चित केलेली आवृत्ती आहे. 12 November 2026 रोजी latest हे 0.2.2-rc.1 कडे निर्देश करते. ही आवृत्ती tokenized startup URL दाखवते. GitHub वर नवीन prerelease 0.2.2-rc.2 सूचीबद्ध आहे. त्यामुळे दुसऱ्या आवृत्तीवर जाणे हा repository वाचल्यानंतर जाणूनबुजून करायचा upgrade आहे. निश्चित केलेली आवृत्ती वापरल्यास आज तयार केलेला box पुढील महिन्यातही त्याच प्रकारे वागतो. त्यामुळे upgrade हा अपघाताने लक्षात येणारी गोष्ट न राहता तुम्ही घेतलेला निर्णय ठरतो. निश्चित केलेली command तरीही चुकीचा build सुरू करत असेल किंवा install होत नसेल, तर dsh install आणि version मधील नेहमीच्या errors मध्ये npx cache साफ करणे आणि Node मध्ये कोणते npm bundle केले आहे ते तपासणे याची माहिती आहे.

दैनंदिन वापरासाठी प्रत्येक वेळी पुन्हा resolve करण्याऐवजी ते एकदाच install करा.

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

दुसरी line चालवणे उपयुक्त आहे, कारण launcher आणि web app यांचे flag sets स्वतंत्र आहेत. dsh --help launcher चे स्वतःचे options दाखवते. dsh --profile web --help web application स्वीकारत असलेले flags दाखवते. --port, --host आणि पुन्हा वापरता येणारा --trusted-host याच ठिकाणी उपलब्ध आहेत.

आता ते कोणत्या पत्त्यावर listening करत आहे याची खात्री करा.

ss -tlnp | grep 3080

Local address column मध्ये 127.0.0.1:3080 असे दिसले पाहिजे. जर 0.0.0.0:3080 असे दिसत असेल, तर UI प्रत्येक interface वर listening करत आहे. त्यामुळे UI आणि internet यांच्यामध्ये केवळ तुमचे firewalls उरतात. इतर कोणतेही काम करण्यापूर्वी process थांबवा.

3080 पोर्ट कधीही सार्वजनिक का करू नये

0.1.0-rc.6 मधील web server मध्ये authentication layer नाही. त्याच्या configuration मध्ये listen host आणि listen port दिलेले आहेत; एवढाच त्याचा संपूर्ण प्रवेशभाग आहे. non-loopback deployment साठीचे access control हे स्वतंत्र trusted-host setting आहे. ते login screen नाही.

नवीन releases मध्ये authentication layer जोडला आहे. 0.2.0-rc.2 पासून startup वेळी त्या process साठी नवीन token असलेली URL छापली जाते. ती URL उघडणाऱ्या browser ला signed session cookie मिळते आणि token शिवाय त्याच address वर redirect केले जाते. /api च्या पुढील Host/Origin fence मधील routes फक्त loopback, listener चा स्वतःचा bind address आणि --trusted-host मध्ये नमूद केलेले authorities स्वीकारतात. हा खरा credential आहे. मात्र project च्या documentation मध्ये स्पष्ट इशारा दिला आहे की छापलेली URL ही फक्त अपेक्षित users सोबत share करायची credential आहे आणि plain HTTP वापरल्यास ती encryption शिवाय पाठवली जाते. 0.2.1-alpha.2 पासून web app एक विशिष्ट local address वर bind होऊन --tls-cert आणि --tls-key वापरून स्वतः HTTPS देऊ शकते. यामुळे plaintext ची समस्या दूर होते; exposure ची नाही. त्यामुळे exposed port चा गैरवापर करणे अधिक कठीण होते. पण तो सार्वजनिक करण्यास सुरक्षित होत नाही.

आता त्या port मागे काय आहे ते पाहा. agent workspace मधील files संपादित करतो आणि shell commands चालवतो. तुमचे provider credentials देखील त्याच्याजवळ disk वर असतात. त्यामुळे pinned release मध्ये उघडा 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 समर्थित करत नाही आणि सुरू करण्याऐवजी usage error देऊन बंद होते. नवीन 0.2.2-alpha.2 देखील startup वेळी तो पर्याय नाकारते. हा नकार सुरक्षा वैशिष्ट्य आहे. त्यामुळे तो काढून टाकणारा patch शोधू नका.

tunnel योग्य नसल्यास आणखी दोन deployment पद्धती व्यवहार्य आहेत. box private overlay network वर ठेवा, जेणेकरून फक्त तुमची स्वतःची devices route करू शकतील असा address त्याच्याकडे असेल. self-hosted Headscale control server यासाठी हीच सुविधा देते. किंवा port 3080 पर्यंत request पोहोचण्यापूर्वी authentication करणाऱ्या reverse proxy च्या पुढे तो ठेवा. उदाहरणार्थ, Authentik single sign-on server forward auth करू शकतो. त्याच्या पुढे authentication नसलेला reverse proxy हे security control नाही. ती फक्त अधिक लांब URL आहे.

SSH tunnel द्वारे web UI वापरा

हे तुमच्या laptop वर चालवा, server वर नाही.

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

-L तुमच्या laptop वर port 3080 उघडते आणि त्यावर येणारे सर्व connections encrypted SSH session मधून forward करते. 127.0.0.1:3080 हा भाग server वर resolve होतो. त्यामुळे connection loopback वरून harness पर्यंत पोहोचते, अगदी तुम्ही त्या machine वर बसलेले असता त्याप्रमाणे. -N चा अर्थ remote shell सुरू करू नका असा आहे, कारण तुम्हाला फक्त forwarding हवे आहे.

त्यानंतर तुमच्या local browser मध्ये http://127.0.0.1:3080 उघडा. launch token असलेल्या release मध्ये server ने दाखवलेली पूर्ण startup URL उघडा आणि त्यात token समाविष्ट ठेवा. harness SSH द्वारे सुरू केले असतानाही startup line दाखवतो; मात्र तो तुमच्यासाठी browser उघडण्याचा प्रयत्न करत नाही. तुमच्या laptop वर port 3080 आधीच वापरात असल्यास डावीकडील संख्या बदला: ssh -N -L 3180:127.0.0.1:3080 you@your-server. त्यानंतर http://127.0.0.1:3180 वर जा. token असलेल्या URL मध्येही port याच प्रकारे बदला. डावीकडील संख्या local आहे आणि उजवीकडील संख्या server ची आहे. त्यामुळे फक्त डावीकडील संख्या बदलते.

ते ~/.ssh/config मध्ये जतन करा आणि ते पुन्हा टाइप करू नका.

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 सुरू असतो पण दुसऱ्या बाजूला काहीही listening नसते. कारण harness चालू आहे किंवा नाही याची पर्वा न करता SSH port forward करते. वरील ss command वापरून server तपासा.

लॉग आउट केल्यानंतर harness सुरू ठेवा

npx कमांड shell सोबत बंद होते. systemd user service मात्र सुरू राहते आणि crash किंवा reboot झाल्यानंतर harness पुन्हा सुरू करते. येथील unit मुद्दाम किमान ठेवले आहे. harness स्वतंत्र, मर्यादित अधिकार असलेल्या account अंतर्गत चालवायचा असल्यास, unit मध्ये version pin करायची असल्यास आणि प्रत्यक्ष शोधता येतील असे logs हवे असल्यास, dsh साठी headless systemd setup मध्ये त्याची संपूर्ण माहिती आहे.

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

enable-linger महत्त्वाचे आहे, कारण user services तुमचे शेवटचे session संपल्यावर सामान्यतः बंद होतात. त्यामुळे हे नसल्यास tunnel बंद करताच harness बंद होते. command -v dsh ने दाखवलेला absolute path घ्या आणि तो unit मध्ये ठेवा, कारण systemd तुमच्या login shell ने तयार केलेला PATH शोधत नाही.

[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 process त्याच्या invoking directory चा default filesystem location म्हणून वापर करते. त्यामुळे चुकीच्या ठिकाणी सुरू केलेली service agent ला चुकीच्या folder कडे निर्देशित करते. मात्र, ही directory फक्त default असते. नवीन Web UI मध्ये Choose workspace अंतर्गत workspace जोडल्याशिवाय कोणतेही workspace निवडलेले नसते. प्रकल्पाच्या guide मध्ये तुम्ही dsh ज्या directory मध्ये सुरू केले ती directory जोडण्यास सांगितले आहे. 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 किंवा binary न स्वीकारणारी Node version असते. journalctl --user -u dsh -n 50 यापैकी कोणते कारण आहे ते दाखवते. Launch token असलेल्या release मध्ये token असलेली startup URL journal मध्येही दिसते आणि प्रत्येक restart वेळी नवीन URL छापली जाते. हीच पद्धत VPS वर कोणताही coding agent सुरू ठेवण्यासाठी लागू होते आणि failure modes सारखेच असतात.

प्लगइनला काय करण्याची अनुमती असते

प्लगइन हे असे मॉड्यूल असते जे shared context मध्ये सेवा, typed events आणि पूर्ववत करता येणारे परिणाम उपलब्ध करून देते. खालील extension points बारकाईने समजून घेणे महत्त्वाचे आहे:

  • ctx.llm वर model provider नोंदणी करणे
  • ctx.tools वर model-facing tools जोडणे
  • ctx.shell मागील shell backend उपलब्ध करून देणे
  • ctx.fs मागील filesystem access किंवा policy उपलब्ध करून देणे
  • ctx.commands वर human commands नोंदणी करणे
  • ctx.jobs द्वारे background work चालवणे
  • ctx.sandbox backend वापरून निर्माण केलेल्या processes भोवती wrapper लावणे
  • agent/* आणि tools/* events द्वारे requests आणि tool calls मध्ये हस्तक्षेप करणे
  • durable session state वाढवणे
  • ctx.agents द्वारे UI नियंत्रित करणे

ही यादी आक्रमणकर्त्याच्या दृष्टीने वाचा. प्लगइन filesystem layer आणि shell layer पुरवू शकते. तसेच मॉडेलने केलेल्या प्रत्येक tool call च्या मध्ये ते कार्य करू शकते. प्लगइन आणि या extension points यांच्या मध्ये कोणताही permission dialog नसतो, कारण प्लगइन हा इतर सर्व घटकांसोबत त्याच process मध्ये लोड होणारा सामान्य Node code असतो. प्लगइन install करणे म्हणजे तुमच्या agent च्या permissions सह अपरिचित व्यक्तीचा code चालवणे होय. तुमच्या agent चे permissions म्हणजे तुमच्या Unix user चे permissions.

तुम्ही VPS वरील agent शी MCP server जोडता, तेव्हा घेतलेला हा त्याच प्रकारचा trust decision आहे; येथे MCP म्हणजे model context protocol. म्हणूनच VPS वर coding agent सुरक्षितपणे चालवणे हे मॉडेलपासून नव्हे, तर agent कोणत्या account अंतर्गत चालतो यापासून सुरू होते. तसेच npm supply chain attacks सर्व्हरवर इतके गंभीर परिणाम का करतात हेही यामुळे स्पष्ट होते: install step हाच breach असतो आणि कोणताही prompt दिसत नाही.

प्लगिन कुठून येतात

प्लगिन profile मध्ये असतात. Profile ही $DSH_HOME अंतर्गत साठवलेली नाव दिलेली रचना आहे. तिचे default मूल्य ~/.dsh असते. प्रत्येक profile directory मध्ये ती install करत असलेले out-of-tree प्लगिन असतात. CLI तुमचे arguments थेट pnpm कडे पाठवून त्यांचे व्यवस्थापन करते. यासाठी profile directory working directory म्हणून वापरली जाते.

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

Arguments pnpm कडे कोणताही बदल न करता पोहोचतात. त्यामुळे add, remove, update आणि why कोणत्याही pnpm project प्रमाणे कार्य करतात. प्लगिन npm package किंवा GitHub reference असू शकते. pnpm आधी PATH मध्ये असणे आवश्यक आहे. Node 24 वर corepack enable pnpm तेथे ते उपलब्ध करून देते. Node 25 मध्ये Corepack वितरित करणे बंद झाले. त्यामुळे Node 25 आणि त्यानंतरच्या आवृत्त्यांवर ते npm install -g pnpm वापरून install करा.

Discovery GitHub topic द्वारे कार्य करते. प्लगिन लेखक त्यांच्या repository मध्ये dsh-plugin topic जोडतात. उपलब्ध प्लगिन शोधण्यासाठी त्या topic चे browsing करा. Topic हा लेखकाने स्वतःच्या repository ला लावलेला label असतो. त्याचे कोणी review करत नाही आणि कोणी त्यावर स्वाक्षरी करत नाही. Topic page वर ranking stars नुसार होते. Stars लोकप्रियता दर्शवतात, सुरक्षितता नाही.

सध्याच्या releases मध्ये experimental Custom plugin indexes bundle देखील आहे. Plugins अंतर्गत ते सुरू करा. त्यानंतर Discover tab मध्ये index जोडता येतो. Index म्हणजे तुम्ही दिलेल्या URL वरून fetch केलेली JSON file. Harness स्वतःचा कोणताही index पाठवत नाही. ते file चे format तपासते, पण एखादा market ज्या titles, authors किंवा sources चे दावे करतो त्यांची पडताळणी करत नाही. Plain http: वरून दिलेला index network path वरील कोणीही बदलू शकतो. Market म्हणजे दुसऱ्याने तयार केलेला catalogue आहे; ते review नाही.

ही व्यवस्था नियंत्रित ठेवण्यासाठी चार सवयी उपयुक्त आहेत. Install करण्यापूर्वी source वाचा. बहुतेक प्लगिन इतके छोटे असतात की ते दहा मिनिटांत वाचता येतात. Branch track करण्याऐवजी exact version किंवा commit pin करा. इतर कोणत्याही मालकीची साधने नसलेल्या user अंतर्गत harness चालवा. आवश्यक असल्यास पुन्हा तयार करता येईल अशा VPS वर तो चालवा. Agent साठी स्वतंत्र API key वापरा आणि तिची spending limit स्वतंत्र ठेवा. Production services वापरत असलेल्या key पासून ती वेगळी असावी. एखादा प्लगिन वाचताना कोणत्या files मध्ये धोका आहे हे जाणून घ्यायचे असल्यास, dsh प्लगिनचे परीक्षण करण्याची walkthrough manifest, entry point आणि प्लगिन नोंदवत असलेल्या extension points चे स्पष्टीकरण देते.

एक रचना निवडण्यापूर्वी designs ची तुलना करायची असल्यास, Omnigent multi-agent harness हीच समस्या वेगळ्या रचनेने सोडवते. प्लगिन वापरात आल्यानंतर त्यातील trade-offs स्पष्ट होतात. अंतिम निवड न करता त्यापैकी दोन किंवा तीन एकाच box वर ठेवणार असल्यास, सर्व harness एकाच self-hosted API मागे ठेवणे प्रत्येक port साठी स्वतंत्र tunnel ची गरज कमी करते. मात्र loopback वर bind करून पहिल्याच दिवशी खरा password देणे आवश्यक असलेली आणखी एक service जोडली जाते.

सर्वप्रथम काय बिघडते

Node खूप जुना आहे. प्रकल्पाच्या main branch आणि 0.2.2-alpha.2 साठी Node 24.9 किंवा त्यानंतरची आवृत्ती आवश्यक आहे. त्याच्या CI मध्ये Node 24 वर चाचण्या आणि Node 24.9 तसेच Node 26 वर compatibility check चालते; Node 22 साठी काहीही नाही. 0.2.1-rc.4 पर्यंतच्या जुन्या tagged releases मध्ये Node 22.19 स्वीकार्य असल्याचे नमूद होते, परंतु प्रकल्प आता त्यावर build होत नाही. कोडमध्ये उपलब्ध नसलेले syntax आणि APIs वापरले असल्यामुळे जुना runtime startup वेळी fail होतो. इतर कोणतीही कृती करण्यापूर्वी node --version चालवा.

Port 3080 आधीच वापरात आहे. दुसरा harness, जुनी process किंवा 3080 वापरणारे एखादे unrelated application यापैकी कोणतेही कारण असू शकते. ss -tlnp | grep 3080 वापरून ते शोधा. त्यानंतर ते थांबवा किंवा dsh web --port 3180 वापरून harness दुसऱ्या port वर सुरू करा. --port web app साठी आहे, त्यामुळे ते web नंतर वापरा.

Tunnel द्वारे browser connect होत नाही. तुम्ही server च्या public address ऐवजी 127.0.0.1 वर browse केले आहे याची खात्री करा, कारण forwarded port फक्त तुमच्या laptop वर उपलब्ध असतो. त्यानंतर server वर harness listening करत आहे का ते तपासा. कारण दूरच्या टोकाला कोणतीही process उत्तर देत नसली तरी SSH forward तयार करतो.

dsh plugin त्वरित fail होते. हा command pnpm भोवतीचा wrapper आहे. त्यामुळे pnpm binary उपलब्ध नसल्यास कोणतेही plugin काम सुरू होण्यापूर्वीच command थांबतो. Node 25 आणि त्यानंतरच्या आवृत्त्यांमध्ये हीच default स्थिती आहे, कारण Corepack आता Node सोबत ship होत नाही.

Agent ला तुमचा project दिसत नाही. नवीन Web UI मध्ये workspace add करेपर्यंत कोणतेही workspace selected नसते. तोपर्यंत session composer देखील उपलब्ध राहत नाही. Process ज्या directory मधून सुरू होते ती directory फक्त default filesystem location म्हणून वापरते. त्यामुळे WorkingDirectory चे मूल्य तुमची home directory असलेल्या unit मधून agent ला तुमच्या home directory कडे निर्देश मिळतो. UI मध्ये workspace निवडा किंवा unit दुरुस्त करून reload करा.

FAQ

DeepSeek Harness वेब UI port 3080 वर सार्वजनिक करणे सुरक्षित आहे का?

नाही. पिन केलेल्या 0.1.0-rc.6 मध्ये web server चे स्वतःचे login नाही. त्यामागील agent प्रक्रिया सुरू करणाऱ्या user च्या अधिकारांनी files संपादित करतो आणि shell commands चालवतो. तुमची provider API key त्याच disk वर साठवलेली असते. 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 हा token session cookie साठी वापरतो. परंतु plain HTTP ही URL credential encryption शिवाय पाठवते. त्यामुळे सल्ला बदलत नाही. Listener 127.0.0.1 वरच ठेवा आणि SSH tunnel द्वारे त्याच्यापर्यंत पोहोचा. Private overlay network किंवा port पर्यंत पोहोचण्यापूर्वी प्रत्येक request चे authentication करणारा reverse proxy देखील वापरता येतो. Version 0.1.0-rc.6 पासून CLI --host 0.0.0.0 नाकारतो आणि usage error सह बंद होतो. 0.2.2-alpha.2 देखील ते नाकारतो. यावरून authors या पद्धतीबद्दल काय मत ठेवतात ते स्पष्ट होते.

मला DeepSeek API key आवश्यक आहे का, की local model वापरता येईल?

दोन्हीपैकी कोणताही पर्याय चालतो, कारण harness हे runtime आहे, model नाही. Settings आणि त्यानंतर Models मध्ये जाऊन DeepSeek card किंवा catalog provider मध्ये key paste करता येते. किंवा "Add model provider" आणि त्यानंतर "Custom model API" निवडून OpenAI Chat Completions, OpenAI Responses, Anthropic Messages किंवा Gemini API शी सुसंगत base URL देता येतो. Local Ollama server http://127.0.0.1:11434/v1/ वर प्रतिसाद देतो आणि API key field मध्ये कोणतीही string स्वीकारतो. Keys $DSH_HOME/.credentials.yaml मध्ये साठवल्या जातात. त्याची default value ~/.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 भोवतीची events यांचा समावेश असतो. Plugin स्वतः sandbox पुरवत नसेल, तर या interfaces पासून plugin ला वेगळे ठेवणारी कोणतीही यंत्रणा नसते. Install करण्यापूर्वी source वाचा. तसेच harness अशा user म्हणून चालवा ज्याच्याकडे तुम्हाला महत्त्वाच्या कोणत्याही वस्तूंची मालकी नाही.

कोणती version install करावी आणि ती कार्यरत राहील का?

Exact 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-breaking changes अपेक्षित असल्याचे सांगतो. त्यामुळे unpinned command एका दिवसापासून दुसऱ्या दिवशी वेगळ्या प्रकारे कार्य करू शकतो. Upgrade करण्यापूर्वी repository तपासा. Version अजून 0 ने सुरू असताना config keys आणि plugin interfaces बदलण्याची शक्यता गृहीत धरा.

हा लेख उपयुक्त होता का?