SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor · اپ ڈیٹ شدہ 2026-11-13

VPS پر DeepSeek Harness کو نجی اور محفوظ رکھیں

Linux VPS پر DeepSeek Harness نصب کریں، 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 سے bind کیا جائے اور browser اسے SSH (secure shell) tunnel کے ذریعے access کرے۔ یہ terminal میں چلنے کے بجائے port 3080 پر web UI (user interface) فراہم کرتا ہے۔ اس guide میں مقرر کردہ 0.1.0-rc.6 release میں یہ web server اپنی طرف سے کسی password کا تقاضا نہیں کرتا۔ اس لیے published port 3080 ہر اس شخص کو ایک agent فراہم کر دیتا ہے جو اسے تلاش کر لے، اور وہ agent آپ کی Linux user کے طور پر آپ کی files پڑھ اور commands چلا سکتا ہے۔ 11 November 2026 کو جاری ہونے والے 0.2.0-rc.2 سے 0.2.2-rc.2 تک کے newer releases، جو 12 November 2026 کو GitHub کی فہرست میں موجود newest release ہے، اس process کے لیے ایک fresh token والا startup URL print کرتے ہیں اور اسے session cookie سے بدل دیتے ہیں۔ تاہم یہ releases default طور پر loopback پر ہی listen کرتے ہیں اور اب بھی ہر interface سے 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 نئے prerelease 0.2.2-rc.2 کی فہرست دیتا ہے، جسے dsh-v0.2.2-rc.2 tag کیا گیا اور 11 November 2026 کو release کیا گیا۔ کسی اہم box پر اس کا کوئی حصہ copy کرنے سے پہلے repository check کریں۔

پورے design میں ایک ہی خیال مرکزی حیثیت رکھتا ہے: ہر چیز plugin ہے۔ Model adapter، tool registry، session log، sandbox، scheduler اور agent loop خود بھی plugins ہیں جو ایک shared context میں load ہوتے ہیں، اور ان میں سے کسی کو بھی replace کیا جا سکتا ہے۔ کوئی privileged core موجود نہیں جسے plugins صرف decorate کرتے ہوں۔ یہی چیز harness کو آزمانے کے قابل بناتی ہے، اور حقیقی risk بھی یہی ہے۔ یہ 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 کا address نہ دیں، کچھ بھی کام نہیں کرتا۔ اس پوسٹ میں موجود ہر چیز harness configuration سے متعلق ہے، model behaviour سے نہیں، اور دونوں کے درمیان حد کو واضح رکھنا ضروری ہے، اس سے پہلے کہ آپ پورا دوپہر یہ معلوم کرنے میں گزار دیں کہ مسئلہ کس جانب سے آیا ہے۔

آپ یہ configuration UI میں Settings اور پھر Models کے تحت کرتے ہیں۔ DeepSeek کا اپنا card ہے، اور current releases میں اس کے نیچے موجود "Add model provider" button دو modes کھولتا ہے۔ "Third-party model provider" میں وہ providers شامل ہیں جن کے لیے harness catalog فراہم کرتا ہے، مثلاً OpenAI اور Anthropic؛ یہاں آپ key paste کرتے ہیں اور catalog endpoint اور model list فراہم کرتا ہے۔ "Custom model API" زیادہ اہم option ہے۔ اس میں lowercase provider ID، display name، base URL، API protocol، credential اور کم از کم ایک model درکار ہوتا ہے۔ Protocol picker میں OpenAI Chat Completions، OpenAI Responses، Anthropic Messages اور Gemini API شامل ہیں۔ اس لیے آپ ایسا gateway یا local server configure کر سکتے ہیں جو ان میں سے کسی ایک protocol پر کام کرتا ہو۔ جن endpoints کے request format میں فرق ہو، ان کے لیے compatibility settings درکار ہوتی ہیں۔ Custom providers model list خود بھرنے کے لیے OpenAI-compatible GET /models endpoint سے query بھی کر سکتے ہیں۔

اسی طرح آپ harness کو اسی VPS پر موجود model کی طرف بھیجتے ہیں۔ Ollama http://127.0.0.1:11434/v1/ پر OpenAI-compatible API فراہم کرتا ہے، اور API key field میں کوئی بھی string، عموماً ollama، استعمال کی جا سکتی ہے، کیونکہ OpenAI-style client کو ایک value درکار ہوتی ہے اور Ollama اسے نظرانداز کرتا ہے۔ Ollama کی اپنی docs میں ollama launch dsh بھی بیان کیا گیا ہے۔ یہ command missing ہونے کی صورت میں @deepseek-ai/dsh install کرتی ہے اور اسے Ollama model کے خلاف start کرتی ہے، اس لیے نیچے دی گئی pin پر انحصار کرنے سے پہلے دیکھیں کہ یہ کون سا version install کرتی ہے۔ آپ کے VPS میں فٹ ہونے والا چھوٹا model agent چلانے کے لیے کافی ہے یا نہیں، یہ زیادہ مشکل سوال ہے، اور local model server کے طور پر Ollama اور vLLM کا فرق طے کرتا ہے کہ اس جواب کے لیے آپ کی RAM کا کتنا حصہ درکار ہوگا۔

UI میں درج کی گئی keys صرف write-only ہوتی ہیں۔ Harness انہیں $DSH_HOME/.credentials.yaml میں محفوظ کرتا ہے، جبکہ settings صرف credential reference رکھتی ہیں۔ Current releases یہ reference 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 میں click کرنے کے بجائے ان files کو براہ راست edit کرنا چاہتے ہیں تو dsh config files، keys اور model endpoints کا walkthrough بتاتا ہے کہ ہر key کیا کرتی ہے اور ہر mode میں آپ کے box سے کیا باہر جاتا ہے۔

انسٹال کرنے سے پہلے درکار چیزیں

  • Ubuntu 24.04 یا کسی دوسرے موجودہ Linux پر چلنے والا VPS، جس تک SSH کے ذریعے رسائی ہو
  • Node.js 24.9 یا اس کے بعد کا ورژن، کیونکہ پروجیکٹ کی main branch اور 0.2.2-alpha.2 اب >=24.9.0 کا اعلان کرتی ہیں، اور اس کے CI tests Node 24 کو Node 24.9 اور Node 26 پر compatibility check کے ساتھ آزماتے ہیں؛ Node 22 کے لیے کوئی job نہیں ہے۔ 0.2.1-rc.4 تک کی tagged releases میں Node 22.19 کو اب بھی قابل قبول درج کیا گیا تھا، لیکن اب یہ وہ کم از کم ورژن نہیں ہے جس کے خلاف پروجیکٹ build کرتا ہے
  • عام user account، root نہیں، کیونکہ agent shell commands اسی user کے طور پر چلاتا ہے جس نے process شروع کیا ہو
  • اگر plugins انسٹال کرنے کا ارادہ ہے تو PATH میں pnpm، کیونکہ plugin command اسے shell out کرکے چلاتی ہے
  • آپ کے firewall اور provider کے الگ network firewall، دونوں پر port 3080 بند ہو

Ubuntu 24.04 کا اپنا nodejs package اس harness کی ضرورت سے پرانا ہے، اس لیے اس release پر Node انسٹال کرنے کے لیے apt install nodejs استعمال کرنے کے بجائے NodeSource یا nvm استعمال کریں۔ Ubuntu 26.10 کی official repository میں Node 24.19.0 درج ہے، جو Node 24.9 کی کم از کم ضرورت سے زیادہ ہے۔ اگر VPS نیا ہے تو کسی اور کام سے پہلے SSH کو harden کرنا دس منٹ صرف کرنے کے قابل ہے، کیونکہ جس tunnel پر آپ اب انحصار کرنے والے ہیں، اس کی مضبوطی SSH server کی مضبوطی تک محدود ہے جو اس کے پیچھے موجود ہے۔

VPS پر DeepSeek Harness انسٹال کریں اور اسے ایک ہی version پر مقید رکھیں

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

npx package download کرتا ہے اور اس کی dsh binary چلاتا ہے۔ web، --profile web کا alias ہے، جو browser application شروع کرتا ہے، اور process وہ address دکھاتا ہے جس پر یہ listening کر رہا ہے۔ Default http://127.0.0.1:3080 ہے۔ یہ numbers صرف ظاہری default نہیں بلکہ binding کا فیصلہ ہیں۔ dsh loopback address کیوں دکھاتا ہے میں بتایا گیا ہے کہ laptop سے تلاش شروع کرنے سے پہلے harness کن درخواستوں کا جواب دے گا اور کن کا نہیں۔

version کو pin کریں۔ npx @deepseek-ai/dsh web، run کے وقت latest tag جس چیز کی طرف اشارہ کر رہا ہو اسے resolve کرتا ہے۔ تاہم، اگر جس project سے آپ اسے چلا رہے ہیں اس میں پہلے ہی copy installed ہو تو npx خاموشی سے وہی copy استعمال کرتا ہے۔ دونوں صورتوں میں version کا انتخاب آپ نہیں کر رہے ہوتے۔ project پہلے ہی کئی release candidates جاری کر چکا ہے اور بتا رہا ہے کہ breaking changes آنے والی ہیں۔ 0.1.0-rc.6، August 2026 کا وہ version ہے جسے یہاں pin کیا گیا ہے۔ 12 November 2026 کو latest، 0.2.2-rc.1 کی طرف اشارہ کرتا ہے۔ یہ ایسی release ہے جو tokenized startup URL دکھاتی ہے۔ GitHub پر نئی prerelease 0.2.2-rc.2 درج ہے۔ اس لیے کسی دوسرے version پر منتقل ہونا وہ upgrade ہے جو repository پڑھنے کے بعد جان بوجھ کر کرنا چاہیے۔ Pinned version کا مطلب ہے کہ آج تیار کیا گیا box اگلے ماہ بھی اسی طرح کام کرے گا۔ یوں upgrade آپ کا کیا ہوا فیصلہ بنتا ہے، نہ کہ بعد میں معلوم ہونے والا حادثہ۔ اگر pinned command پھر بھی غلط build شروع کرے یا بالکل install نہ ہو تو dsh کی عام install اور version errors میں npx cache صاف کرنے اور یہ جانچنے کا طریقہ بتایا گیا ہے کہ آپ کے Node کے ساتھ کون سا npm bundled ہے۔

روزمرہ استعمال کے لیے اسے ہر start پر دوبارہ 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 اور repeatable --trusted-host وہیں موجود ہیں۔

اب تصدیق کریں کہ یہ کس address پر listening کر رہا ہے۔

ss -tlnp | grep 3080

Local address column میں 127.0.0.1:3080 ہونا چاہیے۔ اگر وہاں 0.0.0.0:3080 ہو تو UI ہر interface پر listening کر رہا ہے۔ اس صورت میں اسے internet سے الگ رکھنے والی واحد چیزیں آپ کے firewalls ہیں۔ کوئی اور کام کرنے سے پہلے process روک دیں۔

آپ کو port 3080 کبھی بھی public کیوں نہیں کرنا چاہیے

0.1.0-rc.6 میں موجود web server میں authentication layer نہیں ہے۔ اس کی configuration صرف listen host اور listen port ظاہر کرتی ہے، اور یہی اس کی مکمل سطح ہے۔ non-loopback deployments کے لیے access control ایک الگ trusted-host setting ہے، login screen نہیں۔

نئی releases میں یہ سہولت شامل ہے۔ 0.2.0-rc.2 سے startup پر ایک ایسا URL دکھایا جاتا ہے جس میں اسی process کے لیے نیا token شامل ہوتا ہے؛ جو browser اسے کھولتا ہے اسے signed session cookie ملتی ہے اور token کے بغیر اسی address پر redirect کر دیا جاتا ہے۔ /api routes کے سامنے موجود Host/Origin fence صرف loopback، listener کے اپنے bind address، اور --trusted-host کے ذریعے متعین کیے گئے authorities کو قبول کرتا ہے۔ یہ ایک حقیقی credential ہے، لیکن project کی اپنی documentation خبردار کرتی ہے کہ دکھایا گیا URL ایسا credential ہے جسے صرف مطلوبہ users کے ساتھ share کرنا چاہیے، اور plain HTTP اسے encryption کے بغیر بھیجتا ہے۔ 0.2.1-alpha.2 سے web app ایک مخصوص local address پر بھی bind ہو سکتی ہے اور --tls-cert اور --tls-key کے ذریعے خود HTTPS فراہم کر سکتی ہے۔ اس سے plaintext کا مسئلہ حل ہوتا ہے، exposure کا نہیں۔ اس سے exposed port کا غلط استعمال مشکل ہو جاتا ہے۔ یہ اسے public کرنے کے قابل نہیں بناتا۔

اب دیکھیں کہ اس port کے پیچھے کیا موجود ہے۔ agent workspace میں files edit کرتا ہے اور shell commands چلاتا ہے، جبکہ آپ کے provider credentials اسی کے ساتھ disk پر موجود ہوتے ہیں۔ لہذا pinned release میں کھلا port 3080 ایک remote shell ہے جس کے ساتھ chat interface موجود ہے۔ یہ اس user کے طور پر چلتا ہے جس نے اسے start کیا، اور اس کے ساتھ آپ کی 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 نہیں کرتا اور start ہونے کے بجائے usage error کے ساتھ exit ہو جاتا ہے، جبکہ نیا 0.2.2-alpha.2 بھی startup پر اسے reject کرتا ہے۔ یہ refusal ایک security feature ہے، اس لیے اسے ہٹانے والا patch تلاش نہ کریں۔

جب tunnel موزوں نہ ہو تو دو دیگر deployments مناسب ہیں۔ box کو private overlay network پر رکھیں تاکہ اس کے پاس ایسا address ہو جس تک صرف آپ کے اپنے devices route کر سکیں؛ یہی سہولت self-hosted Headscale control server فراہم کرتا ہے۔ یا اسے ایسے reverse proxy کے پیچھے رکھیں جو request کو port 3080 تک پہنچنے سے پہلے authenticate کرے، مثلاً Authentik single sign-on server کے ذریعے forward auth استعمال کریں۔ اس کے سامنے موجود reverse proxy، جس میں authentication نہ ہو، security control نہیں ہے۔ یہ صرف ایک طویل URL ہے۔

SSH tunnel کے ذریعے web UI تک رسائی حاصل کریں

یہ کمانڈ server پر نہیں، اپنے laptop پر چلائیں۔

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

-L آپ کے laptop پر port 3080 کھولتا ہے اور اس port سے آنے والی ہر connection کو encrypted SSH session کے ذریعے forward کرتا ہے۔ 127.0.0.1:3080 حصہ server پر resolve ہوتا ہے، اس لیے connection loopback سے harness تک پہنچتی ہے، بالکل ایسے جیسے آپ خود machine پر بیٹھے ہوں۔ -N کا مطلب ہے کہ remote shell شروع نہ کریں، کیونکہ آپ کو صرف port forwarding درکار ہے۔

اس کے بعد اپنے local browser میں http://127.0.0.1:3080 کھولیں۔ جس release میں launch token موجود ہو، اس کے بجائے server کی طرف سے print کیا گیا مکمل startup URL کھولیں، جس میں token بھی شامل ہو۔ جب harness کو SSH کے ذریعے start کیا گیا ہو تو یہ 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 ہے، جبکہ دائیں طرف کا نمبر 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 فعال ہے، لیکن دوسری طرف کوئی چیز listen نہیں کر رہی، کیونکہ SSH اس بات سے قطع نظر port forward کرتا ہے کہ harness چل رہا ہے یا نہیں۔ اوپر دی گئی ss command سے server چیک کریں۔

لاگ آؤٹ کرنے کے بعد harness کو چلتا رکھیں

npx کمانڈ آپ کے shell کے ساتھ ختم ہو جاتی ہے۔ systemd user service برقرار رہتی ہے اور crash یا reboot کے بعد harness کو دوبارہ شروع کر دیتی ہے۔ یہاں دیا گیا unit دانستہ طور پر کم سے کم رکھا گیا ہے؛ اگر آپ harness کو اپنے الگ locked-down account کے تحت چلانا چاہتے ہیں، version کو unit کے اندر pin کرنا چاہتے ہیں، اور ایسے logs چاہتے ہیں جن میں حقیقتاً search کیا جا سکے، تو 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 اس PATH کو search نہیں کرتا جو آپ کا 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 process اپنے invoking directory کو default filesystem location کے طور پر استعمال کرتا ہے۔ اس لیے غلط جگہ سے شروع کی گئی service agent کو غلط folder کی طرف بھیجتی ہے۔ تاہم یہ directory صرف default ہوتی ہے۔ تازہ Web UI میں workspace منتخب نہیں ہوتا، جب تک آپ Choose workspace کے تحت کوئی workspace شامل نہ کریں۔ project کی guide میں بھی ہدایت ہے کہ وہ directory شامل کریں جہاں آپ نے dsh شروع کیا تھا۔ guide میں version marker موجود نہیں ہے، اور یہی عبارت پہلے ہی 0.1.0-rc.7 میں موجود ہے، اس لیے pinned release پر بھی یہی ہدایت متوقع ہے۔ unit کی directory کو project پر set کریں، پھر 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 ظاہر ہوتا ہے۔ یہی طریقہ کسی بھی coding agent کو VPS پر فعال رکھنے کے لیے بھی ہے، اور failure modes یکساں ہوتے ہیں۔

پلگ ان کیا کر سکتا ہے

پلگ ان ایک module ہے جو مشترکہ context میں services، typed events اور قابل واپسی effects شامل کرتا ہے۔ جن extension points کو غور سے پڑھنا ضروری ہے، وہ یہ ہیں:

  • ctx.llm پر model provider register کرنا
  • ctx.tools پر model-facing tools شامل کرنا
  • ctx.shell کے پیچھے shell backend فراہم کرنا
  • ctx.fs کے پیچھے filesystem access یا policy فراہم کرنا
  • ctx.commands پر human commands register کرنا
  • ctx.jobs کے ذریعے background work چلانا
  • spawned processes کو ctx.sandbox backend کے ذریعے wrap کرنا
  • agent/* اور tools/* events کے ذریعے requests اور tool calls کو intercept کرنا
  • durable session state کو extend کرنا
  • ctx.agents کے ذریعے UI کو control کرنا

اس فہرست کو حملہ آور کے نقطۂ نظر سے پڑھیں۔ ایک پلگ ان filesystem layer اور shell layer فراہم کر سکتا ہے، اور model کی جانب سے کی جانے والی ہر tool call کے درمیان موجود رہ سکتا ہے۔ plugin اور ان interfaces کے درمیان کوئی permission dialog حائل نہیں ہوتا، کیونکہ پلگ ان عام Node code ہوتا ہے جو باقی تمام components کے اسی process میں load ہوتا ہے۔ پلگ ان install کرنے کا مطلب ہے کہ آپ کے agent کی permissions کے ساتھ کسی اجنبی کا code چلایا جائے۔ آپ کے agent کی permissions آپ کے Unix user کی permissions ہوتی ہیں۔

یہ وہی trust decision ہے جو آپ اس وقت کرتے ہیں جب VPS پر کسی agent کے ساتھ MCP server منسلک کرتے ہیں، جہاں MCP سے مراد model context protocol ہے۔ اسی وجہ سے VPS پر coding agent کو محفوظ طریقے سے چلانا model کے بجائے اس account سے شروع ہوتا ہے جس کے تحت agent چلتا ہے۔ اسی طرح npm supply chain attacks سرورز پر اتنے شدید اثر انداز ہوتے ہیں: compromise install step پر ہی ہو جاتا ہے، اور کوئی prompt ظاہر نہیں ہوتا۔

Plugins کہاں سے آتے ہیں

Plugins profiles میں رہتے ہیں۔ Profile ایک نامزد composition ہے جو $DSH_HOME کے تحت محفوظ ہوتی ہے۔ اس کی default قدر ~/.dsh ہے۔ ہر profile directory میں وہ out-of-tree plugins موجود ہوتے ہیں جنہیں یہ install کرتی ہے۔ CLI آپ کے arguments براہِ راست pnpm کو بھیج کر انہیں manage کرتا ہے۔ اس دوران 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 کی طرح کام کرتے ہیں۔ Plugin npm package یا GitHub reference ہو سکتا ہے۔ pnpm پہلے PATH میں موجود ہونا چاہیے۔ Node 24 پر corepack enable pnpm اسے PATH میں شامل کرتا ہے۔ Node 25 میں Corepack کی distribution بند کر دی گئی، اس لیے Node 25 اور اس کے بعد کے versions پر اسے npm install -g pnpm کے ذریعے install کریں۔

Discovery ایک GitHub topic کے ذریعے کام کرتی ہے۔ Plugin authors اپنے repository میں dsh-plugin topic شامل کرتے ہیں۔ دستیاب plugins تلاش کرنے کا طریقہ اسی topic کو browse کرنا ہے۔ Topic وہ label ہے جو author اپنے repository پر خود لگاتا ہے۔ کوئی اس کا review نہیں کرتا اور نہ ہی اس پر دستخط کرتا ہے۔ Topic page کی ranking stars کی بنیاد پر ہوتی ہے، جو safety کے بجائے popularity ناپتی ہے۔

موجودہ releases میں experimental Custom plugin indexes bundle بھی شامل ہے۔ اسے Plugins کے تحت فعال کریں۔ اس کے بعد Discover tab میں index شامل کیا جا سکتا ہے۔ Index ایک JSON file ہے جو آپ کے فراہم کردہ URL سے fetch ہوتی ہے۔ Harness اپنا کوئی index فراہم نہیں کرتا۔ یہ file کا format check کرتا ہے، لیکن market کے بتائے گئے titles، authors یا sources کی تصدیق نہیں کرتا۔ plain http: پر فراہم کیے گئے index کو network path پر موجود کوئی بھی شخص تبدیل کر سکتا ہے۔ Market کسی دوسرے شخص کی لکھی ہوئی catalogue ہے، review نہیں۔

چار عادتیں اس عمل کو قابلِ انتظام رکھتی ہیں۔ Install کرنے سے پہلے source پڑھیں، کیونکہ زیادہ تر plugins اتنے چھوٹے ہوتے ہیں کہ انہیں دس منٹ میں پڑھا جا سکتا ہے۔ Branch track کرنے کے بجائے exact version یا commit pin کریں۔ Harness ایسے user کے تحت چلائیں جس کی ملکیت میں کوئی دوسری چیز نہ ہو، اور اسے ایسے VPS پر چلائیں جسے آپ ضرورت پڑنے پر دوبارہ build کرنے کے لیے تیار ہوں۔ Agent کو اپنی API key اور اپنی spending limit دیں۔ یہ key production services میں استعمال ہونے والی key سے الگ ہو۔ جب آپ plugin پڑھنے بیٹھیں اور یہ جاننا چاہیں کہ risk کن files میں موجود ہے، تو dsh plugin کی جانچ کا walkthrough manifest، entry point اور ان extension points کا جائزہ لیتا ہے جنہیں plugin register کرتا ہے۔

اگر آپ کسی ایک design پر فیصلہ کرنے سے پہلے designs کا تقابل کرنا چاہتے ہیں، تو Omnigent multi-agent harness اسی مسئلے کو مختلف structure کے ساتھ حل کرتا ہے۔ Plugins استعمال میں آنے کے بعد اس کے trade-offs واضح ہو جاتے ہیں۔ اگر آپ کسی ایک کو منتخب کرنے کے بجائے اسی machine پر دو یا تین plugins رکھنا چاہیں، تو تمام harnesses کو ایک self-hosted API کے پیچھے رکھنا ہر port کے لیے الگ tunnel کی ضرورت ختم کرتا ہے۔ اس کے بدلے ایک اضافی service manage کرنی پڑتی ہے، جسے پہلے دن loopback پر bind کرنا اور حقیقی password دینا ضروری ہے۔

جو چیز سب سے پہلے ناکام ہوتی ہے

Node بہت پرانا ہے۔ پروجیکٹ کی main branch اور 0.2.2-alpha.2 کے لیے Node 24.9 یا اس کے بعد کا ورژن درکار ہے۔ اس کے CI tests میں Node 24 کے علاوہ Node 24.9 اور Node 26 پر compatibility check بھی شامل ہے، جبکہ Node 22 کے لیے کوئی test نہیں ہے۔ 0.2.1-rc.4 تک کے پرانے tagged releases میں Node 22.19 کو قابل قبول بتایا گیا تھا، لیکن پروجیکٹ اب اس کے ساتھ build نہیں ہوتا۔ پرانا runtime startup کے وقت ناکام ہو جاتا ہے، کیونکہ code ایسی syntax اور APIs استعمال کرتا ہے جو اس میں موجود نہیں ہیں۔ سب سے پہلے node --version چلائیں۔

Port 3080 پہلے ہی استعمال ہو رہا ہے۔ اس کی وجہ دوسرا harness، کوئی پرانا process، یا کوئی غیر متعلقہ application ہو سکتی ہے جو 3080 بھی استعمال کر رہی ہو۔ ss -tlnp | grep 3080 سے اسے تلاش کریں، پھر اسے روک دیں یا dsh web --port 3180 کے ذریعے harness کو کسی دوسرے port پر شروع کریں۔ --port web app کے لیے ہے، اس لیے اسے web کے بعد چلائیں۔

Browser tunnel کے ذریعے connect نہیں ہو سکتا۔ تصدیق کریں کہ آپ نے 127.0.0.1 کھولا ہے، نہ کہ server کا public address، کیونکہ forwarded port صرف آپ کے laptop پر موجود ہوتا ہے۔ پھر تصدیق کریں کہ harness server پر listening کر رہا ہے، کیونکہ SSH forward قائم کر دیتا ہے، چاہے دوسری طرف کوئی process جواب دے یا نہ دے۔

dsh plugin فوراً ناکام ہو جاتا ہے۔ یہ command، pnpm کے گرد ایک wrapper ہے، اس لیے pnpm binary موجود نہ ہو تو plugin کا کام شروع ہونے سے پہلے ہی command رک جاتی ہے۔ Node 25 اور اس کے بعد کے ورژنز میں یہی default حالت ہے، کیونکہ Corepack اب Node کے ساتھ شامل نہیں ہوتا۔

Agent آپ کا project نہیں دیکھ سکتا۔ نئی Web UI میں workspace شامل کرنے تک کوئی workspace منتخب نہیں ہوتا، اور اس سے پہلے session composer بھی دستیاب نہیں ہوتا۔ Process جس directory سے شروع ہوتا ہے، اسے صرف default filesystem location کے طور پر استعمال کرتا ہے۔ اس لیے جس unit کا WorkingDirectory آپ کی home directory ہو، وہ agent کو بھی آپ کی home directory کی طرف بھیجتی ہے۔ UI میں workspace منتخب کریں، یا unit کو درست کر کے اسے reload کریں۔

FAQ

کیا DeepSeek Harness کا web UI port 3080 پر ظاہر کرنا محفوظ ہے؟

نہیں۔ pinned 0.1.0-rc.6 میں web server کی اپنی login نہیں ہے، اور اس کے پیچھے چلنے والا agent فائلوں میں ترمیم کرتا ہے اور shell commands اس user کے طور پر چلاتا ہے جس نے process شروع کیا ہو۔ آپ کی provider API key بھی اسی disk پر محفوظ ہوتی ہے۔ 0.2.0-rc.2 سے شروع ہونے والے versions میں، جن میں 0.2.2-rc.1، 12 November 2026 کو npm کی جاری کردہ latest، اور نئی 0.2.2-rc.2 prerelease شامل ہیں، startup URL میں launch token موجود ہوتا ہے۔ browser اس token کے بدلے session cookie حاصل کرتا ہے۔ لیکن plain HTTP اس URL کو encryption کے بغیر بھیجتا ہے، اس لیے مشورہ تبدیل نہیں ہوتا۔ listener کو 127.0.0.1 پر رکھیں اور اسے SSH tunnel کے ذریعے access کریں۔ Private overlay network، یا ایسا reverse proxy جو port تک پہنچنے سے پہلے ہر request کی authentication کرے، بھی استعمال کیا جا سکتا ہے۔ Version 0.1.0-rc.6 میں CLI --host 0.0.0.0 کو مسترد کر کے usage error کے ساتھ exit کرتی ہے، اور 0.2.2-alpha.2 بھی اسے مسترد کرتا ہے۔ اس سے معلوم ہوتا ہے کہ developers اس طریقے کے بارے میں کیا رائے رکھتے ہیں۔

کیا مجھے 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/ پر response دیتا ہے اور API key field میں کوئی بھی string قبول کرتا ہے۔ Keys $DSH_HOME/.credentials.yaml میں محفوظ ہوتی ہیں، جس کی default value ~/.dsh/.credentials.yaml ہے۔

DeepSeek Harness plugin install کرنے سے plugin کو حقیقتاً کیا ملتا ہے؟

Harness چلانے والے account کی permissions۔ Plugin وہ Node code ہے جو اسی process میں load ہوتا ہے، اور extension points میں shell backend، filesystem layer، tool registry اور ہر tool call کو wrap کرنے والے events شامل ہیں۔ جب تک plugin خود sandbox فراہم نہ کرے، کوئی چیز plugin کو ان interfaces سے الگ نہیں رکھتی۔ Install کرنے سے پہلے source پڑھیں، اور harness ایسے user کے طور پر چلائیں جس کے پاس کوئی اہم data موجود نہ ہو۔

مجھے کون سا 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 نئی prerelease 0.2.2-rc.2 درج کرتا ہے، جو 11 November کو جاری ہوئی، اور موجودہ CLI کے لیے Node 24.9 یا اس سے نیا version درکار ہے۔ Project خود کو developer preview کہتا ہے اور بتاتا ہے کہ compatibility توڑنے والی تبدیلیاں متوقع ہیں۔ اس لیے unpinned command ایک دن سے دوسرے دن مختلف طریقے سے کام کر سکتی ہے۔ Upgrade کرنے سے پہلے repository check کریں، اور توقع رکھیں کہ version ابھی 0 سے شروع ہونے کے باوجود config keys اور plugin interfaces تبدیل ہو سکتی ہیں۔

کیا یہ مضمون مفید تھا؟