dsh web: http://127.0.0.1:3080 কেন দেখায়
dsh Web UI শুধু localhost-এ bind হওয়ায় http://127.0.0.1:3080 দেখায়। SSH tunnel দিয়ে নিরাপদে খুলুন, আর 3080 প্রকাশ করা কেন ঝুঁকিপূর্ণ জানুন।
dsh web: http://127.0.0.1:3080 কী বোঝায়
আপনি যখন VPS-এ DeepSeek Harness web profile চালু করেন, তখন এটি এ ধরনের একটি লাইন দেখিয়ে অপেক্ষা করে:
dsh web: http://127.0.0.1:3080/?token=...127.0.0.1 হলো loopback address। কোনো মেশিন নিজের সঙ্গে যোগাযোগ করতে এই address ব্যবহার করে। 127.0.0.1-এ bind করা socket একই মেশিনের process থেকে আসা connection গ্রহণ করে, অন্য কোথাও থেকে নয়। তাই এই লাইনটি একসঙ্গে দুটি বিষয় জানায়: Web UI কোথায় listen করছে এবং কারা এতে পৌঁছাতে পারবে। শুধু যে মেশিনে dsh চলছে, সেই মেশিনই এতে পৌঁছাতে পারবে। শেষে থাকা ?token= অংশটি একটি নতুন random credential, যা process প্রতিবার চালু হওয়ার সময় তৈরি করে। এ বিষয়ে পরে আরও বলা হবে।
এই কারণে URL-টি আপনার laptop-এর browser-এ paste করলে কোনো কাজ হয় না। আপনার laptop-এর 127.0.0.1 আপনার laptop-কেই বোঝায়। Harness যে VPS-এ চলছে, সেটির 127.0.0.1-এ listen করছে। এটি ভিন্ন loopback stack-সহ ভিন্ন একটি মেশিন। কিছু নষ্ট হয়নি। আপনাকে connection-টি অন্য প্রান্তে পৌঁছে দিতে হবে।
Official README-তে default আচরণটি স্পষ্টভাবে বলা আছে: “The command starts the Web UI at http://127.0.0.1:3080 by default and opens it in the default browser for a local launch.” SSH-এর মাধ্যমে চালালে খোলার মতো কোনো browser থাকে না। তাই URL-টি আপনাকে নিজে ব্যবহার করতে হবে। Bind address আসে webserver host plugin, @deepseek-ai/dsh-host-webserver থেকে। এই guide যে 0.2.0-rc.2 release ব্যবহার করে, সেখানে এর host key-টি “Listen host; the two supported values are loopback and all-interfaces” হিসেবে নথিভুক্ত। আপনি পরিবর্তন না করলে loopback-ই ব্যবহৃত হয়। Port সম্পর্কে ধারণা নতুন হলে Linux-এ port কীভাবে কাজ করে অংশে address-plus-port model ব্যাখ্যা করা হয়েছে, যার ওপর এই পুরো ব্যবস্থা নির্ভর করে।
Web UI কেন শুধু localhost-এ bind করে
dsh একটি agent harness, অর্থাৎ model-কে ঘিরে থাকা প্রোগ্রাম: loop, tool call এবং সেই call-গুলো যে permission-এর অধীনে চলে, সবকিছুর মালিক এটি। Browser tab এমন একটি process-এর control surface, যা shell command চালায়, আপনার নির্বাচিত workspace directory থেকে file পড়ে ও লেখে, এবং আপনার model API key ব্যবহার করে। যে কেউ ওই page load করতে পারে, সে dsh চালানো user হিসেবে এসব কাজ করতে পারে। এই access পাওয়ার একমাত্র পথ network নয়: আপনি যে plugin install করেন, সেটিও একই process-এর ভেতরে একই permission নিয়ে চলে। তাই install করার আগে dsh plugin যাচাই করা server কোন address-এ listen করবে তা নির্ধারণের মতোই সতর্কতার সঙ্গে করা উচিত।
তাই port 3080 কোনো read-only dashboard নয়। ওই page load করলে server-এ command execution-এর সুযোগ পাওয়া যায়।
মুদ্রিত URL খুললে সরাসরি session list দেখা যায়। কোনো login screen নেই এবং কোনো user account নেই। Page-টি নিয়ন্ত্রণ করে URL-এর শেষে থাকা token: root page token-টিকে signed session cookie-তে রূপান্তর করে এবং পরিষ্কার address-এ redirect করে। এরপর valid cookie ছাড়া UI যে প্রতিটি RPC call এবং WebSocket stream তৈরি করে, সেগুলো 401 Unauthorized পায়। তবে port-এর সবকিছু gated নয়। Connection plugin-এর documentation অনুযায়ী static asset public থাকে, এবং webserver-এর নিজস্ব server-wide authentication বা origin policy নেই। তাই যে plugin কোনো route-এর মালিক, সেটিই নিজের rule প্রয়োগ করে। Protected route-গুলোতে Host header loopback না হলে বা আপনি স্পষ্টভাবে trusted না করা কোনো host হলে Connection plugin 403-ও দেয়। Loopback-এ এটি প্রকৃত access control-এর পেছনে একটি যুক্তিসঙ্গত দ্বিতীয় স্তর। এখানে operating system শুধু local process-কে প্রবেশের অনুমতি দেয়। তবে এটি port public করার কারণ নয়। Token আপনার terminal scrollback-এ এবং startup output সংরক্ষণ করা যেকোনো log-এ থেকে যায়। Project-এর নিজস্ব reverse proxy guide-এ বলা আছে, এর Host check বা advertised URL কোনোটিই listening port-কে নিজে সুরক্ষিত করে না। Webserver documentation সতর্ক করে যে non-loopback address-এ bind করলে "still exposes unprotected routes and static assets to that network"। এছাড়া 0.2.0-rc.2-এ webserver plugin-এর নিজস্ব TLS নেই। Automated scanner ক্রমাগত uncommon port scan করে। তাই public করা 3080 ইতিমধ্যে আবিষ্কৃত হয়েছে ধরে নিন।
Public VPS-এ firewall-এ port 3080 খুলবেন না এবং webserver-এরhost-কে0.0.0.0বা আপনার public IP-তে সেট করবেন না। এই combination ব্যবহার করলে আপনার server-এ command execution যে কেউ leaked URL পেলে তার নাগালের মধ্যে চলে আসে।
বর্তমান release-গুলো ইতিমধ্যেই আপনাকে এই পদ্ধতির দিকে নিয়ে যায়: web application-এর নিজস্ব --host flag সব interface-এ bind করা প্রত্যাখ্যান করে। তবে 0.2.0-rc.2-এ webserver plugin-এর host config key এখনও 0.0.0.0 গ্রহণ করে। তাই config edit করেও এটি expose করা সম্ভব। Project-এর default branch-এর webserver documentation এবং npm-এর latest tag এখন যে 0.2.1-rc.5 release-এ নির্দেশ করে, সেখানে আরও কঠোর নিয়ম আছে: load করার সময় unspecified address প্রত্যাখ্যান করা হয় এবং একটি optional tls setting যোগ করা হয়েছে। এটি local interface-এর একটি নির্দিষ্ট address এখনও গ্রহণ করে। তাই host-কে আপনার VPS-এর public IP-তে সেট করলেও UI একইভাবে expose হবে।
Server-এ চালানো প্রতিটি agent runtime-এর ক্ষেত্রেও একই যুক্তি প্রযোজ্য। তাই VPS-এ coding agent নিরাপদে চালানো একই নিয়ম থেকে শুরু হয়: agent-এর control port private থাকবে, এবং আপনার trusted কোনো ব্যবস্থা আপনাকে সেখানে পৌঁছে দেবে।
ল্যাপটপ থেকে dsh Web UI কীভাবে খুলব?
এর 3টি নিরাপদ ও বাস্তবসম্মত উপায় আছে। প্রতিটি উপায়েই harness loopback-এ bound থাকে।
- একটি SSH tunnel। Public interface-এ নতুন কোনো listening service চালু হয় না, এবং আপনার কাছে আগে থেকেই credentials আছে। এই পদ্ধতিই ব্যবহার করুন।
- একটি private overlay network। এতে UI শুধু আপনার নিজের device-গুলো থেকে reachable থাকে এবং অন্য সবার কাছ থেকে অদৃশ্য থাকে।
- এমন একটি reverse proxy, যা TLS (transport layer security) termination করে এবং কোনো request forward করার আগে password চায়।
পার্থক্য হলো, কোন উপায়ে আপনার browser loopback-এ পৌঁছায়। কোনো পদ্ধতিতেই harness-কে loopback থেকে সরানো উচিত নয়।
SSH tunnel দিয়ে এতে পৌঁছান
এটি VPS-এ নয়, আপনার laptop-এ চালান:
ssh -N -L 3080:127.0.0.1:3080 you@your-vpsএটি চালু রাখুন। এরপর আপনার local browser-এ ছাপানো সম্পূর্ণ URL dsh খুলুন, যেখানে token http://127.0.0.1:3080/?token=... অন্তর্ভুক্ত আছে। Web UI লোড হয়, token-এর বিনিময়ে একটি session cookie নেয় এবং address bar থেকে token সরিয়ে দেয়। আপনার browser 127.0.0.1:3080-কে Host হিসেবে পাঠায়, যা loopback। তাই অতিরিক্ত configuration ছাড়াই tunnel Host check পাস করে।
-L argument-এ colon দিয়ে আলাদা করা তিনটি field থাকে। প্রথমটি আপনার laptop-এ খোলার port। দ্বিতীয় ও তৃতীয়টি হলো প্রতিটি connection যে address এবং port-এ forward হবে। গুরুত্বপূর্ণ বিষয় হলো, মাঝের field-এর 127.0.0.1 VPS-এর SSH server দ্বারা resolve হয়, আপনার traffic সেখানে পৌঁছানোর পরে। এটি আপনার laptop-এর নয়, VPS-এর loopback বোঝায়। dsh যে address ছাপিয়েছে, সেটিই এটি। তাই direct browser connection কাজ না করলেও tunnel কাজ করে।
-N SSH-কে remote command না চালাতে বলে। ফলে shell নয়, শুধু একটি forwarder পান। নীরবে ব্যর্থ না হয়ে স্পষ্টভাবে ব্যর্থ হবে এমন background tunnel-এর জন্য:
ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps-f authentication-এর পরে tunnel-টিকে background-এ পাঠায়। ExitOnForwardFailure=yes দেখতে যতটা ছোট, তার চেয়ে বেশি গুরুত্বপূর্ণ। এটি না থাকলে forward সেট up না হলেও SSH সফলভাবে connect করে। ফলে session সচল থাকে, কিন্তু tunnel নিষ্ক্রিয় থাকে এবং কোনো সতর্কতা দেখা যায় না। ServerAliveInterval=30 প্রতি 30 সেকেন্ডে keepalive পাঠায়, যাতে café ও hotel router-এর NAT (network address translation) timeout-এর পরও idle tunnel সচল থাকে।
আপনার যা দেখা উচিত
VPS-এ সত্যিই কোন address ও port listen করছে তা নিশ্চিত করুন:
ss -ltnp | grep 3080সুস্থ ফলাফলে loopback address দেখা যায়:
LISTEN 0 511 127.0.0.1:3080 0.0.0.0:* users:(("node",pid=1042,fd=21))local address column-এ এর বদলে 0.0.0.0:3080 থাকলে Web UI সব interface-এ, public interface-সহ, চালু আছে। ওই column-এ VPS-এর public IP থাকলেও একই exposure বোঝায়। এটি বন্ধ করুন এবং অন্য কিছু করার আগে bind ঠিক করুন। ss socket-টি ছাপালেও users: field খালি রাখলে sudo দিয়ে চালান। অন্য user-এর মালিকানাধীন socket-এর process name না হলে সাধারণত গোপন থাকে।
Tunnel চালু হতে না চাইলে
SSH এই বার্তা দেখিয়ে বন্ধ হয়ে যায়:
bind [127.0.0.1]:3080: Address already in use
channel_setup_fwd_listener_tcpip: cannot listen to port: 3080সমস্যাটি আপনার laptop-এ, server-এ নয়। কোনো local process ইতিমধ্যে port 3080 ব্যবহার করছে। প্রায়ই এটি এমন একটি পুরোনো tunnel হয়, যা আপনি বন্ধ করতে ভুলেছেন। তার বদলে একটি খালি local port বেছে নিন:
ssh -N -L 3081:127.0.0.1:3080 you@your-vpsশুধু প্রথম field পরিবর্তিত হয়েছে। তাই একই token ব্যবহার করে এখন http://127.0.0.1:3081/?token=...-এ browse করবেন, আর harness 3080-এ listen করতে থাকবে। দুটি সংখ্যার এক হওয়া জরুরি নয়। Session cookie address bar-এর host ও port-এর সঙ্গে যুক্ত থাকে। তাই নতুন local port-এর জন্য আবার একবার token URL খুলতে হবে।
Tunnel চালু হলেও browser refused connection বা empty reply দেখালে বুঝবেন traffic VPS-এ পৌঁছেছে, কিন্তু দূরের প্রান্তে কিছু পায়নি। হয় dsh বন্ধ হয়ে গেছে, নয়তো অন্য port-এ bind হয়েছে। Server-এ ss -ltnp | grep 3080 দিয়ে পরীক্ষা করুন। Page যদি 401 Unauthorized-এর উত্তর দেয়, tunnel ঠিক আছে। আপনার browser-এ ওই address-এর জন্য বৈধ cookie নেই। Token-সহ ছাপানো URL আবার খুলুন। Restart-এর পরে নতুন output থেকে URL নিন, কারণ প্রতিটি process নতুন token তৈরি করে।
এখানে আরও একটি বিষয় সমস্যা তৈরি করে। Foreground npx @deepseek-ai/dsh web-এর shell বন্ধ হলে এটি বন্ধ হয়ে যায়। ফলে আপনি logout করার সঙ্গে সঙ্গে harness থেমে যায়। এটি tmux-এর ভিতরে অথবা systemd user service-এর অধীনে চালান। একই সমস্যার সমাধান VPS-এ coding agent চালু রাখা অংশে দেখানো হয়েছে। systemd-এর অধীনে token-সহ dsh web: line service log-এ লেখা হয়। তাই সেখান থেকে এটি পড়ুন। SSH অংশে কাজ করার সময় আপনার VPS-এ SSH hardening করা আগে করা উচিত, কারণ tunnel আপনার SSH login-কে agent-এ পৌঁছানোর একমাত্র পথ বানায়।
একটি private overlay network-এর মাধ্যমে এতে পৌঁছান
একটি overlay network আপনার VPS এবং laptop-কে এমন একটি private network-এ address দেয়, যেখানে শুধু আপনার ডিভাইসগুলো যুক্ত থাকে। Tailscale সাধারণ পছন্দ। এর serve command এই ব্যবহারের জন্য উপযুক্ত: tailscaled VPS-এ চলে এবং localhost:3080-এর সঙ্গে নিজেই সংযোগ স্থাপন করে। ফলে harness loopback-এই থাকে।
tailscale serve --bg localhost:3080
tailscale serve statusএরপর আপনার tailnet-এর ভেতরে machine name ব্যবহার করে, HTTPS-এর মাধ্যমে UI-তে পৌঁছানো যায়। public interface-এ কোনো port খোলা রাখতে হয় না। এর জন্য tailnet-এর জন্য HTTPS certificate সক্রিয় থাকতে হবে। তা না হলে serve দেখানোর মতো কোনো certificate পাবে না। এখন browser Host হিসেবে ওই tailnet name পাঠায়। তাই trusted name দিয়ে harness চালু করুন। তা না হলে এর API call-গুলো 403 পাবে। port ছাড়া কোনো entry যেকোনো port-এর সঙ্গে মিলে যায়:
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=... খুলুন এবং printed line থেকে token ব্যবহার করুন। এটি আবার বন্ধ করতে একই command-এর সঙ্গে off ব্যবহার করুন:
tailscale serve --https=443 offserve ব্যবহার করুন, funnel নয়। Funnel একই target public internet-এ প্রকাশ করে। এতে agent runtime একটি open port-এ চলে এবং সামনে থাকে শুধু একটি URL token। দুটি command দেখতে প্রায় একই, কিন্তু কাজ সম্পূর্ণ বিপরীত। তাই যেকোনোটি চালানোর আগে Tailscale Serve এবং Funnel-এর পার্থক্য পড়ুন। সেটআপ সম্পর্কে private network হিসেবে Tailscale দেখুন।
পাসওয়ার্ড যাচাই করে এমন reverse proxy-এর মাধ্যমে এতে প্রবেশ করুন
এটি এমন বিকল্প, যা সত্যিই একটি port Internet-এ প্রকাশ করে। তাই authentication-ই অপরিচিত ব্যক্তি এবং আপনার server-এ command execution-এর মধ্যকার একমাত্র বাধা। একাধিক ব্যক্তির UI ব্যবহার করার প্রয়োজন হলে এবং প্রত্যেকের জন্য আলাদা tunnel ব্যবহার করা বাস্তবসম্মত না হলে এটি বেছে নিন।
harness 127.0.0.1:3080-এ চলতে থাকে। nginx একই machine-এ চলে, তাই এটি loopback-এ পৌঁছাতে পারে। nginx certificate এবং password file ব্যবহার করে 443 port-এ 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;
}
}password file তৈরি করে reload করুন:
sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginxnginx -t-এর output-এ প্রথমে syntax is ok এবং তার পরে test is successful থাকার কথা। ভুল file থাকলে reload ব্যর্থ হয় এবং চলমান configuration অপরিবর্তিত থাকে। তাই না বুঝে restart না করে error পড়ুন।
proxy-এর ওই তিনটি line শুধু আনুষ্ঠানিকতা নয়। Upgrade এবং Connection header WebSocket handshake পার হতে দেয়। এগুলো না থাকলে page load হয়, কিন্তু আর update হয় না। proxy_read_timeout 3600s nginx-এর inactivity timeout 60 seconds থেকে এক hour-এ বাড়ায়। এটি agent run-এর মোট সময়সীমা নির্ধারণ করে না। pinned 0.2.0-rc.2 ডিফল্টভাবে প্রতি দুই seconds-এ WebSocket ping পাঠায়। দীর্ঘ agent step চলাকালেও এতে connection সক্রিয় থাকে। proxy_buffering off proxied HTTP response-এর buffering বন্ধ করে। এটি WebSocket frame নিয়ন্ত্রণ করে না। nginx reverse proxy configuration, প্রতিটি line-এর ব্যাখ্যা-এ বাকি বিষয়টি ব্যাখ্যা করা হয়েছে। nginx, Caddy এবং Traefik-এর মধ্যে নির্বাচন-এ automatic certificate ব্যবহার করে একই কাজ করার পদ্ধতি দেখানো হয়েছে।
harness-কেও proxy সম্পর্কে জানাতে হবে। proxy_set_header Host $host browser-এ প্রদর্শিত নামটি অপরিবর্তিতভাবে পাঠায়। প্রকল্পের proxy guide-এ এটাই চাওয়া হয়েছে। তাই dsh-কে সেই নাম trusted করে চালু করুন। না হলে এটি 403 উত্তর দেবে:
npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.comএরপর প্রত্যেক ব্যক্তি token-সহ https://dsh.example.com/?token=... একবার খুলবেন। token-টি dsh web: line-এ আছে। তারপর browser session cookie সংরক্ষণ করবে। backend Secure flag ছাড়াই cookie সেট করে। proxy guide HTTPS-এ proxy-কে এই flag যোগ করতে বলে। nginx 1.19.3 বা পরবর্তী সংস্করণে proxy_cookie_flags ~ secure;, location block-এর মধ্যে এটি করে।
যে proxy-ই বেছে নিন, firewall-এ 3080 বন্ধ রাখুন। এতে প্রবেশের একমাত্র পথ authenticated proxy হয়ে থাকবে। ufw firewall-এর মৌলিক বিষয়-এ rule-গুলোর ব্যাখ্যা আছে। TLS-এর ওপর Basic authentication হলো ন্যূনতম সুরক্ষা, সম্পূর্ণ security model নয়। যার কাছে ওই password এবং token URL আছে, তার কাছে আপনার server-এর shell আছে। সম্ভব হলে tunnel ব্যবহার করুন।
dsh web যে port-এ listen করে, সেটি কীভাবে পরিবর্তন করব?
--port web application-এর অন্তর্ভুক্ত, launcher-এর নয়। CLI documentation-এ সরাসরি উদাহরণটি দেওয়া আছে:
dsh --profile web --port 8080dsh web হলো --profile web-এর alias, তাই dsh web --port 8080 একই command। Launcher শুধু নিজের flags parse করে এবং এরপরের সবকিছু booted profile-এর কাছে পাঠিয়ে দেয়। তাই launcher flags আগে দিতে হবে, আর launcher যে প্রথম token চিনতে পারে না, সেখান থেকেই application-এর arguments শুরু হয়। --port profile-এর পরে দিন, আগে নয়।
Command যে URL print করে, সেটি পড়ুন; অনুমান করবেন না। ওই লাইনে server বাস্তবে যে address-এ bind করেছে, সেটি এবং আপনার প্রয়োজনীয় token দুটিই দেখানো হয়। এরপর tunnel-এর শেষ field-টি সেই অনুযায়ী update করুন:
ssh -N -L 3080:127.0.0.1:8080 you@your-vpsস্থায়ী পরিবর্তনের জন্য port command line-এ নয়, profile configuration-এ থাকে। web এবং headless profile প্রথমবার ব্যবহারের সময় ~/.dsh-এর অধীনে shipped template থেকে স্বয়ংক্রিয়ভাবে initialize হয়। আপনার API key এবং model endpoint-এর settings-ও একই directory-তে থাকে। তাই আপনি যখন এই file-গুলো সম্পাদনা করছেন, তখন dsh key, model ও endpoint configure করা সহায়ক পাঠ হিসেবে দেখুন। সব layer একত্র হওয়ার পরে বাস্তবে কোন settings কার্যকর আছে তা দেখতে:
dsh --dump-configListen address webserver plugin-এর host এবং port—এই দুটি key থেকে আসে। 0.2.0-rc.2-এ এর অন্যান্য key শুধু response compression নিয়ন্ত্রণ করে। 0.2.1-rc.2 এবং default branch-এ একটি ঐচ্ছিক tls key যোগ করা হয়েছে। port-কে 0 সেট করলে operating system-এর কাছে একটি free port চাওয়া হয়। Documentation-এ বলা আছে, "zero requests an OS-assigned port"। এতে port conflict হওয়ার আশঙ্কা থাকে না। তবে tunnel-এর জন্য এটি উপযুক্ত নয়, কারণ প্রতিবার restart-এর পরে port নম্বর বদলে যায়।
কেন dsh 'address already in use' ত্রুটি দেখায়?
কারণ অন্য একটি প্রসেস ইতিমধ্যে সেই অ্যাড্রেস এবং পোর্টটি দখল করে রেখেছে, তাই কার্নেল দ্বিতীয়বার bind করার অনুরোধ প্রত্যাখ্যান করে। Node এটি এভাবে রিপোর্ট করে:
Error: listen EADDRINUSE: address already in use 127.0.0.1:3080কোনো কিছু পরিবর্তন করার আগে কোনটি পোর্টটি দখল করে আছে তা খুঁজে বের করুন:
sudo ss -ltnp | grep 3080users:(("node",pid=1042,fd=21)) ফিল্ডে প্রসেসের নাম এবং এর PID উল্লেখ থাকে। সাধারণত কারণটি হয় আগের একটি dsh, যেটি বন্ধ হয়েছে বলে আপনি ভেবেছিলেন, তবে প্রায়শই সেটি একটি detached tmux উইন্ডোতে এখনও চলমান থাকে। সেটিকে kill 1042 ব্যবহার করে বন্ধ করুন, অথবা নতুন instance-টি অন্য কোনো পোর্টে চালু করুন। মনে রাখবেন যে 127.0.0.1:3080 এবং 0.0.0.0:3080 একে অপরের সাথে সংঘর্ষ তৈরি করে, কারণ সব ইন্টারফেস bind করার অর্থ হলো এটি ইতিমধ্যে loopback-কেও অন্তর্ভুক্ত করে ফেলেছে।
ভার্সন pin করুন, কারণ এটি developer preview
README-তে বিষয়টি স্পষ্টভাবে বলা আছে: DeepSeek Harness এখন developer preview পর্যায়ে রয়েছে এবং দ্রুত পরিবর্তিত হচ্ছে। ফলে compatibility ভেঙে দিতে পারে এমন পরিবর্তন আসবে। এই গতি যদি আপনার দ্বিধার কারণ হয়, dsh, Claude Code এবং Omnigent-এর তুলনা একই পরিবর্তনধারার ভিন্ন পর্যায়ে থাকা দুটি harness-এর সঙ্গে এটি তুলনা করে।
একটি unpinned npx @deepseek-ai/dsh web-এ কোনো version নির্দিষ্ট থাকে না। তাই কোন build চালু হবে, তা আপনি নিয়ন্ত্রণ করতে পারেন না। npm-এর documentation অনুযায়ী, specifier ছাড়া package name "local project-এ যে version আছে, তার সঙ্গে মেলানো হবে"; আর project-এ package না থাকলে সেটি npm cache-এর একটি folder-এ install হয়। কোন build চালু হবে, তা ওই machine-এ তখন কী আছে তার ওপর নির্ভর করে। তাই restart-এর পরে আপনার পরীক্ষিত CLI-এর বদলে ভিন্ন flag-সহ অন্য CLI চালু হতে পারে। Version pin করুন, যাতে restart upgrade হিসেবে কাজ না করে:
npx @deepseek-ai/dsh@0.2.0-rc.2 webNovember 2026 অনুযায়ী (2026-11-01 তারিখে পরীক্ষা করা), npm-এর latest tag এখন 0.2.1-rc.5-এর দিকে নির্দেশ করে। এটি GitHub-এ 2026-10-30 তারিখে release হয়েছে। GitHub-এর তথ্য অনুযায়ী 0.2.1-rc.4 2026-10-28 তারিখে 02:49 UTC-তে release হয়েছে। এটি 2026-10-23 তারিখে 15:26 UTC-তে প্রকাশিত 0.2.1-rc.3-এর প্রায় চার দিন এগারো ঘণ্টা পরে। তাই local copy না থাকা machine-এ bare npx @deepseek-ai/dsh এখন এই guide-এ pin করা build-এর বদলে 0.2.1 release candidate নামাবে। Pin করা 0.2.0-rc.2 GitHub-এ 2026-09-29 তারিখে release হয়েছিল। এই guide-এ August মাসে pin করা 0.1.0-rc.7 build এখন বহু preview release পিছিয়ে আছে। এর মধ্যে 0.1 line-এর বাকি release এবং 0.2 line-এর release-ও রয়েছে। গ্রহণ করার আগে bare npx কী নামাবে তা পরীক্ষা করুন:
npm view @deepseek-ai/dsh versionnpm view @deepseek-ai/dsh dist-tags একসঙ্গে সব tag দেখায়। Pin করার আগে release candidate এবং alpha আলাদা করার এটাই উপায়।
Pin install হতে না চাইলে, অথবা নতুন version pin করার পরেও npx পুরোনো build চালু করতে থাকলে, এটি যে install ও version error তৈরি করে সেখানে npx cache পরিষ্কার করা এবং আপনার Node কোন npm bundle করে তা পরীক্ষা করার পদ্ধতি আছে।
Preview release-গুলোর মধ্যে launcher এবং web application-এর মধ্যে flag স্থানান্তরিত হয়। --port এই guide-এ বর্ণিতভাবে কাজ করা বন্ধ করলে অনুমান না করে application-এর নিজস্ব flag list দেখুন:
dsh --profile web --helpInstall, workspace setup এবং model key-এর জন্য VPS-এ DeepSeek Harness install করা দেখুন। শুধু access ধাপের সংক্ষিপ্ত নির্দেশনার জন্য VPS-এ dsh Web UI-তে প্রবেশ করা tunnel ব্যবহারের পদ্ধতি দেখায়, reasoning ছাড়াই।
FAQ
আমি আমার laptop browser-এ http://127.0.0.1:3080 খুলতে পারছি না কেন?
কারণ 127.0.0.1 বলতে আপনি যে machine-এ command লিখছেন সেটিকে বোঝায়। DeepSeek Harness Web UI VPS-এর loopback address-এ bind করা আছে, তাই শুধু VPS-এর process-গুলো এতে connect করতে পারে। আপনার laptop-এর loopback আলাদা, এবং সেখানে port 3080-এ কোনো process listen করছে না। ssh -N -L 3080:127.0.0.1:3080 you@your-vps ব্যবহার করে SSH-এর মাধ্যমে port forward করুন। এরপর locally সম্পূর্ণ printed URL, http://127.0.0.1:3080/?token=..., load করুন। -L argument-এর মাঝের field server side-এ resolve হয়। এ কারণেই এটি harness-এর দিকে নির্দেশ করে। token বাদ দিলে browser session cookie ধরে না রাখা পর্যন্ত 401 Unauthorized পাবেন।
Public VPS-এ dsh Web UI-কে 0.0.0.0-এ bind করা কি নিরাপদ?
না। Web UI এমন একটি agent-এর control surface, যা dsh হিসেবে চলা user-এর হয়ে shell command চালায় এবং file edit করে। এতে user account বা login screen নেই। একমাত্র credential হলো printed URL-এর token। Static asset-গুলো token ছাড়াই serve হয়। প্রকল্পের নিজস্ব documentation-এও বলা আছে যে listening port নিজেই unprotected। Public IP-তে সব interface-এ bind করলে port 3080-এ পৌঁছাতে পারে এমন যে কেউ একটি ফাঁস হওয়া URL-এর মাধ্যমে আপনার server-এ command execute করতে পারবে। সরাসরি public IP-তে bind করলেও একই risk থাকে। Bind 127.0.0.1-এ রাখুন, firewall-এ 3080 বন্ধ রাখুন, এবং এমন SSH tunnel, private overlay network বা reverse proxy ব্যবহার করুন যেটিতে password প্রয়োজন।
SSH session বন্ধ করার পর dsh Web UI কীভাবে চালু রাখব?
Foreground npx @deepseek-ai/dsh web আপনার login shell-এর child process। তাই shell exit করলে এটি kill হয়। একটি tmux session-এর ভিতরে এটি start করুন এবং Ctrl-b d দিয়ে detach করুন। অথবা lingering enabled রেখে systemd user service হিসেবে চালান। Tunnel এবং harness স্বাধীন। Harness চলমান থাকলে আপনি যতবার ইচ্ছা SSH tunnel বন্ধ করে আবার তৈরি করতে পারেন। এর জন্য harness-এর এমন একটি parent থাকতে হবে, যা আপনার login session-এর চেয়ে বেশি সময় চলবে।
nginx-এর পেছনে দীর্ঘ agent run চলার সময় dsh Web UI মাঝপথে freeze করে কেন?
WebSocket connection এবং nginx-এর error log পরীক্ষা করুন। nginx-এর default proxy_read_timeout হলো reads-এর মধ্যে 60 seconds। তবে pinned 0.2.0-rc.2 defaultভাবে প্রতি দুই seconds-এ WebSocket ping পাঠায়। তাই শুধু দীর্ঘ agent step-এর কারণে ওই timeout হওয়ার কথা নয়। proxy_read_timeout 3600s; inactivity allowance এক hour পর্যন্ত বাড়ায়। proxy_buffering off; WebSocket frame নয়, HTTP response-এর buffering বন্ধ করে। WebSocket handshake সফল করতে proxy_http_version 1.1; দিয়ে Upgrade এবং Connection header পাঠান। ওই header না থাকলে page load হয়, কিন্তু কোনো update পায় না।