SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-10-30

VPS-এ systemd ব্যবহার করে dsh headless হিসেবে চালানোর নিয়ম

VPS-এ dsh সার্ভিস হিসেবে চালাতে systemd unit file তৈরির নিয়ম জানুন। ডেডিকেটেড ইউজার, Restart রুলস এবং journalctl লগ ব্যবহার করে কীভাবে এটি স্থায়ীভাবে চালু রাখবেন তা দেখুন।

একটি VPS-এ টার্মিনাল ছাড়াই dsh headless হিসেবে চালানো

একটি VPS-এ dsh headless হিসেবে চালানোর জন্য একটি systemd unit file এবং এটি পরিচালনার জন্য একটি ডেডিকেটেড user প্রয়োজন। dsh হলো DeepSeek Harness-এর কমান্ড লাইন লঞ্চার, যা DeepSeek-এর এজেন্ট রানটাইম। এটি 2026 সালের আগস্ট মাসে ডেভেলপার প্রিভিউ হিসেবে MIT লাইসেন্সের অধীনে প্রকাশিত হয়েছে। হারনেস (harness) হলো মডেলের চারপাশের প্রোগ্রাম, মডেলটি নিজে নয়। তাই আপনি systemd-এর অধীনে যা রাখছেন তা হলো লুপ, টুলস এবং পারমিশন, DeepSeek-এর ইনফারেন্স নয়। কুইকস্টার্ট গাইড আপনাকে npx @deepseek-ai/dsh web টাইপ করতে বলে, যা সঠিক, কিন্তু আপনার SSH (secure shell) সেশন বন্ধ করার সাথে সাথেই এটি বন্ধ হয়ে যায়।

একটি unit file একই সাথে চারটি সমস্যার সমাধান করে। রিবুট করার পর সার্ভিসটি নিজে থেকেই চালু হয়। এর আউটপুট স্ক্রিনে ভেসে না গিয়ে journal-এ জমা হয়। এটি root নয় এমন একটি অ্যাকাউন্টে চলে। এবং এটি আপনার বেছে নেওয়া ভার্সনেই চলে, যা এখানে সাধারণের চেয়ে বেশি গুরুত্বপূর্ণ, কারণ আপস্ট্রিম থেকে বড় হাতের অক্ষরে বলা হয়েছে:

DeepSeek Harness বর্তমানে ডেভেলপার প্রিভিউ পর্যায়ে আছে এবং দ্রুত পরিবর্তিত হচ্ছে। এখানে কম্প্যাটিবিলিটি নষ্ট করতে পারে এমন পরিবর্তন আসবে।

এই গাইডটি ধরে নিচ্ছে যে dsh আপনার হাতে আগে থেকেই কাজ করছে। যদি তা না হয়, তবে প্রথমে একটি VPS-এ DeepSeek Harness ইনস্টল করা সম্পন্ন করুন এবং যখন npx @deepseek-ai/dsh web একটি পেজ সার্ভ করবে, তখন ফিরে আসুন।

প্রথমে Node ইনস্টল করুন, কারণ npm আপনাকে সতর্ক করবে না

node -v

Ubuntu 24.04-এর নিজস্ব প্যাকেজে Node 18 (আগস্ট 2026 অনুযায়ী 18.19.1) রয়েছে, যা এই বছর প্রকাশিত কোনো প্যাকেজের জন্য বেশ পুরনো। npm নিজে Node-এর সংস্করণ পরীক্ষা করে: এর ডকুমেন্টেশন অনুযায়ী, একটি প্যাকেজের engines ফিল্ড "শুধুমাত্র সতর্কবার্তা প্রদান করবে" যদি না আপনি engine-strict সক্রিয় করেন। সমস্যা হলো, প্রকাশিত @deepseek-ai/dsh ম্যানিফেস্টগুলোতে কোনো engines ফিল্ড থাকে না (27 অক্টোবর 2026 তারিখে 0.1.0-rc.7, 0.2.1-rc.2 এবং 0.2.1-rc.4-এর জন্য যাচাইকৃত), যদিও রিপোজিটরিতে এটি ঘোষণা করা থাকে। ফলে npm-এর কাছে আপনার Node-এর সাথে তুলনা করার মতো কিছু থাকে না এবং এটি কোনো EBADENGINE সতর্কবার্তা দেখায় না। এর পরিবর্তে রানটাইমে সিনট্যাক্স এরর বা কোনো বিল্ট-ইন ফাংশন অনুপস্থিত থাকার মতো ত্রুটি দেখা দেয়, যা শনাক্ত করা অনেক বেশি কঠিন।

রিপোজিটরির ন্যূনতম প্রয়োজনীয়তাও পরিবর্তিত হয়েছে। 0.2.1-rc.2 সোর্স ^22.19.0 || >=24.0.0 গ্রহণ করে, কিন্তু মাস্টার ব্রাঞ্চের CLI প্যাকেজ এখন >=24.9.0 ঘোষণা করে, যা Node 22 পূরণ করতে পারে না। NodeSource থেকে Node 24 ইনস্টল করুন। এটি একটি লং টার্ম সাপোর্ট (LTS) সংস্করণ, যা 20 অক্টোবর 2026 থেকে রক্ষণাবেক্ষণ পর্যায়ে রয়েছে এবং এর বর্তমান বিল্ডগুলো উভয় রেঞ্জই পূরণ করে। Node 26 আগামী 28 অক্টোবর 2026 তারিখে LTS হিসেবে গণ্য হবে।

curl -fsSL https://deb.nodesource.com/setup_24.x -o /tmp/nodesource_setup.sh
less /tmp/nodesource_setup.sh
sudo -E bash /tmp/nodesource_setup.sh
sudo apt install -y nodejs
node -v

node -v এখন একটি v24 সংস্করণ প্রদর্শন করবে, যা 24.9.0 বা তার নতুন। less লাইনটি এখানে রাখা হয়েছে কারণ সরাসরি রিমোট স্ক্রিপ্ট পাইপ করে bash-এ রান করা মানে এমন কোড চালানো যা আপনি আগে পড়েননি।

ইউনিট ফাইল লেখার আগে নিশ্চিত করুন যে এটি চলছে

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

সেটিকে চলতে দিন। দ্বিতীয় একটি SSH সেশন থেকে চালান:

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/

যেকোনো HTTP স্ট্যাটাস কোড আসার মানে হলো ওয়েব প্রোফাইলটি লুপব্যাকে লিসেন করছে, যা ডিফল্টভাবে সেখানেই বাইন্ড হয়। একটি 401 আশা করুন এবং এটিকে সফল হিসেবে গণ্য করুন: UI ব্রাউজারকে প্রিন্ট করা URL-এ থাকা একটি লঞ্চ টোকেন দিয়ে অথেন্টিকেট করে, যা পরে একটি সাইন করা সেশন কুকির বিনিময়ে ব্যবহৃত হয়। যে অনুরোধে এর কোনোটিই থাকে না, সেটি 401 এরর পায়। 000 এর সাথে curl: (7) Failed to connect to 127.0.0.1 port 3080 আসার মানে হলো এটি লিসেন করছে না, এবং প্রথম টার্মিনালে এর কারণ লেখা আছে। পরবর্তী ধাপে যাওয়ার আগে Ctrl+C চেপে ম্যানুয়াল রান বন্ধ করুন: এমন কোনো ইউনিট যা ইতিমধ্যে ব্যবহৃত কোনো পোর্টে বাইন্ড করার চেষ্টা করে, তা Error: listen EADDRINUSE: address already in use 127.0.0.1:3080 এরর দিয়ে ব্যর্থ হয়।

0.1.0-rc.7 ছিল 18 আগস্ট 2026 তারিখে প্রকাশিত সংস্করণ, এবং এটি এই গাইডে ব্যবহৃত ব্রাউজার অথেন্টিকেশনের আগের সংস্করণ: এর ওয়েব README অনুযায়ী তখন সুরক্ষা ছিল শুধুমাত্র একটি Host চেক এবং "ওয়েব ক্যারিয়ার কোনো অথেন্টিকেশন লেয়ার প্রদান করে না"। 11 অক্টোবর 2026 তারিখে latest ট্যাগটি 0.2.0-rc.2 কে নির্দেশ করছিল। 27 অক্টোবর 2026 তারিখে latest নির্দেশ করছিল 0.2.1-rc.2 কে এবং next নির্দেশ করছিল 0.2.1-rc.4 কে, তাই এখানে কমান্ডগুলো 0.2.1-rc.2 কে পিন করে রাখা হয়েছে। npm view @deepseek-ai/dsh version ব্যবহার করে বর্তমান সংস্করণ যাচাই করুন, তারপর আপনি যা চালাতে চান তা পিন করুন।

আপনার পিন করা সংস্করণটি গ্লোবালি ইনস্টল করুন

ইউনিট ফাইলের ভেতরে npx ব্যবহার করা ভুল। এটি প্রসেস শুরু হওয়ার সময় প্যাকেজের সংস্করণ নির্ধারণ করে, তাই তিন মাস পরে রিস্টার্ট দিলে আপনার কোনো পরিবর্তন ছাড়াই প্রিভিউ-স্টেজ এজেন্টের একটি ভিন্ন বিল্ড চালু হতে পারে। বুট করার সময় npm registry-এর সাথে সংযোগ থাকাটাও জরুরি, যার ফলে registry ধীরগতির হলে একটি সচল মেশিনও ব্যর্থ ইউনিটে পরিণত হতে পারে। একবার ইনস্টল করুন, আপনার লিখে রাখা নির্দিষ্ট সংস্করণে:

sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
command -v dsh
npm ls -g --depth=0 @deepseek-ai/dsh

command -v dsh কমান্ডটি /usr/bin/dsh প্রিন্ট করে যদি npm NodeSource থেকে আসে, এবং /usr/local/bin/dsh প্রিন্ট করে যদি এটি Ubuntu-এর নিজস্ব প্যাকেজ থেকে আসে। ইউনিট ফাইলে যে পাথটি প্রিন্ট হয়েছে সেটি ব্যবহার করুন। npm ls -g সঠিক সংস্করণটি প্রিন্ট করে, যা ছয় সপ্তাহ পর আপনার কাজে আসবে যখন আচরণের পরিবর্তন ঘটবে এবং আপনি মনে করতে পারবেন না যে আপনি কী ইনস্টল করেছিলেন। যদি ইনস্টলেশন ব্যর্থ হয়, অথবা command -v dsh পরে কিছুই প্রিন্ট না করে, অথবা আপনি যে সংস্করণটি চেয়েছেন সেটি না পান, তবে ইউনিট ফাইল লেখার আগে সাধারণ dsh ইনস্টল এবং সংস্করণ সংক্রান্ত ব্যর্থতা সমাধান করুন।

যে ব্যবহারকারী শুধু service-টির মালিক হবে

Agent shell command চালায়। এটাই তার কাজ। এটিকে root হিসেবে চালালে প্রতিটি tool call root-এর অধিকার নিয়ে চলে। তাই এর জন্য আলাদা account তৈরি করুন এবং সেই account-এ কোনো login shell রাখবেন না।

sudo useradd --system --create-home --home-dir /var/lib/dsh --shell /usr/sbin/nologin dsh
sudo install -d -o dsh -g dsh -m 750 /var/lib/dsh/harness /var/lib/dsh/workspace
id dsh

/var/lib/dsh/harness হয়ে যায় DSH_HOME, যে directory-তে dsh profile সংরক্ষণ করে। Profile হলো আপনার নিজস্ব patch layer-সহ plugin bundle-এর একটি নামযুক্ত stack। web এবং headless profile প্রথমবার চালু হলে shipped template থেকে নিজেদের তৈরি করে। পরে আপনি ওই stack-এ যা যোগ করবেন, তা এই user হিসেবে agent-এর নিজস্ব file ও shell access নিয়ে চলবে। তাই install করার আগে plugin যাচাই করা account তৈরির কাজেরই অংশ। প্রথম boot-এ file লেখা হতে পারে এবং bundle fetch করা হতে পারে। তাই সম্ভব হলে এটি নিজে হাতে চালান, যাতে আপনি প্রক্রিয়াটি পর্যবেক্ষণ করতে পারেন।

sudo -u dsh env HOME=/var/lib/dsh DSH_HOME=/var/lib/dsh/harness /usr/bin/dsh --profile web

HOME স্পষ্টভাবে সেট করুন। sudo এটি কীভাবে পরিচালনা করে তার ওপর নির্ভর করবেন না। কারণ login নয় এমন command-এর জন্য sudo HOME পুনর্লিখবে কি না, তা /etc/sudoers-এর set_home setting-এর ওপর নির্ভর করে। ভুলভাবে সেট করলে প্রথম run-এ cache directory আপনার home directory-তে তৈরি হবে এবং তার মালিক হবে dsh। পরে service নিজের state খুঁজে পাবে না। curl check status code দেখালে Ctrl+C চাপুন।

ইউনিট ফাইল

/etc/systemd/system/dsh.service লিখুন:

[Unit]
Description=DeepSeek Harness (dsh) web profile
Documentation=https://github.com/deepseek-ai/deepseek-harness
After=network-online.target
Wants=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5

[Service]
Type=exec
User=dsh
Group=dsh
WorkingDirectory=/var/lib/dsh/workspace
Environment=HOME=/var/lib/dsh
Environment=DSH_HOME=/var/lib/dsh/harness
ExecStart=/usr/bin/dsh --profile web
Restart=on-failure
RestartSec=5s
TimeoutStopSec=30s
SyslogIdentifier=dsh
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
ProtectHome=true

[Install]
WantedBy=multi-user.target

ExecStart=-এ command -v dsh থেকে পাওয়া অ্যাবসোলিউট পাথ ব্যবহার করুন। systemd একটি নির্দিষ্ট পাথ লিস্টে কমান্ডের নাম খোঁজে, কিন্তু সেই লিস্ট আপনার শেলের PATH নয়, তাই অ্যাবসোলিউট পাথ ব্যবহার করলে কোনো অনিশ্চয়তা থাকে না।

WorkingDirectory= হলো সেই জায়গা যেখানে রিলেটিভ পাথগুলো রেজলভ হয় এবং কোনো টুল যখন কোনো আর্গুমেন্ট ছাড়া ls চালায়, তখন সেটি এখান থেকেই শুরু হয়। এটিকে সেই ওয়ার্কস্পেসের দিকে নির্দেশ করুন যা আপনি এজেন্টকে দিচ্ছেন। যদি ডিরেক্টরিটির অস্তিত্ব না থাকে বা সার্ভিস ইউজার সেখানে প্রবেশ করতে না পারে, তবে dsh চলার আগেই ইউনিটটি status=200/CHDIR এর কারণে ব্যর্থ হবে।

ProtectHome=true প্রসেস থেকে /home এবং /root কে লুকিয়ে রাখে। এটি এখানে নিরাপদ কারণ সার্ভিসটি যা কিছু ব্যবহার করে তার সবই /var/lib/dsh এর অধীনে থাকে। ওয়ার্কস্পেসকে যদি /home এর অধীনে কোনো পাথে নির্দেশ করেন, তবে এজেন্ট রিপোর্ট করবে যে ডিরেক্টরিটি নেই; এই লাইনটি মনে না থাকলে বিষয়টি বিভ্রান্তিকর হতে পারে। ProtectSystem=full এর মাধ্যমে /usr, /boot এবং /etc কে রিড-অনলি করা হয়, কারণ সার্ভিসটির এগুলোতে লেখার কোনো প্রয়োজন নেই।

এর চেয়ে বেশি কিছু করার প্রলোভন হওয়া স্বাভাবিক, কিন্তু সাধারণত তা ভুল হয়। ProtectSystem=strict কার্নেল সিউডো-ফাইলসিস্টেম বাদে পুরো ফাইলসিস্টেমকে রিড-অনলি করে দেয়, ফলে প্রথম যে টুলটি কোনো ফাইল লিখতে যাবে সেটি EROFS: read-only file system এর কারণে ব্যর্থ হবে। যদি আপনি সেই পর্যায়ের নিরাপত্তা চান, তবে একই এডিটে ReadWritePaths=/var/lib/dsh যোগ করুন।

এখানে কোন Type= ব্যবহার করা উচিত

Type=exec, কারণ dsh ফোরগ্রাউন্ডে থাকে এবং কখনোই ফর্ক (fork) করে না। ডিফল্ট অপশনের তুলনায় এটি ব্যবহারের সুবিধা হলো, আপনি সরাসরি সঠিক এরর মেসেজ দেখতে পাবেন। Type=simple ব্যবহার করলে, বাইনারি ফাইলটি আদৌ আছে কি না তা জানার আগেই systemd ফর্ক হওয়ার সাথে সাথে স্টার্ট সফল হয়েছে বলে ধরে নেয়। ফলে systemctl start dsh কোনো সমস্যা ছাড়াই রিটার্ন করে এবং ব্যর্থতার বিষয়টি শুধুমাত্র জার্নালে দেখা যায়। Type=exec ব্যবহার করলে, systemd execve() সফল হওয়ার জন্য অপেক্ষা করে। তাই ExecStart=-এ কোনো টাইপো থাকলে আপনি যে কমান্ডটি টাইপ করেছেন সেটিই ব্যর্থ হবে এবং আপনি তা সরাসরি দেখতে পাবেন।

অন্য দুটি ভুল পদ্ধতিই সিস্টেমকে হ্যাং করে দেয়। Type=forking systemd-কে নির্দেশ দেয় প্যারেন্ট প্রসেসটি শেষ হওয়া পর্যন্ত অপেক্ষা করতে, কিন্তু dsh কখনোই শেষ হয় না। ফলে স্টার্ট প্রসেসটি TimeoutStartSec শেষ হওয়া পর্যন্ত (ডিফল্টভাবে 90 সেকেন্ড) আটকে থাকে এবং তারপর Job for dsh.service failed because a timeout was exceeded. রিপোর্ট করে। Type=notify একটি READY=1 মেসেজের জন্য sd_notify-এর মাধ্যমে অপেক্ষা করে, আর যে Node প্রসেস কখনোই তা পাঠায় না, সেটি একইভাবে আটকে থাকে। systemd সার্ভিস টাইপের পূর্ণাঙ্গ তুলনা বাকি বিষয়গুলো কভার করে, যার মধ্যে notify কনফিগার করার প্রয়োজনীয়তাও অন্তর্ভুক্ত।

যেসব রিস্টার্ট রুল ব্যর্থ হলে সতর্ক করে

Restart=on-failure কোনো নন-জিরো এক্সিট বা ফ্যাটাল সিগন্যালের ক্ষেত্রে রিস্টার্ট করে এবং ক্লিন এক্সিটের পর ইউনিটটিকে আর পরিবর্তন করে না। প্রিভিউ বিল্ডের ক্ষেত্রে আপনি এই আচরণই আশা করবেন। যদি dsh কোনো কনফিগারেশন পছন্দ না হওয়ার কারণে 0 এক্সিট কোড দেয়, তবে ইউনিটটি থেমে যায় এবং বন্ধই থাকে, আর systemctl status dsh তখন inactive (dead) দেখায় যেখানে আপনি বিষয়টি দেখতে পাবেন। Restart=always একই ঘটনাকে একটি রিস্টার্ট লুপে পরিণত করে, যা দূর থেকে দেখলে স্বাভাবিক মনে হয়।

রেট লিমিট হলো সেই অংশ যা মানুষ এড়িয়ে যায়। systemd-এর ডিফল্ট হলো দশ সেকেন্ডের মধ্যে পাঁচটি স্টার্ট, আর RestartSec=5s-এর সাথে আপনি দশ সেকেন্ডের উইন্ডোতে কখনোই পাঁচটি স্টার্টে পৌঁছাতে পারবেন না। ফলে স্টার্টআপে ক্র্যাশ করা একটি ইউনিট চিরকাল রিস্টার্ট হতে থাকে এবং শুধুমাত্র জার্নালেই তা ধরা পড়ে। StartLimitBurst=5 সহ StartLimitIntervalSec=300 ব্যবহারের অর্থ হলো পাঁচ মিনিটে পাঁচটি ব্যর্থতাই যথেষ্ট: systemd হাল ছেড়ে দেয় এবং ইউনিটটিকে failed অবস্থায় পার্ক করে, যেখানে Start request repeated too quickly. লগ হয়। কারণটি ঠিক করার পর sudo systemctl reset-failed dsh দিয়ে সেই স্টেট ক্লিয়ার করুন। উভয় সেটিংই [Unit]-এ থাকা উচিত, [Service]-এ নয়; ভুল সেকশনে থাকলে systemd নীরবে সেগুলোকে উপেক্ষা করে।

এটি চালু করুন, তারপর পরীক্ষা করুন

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

enable --now দুটি কাজ করে। enable reboot-এর পরে service পুনরায় চালু করে, আর --now বর্তমান boot-এ এটি চালু করে। শুধু systemctl start ব্যবহার করলে পরবর্তী reboot-এর পরে সেটি কার্যকর থাকে না, আর kernel update হলে reboot করতেই হয়।

systemctl status dsh-এর আউটপুটে Active: active (running), একটি Main PID এবং একটি Memory: line দেখা উচিত। এরপর এটি কোথায় listening করছে তা নিশ্চিত করুন:

sudo ss -lntp | grep 3080

আপনার 127.0.0.1:3080 দেখা উচিত। অন্য কোনো address দেখা গেলে, একটি --host flag listener-কে সেই address-এর network-এ সরিয়ে দিয়েছে। TLS সেট না থাকলে সেখানে plain HTTP পরিবেশিত হবে। ওই output-এ process-এর নাম node, dsh নয়। কারণ dsh binary একটি Node script, তাই pgrep -x dsh কিছুই খুঁজে পায় না। এর পরিবর্তে systemctl show -p MainPID dsh ব্যবহার করুন।

এরপর একবার reboot করুন। যে service কখনো reboot পার হয়ে চালু থাকেনি, সেটিকে এখনো service বলা যায় না।

sudo reboot

আবার সংযোগ করে systemctl is-active dsh চালান। এটি active প্রদর্শন করবে।

journalctl দিয়ে লগ পড়া

dsh যা কিছু stdout এবং stderr-এ লেখে, তা unit-এর নামে journal-এ জমা হয়।

journalctl -u dsh -f
journalctl -u dsh -n 200 --no-pager
journalctl -u dsh --since "10 min ago" -p err

-f নতুন লাইনগুলো অনুসরণ করে, -n শেষ N সংখ্যক লাইন দেখায়, এবং -p err প্রায়োরিটি অনুযায়ী ফিল্টার করে। unit-এর মধ্যে SyslogIdentifier=dsh থাকার কারণেই লাইনগুলো dsh হিসেবে ট্যাগ করা হয়, node হিসেবে নয়। যখন আপনি unit দিয়ে ফিল্টার করা হয়নি এমন journal আউটপুট প্রথমবার পড়বেন, তখন এটি গুরুত্বপূর্ণ।

আপনার প্রয়োজনে journal যেন reboot-এর পরেও টিকে থাকে তা নিশ্চিত করুন:

journalctl -u dsh -b -1

যদি এটি Specifying boot ID or boot offset has no effect, no persistent journal was found প্রিন্ট করে, তবে journal /run-এ থাকে এবং প্রতিটি reboot-এর পর তা মুছে যায়। ডিরেক্টরিটি তৈরি করুন এবং daemon রিস্টার্ট করুন:

sudo mkdir -p /var/log/journal
sudo systemctl restart systemd-journald

পাবলিক পোর্টের পরিবর্তে SSH টানেলের মাধ্যমে UI অ্যাক্সেস করুন

dsh ডিফল্টভাবে 127.0.0.1:3080-এ ওয়েব UI (user interface) পরিবেশন করে। লুপব্যাক ডিফল্ট হলেও এটিই একমাত্র বিকল্প নয়: --host একটি লোকাল ইন্টারফেসের নির্দিষ্ট IPv4 বা IPv6 অ্যাড্রেস গ্রহণ করে। লুপব্যাক ছাড়া অন্য যেকোনো অ্যাড্রেস plain HTTP-এর মাধ্যমে সংশ্লিষ্ট নেটওয়ার্কে এটি উন্মুক্ত করে দেয়, যা স্টার্টআপের সময় একটি সতর্কবার্তা দেখায়, যদি না আপনি --tls-cert এবং --tls-key ব্যবহার করেন। dsh ওয়াইল্ডকার্ড গ্রহণ করে না। আপনি যদি --host 0.0.0.0 ব্যবহার করার চেষ্টা করেন, তবে ত্রুটিটি এভাবে শুরু হবে:

webserver: host "0.0.0.0" is an unspecified (wildcard) address, which is not supported:

এরপরে বলা হয় যে "প্রতিটি ইন্টারফেস বাইন্ড করলে নেটওয়ার্কে রিমোট কোড এক্সিকিউশন ঝুঁকি তৈরি হতে পারে" এবং আপনাকে "লোকাল ইন্টারফেসের একটি নির্দিষ্ট IPv4 বা IPv6 অ্যাড্রেস বাইন্ড করার" পরামর্শ দেওয়া হয়। যদি কোনো হোস্টনামের মতো মান ব্যবহার করেন যা সরাসরি IP নয়, তবে is not a concrete IPv4 or IPv6 address literal ত্রুটি দেখা দেবে।

ডিফল্ট সেটিংসই বজায় রাখুন। ওয়েব API (application programming interface) এজেন্টকে নিয়ন্ত্রণ করে এবং এজেন্ট শেল কমান্ড চালায়। dsh এই API-এর সামনে প্রমাণীকরণ ব্যবস্থা যুক্ত করেছে: Host এবং Origin চেক, এবং স্টার্টআপে প্রিন্ট হওয়া URL-এ একটি লঞ্চ টোকেন, যা UI একটি সাইন-ইন সেশন কুকির বিনিময়ে গ্রহণ করে। তবে plain HTTP-এর ক্ষেত্রে, এই টোকেন নেটওয়ার্কে প্লেইন টেক্সট হিসেবে আদান-প্রদান হয় এবং আপস্ট্রিমের নিজস্ব ডকুমেন্টেশন অনুযায়ী Host চেক লিসেনিং পোর্টকে সরাসরি সুরক্ষা দেয় না। যদি আপনার UI-কে একটি রিয়েল হোস্টনামে প্রয়োজন হয়, তবে DeepSeek-এর পাবলিক ডিপ্লয়মেন্ট গাইড অনুযায়ী --public-url এবং --trusted-host ব্যবহার করে রিভার্স প্রক্সি অথবা --tls-cert এবং --tls-key ব্যবহার করে নেটিভ TLS সেটআপ করতে পারেন। স্টার্টআপ আউটপুটে থাকা 127.0.0.1:3080 লাইনটি আসলে কী বোঝায় তা পরিবর্তন করার আগে পড়ে নেওয়া জরুরি। যদি সার্ভারটি শুধুমাত্র আপনিই ব্যবহার করেন, তবে আপনার নিজের মেশিন থেকে পোর্টটি ফরওয়ার্ড করুন:

ssh -N -L 3080:127.0.0.1:3080 you@203.0.113.10

-L 3080:127.0.0.1:3080 আপনার ল্যাপটপে পোর্ট 3080 খোলে এবং সেখানে আসা যেকোনো ট্রাফিককে VPS-এ রেজলভ হওয়া 127.0.0.1:3080-এ পাঠিয়ে দেয়। -N মানে কোনো রিমোট কমান্ড চালানো হবে না, তাই সেশনটি শুধুমাত্র টানেলটি চালু রাখবে। এটি চালু রাখুন, journalctl -u dsh -n 100 --no-pager ব্যবহার করে dsh স্টার্টআপে যে URL প্রিন্ট করেছিল তা খুঁজে বের করুন এবং আপনার ব্রাউজারে সেটি খুলুন। সেই URL-এ লঞ্চ টোকেন থাকে। যদি কোনো ব্রাউজার সাইন-ইন না করে সরাসরি http://127.0.0.1:3080/ খোলার চেষ্টা করে, তবে 401 ত্রুটি পাবেন। টোকেনটি চলমান প্রসেসের সাথে যুক্ত, কিন্তু এটি যে সেশন কুকি তৈরি করে তা প্রসেস বন্ধ হওয়ার পরেও কার্যকর থাকে: কুকিটি dsh-এর $DSH_HOME/.credentials.yaml-এ সংরক্ষিত একটি সিক্রেট দিয়ে সাইন করা থাকে এবং ডিফল্টভাবে 30 দিন পর্যন্ত কার্যকর থাকে। তাই একবার সাইন-ইন করা ব্রাউজার রিস্টার্টের পরেও সরাসরি URL খুলতে পারে। নতুন ব্রাউজারের জন্য অথবা কুকি মেয়াদোত্তীর্ণ হলে জার্নাল থেকে নতুন URL প্রয়োজন হবে। URL-টিকে একটি ক্রেডেনশিয়াল হিসেবে গণ্য করুন: আপস্ট্রিম অনুযায়ী এটি শুধুমাত্র অনুমোদিত ব্যবহারকারীদের সাথে শেয়ার করুন, কারণ সিস্টেম জার্নাল পড়তে পারে এমন যেকোনো ব্যক্তি এটি দেখতে পাবে। একবার প্রবেশ করার পর, Settings থেকে Models-এ গিয়ে DeepSeek API কি (key) প্রদান করুন এবং ওয়ার্কস্পেস ডিরেক্টরি নির্বাচন করুন। ওয়ার্কস্পেসটিকে /var/lib/dsh/workspace-এ পয়েন্ট করুন, যা সার্ভিস ইউজারের মালিকানাধীন, অন্যথায় এজেন্টের ফাইল টুলস EACCES: permission denied ত্রুটির কারণে ব্যর্থ হবে।

যদি আপনার ল্যাপটপে পোর্ট 3080 ব্যস্ত থাকে, তবে ssh তা জানিয়ে দেবে:

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

ssh -N -L 3081:127.0.0.1:3080 you@203.0.113.10 ব্যবহার করে অন্য একটি লোকাল পোর্ট বেছে নিন এবং তারপর 3080-কে 3081-এ পরিবর্তন করে প্রিন্ট হওয়া URLটি খুলুন। আপনার নিজের মেশিনে টাইপিং কমাতে ~/.ssh/config ব্যবহার করুন:

Host dsh-vps
  HostName 203.0.113.10
  User you
  LocalForward 3080 127.0.0.1:3080

এর পরে, ssh -N dsh-vps হবে সম্পূর্ণ কমান্ড। এই টানেলটি এখন আপনার এজেন্টের একমাত্র প্রবেশপথ, তাই SSH ডেমোনই এটিকে সুরক্ষিত রাখছে: শুধুমাত্র কি (key) ব্যবহার করুন, পাসওয়ার্ড প্রমাণীকরণ বন্ধ রাখুন এবং আপনার VPS-এ SSH হার্ডেনিং-এর বাকি নির্দেশাবলী সাধারণের চেয়ে বেশি গুরুত্বের সাথে অনুসরণ করুন। যদি সেই VPS একটি ছোট প্রাইভেট নেটওয়ার্কে পরিণত হয়, যার পেছনে ডেটাবেস বা স্টেজিং বক্স থাকে, তবে আপনার tailnet-এ সেই অ্যাড্রেসগুলো সাবনেট রাউটারের মাধ্যমে অ্যাডভার্টাইজ করা প্রতিটি সার্ভিসের জন্য আলাদা ফরওয়ার্ড করার ঝামেলা কমাবে, যদিও dsh-এর লুপব্যাক ডিফল্টের কারণে UI সবসময় টানেলের মাধ্যমেই আসবে।

কি (key) ইউনিট ফাইলে রাখা উচিত নয়। Environment= মানগুলো systemctl show dsh -p Environment দ্বারা প্রিন্ট করা হয়, যা বক্সের যেকোনো ব্যবহারকারী চালাতে পারে। যদি আপনার ইনস্টল করা কোনো প্লাগইনের এনভায়রনমেন্টে কি (key)-এর প্রয়োজন হয়, তবে সেটিকে রুট মালিকানাধীন 600 মোডের /etc/dsh.env ফাইলে রাখুন এবং EnvironmentFile=/etc/dsh.env দিয়ে রেফারেন্স করুন। systemd এক্সিকিউশন সময়ে রুট হিসেবে সেই ফাইলটি পড়ে এবং systemctl show এর বিষয়বস্তু প্রিন্ট করে না। dsh-কে DeepSeek API-এর পরিবর্তে লোকাল Ollama এন্ডপয়েন্টে পয়েন্ট করলে ডিস্কের কোন ফাইলে প্রতিটি সেটিং জমা হয় এবং আপনার বক্স থেকে কী তথ্য বাইরে যায়, তা dsh-এর কি, মডেল এবং এন্ডপয়েন্ট কনফিগারেশন-এর বিষয়।

পরিচালনা ব্যয়

ইনফারেন্স (Inference) আপনার VPS-এ নয়, বরং DeepSeek-এর API-তে সম্পন্ন হয়। আপনার সার্ভারে Node প্রসেস, এর পরিবেশিত UI এবং এজেন্ট যে কমান্ডগুলো চালানোর সিদ্ধান্ত নেয়, তার খরচ বহন করতে হয়। প্রথম দুটি খরচ স্থিতিশীল এবং সামান্য। তৃতীয়টির ক্ষেত্রে এই unit file-এ কোনো সীমাবদ্ধতা নেই।

অন্য কারো দেওয়া তথ্যের ওপর নির্ভর না করে আপনার নিজের সার্ভারে ন্যূনতম খরচ পরিমাপ করুন:

systemctl show dsh -p MemoryCurrent
systemd-cgtop -1 --depth 2

MemoryCurrent বাইট এককে থাকে। এজেন্ট যখন কাজ করছে তখন এটি পর্যবেক্ষণ করুন, অলস অবস্থায় নয়।

টুল কলগুলো (Tool calls) মূল সার্ভিসের চাইল্ড প্রসেস, তাই এগুলো একই কন্ট্রোল গ্রুপে থাকে এবং একই সীমার মধ্যে গণ্য হয়। যে এজেন্ট ওয়ার্কস্পেসের ভেতরে npm install বা কোনো টেস্ট স্যুট চালায়, তা মূল হার্নেসের চেয়ে অনেক বেশি মেমোরি ব্যবহার করতে পারে। 1 GB RAM-এর VPS-এ এখানেই সমস্যা হয়: কার্নেল একটি প্রসেস বেছে নিয়ে সেটিকে বন্ধ (kill) করে দেয় এবং journalctl -k | grep -i "out of memory" কমান্ডটি Out of memory: Killed process লাইনটি দেখায়, যেখানে কার্নেল যে প্রসেসটিকে বেছে নিয়েছে তার নাম থাকে। অনেক সময় সেই প্রসেসটি সমস্যার মূল কারণ হয় না।

এর সমাধান হলো আপনার নিজের নির্ধারণ করা একটি সীমা। [Service] সেকশনে MemoryMax= এবং CPUQuota= ব্যবহার করলে ক্ষতির পরিমাণ ইউনিটটির ভেতরেই সীমাবদ্ধ থাকে, ফলে পুরো সার্ভার হ্যাং হওয়ার বদলে শুধুমাত্র অনিয়ন্ত্রিত বিল্ড প্রসেসটি বন্ধ হয়ে যায়। systemd দিয়ে মেমোরি ও CPU সীমাবদ্ধ করা অংশে সংখ্যা এবং ব্যর্থতার আচরণ সম্পর্কে বিস্তারিত আলোচনা করা হয়েছে। DSH_HOME-এর অধীনে সেশন হিস্ট্রি এবং এজেন্ট ওয়ার্কস্পেসে যা কিছু লেখে তার কারণে ডিস্কের ব্যবহারও বাড়তে থাকে, তাই ডিস্ক পর্যবেক্ষণের জন্য আপনি যা ব্যবহার করেন তাতে du -sh /var/lib/dsh যুক্ত করুন।

আপনি যদি এমন একটি ইন্টারঅ্যাক্টিভ এজেন্ট চান যাতে আপনি যুক্ত হতে এবং বিচ্ছিন্ন হতে পারবেন, তবে সার্ভিস হিসেবে চালানো সঠিক পদ্ধতি নয়; সেক্ষেত্রে একটি পারসিস্টেন্ট tmux সেশনে এজেন্ট চালানো বেশি কার্যকর। যখন আপনি চান যে এজেন্টটি সবসময় চালু থাকুক এবং টানেলের মাধ্যমে অ্যাক্সেসযোগ্য হোক, তখনই কেবল এটিকে সার্ভিস হিসেবে চালান।

ব্যর্থতার ধরন এবং যে বার্তাগুলো আপনি দেখতে পাবেন

status=203/EXEC. systemd ফাইলটি চালাতে পারেনি এবং Failed to locate executable /usr/local/bin/dsh: No such file or directory লগ দেখায়। ExecStart=-এ থাকা পাথটি command -v dsh-এর আউটপুটের সাথে মিলছে না। এটি সেই ব্যর্থতা যা Type=exec গোপন না করে systemctl start সময়ে রিপোর্ট করে।

status=217/USER. systemd User= এবং Group= থেকে ব্যবহারকারীর ক্রেডেনশিয়াল নির্ধারণ বা পরিবর্তন করতে ব্যর্থ হয়েছে, অথবা ইউজার নেমস্পেসিং সেটআপ করতে পারেনি। এই ইউনিটের ক্ষেত্রে সাধারণত এমন একটি অ্যাকাউন্টের কারণে এটি ঘটে যা বিদ্যমান নেই। id dsh দিয়ে এটি নিশ্চিত করুন।

status=200/CHDIR. WorkingDirectory= অনুপস্থিত, অথবা সার্ভিস ব্যবহারকারী সেখানে প্রবেশ করতে পারছে না। sudo -u dsh ls /var/lib/dsh/workspace সরাসরি এটি পুনরুৎপাদন করে।

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080. অন্য কোনো কিছু ইতিমধ্যে পোর্টটি দখল করে রেখেছে, সাধারণত অন্য টার্মিনালে খোলা থাকা npx রান এর কারণ। sudo ss -lntp | grep 3080 প্রসেসটির নাম জানায়।

EACCES: permission denied এবং একটি পাথ। /var/lib/dsh-এর অধীনে মালিকানা (ownership) ভুল, সাধারণত প্রথমবার root হিসেবে বা ভুল HOME দিয়ে চালানোর কারণে এমন হয়। sudo chown -R dsh:dsh /var/lib/dsh এটি ঠিক করে।

Start request repeated too quickly. ইউনিটটি স্টার্ট রেট লিমিটে পৌঁছেছে এবং হাল ছেড়ে দিয়েছে। আসল ত্রুটিটি এর উপরের লাইনগুলোতে থাকে। পুনরায় চেষ্টা করার আগে sudo systemctl reset-failed dsh চালান।

ইউনিটটি active (running) দেখাচ্ছে কিন্তু ব্রাউজারে কিছুই আসছে না। VPS-এ চেকটি চালান: যদি curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3080/ সেখানে একটি স্ট্যাটাস কোড প্রিন্ট করে, তবে লিসেনার VPS-এ সাড়া দিচ্ছে, তাই পরবর্তী ধাপে পোর্ট ফরওয়ার্ড চেক করুন। সেই কোডটি প্রমাণ করে না যে সবকিছু লোড হয়েছে: আপস্ট্রিম অনুযায়ী ঐচ্ছিক প্লাগইন ব্যর্থতা রেডিনেসকে বাধা দেয় না, তাই প্লাগইন ত্রুটির জন্য journalctl -u dsh -n 200 --no-pager পড়ুন। ব্রাউজারে 401 মানে হলো কোনো বৈধ সেশন কুকি নেই এবং URL-এ কোনো বৈধ লঞ্চ টোকেন নেই, হয় আপনি সরাসরি URL খুলেছেন অথবা টোকেনটি সর্বশেষ রিস্টার্টের আগের। বর্তমান প্রসেস যে URL প্রিন্ট করেছে সেটি খুলুন।

ইচ্ছাকৃতভাবে আপগ্রেড করা

Pinning-এর অর্থ হলো আপগ্রেড আপনার নিজের নিয়ন্ত্রণে থাকা একটি কাজ, এটি স্বয়ংক্রিয়ভাবে ঘটে না। আপগ্রেড করার আগে অবশ্যই release notes পড়ুন, কারণ upstream থেকে সামঞ্জস্যতা নষ্টকারী পরিবর্তন (compatibility-breaking changes) সম্পর্কে যে সতর্কবার্তা দেওয়া হয়, তা মূলত এই pin করার কারণেই। প্রথমে state directory-এর ব্যাকআপ নিন, তারপর ভার্সন পরিবর্তন করুন:

sudo systemctl stop dsh
sudo tar czf /root/dsh-home-$(date +%F).tgz -C /var/lib/dsh harness
sudo npm install -g @deepseek-ai/dsh@0.2.1-rc.2
sudo systemctl start dsh
journalctl -u dsh -n 50 --no-pager

পুরানো ভার্সন দিয়ে npm install -g করার প্রক্রিয়াটিও একই, তবে এর সাথে সেই tarball-টি রিস্টোর করতে হবে, যা কেবল তখনই সম্ভব যদি আপনি আগে ব্যাকআপ নিয়ে থাকেন। একটি preview-stage agent runtime হলো ঠিক সেই ধরনের সফটওয়্যার, যেখানে আপগ্রেড করার সময় আপনার অজান্তেই কনফিগারেশন ফরম্যাট নতুন করে লেখা হতে পারে।

FAQ

আমার SSH সেশন বন্ধ করলে dsh কেন বন্ধ হয়ে যায়?

কারণ npx @deepseek-ai/dsh web হলো আপনার লগইন সেশনের অধীনে থাকা একটি foreground প্রসেস, তাই সেশন শেষ হলে এটি বন্ধ হয়ে যায়। একটি systemd unit সরাসরি init সিস্টেমের অধীনে থাকে, যার ফলে আপনি ডিসকানেক্ট করার পরেও এটি চলতে থাকে এবং রিবুটের পরে পুনরায় চালু হয়। sudo systemctl enable --now dsh হলো সেই ধাপগুলোর সমষ্টি যা আপনাকে উভয় সুবিধাই দেয়: রিবুটের জন্য enable এবং বর্তমান বুটের জন্য --now।

dsh-এর জন্য আমার কি Type=simple নাকি Type=exec ব্যবহার করা উচিত?

Type=exec। dsh foreground-এ চলে এবং কখনোই fork করে না, তাই উভয়ই কাজ করবে, তবে Type=exec ব্যবহার করলে systemd নিশ্চিত করে যে execve() সফলভাবে সম্পন্ন হয়েছে, তারপরই এটি স্টার্টকে সফল হিসেবে গণ্য করে। ExecStart=-এ ভুল পাথ থাকলে তা systemctl start-এ ব্যর্থ হয় এবং আপনার সামনে status=203/EXEC দেখায়। Type=simple ব্যবহার করলে একই ভুল সফল হিসেবে গণ্য হয় এবং তা journal-এ লুকিয়ে থাকে। Type=forking এবং Type=notify উভয়ই এখানে ভুল এবং উভয়ই 90 সেকেন্ড পর TimeoutStartSec শেষ না হওয়া পর্যন্ত ঝুলে থাকে।

আমি আমার ল্যাপটপ থেকে কীভাবে dsh ওয়েব UI খুলব?

SSH-এর মাধ্যমে পোর্টটি ফরওয়ার্ড করুন: ssh -N -L 3080:127.0.0.1:3080 you@your-vps, তারপর স্টার্টআপের সময় dsh যে URL-টি প্রিন্ট করেছিল সেটি আপনার ব্রাউজারে খুলুন, যা আপনি journalctl -u dsh ব্যবহার করে খুঁজে পেতে পারেন। সেই URL-এ লঞ্চ টোকেন থাকে, এবং যে ব্রাউজার লগইন করেনি সেটি এটি ছাড়া 401 এরর পাবে। একবার লগইন করলে, সেশন কুকি ডিফল্টভাবে 30 দিন স্থায়ী হয় এবং সার্ভিস রিস্টার্টের পরেও টিকে থাকে। সার্ভিসটিকে এর ডিফল্ট loopback-এ রাখুন। dsh --host 0.0.0.0-এর মতো ওয়াইল্ডকার্ডকে অনির্দিষ্ট অ্যাড্রেস হিসেবে প্রত্যাখ্যান করে, এবং যদিও এটি একটি নির্দিষ্ট লোকাল অ্যাড্রেস গ্রহণ করে, তবে non-loopback bind-এ TLS সেটআপ না করলে তা plain HTTP হিসেবে কাজ করে, যা নেটওয়ার্কের মাধ্যমে শেল কমান্ড চালানো এজেন্টের লঞ্চ টোকেনকে প্লেইন টেক্সটে পাঠিয়ে দেয়।

পারমিশন সহজ রাখার জন্য আমি কি root হিসেবে dsh চালাতে পারি?

না। এই হারনেসটি কমান্ড চালানো এবং ফাইল লেখার জন্য তৈরি, তাই সার্ভিসের যে প্রিভিলেজ থাকে, এজেন্টেরও সেই একই প্রিভিলেজ থাকে। useradd --system --shell /usr/sbin/nologin dsh দিয়ে একটি সিস্টেম অ্যাকাউন্ট তৈরি করুন, /var/lib/dsh-এর মালিকানা সেই অ্যাকাউন্টের অধীনে নিন এবং ইউনিটে NoNewPrivileges=true যোগ করুন। এরপর যদি আপনি EACCES: permission denied এর সম্মুখীন হন, তবে সাধারণত এর কারণ হলো আগে root হিসেবে চালানোর ফলে root-এর মালিকানাধীন ফাইল রয়ে যাওয়া, এবং sudo chown -R dsh:dsh /var/lib/dsh তা পরিষ্কার করে দেয়।

ইউনিটে আমার dsh-এর কোন ভার্সনটি পিন করা উচিত?

সার্ভিস সেটআপ করার সময় npm view @deepseek-ai/dsh version যা রিপোর্ট করে, যা npm install -g @deepseek-ai/dsh@<that version> দিয়ে ইনস্টল করা হয়েছে এবং এমন কোথাও রেকর্ড করা আছে যেখানে আপনি তা খুঁজে পাবেন। 18 আগস্ট 2026-এ 0.1.0-rc.7, 11 অক্টোবর 2026-এ 0.2.0-rc.2 এবং 27 অক্টোবর 2026-এ 0.2.1-rc.2 বর্তমান ছিল, যেখানে next ইতিমধ্যেই 0.2.1-rc.4-এ রয়েছে। 0.1.0-rc.7-এর মতো পুরনো বিল্ডগুলোতে ব্রাউজার অথেন্টিকেশন নেই, তাই ওয়েব প্রোফাইলের জন্য সেগুলো পিন করবেন না। মূল বিষয় সংখ্যাটি নয়, বরং এটি যে ভার্সন ছাড়া npx স্টার্টআপের সময় প্যাকেজটি রিজলভ করে, তাই একটি unattended রিস্টার্ট আপনাকে নীরবে ভিন্ন কনফিগ ফরম্যাটের কোনো বিল্ডে নিয়ে যেতে পারে।

এই লেখাটি কি কাজে লেগেছে?