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

dsh web http://127.0.0.1:3080 का क्या अर्थ है

dsh वेब UI केवल localhost पर बाइंड होता है इसलिए यह 127.0.0.1:3080 दिखाता है। इसे सुरक्षित रूप से एक्सेस करने के लिए SSH टनल का उपयोग करें। पोर्ट 3080 को सीधे पब्लिक करना असुरक्षित है।

dsh web: http://127.0.0.1:3080 का अर्थ

जब आप VPS पर DeepSeek Harness वेब प्रोफाइल शुरू करते हैं, तो यह इस तरह की एक लाइन प्रिंट करता है और फिर प्रतीक्षा करता है:

dsh web: http://127.0.0.1:3080/?token=...

127.0.0.1 लूपबैक एड्रेस है। यह वह पता है जिसका उपयोग मशीन खुद से बात करने के लिए करती है। 127.0.0.1 पर बाइंड किया गया सॉकेट केवल उसी मशीन पर चल रही प्रक्रियाओं से कनेक्शन स्वीकार करता है, कहीं और से नहीं। इसलिए वह लाइन आपको एक साथ दो बातें बताती है: वेब UI कहाँ लिसन (listen) कर रहा है, और इसे एक्सेस करने की अनुमति किसे है। केवल वह मशीन जिस पर dsh चल रहा है। अंत में ?token= भाग एक नया रैंडम क्रेडेंशियल है जिसे प्रोसेस हर बार शुरू होने पर बनाती है। इसके बारे में अधिक जानकारी नीचे दी गई है।

यही कारण है कि जब आप इसे अपने लैपटॉप के ब्राउज़र में पेस्ट करते हैं तो URL काम नहीं करता है। आपके लैपटॉप का 127.0.0.1 आपका लैपटॉप ही है। हार्नेस VPS के 127.0.0.1 पर लिसन कर रहा है, जो एक अलग मशीन है और जिसका लूपबैक स्टैक अलग है। कुछ भी खराब नहीं है। आपको कनेक्शन को आगे ले जाने (carry) की आवश्यकता है।

आधिकारिक README डिफ़ॉल्ट को स्पष्ट रूप से बताता है: "कमांड डिफ़ॉल्ट रूप से http://127.0.0.1:3080 पर वेब UI शुरू करता है और इसे स्थानीय लॉन्च के लिए डिफ़ॉल्ट ब्राउज़र में खोलता है।" SSH पर खोलने के लिए कोई ब्राउज़र नहीं होता है, इसलिए URL आपके उपयोग के लिए छोड़ दिया जाता है। बाइंड एड्रेस वेबसर्वर होस्ट प्लगइन, @deepseek-ai/dsh-host-webserver से आता है। 0.2.0-rc.2 रिलीज़ में जिसे यह गाइड पिन करती है, इसकी host की (key) को "Listen host; the two supported values are loopback and all-interfaces" के रूप में प्रलेखित किया गया है। जब तक आप इसे बदलते नहीं हैं, तब तक आपको लूपबैक ही मिलता है। यदि पोर्ट आपके लिए नए हैं, तो Linux पर पोर्ट कैसे काम करते हैं उस एड्रेस-प्लस-पोर्ट मॉडल को कवर करता है जिस पर यह सब आधारित है।

Web UI केवल localhost पर bind क्यों होता है

dsh एक agent harness है, जो model के चारों ओर लपेटा गया प्रोग्राम है: यह लूप, टूल कॉल्स और उन अनुमतियों को नियंत्रित करता है जिनके तहत ये कॉल्स चलते हैं। ब्राउज़र टैब एक ऐसी प्रक्रिया के लिए कंट्रोल सरफेस है जो शेल कमांड चलाती है, आपके द्वारा चुनी गई वर्कस्पेस डायरेक्टरी में फाइलें पढ़ती और लिखती है, और आपकी model API key का उपयोग करती है। जो कोई भी उस पेज को लोड कर सकता है, वह dsh चलाने वाले उपयोगकर्ता के रूप में यह सब कर सकता है। नेटवर्क ही इस पहुंच का एकमात्र जरिया नहीं है: आपके द्वारा इंस्टॉल किया गया प्लगइन उसी प्रक्रिया के भीतर समान अनुमतियों के साथ चलता है, यही कारण है कि dsh प्लगइन को इंस्टॉल करने से पहले उसकी जांच करना उतना ही महत्वपूर्ण है जितना यह तय करना कि सर्वर किस पोर्ट पर लिसन करेगा।

इसलिए पोर्ट 3080 केवल एक रीड-ओनली डैशबोर्ड नहीं है। उस पेज को लोड करने का मतलब है सर्वर पर कमांड निष्पादित करना।

प्रिंट किए गए URL को खोलने पर आप सीधे सेशन लिस्ट में पहुंच जाते हैं। यहां कोई लॉगिन स्क्रीन नहीं है और न ही कोई यूजर अकाउंट है। पेज को जो चीज सुरक्षित रखती है, वह URL के अंत में मौजूद टोकन है: रूट पेज इसे एक साइन्ड सेशन कुकी के लिए बदल देता है और एक साफ पते पर रीडायरेक्ट कर देता है। उसके बाद, UI द्वारा की जाने वाली हर RPC कॉल और WebSocket स्ट्रीम बिना वैध कुकी के 401 Unauthorized प्राप्त करती है। हालांकि, पोर्ट पर मौजूद हर चीज सुरक्षित नहीं है। Connection प्लगइन का डॉक्यूमेंटेशन कहता है कि स्टेटिक एसेट्स सार्वजनिक रहते हैं, और वेबसर्वर में स्वयं कोई सर्वर-व्यापी प्रमाणीकरण या ओरिजिन पॉलिसी नहीं है, इसलिए प्रत्येक प्लगइन जो किसी रूट का मालिक है, वह अपने स्वयं के नियम लागू करता है। उन सुरक्षित रूट्स पर, Connection प्लगइन 403 का उत्तर भी देता है जब Host हेडर न तो लूपबैक होता है और न ही कोई ऐसा होस्ट जिस पर आपने स्पष्ट रूप से भरोसा किया हो। लूपबैक पर यह वास्तविक एक्सेस कंट्रोल के पीछे एक समझदार दूसरी परत है, जो ऑपरेटिंग सिस्टम द्वारा केवल स्थानीय प्रक्रियाओं को अनुमति देने का काम है। यह पोर्ट को सार्वजनिक करने का कारण नहीं है। टोकन आपके टर्मिनल स्क्रॉलबैक में और किसी भी ऐसे लॉग में होता है जिसने स्टार्टअप आउटपुट को कैप्चर किया है। प्रोजेक्ट की अपनी reverse proxy गाइड कहती है कि न तो इसका Host चेक और न ही विज्ञापित URL स्वयं लिसनिंग पोर्ट की सुरक्षा करता है। वेबसर्वर डॉक्यूमेंटेशन चेतावनी देता है कि नॉन-लूपबैक पते को बाइंड करना "अभी भी असुरक्षित रूट्स और स्टेटिक एसेट्स को उस नेटवर्क के लिए उजागर करता है"। और 0.2.0-rc.2 में वेबसर्वर प्लगइन में अपना कोई TLS नहीं है। स्वचालित स्कैनर्स लगातार असामान्य पोर्ट्स को स्कैन करते हैं, इसलिए एक प्रकाशित 3080 को खोजा हुआ ही मानें।

अपने फायरवॉल में पोर्ट 3080 न खोलें, और सार्वजनिक VPS पर वेबसर्वर host को 0.0.0.0, या अपने सार्वजनिक IP पर सेट न करें। यह संयोजन आपके सर्वर पर कमांड निष्पादन को किसी भी ऐसे व्यक्ति के लिए सुलभ बना देता है जिसके पास लीक हुआ URL है।

वर्तमान releases पहले ही आपको इस दिशा में धकेलते हैं: वेब एप्लिकेशन का अपना --host फ्लैग सभी इंटरफेस को बाइंड करने से इनकार करता है। हालांकि, 0.2.0-rc.2 में, वेबसर्वर प्लगइन की host कॉन्फ़िगरेशन की अभी भी 0.0.0.0 स्वीकार करती है, इसलिए कॉन्फ़िगरेशन में बदलाव इसे अभी भी उजागर कर सकता है। प्रोजेक्ट की डिफॉल्ट ब्रांच पर वेबसर्वर डॉक्यूमेंटेशन, और 0.2.1-rc.5 रिलीज़ में जिसे npm का latest टैग अब पॉइंट करता है, और आगे जाता है: यह लोड होने पर अनिर्दिष्ट पते को अस्वीकार करता है और एक वैकल्पिक tls सेटिंग जोड़ता है। यह अभी भी स्थानीय इंटरफेस के किसी भी एक ठोस पते को स्वीकार करता है, इसलिए host को अपने VPS के सार्वजनिक IP पर पॉइंट करना UI को वैसे ही उजागर कर देता है।

यही तर्क हर उस एजेंट रनटाइम पर लागू होता है जिसे आप सर्वर पर डालते हैं, यही कारण है कि VPS पर कोडिंग एजेंट को सुरक्षित रूप से चलाना एक ही नियम से शुरू होता है: एजेंट का कंट्रोल पोर्ट निजी रहता है, और कोई ऐसी चीज जिस पर आप भरोसा करते हैं, वह आपको उस तक ले जाती है।

मैं अपने लैपटॉप से dsh Web UI कैसे खोलूँ?

इसके तीन सही तरीके हैं, और इनमें से हर एक harness को loopback पर ही bound रखता है।

  • एक SSH tunnel। सार्वजनिक interface पर कोई नई चीज़ listen नहीं करती है, और आपके पास पहले से ही credentials मौजूद हैं। यही वह तरीका है जिसका उपयोग करना चाहिए।
  • एक private overlay network, ताकि UI आपके अपने उपकरणों से तो पहुँच योग्य हो, लेकिन बाकी किसी के लिए अदृश्य रहे।
  • एक reverse proxy जो TLS (transport layer security) को terminate करता है और किसी भी चीज़ को forward करने से पहले पासवर्ड मांगता है।

इनके बीच का अंतर यह है कि आपके ब्राउज़र को loopback तक कौन ले जाता है। इनमें से किसी में भी harness को loopback से हटाना शामिल नहीं होना चाहिए।

SSH tunnel के माध्यम से एक्सेस करें

इसे अपने लैपटॉप पर चलाएं, VPS पर नहीं:

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

इसे चलते रहने दें, फिर अपने स्थानीय ब्राउज़र में dsh द्वारा प्रिंट किया गया पूरा URL खोलें, जिसमें http://127.0.0.1:3080/?token=... टोकन शामिल हो। Web UI लोड होता है, टोकन को session cookie के लिए बदलता है, और address bar से टोकन को हटा देता है। आपका ब्राउज़र Host के रूप में 127.0.0.1:3080 भेजता है, जो कि loopback है, इसलिए tunnel बिना किसी अतिरिक्त कॉन्फ़िगरेशन के Host चेक को पास कर लेती है।

-L तर्क में कोलन (colons) द्वारा अलग किए गए तीन फ़ील्ड होते हैं। पहला आपके लैपटॉप पर खुलने वाला पोर्ट है। दूसरा और तीसरा वह पता और पोर्ट है जहाँ प्रत्येक कनेक्शन को फॉरवर्ड करना है। महत्वपूर्ण विवरण यह है: बीच वाले फ़ील्ड में 127.0.0.1 को VPS पर मौजूद SSH सर्वर द्वारा रिज़ॉल्व किया जाता है, जब आपका ट्रैफ़िक वहाँ पहुँच चुका होता है। इसका मतलब है VPS का loopback, न कि आपका। यही वह पता है जिसे dsh प्रिंट करता है, और इसीलिए tunnel तब काम करती है जब सीधा ब्राउज़र कनेक्शन काम नहीं करता।

-N SSH को रिमोट कमांड न चलाने के लिए कहता है, जिससे आपको केवल एक फॉरवर्डर मिलता है और कोई शेल नहीं। बैकग्राउंड tunnel के लिए जो चुपचाप फेल होने के बजाय स्पष्ट रूप से फेल हो:

ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps

-f प्रमाणीकरण के बाद इसे बैकग्राउंड में डाल देता है। ExitOnForwardFailure=yes दिखने से कहीं अधिक महत्वपूर्ण है: इसके बिना, SSH तब भी सफलतापूर्वक कनेक्ट हो जाता है जब फॉरवर्ड सेट नहीं हो पाता, जिससे आपको एक काम करने वाला सेशन तो मिलता है लेकिन बिना किसी चेतावनी के एक डेड tunnel मिलती है। ServerAliveInterval=30 हर 30 सेकंड में एक keepalive भेजता है ताकि एक निष्क्रिय tunnel कैफे और होटल राउटर के NAT (network address translation) टाइमआउट के दौरान भी बनी रहे।

आपको क्या देखना चाहिए

VPS पर, पुष्टि करें कि वास्तव में क्या listening मोड में है:

ss -ltnp | grep 3080

एक सही परिणाम loopback पते को दर्शाता है:

LISTEN 0  511  127.0.0.1:3080  0.0.0.0:*  users:(("node",pid=1042,fd=21))

यदि स्थानीय पता कॉलम में 0.0.0.0:3080 लिखा है, तो Web UI हर इंटरफ़ेस पर है, जिसमें पब्लिक इंटरफ़ेस भी शामिल है। उस कॉलम में आपके VPS का पब्लिक IP होने का मतलब भी वही एक्सपोज़र है। इसे रोकें और कुछ भी करने से पहले bind को ठीक करें। यदि ss सॉकेट को प्रिंट करता है लेकिन users: फ़ील्ड को खाली छोड़ देता है, तो इसे sudo के साथ चलाएं, क्योंकि किसी अन्य उपयोगकर्ता के स्वामित्व वाले सॉकेट के लिए प्रोसेस का नाम अन्यथा छिपा रहता है।

जब tunnel शुरू होने से मना कर दे

SSH इसे प्रिंट करता है और बाहर निकल जाता है:

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

यह आपके लैपटॉप के बारे में है, सर्वर के बारे में नहीं। पोर्ट 3080 पर पहले से ही कुछ स्थानीय रूप से चल रहा है, अक्सर यह कोई पुरानी tunnel होती है जिसे आप भूल गए हैं। इसके बजाय एक खाली स्थानीय पोर्ट चुनें:

ssh -N -L 3081:127.0.0.1:3080 you@your-vps

केवल पहला फ़ील्ड बदला है, इसलिए अब आप http://127.0.0.1:3081/?token=... पर ब्राउज़ करें, उसी टोकन के साथ, जबकि harness 3080 पर listening जारी रखता है। दोनों नंबरों का मेल खाना आवश्यक नहीं है। session cookie address bar में मौजूद host और port से बंधी होती है, इसलिए एक नए स्थानीय पोर्ट के लिए टोकन URL की फिर से आवश्यकता होती है।

यदि tunnel शुरू हो जाती है लेकिन ब्राउज़र कनेक्शन अस्वीकार होने या खाली रिस्पॉन्स की रिपोर्ट करता है, तो ट्रैफ़िक VPS तक पहुँचा लेकिन दूसरी तरफ कुछ नहीं मिला। या तो dsh बंद हो गया है, या उसने किसी अलग पोर्ट को bind किया है। सर्वर पर ss -ltnp | grep 3080 के साथ जाँच करें। यदि पेज इसके बजाय 401 Unauthorized का उत्तर देता है, तो tunnel ठीक है और आपके ब्राउज़र में उस पते के लिए कोई वैध cookie नहीं है: प्रिंट किया गया URL फिर से खोलें, टोकन सहित। रीस्टार्ट के बाद, नए आउटपुट से URL लें, क्योंकि प्रत्येक प्रोसेस एक नया टोकन बनाती है।

यहाँ एक और बात लोगों को परेशान करती है। एक फोरग्राउंड npx @deepseek-ai/dsh web शेल बंद होने पर मर जाता है, इसलिए जैसे ही आप लॉग आउट करते हैं, harness रुक जाता है। इसे tmux के अंदर या systemd यूजर सर्विस के तहत शुरू करें, जो कि VPS पर कोडिंग एजेंट को चालू रखना में हल की गई समस्या है। systemd के तहत dsh web: लाइन, टोकन और सब कुछ, सर्विस लॉग में चला जाता है, इसलिए इसे वहाँ से पढ़ें। जब आप SSH साइड पर काम कर रहे हों, तो अपने VPS पर SSH को सुरक्षित करना पहले करना उचित है, क्योंकि tunnel आपके SSH लॉगिन को एजेंट के लिए एकमात्र दरवाजा बना देती है।

इसे एक प्राइवेट ओवरले नेटवर्क के माध्यम से एक्सेस करें

एक ओवरले नेटवर्क आपके VPS और आपके लैपटॉप को एक ऐसे प्राइवेट नेटवर्क पर एड्रेस देता है जिससे केवल आपके डिवाइस ही जुड़ते हैं। Tailscale एक सामान्य विकल्प है, और इसका serve कमांड इस स्थिति के लिए बिल्कुल उपयुक्त है: tailscaled VPS पर चलता है और खुद localhost:3080 से कनेक्ट होता है, इसलिए हार्नेस लूपबैक पर ही रहता है।

tailscale serve --bg localhost:3080
tailscale serve status

इसके बाद UI आपके tailnet के भीतर आपकी मशीन के नाम पर, HTTPS के माध्यम से एक्सेस किया जा सकता है, जिसमें पब्लिक इंटरफेस पर कोई भी पोर्ट खुला नहीं होता। इसके लिए आपके tailnet के लिए HTTPS सर्टिफिकेट इनेबल होना आवश्यक है, अन्यथा serve के पास प्रस्तुत करने के लिए कोई सर्टिफिकेट नहीं होगा। चूंकि आपका ब्राउज़र अब उस tailnet नाम को Host के रूप में भेजता है, इसलिए हार्नेस को उस नाम को ट्रस्ट (trusted) करके शुरू करें, अन्यथा इसके API कॉल्स को 403 प्राप्त होगा। बिना पोर्ट वाली एंट्री किसी भी पोर्ट से मेल खाती है:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host your-vps.your-tailnet.ts.net

फिर https://your-vps.your-tailnet.ts.net/?token=... खोलें और प्रिंट की गई लाइन से टोकन को कॉपी करें। इसे दोबारा हटाने के लिए, off के साथ कमांड को दोहराएं:

tailscale serve --https=443 off

serve का उपयोग करें, कभी भी funnel का नहीं। Funnel उसी टारगेट को पब्लिक इंटरनेट पर पब्लिश कर देता है, जो एक ओपन पोर्ट पर एजेंट रनटाइम को केवल एक URL टोकन के भरोसे छोड़ देता है। ये दोनों कमांड लगभग एक जैसे दिखते हैं और विपरीत काम करते हैं, इसलिए किसी को भी टाइप करने से पहले Tailscale Serve और Funnel के बीच का अंतर पढ़ें। प्राइवेट नेटवर्क के रूप में Tailscale सेटअप की पूरी जानकारी देता है।

इसे एक ऐसे reverse proxy के माध्यम से एक्सेस करें जो पासवर्ड की जाँच करता है

यह वह विकल्प है जो वास्तव में एक port को इंटरनेट पर प्रकाशित करता है, इसलिए प्रमाणीकरण (authentication) ही वह एकमात्र बाधा है जो किसी अनजान व्यक्ति और आपके सर्वर पर command execution के बीच खड़ी है। इसे तब चुनें जब कई लोगों को UI की आवश्यकता हो और हर किसी के लिए अलग tunnel बनाना अव्यावहारिक हो।

harness 127.0.0.1:3080 पर रहता है। nginx उसी बॉक्स पर चलता है, इसलिए यह loopback तक पहुँच सकता है, और यह एक certificate तथा पासवर्ड फ़ाइल के साथ 443 पर listen करता है।

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;
    }
}

पासवर्ड फ़ाइल बनाएँ और reload करें:

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginx

nginx -t को syntax is ok और उसके बाद test is successful प्रिंट करना चाहिए। एक खराब फ़ाइल के साथ reload विफल हो जाता है और चल रहे configuration को वैसा ही छोड़ देता है, इसलिए आँख बंद करके restart करने के बजाय त्रुटि (error) को पढ़ें।

उनमें से तीन proxy लाइनें सजावट नहीं हैं। Upgrade और Connection headers WebSocket handshake को अनुमति देते हैं, और उनके बिना पेज लोड तो होता है लेकिन कभी अपडेट नहीं होता। proxy_read_timeout 3600s nginx के inactivity timeout को 60 सेकंड से बढ़ाकर एक घंटा कर देता है; यह agent run की कुल अवधि को सीमित नहीं करता है। pinned 0.2.0-rc.2 डिफ़ॉल्ट रूप से हर दो सेकंड में WebSocket pings भेजता है, जो एक लंबे agent step के दौरान उस connection को सक्रिय रखता है। proxy_buffering off proxied HTTP responses के लिए buffering को अक्षम (disable) कर देता है; यह WebSocket frames को नियंत्रित नहीं करता है। एक nginx reverse proxy config, लाइन दर लाइन बाकी चीजों की व्याख्या करता है, और nginx, Caddy और Traefik के बीच चयन स्वचालित certificates के साथ यही काम करने के बारे में बताता है।

harness को भी proxy के बारे में पता होना चाहिए। proxy_set_header Host $host ब्राउज़र-फेसिंग नाम को अपरिवर्तित (unchanged) पास करता है, जो कि प्रोजेक्ट की proxy गाइड में मांगा गया है, इसलिए dsh को उस भरोसेमंद नाम के साथ शुरू करें अन्यथा यह 403 का उत्तर देगा:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.com

इसके बाद प्रत्येक व्यक्ति https://dsh.example.com/?token=... को एक बार खोलता है, dsh web: लाइन से प्राप्त token के साथ, और ब्राउज़र उसके बाद session cookie को सुरक्षित रखता है। backend उस cookie को Secure flag के बिना सेट करता है, और proxy गाइड proxy से इसे HTTPS पर जोड़ने के लिए कहती है। nginx 1.19.3 या उससे नए संस्करण पर, location ब्लॉक में proxy_cookie_flags ~ secure; यह काम करता है।

चाहे आप कोई भी proxy चुनें, firewall पर 3080 को बंद रखें, ताकि अंदर आने का एकमात्र रास्ता केवल प्रमाणीकृत (authenticated) रास्ता ही हो। ufw firewall की बुनियादी बातें नियमों को कवर करती हैं। TLS पर basic authentication एक न्यूनतम स्तर है, न कि एक पूर्ण सुरक्षा मॉडल: जिसके पास भी वह पासवर्ड और token URL है, उसके पास आपके सर्वर पर shell का एक्सेस है। जब संभव हो, tunnel को प्राथमिकता दें।

dsh web जिस port पर listen करता है, उसे कैसे बदलें?

--port वेब एप्लिकेशन से संबंधित है, न कि लॉन्चर से। CLI डॉक्यूमेंटेशन में इसका उदाहरण सीधे दिया गया है:

dsh --profile web --port 8080

dsh web, --profile web का एक alias है, इसलिए dsh web --port 8080 एक ही कमांड है। लॉन्चर केवल अपने स्वयं के flags को पार्स करता है और उनके बाद आने वाली हर चीज़ को बूट किए गए प्रोफाइल को सौंप देता है। इसलिए लॉन्चर के flags पहले आते हैं, और लॉन्चर द्वारा न पहचाना गया पहला टोकन एप्लिकेशन के arguments की शुरुआत करता है। --port को हमेशा प्रोफाइल के बाद रखें, पहले कभी नहीं।

कमांड द्वारा प्रिंट किए गए URL को पढ़ें, न कि यह मान लें कि वह क्या है, क्योंकि वह लाइन उस पते को रिपोर्ट करती है जिस पर सर्वर वास्तव में bind हुआ है, साथ ही उस टोकन के साथ जिसकी आपको आवश्यकता होगी। फिर अपने tunnel के अंतिम फ़ील्ड को मेल खाने के लिए अपडेट करें:

ssh -N -L 3080:127.0.0.1:8080 you@your-vps

स्थायी बदलाव के लिए, port कमांड लाइन के बजाय प्रोफाइल कॉन्फ़िगरेशन में रहता है। web और headless प्रोफाइल पहली बार उपयोग किए जाने पर ~/.dsh के अंतर्गत दिए गए टेम्प्लेट से स्वतः-इनिशियलाइज़ (auto-initialise) हो जाते हैं। उसी डायरेक्टरी में आपकी API key और model endpoint सेटिंग्स भी रहती हैं, इसलिए dsh keys, models और endpoints को कॉन्फ़िगर करना एक आवश्यक लेख है जिसे आपको तब पढ़ना चाहिए जब आप इन फ़ाइलों को एडिट कर रहे हों। यह देखने के लिए कि सभी लेयर्स के जुड़ने के बाद वास्तव में क्या प्रभावी है:

dsh --dump-config

Listen address वेबसर्वर प्लगइन की दो keys, host और port से आता है। 0.2.0-rc.2 में इसकी अन्य keys केवल रिस्पॉन्स कम्प्रेशन को ट्यून करती हैं, और 0.2.1-rc.2 तथा डिफ़ॉल्ट ब्रांच में एक वैकल्पिक tls key जोड़ी गई है। port को 0 पर सेट करने से ऑपरेटिंग सिस्टम से एक खाली port की मांग की जाती है, जिसे "zero requests an OS-assigned port" के रूप में डॉक्यूमेंट किया गया है। यह सुनिश्चित करता है कि आपको कभी भी conflict का सामना न करना पड़े, और यह tunnel के लिए एक खराब विकल्प है, क्योंकि हर बार रीस्टार्ट करने पर नंबर बदल जाता है।

dsh 'address already in use' के साथ विफल क्यों होता है?

इसका कारण यह है कि कोई अन्य process पहले से ही उस address और port का उपयोग कर रही है, इसलिए kernel दूसरे bind अनुरोध को अस्वीकार कर देता है। Node इसे इस प्रकार रिपोर्ट करता है:

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080

किसी भी बदलाव को करने से पहले यह पता लगाएँ कि उस port का उपयोग कौन कर रहा है:

sudo ss -ltnp | grep 3080

users:(("node",pid=1042,fd=21)) field उस process और उसके PID का नाम बताती है। इसका सामान्य उत्तर एक पिछला dsh होता है जिसके बारे में आपको लगा था कि वह बंद हो चुका है, लेकिन वह अक्सर किसी detached tmux window में चल रहा होता है। उसे kill 1042 के साथ बंद करें, या नए instance को किसी अलग port पर शुरू करें। ध्यान दें कि 127.0.0.1:3080 और 0.0.0.0:3080 भी आपस में टकराते हैं, क्योंकि सभी interfaces को bind करने का अर्थ loopback को भी कवर करना होता है।

वर्जन को पिन करें, क्योंकि यह एक डेवलपर प्रीव्यू है

README इस बारे में स्पष्ट है: DeepSeek Harness अभी डेवलपर प्रीव्यू में है और इसमें तेजी से बदलाव हो रहे हैं, जिसके कारण compatibility-breaking बदलाव हो सकते हैं। यदि यही गति आपके संकोच का कारण है, तो dsh की Claude Code और Omnigent से तुलना इसे एक ही विकास क्रम के अलग-अलग चरणों पर मौजूद दो अन्य harnesses के साथ तौलती है।

एक अनपिन किया गया npx @deepseek-ai/dsh web किसी वर्जन को निर्दिष्ट नहीं करता है, इसलिए आप यह नियंत्रित नहीं कर पाते कि कौन सा build शुरू होगा। npm का डॉक्यूमेंटेशन कहता है कि बिना किसी specifier के पैकेज का नाम "लोकल प्रोजेक्ट में मौजूद किसी भी वर्जन के साथ मैच हो जाएगा", और जो पैकेज प्रोजेक्ट में नहीं है, वह npm cache के एक फोल्डर में इंस्टॉल हो जाता है। कौन सा build शुरू होगा, यह इस बात पर निर्भर करता है कि उस मशीन पर क्या उपलब्ध है, इसलिए एक रीस्टार्ट आपके द्वारा टेस्ट किए गए CLI से अलग CLI ला सकता है, जिसमें अलग flags हो सकते हैं। वर्जन को पिन करें ताकि रीस्टार्ट करने पर अपने आप अपग्रेड न हो जाए:

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

नवंबर 2026 तक (2026-11-01 को जाँचा गया), npm latest टैग 0.2.1-rc.5 की ओर इशारा करता है, जिसे 2026-10-30 को GitHub पर रिलीज़ किया गया था। GitHub के रिकॉर्ड के अनुसार 0.2.1-rc.4 को 2026-10-28 को 02:49 UTC पर रिलीज़ किया गया था, जो 2026-10-23 को 15:26 UTC पर आए 0.2.1-rc.3 के लगभग चार दिन और ग्यारह घंटे बाद है। इसलिए, बिना किसी लोकल कॉपी वाली मशीन पर, एक साधारण npx @deepseek-ai/dsh अब 0.2.1 रिलीज़ कैंडिडेट को पुल करेगा, न कि उस build को जिसे यह गाइड पिन करती है। पिन किया गया 0.2.0-rc.2 GitHub पर 2026-09-29 को रिलीज़ हुआ था। अगस्त में इस गाइड द्वारा पिन किया गया 0.1.0-rc.7 build अब कई प्रीव्यू रिलीज़ पीछे है, जो 0.1 लाइन के बाकी हिस्सों से होते हुए 0.2 तक पहुँच गया है। स्वीकार करने से पहले जाँच लें कि एक साधारण npx क्या पुल करेगा:

npm view @deepseek-ai/dsh version

npm view @deepseek-ai/dsh dist-tags एक साथ सभी टैग्स को लिस्ट करता है, जिससे आप पिन करने से पहले रिलीज़ कैंडिडेट और अल्फा के बीच अंतर जान सकते हैं।

यदि पिन इंस्टॉल होने से मना कर दे, या नया वर्जन पिन करने के बाद भी npx पुराना build ही शुरू करता रहे, तो इसके कारण आने वाली इंस्टॉल और वर्जन त्रुटियाँ npx cache को क्लियर करने और यह जाँचने में मदद करेगा कि आपका Node कौन सा npm बंडल करता है।

प्रीव्यू रिलीज़ के दौरान flags लॉन्चर और वेब एप्लिकेशन के बीच बदलते रहते हैं। यदि --port उस तरह काम करना बंद कर दे जैसा इस गाइड में बताया गया है, तो अनुमान लगाने के बजाय एप्लिकेशन से ही उसकी फ्लैग लिस्ट मांगें:

dsh --profile web --help

इंस्टॉल, वर्कस्पेस सेटअप और मॉडल की के लिए, VPS पर DeepSeek Harness इंस्टॉल करना देखें। केवल एक्सेस स्टेप के संक्षिप्त विवरण के लिए, VPS पर dsh Web UI तक पहुँचना बिना किसी अतिरिक्त तर्क के टनल के बारे में जानकारी देता है।

FAQ

मैं अपने लैपटॉप ब्राउज़र में http://127.0.0.1:3080 क्यों नहीं खोल पा रहा हूँ?

क्योंकि 127.0.0.1 का अर्थ वह मशीन है जिस पर आप टाइप कर रहे हैं। DeepSeek Harness Web UI VPS के loopback address से बंधा (bound) है, इसलिए केवल VPS पर चल रही प्रक्रियाएं ही इससे जुड़ सकती हैं। आपके लैपटॉप का अपना अलग loopback है, और वहाँ port 3080 पर कोई भी service listening नहीं है। ssh -N -L 3080:127.0.0.1:3080 you@your-vps के साथ SSH के माध्यम से port को forward करें, फिर स्थानीय रूप से पूरा प्रिंट किया गया URL, http://127.0.0.1:3080/?token=..., लोड करें। -L तर्क (argument) का मध्य भाग सर्वर साइड पर resolve होता है, जो इसे harness की ओर इंगित करता है। टोकन को हटा दें तो आपको 401 Unauthorized मिलेगा, जब तक कि आपके ब्राउज़र में session cookie न हो।

क्या सार्वजनिक VPS पर dsh Web UI को 0.0.0.0 पर bind करना सुरक्षित है?

नहीं। Web UI उस agent के लिए control surface है जो dsh चलाने वाले उपयोगकर्ता के रूप में shell commands चलाता है और फ़ाइलों को संपादित करता है। इसमें कोई user account या login screen नहीं है: एकमात्र credential प्रिंट किए गए URL में मौजूद टोकन है, static assets इसके बिना भी serve किए जाते हैं, और प्रोजेक्ट के अपने दस्तावेज़ कहते हैं कि listening port स्वयं असुरक्षित है। सार्वजनिक IP पर सभी interfaces से bind करने का मतलब है कि port 3080 तक पहुँचने वाला कोई भी व्यक्ति आपके सर्वर पर command execution कर सकता है। सीधे सार्वजनिक IP पर bind करने में भी वही जोखिम है। bind को 127.0.0.1 पर रखें, firewall पर 3080 को बंद रखें, और SSH tunnel, private overlay network, या password की आवश्यकता वाले reverse proxy का उपयोग करें।

अपना SSH session बंद करने के बाद मैं dsh Web UI को कैसे चालू रखूँ?

Foreground npx @deepseek-ai/dsh web आपके login shell का child होता है, इसलिए shell बंद होने पर यह भी बंद हो जाता है। इसे tmux session के अंदर शुरू करें और Ctrl-b d के साथ detach करें, या lingering सक्षम (enabled) करके इसे systemd user service के रूप में चलाएं। Tunnel और harness स्वतंत्र हैं: आप जब चाहें SSH tunnel को हटा और फिर से बना सकते हैं, बिना harness को प्रभावित किए, बशर्ते harness का parent आपके login से अधिक समय तक जीवित रहे।

nginx के पीछे लंबे agent run के दौरान dsh Web UI बीच में ही क्यों रुक जाता है?

WebSocket connection और nginx के error log की जाँच करें। nginx का डिफ़ॉल्ट proxy_read_timeout reads के बीच 60 सेकंड का होता है, लेकिन pinned 0.2.0-rc.2 डिफ़ॉल्ट रूप से हर दो सेकंड में WebSocket pings भेजता है, इसलिए केवल एक लंबा agent step उस timeout को ट्रिगर नहीं करता है। proxy_read_timeout 3600s; inactivity की अनुमति को एक घंटे तक बढ़ा देता है। proxy_buffering off; HTTP responses के लिए buffering को अक्षम (disable) करता है, WebSocket frames के लिए नहीं। WebSocket handshake सफल होने के लिए proxy_http_version 1.1; के साथ Upgrade और Connection headers पास करें। इन headers के बिना पेज लोड तो होता है लेकिन कोई अपडेट प्राप्त नहीं होता।

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