VPS-এ DeepSeek Harness private রাখার নিরাপদ উপায়
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 করা এবং SSH (secure shell) tunnel ব্যবহার করে browser থেকে এতে সংযোগ করা। এটি terminal-এ চলার পরিবর্তে port 3080-এ একটি web UI (user interface) পরিবেশন করে। এই গাইডে নির্ধারিত 0.1.0-rc.6 release-এ web server নিজে কোনো password চায় না। তাই port 3080 Internet-এ প্রকাশ করলে যে কেউ এটি খুঁজে পেয়ে এমন একটি agent ব্যবহার করতে পারে, যা আপনার files পড়ে এবং আপনার Linux user হিসেবে commands চালায়। 0.2.0-rc.2 থেকে 0.2.2-rc.2 পর্যন্ত newer releases-এ, যা 11 November 2026-এর মধ্যে 12 November 2026-এ GitHub তালিকাভুক্ত সর্বশেষ release, startup-এর সময় ওই process-এর জন্য নতুন token-সহ একটি URL দেখানো হয় এবং পরে সেটি session cookie দিয়ে প্রতিস্থাপিত হয়। তবে এগুলোও default হিসেবে loopback-এ listen করে এবং সব interface-এ bind করতে অস্বীকার করে।
DeepSeek এটি MIT licence-এর অধীনে npm package @deepseek-ai/dsh হিসেবে প্রকাশ করে। Project-টি নিজেকে developer preview হিসেবে বর্ণনা করে এবং জানায় যে compatibility ভঙ্গকারী পরিবর্তন প্রত্যাশিত। নিচে নির্ধারিত version-টি August 2026 release। 12 November 2026-এ npm-এর latest tag-এ 0.2.2-rc.1 লেখা আছে। GitHub-এ আরও নতুন prerelease 0.2.2-rc.2 তালিকাভুক্ত, যার tag dsh-v0.2.2-rc.2 এবং release date 11 November 2026। গুরুত্বপূর্ণ কোনো box-এ এটি copy করার আগে repository পরীক্ষা করুন।
পুরো design-জুড়ে একটি ধারণা কাজ করে: সবকিছুই plugin। Model adapter, tool registry, session log, sandbox, scheduler এবং agent loop নিজেও plugin হিসেবে একটি shared context-এ load হয়, এবং এগুলোর যেকোনোটি প্রতিস্থাপন করা যায়। এমন কোনো privileged core নেই, যাকে plugins শুধু অতিরিক্ত বৈশিষ্ট্য দেয়। Harness পরীক্ষা করার মূল কারণ এটি। একই সঙ্গে প্রকৃত ঝুঁকিটিও এখানেই রয়েছে। এই trade-off সঠিক কি না, তা নির্ভর করে আপনি এটিকে কোন কিছুর সঙ্গে তুলনা করছেন তার ওপর। Claude Code এবং Omnigent-এর তুলনায় এর অবস্থান অংশে plugin-everything design-কে model coupling, licence এবং প্রতিটি tool একটি VPS-এর কতটা resource চায়—এই তিনটি বিষয়ে অন্য দুটি পদ্ধতির পাশে রাখা হয়েছে।
একটি harness নিজে model নয়
harness agent loop চালায়। reasoning অন্য কোথাও থাকা একটি model-এ হয়। তাই আপনি API (application programming interface) key অথবা নিজে host করা model endpoint-এর address না দেওয়া পর্যন্ত কিছুই কাজ করবে না। এই post-এর সবকিছু harness configuration; model behaviour নয়। কোনো সমস্যার উৎস কোন পাশে, তা নিয়ে বিকেলভর debugging শুরু করার আগে দুটির পার্থক্য স্পষ্ট করে নেওয়া জরুরি।
UI-তে Settings, তারপর Models-এ গিয়ে এটি configure করুন। DeepSeek-এর জন্য আলাদা card আছে। বর্তমান releases-এ এর নিচের "Add model provider" button-এ দুটি mode খোলা হয়। "Third-party model provider" এমন provider-এর জন্য, যাদের catalog harness সরবরাহ করে। এর মধ্যে 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 রয়েছে। তাই এগুলোর কোনো একটি protocol-এ কথা বলতে পারে এমন gateway বা local server configure করা যায়। যেসব endpoint-এর request format আলাদা, সেগুলোর জন্য compatibility settings দরকার। Custom provider-গুলো 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, কারণ OpenAI-style client একটি value চায় এবং Ollama সেটি উপেক্ষা করে। Ollama-এর নিজস্ব documentation-এ ollama launch dsh-এর কথাও বলা আছে। এটি অনুপস্থিত থাকলে @deepseek-ai/dsh install করে এবং একটি Ollama model-এর বিরুদ্ধে সেটি চালু করে। তাই নিচের pin-এর ওপর নির্ভর করার আগে এটি কোন version install করে তা পরীক্ষা করুন। আপনার VPS-এ fit করে এমন ছোট model agent চালানোর জন্য যথেষ্ট ভালো কি না, সেটিই কঠিন প্রশ্ন। Local model server হিসেবে Ollama এবং vLLM-এর পার্থক্য নির্ধারণ করে এই উত্তরের জন্য কতটা RAM খরচ হবে।
UI-তে লেখা key পরে আর পড়া যায় না। 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 হলো ~/.dsh। Credentials file-কে password file হিসেবে বিবেচনা করুন, কারণ এটি সত্যিই তা-ই। যে কেউ এটি পড়তে পারলে আপনার API budget খরচ করতে পারে। Settings-এ click না করে সরাসরি এই file-গুলো edit করতে চাইলে dsh config file, key এবং model endpoint-এর walkthrough-তে প্রতিটি key-এর কাজ এবং প্রতিটি mode-এ আপনার box থেকে কী বাইরে যায় তা দেখানো হয়েছে।
ইনস্টল করার আগে যা প্রয়োজন
- Ubuntu 24.04 বা অন্য কোনো বর্তমান Linux চালানো একটি VPS, যেখানে SSH access আছে
- 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 release-গুলোতে Node 22.19 এখনও গ্রহণযোগ্য হিসেবে তালিকাভুক্ত ছিল, কিন্তু প্রকল্পটি এখন আর Node 22-কে build-এর minimum version হিসেবে ব্যবহার করে না - একটি সাধারণ user account,
rootনয়, কারণ agent যে user process শুরু করেছে তার account হিসেবেই shell command চালায় - PATH-এ
pnpm, যদি plugin ইনস্টল করার পরিকল্পনা থাকে, কারণ plugin command এটি ব্যবহার করে shell command চালায় - আপনার firewall এবং provider-এর আলাদা network firewall—উভয় স্থানেই port 3080 বন্ধ থাকতে হবে
Ubuntu 24.04-এর নিজস্ব nodejs package-টি এই harness-এর প্রয়োজনের তুলনায় পুরোনো। তাই এই release-এ apt install nodejs ব্যবহার না করে NodeSource বা nvm থেকে Node ইনস্টল করুন। Ubuntu 26.10-এর official repository-তে Node 24.19.0 তালিকাভুক্ত আছে, যা Node 24.9-এর minimum version-এর চেয়ে নতুন। VPS-টি নতুন হলে, অন্য কিছু করার আগে SSH hardening করা-তে দশ মিনিট ব্যয় করা ভালো। কারণ আপনি যে tunnel-এর ওপর নির্ভর করতে যাচ্ছেন, সেটি তার পেছনের SSH server যতটা নিরাপদ, ততটাই নিরাপদ।
VPS-এ DeepSeek Harness ইনস্টল করুন এবং একটি নির্দিষ্ট version-এ pin করুন
node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 webnpx package download করে তার dsh binary চালায়। web হলো --profile web-এর একটি alias। এটি browser application চালু করে এবং process যে address-এ listening করছে, সেটি দেখায়। ডিফল্ট হলো http://127.0.0.1:3080। এই সংখ্যাগুলো শুধু cosmetic default নয়; এগুলো binding-এর সিদ্ধান্ত। ল্যাপটপ থেকে এটি খোঁজার আগে harness কী উত্তর দেবে এবং কী দেবে না, তা কেন dsh loopback address দেখায়-এ ব্যাখ্যা করা হয়েছে।
Version pin করুন। আপনি command চালানোর সময় npx @deepseek-ai/dsh web যে latest tag-এর দিকে নির্দেশ করে, সেটিই resolve করে। তবে যে project থেকে এটি চালাচ্ছেন সেখানে আগে থেকেই একটি copy ইনস্টল করা থাকলে npx নীরবে সেই copy ব্যবহার করে। উভয় ক্ষেত্রেই version নির্বাচন করছেন আপনি নন। Project ইতিমধ্যে বেশ কয়েকটি release candidate প্রকাশ করেছে এবং breaking change আসছে বলে জানিয়েছে। এখানে 0.1.0-rc.6 হলো August 2026-এ pin করা version। 12 November 2026 তারিখে latest, 0.2.2-rc.1-এর দিকে নির্দেশ করে; এটি এমন একটি release যা tokenized startup URL দেখায়। GitHub-এ আরও নতুন prerelease 0.2.2-rc.2 তালিকাভুক্ত আছে। তাই অন্য version-এ যাওয়া repository পড়ে সচেতনভাবে করার মতো upgrade। Pin করা version-এর ফলে আজ সেটআপ করা box পরের মাসেও একইভাবে কাজ করবে। ফলে upgrade আপনার নেওয়া সিদ্ধান্ত হবে, পরে আবিষ্কার করা কোনো দুর্ঘটনা নয়। Pin করা command চালিয়েও যদি ভুল build শুরু হয় বা install একেবারেই না হয়, তাহলে সাধারণ dsh install এবং version error-এ npx cache পরিষ্কার করা এবং আপনার Node কোন npm bundle করে তা পরীক্ষা করার পদ্ধতি দেখুন।
দৈনন্দিন ব্যবহারের জন্য প্রতিবার start করার সময় আবার resolve না করে একবার ইনস্টল করুন।
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --helpদ্বিতীয় line-টি চালানো উচিত, কারণ launcher এবং web app-এর flag set আলাদা। dsh --help launcher-এর নিজস্ব option দেখায়। dsh --profile web --help web application যে flag গ্রহণ করে তা দেখায়। --port, --host এবং পুনরাবৃত্তিযোগ্য --trusted-host এখানেই রয়েছে।
এখন এটি কোন address-এ listening করছে, তা নিশ্চিত করুন।
ss -tlnp | grep 3080Local address column-এ 127.0.0.1:3080 দেখা উচিত। যদি 0.0.0.0:3080 দেখা যায়, তাহলে UI প্রতিটি interface-এ listening করছে। সে ক্ষেত্রে UI এবং Internet-এর মধ্যে কেবল আপনার firewall-গুলোই বাধা হিসেবে আছে। অন্য কিছু করার আগে process বন্ধ করুন।
আপনার কখনোই port 3080 প্রকাশ্যে উন্মুক্ত করা উচিত নয়
0.1.0-rc.6-এর web server-এ কোনো authentication layer নেই। এর configuration-এ একটি listen host এবং একটি listen port নির্ধারিত থাকে। এটিই পুরো exposure surface। non-loopback deployment-এর access control একটি আলাদা trusted-host setting-এর মাধ্যমে নির্ধারিত হয়। এটি কোনো login screen নয়।
নতুন release-গুলোতে authentication layer যুক্ত হয়েছে। 0.2.0-rc.2 থেকে startup-এর সময় এমন একটি URL দেখানো হয়, যাতে ওই process-এর জন্য নতুন token থাকে। URL-টি যে browser-এ খোলা হয়, সেটি একটি signed session cookie পায় এবং token ছাড়া একই address-এ redirect হয়। /api-এর সামনে থাকা Host/Origin fence কেবল loopback, listener-এর নিজস্ব bind address এবং --trusted-host-এ উল্লেখ করা authority গ্রহণ করে। এটি সত্যিকারের credential। তবে প্রকল্পের নিজস্ব documentation-এ সতর্ক করা হয়েছে যে দেখানো URL একটি credential, তাই এটি শুধু নির্দিষ্ট intended user-দের সঙ্গে শেয়ার করা উচিত। Plain HTTP ব্যবহার করলে URL-টি encryption ছাড়াই পাঠানো হয়। 0.2.1-alpha.2 থেকে web app একটি নির্দিষ্ট local address-এ bind করে --tls-cert এবং --tls-key ব্যবহার করে নিজেই HTTPS পরিবেশন করতে পারে। এতে plaintext-এর সমস্যা সমাধান হয়, exposure-এর সমস্যা নয়। এটি উন্মুক্ত port অপব্যবহার করা কঠিন করে। কিন্তু port-টি প্রকাশ্যে উন্মুক্ত করার মতো নিরাপদ করে না।
এখন ওই port-এর পেছনে কী চলছে তা বিবেচনা করুন। Agent workspace-এর file সম্পাদনা করে এবং shell command চালায়। আপনার provider credential-ও তার পাশের disk-এ থাকে। তাই নির্দিষ্ট release-এ উন্মুক্ত port 3080 হলো chat interface-সহ একটি remote shell। এটি সেই user হিসেবে চলছে, যে user এটি চালু করেছে, এবং তার সঙ্গে আপনার API key যুক্ত আছে। এর জন্য কারও exploit দরকার নেই। তার শুধু port number জানা দরকার। Launch token-যুক্ত release-এ token-ও দরকার হবে। তবে আপনার terminal, service log বা unencrypted traffic পড়তে পারে এমন যে কেউ ইতিমধ্যে সেই token পেয়ে যাবে।
CLI (command line interface)-ও একই অবস্থান সমর্থন করে। 0.1.0-rc.6 থেকে এটি ইচ্ছাকৃতভাবে --host 0.0.0.0 সমর্থন করে না এবং চালু হওয়ার পরিবর্তে usage error দিয়ে বন্ধ হয়। নতুন 0.2.2-alpha.2-ও startup-এর সময় এটি প্রত্যাখ্যান করে। এই প্রত্যাখ্যান একটি security feature। তাই এটি সরিয়ে দেওয়ার patch খুঁজবেন না।
Tunnel আপনার জন্য উপযুক্ত না হলে আরও দুটি deployment পদ্ধতি যুক্তিসঙ্গত। Box-টিকে একটি private overlay network-এ রাখুন, যাতে এটি এমন একটি address ব্যবহার করে যেটিতে কেবল আপনার নিজস্ব device-গুলো route করতে পারে। একটি self-hosted Headscale control server এটাই দেয়। অথবা একটি reverse proxy সামনে রাখুন, যা request-টি port 3080-এ পৌঁছানোর আগে authentication সম্পন্ন করে। উদাহরণ হিসেবে একটি Authentik single sign-on server forward auth পরিচালনা করতে পারে। সামনে থাকা reverse proxy-তে authentication না থাকলে সেটি security control নয়। এটি শুধু একটি দীর্ঘ URL।
SSH tunnel-এর মাধ্যমে web UI-তে প্রবেশ
এটি আপনার সার্ভারে নয়, বরং আপনার ল্যাপটপে চালান।
ssh -N -L 3080:127.0.0.1:3080 you@your-server-L আপনার ল্যাপটপে 3080 পোর্টটি খোলে এবং এর সাথে সংযুক্ত যেকোনো কিছুকে এনক্রিপ্ট করা SSH সেশনের মাধ্যমে ফরোয়ার্ড করে। 127.0.0.1:3080 অংশটি সার্ভারে রিজলভ হয়, তাই সংযোগটি লুপব্যাক থেকে হার্নেসে (harness) পৌঁছায়, ঠিক যেন আপনি সরাসরি সেই মেশিনের সামনে বসে আছেন। -N নির্দেশ দেয় যেন কোনো রিমোট শেল চালু না হয়, কারণ আপনার শুধুমাত্র ফরোয়ার্ডিং প্রয়োজন।
এরপর আপনার লোকাল ব্রাউজারে http://127.0.0.1:3080 খুলুন। লঞ্চ টোকেনসহ কোনো রিলিজের ক্ষেত্রে, সার্ভার যে সম্পূর্ণ startup URL প্রিন্ট করেছে সেটি ব্যবহার করুন (টোকেনসহ); SSH-এর মাধ্যমে হার্নেস চালু করলে এটি startup লাইন প্রিন্ট করলেও আপনার জন্য ব্রাউজার খোলার চেষ্টা করে না। যদি আপনার ল্যাপটপে 3080 পোর্টটি আগে থেকেই ব্যবহৃত থাকে, তবে বাম দিকের সংখ্যাটি পরিবর্তন করুন: ssh -N -L 3180:127.0.0.1:3080 you@your-server, এবং এরপর http://127.0.0.1:3180-এ ব্রাউজ করুন, একইভাবে টোকেনযুক্ত URL-এর পোর্টটিও পরিবর্তন করুন। বাম দিকের সংখ্যাটি লোকাল এবং ডান দিকের সংখ্যাটি সার্ভারের, তাই শুধুমাত্র বাম দিকের সংখ্যাটিই পরিবর্তনযোগ্য।
এটি ~/.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 টানেলটি চালু করবে। ব্রাউজারে যদি "connection was refused" মেসেজ দেখায়, তবে সাধারণত এর অর্থ হলো টানেলটি চালু আছে কিন্তু অপর প্রান্তে কোনো কিছু লিসেনিং মোডে নেই, কারণ হার্নেস চলুক বা না চলুক SSH পোর্টটি ফরোয়ার্ড করে। উপরের ss কমান্ডটি ব্যবহার করে সার্ভারটি পরীক্ষা করুন।
লগ আউট করার পরও harness চালু রাখুন
একটি npx command আপনার shell-এর সঙ্গে বন্ধ হয়ে যায়। একটি systemd user service চালু থাকে এবং crash বা reboot-এর পর harness আবার চালু করে। এখানে দেওয়া unit-টি ইচ্ছাকৃতভাবে ন্যূনতম রাখা হয়েছে। harness-কে নিজস্ব সীমাবদ্ধ account-এর অধীনে চালাতে চাইলে, unit-এর ভেতরে version নির্দিষ্ট করে দিতে চাইলে এবং বাস্তবে অনুসন্ধানযোগ্য log চাইলে, dsh-এর জন্য headless systemd setup-এ সম্পূর্ণ পদ্ধতি দেওয়া আছে।
loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dshenable-linger গুরুত্বপূর্ণ, কারণ user service সাধারণত আপনার শেষ 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.targetWorkingDirectory শুধু আনুষ্ঠানিক বিষয় নয়। dsh process তার invoking directory-কে default filesystem location হিসেবে ব্যবহার করে। তাই service ভুল জায়গা থেকে চালু হলে agent-কে ভুল folder-এ নির্দেশ করে। তবে ওই directory-টি শুধু default। একটি নতুন Web UI-তে Choose workspace-এর অধীনে workspace যোগ না করা পর্যন্ত কোনো workspace নির্বাচিত থাকে না। প্রকল্পের guide-এ আপনাকে যে directory থেকে dsh চালু করেছেন, সেটি যোগ করতে বলা হয়েছে। guide-এ কোনো version marker নেই। একই wording ইতিমধ্যে 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 চালু রাখা যায়। ব্যর্থতার ধরনও একই।
একটি plugin কী করতে পারে
একটি plugin হলো এমন একটি module, যা shared context-এ service, typed event এবং reversible effect যোগ করে। যে extension point-গুলো মনোযোগ দিয়ে পড়া দরকার, সেগুলো হলো:
ctx.llm-এ model provider register করাctx.tools-এ model-facing tool যোগ করাctx.shell-এর পেছনে shell backend সরবরাহ করাctx.fs-এর পেছনে filesystem access বা policy সরবরাহ করাctx.commands-এ human command register করাctx.jobs-এর মাধ্যমে background work চালানোctx.sandboxbackend ব্যবহার করে spawned process wrap করাagent/*এবংtools/*event-এর মাধ্যমে request ও tool call intercept করা- durable session state বাড়ানো
ctx.agents-এর মাধ্যমে UI নিয়ন্ত্রণ করা
এই তালিকাটি একজন attacker যেভাবে পড়বে, সেভাবে পড়ুন। একটি plugin filesystem layer এবং shell layer সরবরাহ করতে পারে। এটি model-এর করা প্রতিটি tool call-এর মাঝখানেও অবস্থান করতে পারে। plugin এবং এই extension point-গুলোর মধ্যে কোনো permission dialog থাকে না, কারণ plugin হলো সাধারণ Node code, যা অন্য সবকিছুর মতো একই process-এ load হয়। একটি plugin install করার অর্থ হলো আপনার agent-এর permission নিয়ে কোনো অপরিচিত ব্যক্তির code চালানো। আর আপনার agent-এর permission হলো আপনার Unix user-এর permission।
এটি একই trust decision, যা আপনি VPS-এ কোনো agent-এর সঙ্গে MCP server সংযুক্ত করার সময় নেন, যেখানে MCP হলো model context protocol। এই কারণেই VPS-এ নিরাপদে coding agent চালানো শুরু হয় agent কোন account-এর অধীনে চলছে তা দিয়ে, model দিয়ে নয়। একই কারণে npm supply chain attack server-এ এত গুরুতর প্রভাব ফেলে: install step-ই compromise, এবং কোনো prompt দেখানো হয় না।
Plugin কোথা থেকে আসে
Plugin profile-এ থাকে। Profile হলো $DSH_HOME-এর অধীনে সংরক্ষিত একটি নামযুক্ত composition। এর default মান ~/.dsh। প্রতিটি profile directory-তে সেটি install করা out-of-tree plugin থাকে। CLI আপনার argument সরাসরি pnpm-এ পাঠিয়ে সেগুলো পরিচালনা করে। এ ক্ষেত্রে profile directory-টি working directory হিসেবে ব্যবহৃত হয়।
dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-uiArgument অপরিবর্তিতভাবে pnpm-এ পৌঁছায়। তাই add, remove, update এবং why যেকোনো pnpm project-এর মতোই কাজ করে। একটি plugin npm package বা GitHub reference হতে পারে। pnpm-কে আগে PATH-এ থাকতে হবে। Node 24-এ corepack enable pnpm এটি PATH-এ যোগ করে। Node 25 থেকে Corepack বিতরণ করা বন্ধ হয়েছে। তাই Node 25 এবং পরবর্তী সংস্করণে এর বদলে npm install -g pnpm দিয়ে এটি install করুন।
Discovery একটি GitHub topic-এর মাধ্যমে কাজ করে। Plugin author-রা তাদের repository-তে dsh-plugin topic যোগ করেন। বিদ্যমান plugin খুঁজতে ওই topic browse করতে হয়। Topic হলো author নিজের repository-তে প্রয়োগ করা একটি label। কেউ এটি review করে না এবং কেউ এতে স্বাক্ষরও করে না। Topic page stars-এর ভিত্তিতে ranking করে। Stars popularity মাপে, নিরাপত্তা নয়।
বর্তমান release-গুলোতে experimental Custom plugin indexes bundle-ও আছে। Plugins-এর অধীনে এটি চালু করলে Discover tab-এ একটি index যোগ করার অপশন পাবেন। Index হলো আপনার দেওয়া URL থেকে fetch করা একটি JSON file। Harness নিজস্ব কোনো index দেয় না। এটি file-এর format যাচাই করে, কিন্তু কোনো market যে title, author বা source-এর দাবি করে সেগুলো যাচাই করে না। Plain http:-এর মাধ্যমে পরিবেশিত index network path-এ থাকা যে কেউ পরিবর্তন করতে পারে। Market হলো অন্য কারও লেখা catalogue, review নয়।
চারটি অভ্যাসে এটি নিয়ন্ত্রণে রাখা যায়। Install করার আগে source পড়ুন। অধিকাংশ plugin এত ছোট যে দশ মিনিটে পড়া যায়। Branch track করার বদলে নির্দিষ্ট version বা commit pin করুন। এমন user-এর অধীনে harness চালান, যার মালিকানায় অন্য কোনো resource নেই। এটি এমন একটি VPS-এ চালান, যেটি প্রয়োজনে পুনর্নির্মাণ করতে আপনি প্রস্তুত। Agent-কে নিজস্ব spending limit-সহ আলাদা API key দিন। Production service-গুলো যে key ব্যবহার করে, তার থেকে এটি আলাদা রাখুন। Plugin পড়তে বসে কোন file-গুলো ঝুঁকি বহন করে জানতে চাইলে, একটি dsh plugin যাচাই করার walkthrough-এ manifest, entry point এবং plugin যে extension point register করে সেগুলো ব্যাখ্যা করা হয়েছে।
Commit করার আগে design তুলনা করতে চাইলে, Omnigent multi-agent harness ভিন্ন কাঠামো দিয়ে একই সমস্যার সমাধান করে। Plugin ব্যবহারে এদের trade-off স্পষ্ট হয়। শেষ পর্যন্ত winner বেছে নেওয়ার বদলে একই box-এ দুই বা তিনটি plugin রাখলে, সব harness-কে একটি self-hosted API-এর পেছনে রাখা প্রতি port-এর জন্য আলাদা tunnel তৈরির প্রয়োজন কমায়। তবে এর বিনিময়ে আরও একটি service loopback-এ bind করতে হবে এবং প্রথম দিনেই সেটিতে একটি প্রকৃত password দিতে হবে।
প্রথমে কী নষ্ট হয়
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 release-গুলোতে Node 22.19 গ্রহণযোগ্য বলা হয়েছিল, কিন্তু প্রকল্পটি এখন আর ওই সংস্করণের বিরুদ্ধে build হয় না। পুরোনো runtime startup-এ ব্যর্থ হয়, কারণ code এমন syntax ও API ব্যবহার করে যা ওই সংস্করণে নেই। অন্য কিছু করার আগে node --version চালান।
Port 3080 ইতিমধ্যে ব্যবহৃত হচ্ছে। এটি দ্বিতীয় কোনো harness, আগের কোনো stale process অথবা 3080 ব্যবহারকারী অন্য কোনো application হতে পারে। ss -tlnp | grep 3080 দিয়ে সেটি খুঁজে বের করুন। এরপর process-টি বন্ধ করুন অথবা dsh web --port 3180 দিয়ে harness-টি অন্য port-এ চালু করুন। --port web app-এর জন্য ব্যবহৃত হয়, তাই এটি web-এর পরে দিন।
Browser tunnel-এর মাধ্যমে সংযোগ করতে পারছে না। নিশ্চিত করুন যে আপনি 127.0.0.1-এ browse করেছেন, server-এর public address-এ নয়। Forwarded port-টি শুধু আপনার laptop-এ থাকে। এরপর নিশ্চিত করুন যে server-এ harness listening করছে, কারণ দূরের প্রান্তে কোনো process উত্তর দিচ্ছে না হলেও SSH forward তৈরি করে।
dsh plugin সঙ্গে সঙ্গে ব্যর্থ হয়। এই command-টি pnpm-এর একটি wrapper। তাই pnpm binary না থাকলে কোনো plugin-এর কাজ শুরু হওয়ার আগেই command-টি থেমে যায়। Node 25 এবং পরের সংস্করণে এটি default অবস্থা, কারণ Corepack আর Node-এর সঙ্গে ship করে না।
Agent আপনার project দেখতে পাচ্ছে না। নতুন Web UI-তে কোনো workspace যোগ না করা পর্যন্ত 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-এ প্রকাশ করা কি নিরাপদ?
না। নির্দিষ্ট করা 0.1.0-rc.6-এ web server-এর নিজস্ব login নেই। এর পেছনের agent প্রক্রিয়াটি যে user দিয়ে চালু করা হয়েছে, সেই user হিসেবেই file সম্পাদনা করে এবং shell command চালায়। আপনার 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-কে encryption ছাড়াই পাঠায়। তাই পরামর্শের কোনো পরিবর্তন হয় না। Listener-কে 127.0.0.1-এ রাখুন এবং SSH tunnel-এর মাধ্যমে এতে সংযোগ করুন। একটি private overlay network ব্যবহার করেও কাজ হবে। প্রতিটি request port-এ পৌঁছানোর আগে authentication করে এমন reverse proxy-ও ব্যবহার করা যায়। Version 0.1.0-rc.6 থেকে CLI --host 0.0.0.0 প্রত্যাখ্যান করে এবং usage error দিয়ে বন্ধ হয়। 0.2.2-alpha.2-ও এটি প্রত্যাখ্যান করে। এতে বোঝা যায়, নির্মাতারা এই পদ্ধতি সম্পর্কে কী মনে করেন।
আমার কি 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 গ্রহণ করে। Key-গুলো $DSH_HOME/.credentials.yaml-এ সংরক্ষিত হয়, যার default মান ~/.dsh/.credentials.yaml।
DeepSeek Harness plugin install করলে plugin-টি আসলে কী সুবিধা পায়?
Harness চালানো account-এর permissions। Plugin হলো একই process-এ load হওয়া Node code। এর extension point-এর মধ্যে shell backend, filesystem layer, tool registry এবং প্রতিটি tool call-কে ঘিরে থাকা events অন্তর্ভুক্ত। কোনো plugin নিজে sandbox সরবরাহ না করলে এই interface-গুলো থেকে plugin-কে আলাদা রাখার কোনো sandbox নেই। Install করার আগে source পড়ুন। Harness এমন user হিসেবে চালান, যার কাছে আপনার গুরুত্বপূর্ণ কোনো resource-এর ownership নেই।
কোন version install করা উচিত, এবং এটি কি কাজ চালিয়ে যাবে?
একটি নির্দিষ্ট version install করুন, যেমন npx @deepseek-ai/dsh@0.1.0-rc.6 web। এখানে August 2026-এর এই version-টি নির্দিষ্ট করা হয়েছে। 12 November 2026-এ npm-এর latest tag 0.2.2-rc.1-এর দিকে নির্দেশ করে। GitHub-এ 11 November-এ প্রকাশিত নতুন prerelease 0.2.2-rc.2 তালিকাভুক্ত আছে। বর্তমান CLI-এর জন্য Node 24.9 বা তার পরের version প্রয়োজন। Project নিজেকে developer preview হিসেবে চিহ্নিত করে এবং বলে যে compatibility ভেঙে দিতে পারে এমন পরিবর্তন প্রত্যাশিত। তাই version নির্দিষ্ট না করা command এক দিন থেকে পরের দিনে ভিন্ন আচরণ করতে পারে। Upgrade করার আগে repository পরীক্ষা করুন। Version এখনও 0 দিয়ে শুরু হওয়ার সময় config key এবং plugin interface পরিবর্তিত হতে পারে—এটি ধরে নিন।