SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

راهنمای نصب امن DeepSeek Harness روی VPS

نحوه اجرای امن DeepSeek Harness روی سرور لینوکس با استفاده از SSH Tunnel برای دسترسی به پورت 3080. با پین کردن نسخه npm و جلوگیری از دسترسی عمومی، از فایل‌های خود محافظت کنید.

DeepSeek Harness چیست

DeepSeek Harness (dsh) یک runtime برای عامل‌های Node.js است که می‌توانید آن را روی یک VPS (سرور مجازی) اجرا کنید. روش امن برای اجرای آن، محدود کردن اتصال به 127.0.0.1 است، به‌طوری که مرورگر شما از طریق یک تونل SSH (پوسته امن) به آن دسترسی پیدا کند. این ابزار به جای اجرا در ترمینال، یک رابط کاربری وب (UI) روی پورت 3080 ارائه می‌دهد. در نسخه 0.1.0-rc.6 که این راهنما بر آن متمرکز است، وب‌سرور هیچ رمز عبوری درخواست نمی‌کند؛ بنابراین اگر پورت 3080 را در دسترس عموم قرار دهید، هر کسی که آن را پیدا کند به عاملی دسترسی خواهد داشت که می‌تواند فایل‌های شما را بخواند و دستورات را با سطح دسترسی کاربر لینوکس شما اجرا کند. نسخه‌های جدیدتر، از 0.2.0-rc.2 تا 0.2.2-rc.2 مورخ 11 نوامبر 2026 (جدیدترین نسخه‌ای که گیت‌هاب در 12 نوامبر 2026 لیست کرده است)، یک URL راه‌اندازی حاوی یک توکن تازه برای آن پردازش چاپ می‌کنند و آن را با یک کوکی نشست (session cookie) جایگزین می‌کنند، اما همچنان به‌صورت پیش‌فرض روی loopback گوش می‌دهند و از اتصال به تمام رابط‌های شبکه خودداری می‌کنند.

DeepSeek این ابزار را تحت مجوز MIT و به عنوان بسته npm با نام @deepseek-ai/dsh منتشر می‌کند. این پروژه خود را یک پیش‌نمایش توسعه‌دهنده (developer preview) معرفی کرده و اعلام می‌کند که باید انتظار تغییرات ناسازگار با نسخه‌های قبلی را داشت. نسخه ثابت‌شده در زیر، نسخه اوت 2026 است. در 12 نوامبر 2026، تگ latest در npm به 0.2.2-rc.1 اشاره دارد. گیت‌هاب نسخه پیش‌انتشار جدیدتر 0.2.2-rc.2 را لیست کرده که با تگ dsh-v0.2.2-rc.2 در 11 نوامبر 2026 منتشر شده است. پیش از کپی کردن هر بخشی از آن روی سروری که اهمیت دارد، مخزن (repository) را بررسی کنید.

یک ایده در کل طراحی این پروژه جاری است: همه چیز یک افزونه (plugin) است. آداپتور مدل، رجیستری ابزارها، لاگ نشست، sandbox، زمان‌بند و خودِ حلقه عامل، همگی افزونه‌هایی هستند که در یک زمینه (context) مشترک بارگذاری می‌شوند و هر کدام از آن‌ها قابل جایگزینی هستند. هیچ هسته دارای امتیاز ویژه‌ای وجود ندارد که افزونه‌ها فقط آن را تزئین کنند. همین موضوع باعث می‌شود Harness ارزش امتحان کردن را داشته باشد، اما در عین حال منشأ تنها ریسک واقعی آن نیز هست. اینکه آیا این معامله ارزشش را دارد یا خیر، به معیارهای شما بستگی دارد و مقایسه آن با Claude Code و Omnigent، طراحی مبتنی بر افزونه را در کنار دو راهکار دیگر از نظر اتصال مدل، مجوز و میزان منابع مورد نیاز از VPS بررسی می‌کند.

یک harness مدل نیست

harness حلقهٔ agent را اجرا می‌کند. استدلال در یک مدل در جای دیگری انجام می‌شود، بنابراین تا زمانی که یک کلید API (رابط برنامه‌نویسی کاربردی) یا آدرس endpoint مدلی که خودتان میزبانی می‌کنید را به آن ندهید، هیچ‌چیز کار نخواهد کرد. تمام مطالب این پست مربوط به پیکربندی harness است و نه رفتار مدل، و مرز بین این دو موضوعی است که ارزش دارد پیش از آنکه یک بعدازظهر را صرف عیب‌یابی برای یافتن منشأ مشکل کنید، آن را به‌خوبی درک کنید.

شما این مورد را در UI تحت بخش Settings و سپس Models پیکربندی می‌کنید. DeepSeek کارت مخصوص به خود را دارد و در نسخه‌های فعلی، دکمه "Add model provider" در زیر آن، دو حالت را باز می‌کند. "Third-party model provider" ارائه‌دهندگانی را پوشش می‌دهد که harness برای آن‌ها کاتالوگ ارائه می‌دهد، مانند OpenAI و Anthropic، که در آن شما یک کلید را وارد می‌کنید و کاتالوگ، endpoint و لیست مدل‌ها را فراهم می‌کند. "Custom model API" گزینه جالب‌تری است: این گزینه یک شناسه ارائه‌دهنده با حروف کوچک، یک نام نمایشی، یک base URL، یک پروتکل API، یک اعتبارنامه و حداقل یک مدل دریافت می‌کند. انتخابگر پروتکل، گزینه‌های OpenAI Chat Completions، OpenAI Responses، Anthropic Messages و Gemini API را ارائه می‌دهد، بنابراین می‌توانید یک gateway یا سرور محلی که از یکی از این‌ها پشتیبانی می‌کند را پیکربندی کنید؛ endpointهایی که تفاوت‌هایی در فرمت درخواست دارند، به تنظیمات سازگاری نیاز دارند. ارائه‌دهندگان سفارشی همچنین می‌توانند برای پر کردن لیست مدل‌ها برای شما، از endpoint سازگار با OpenAI یعنی GET /models پرس‌وجو کنند.

این روشی است که با آن harness را به مدلی روی همان VPS اشاره می‌دهید. Ollama یک API سازگار با OpenAI را در http://127.0.0.1:11434/v1/ ارائه می‌دهد و فیلد کلید API هر رشته‌ای را می‌پذیرد، که طبق قرارداد ollama است، زیرا کلاینت به سبک OpenAI به یک مقدار نیاز دارد و Ollama آن را نادیده می‌گیرد. مستندات خود Ollama نیز ollama launch dsh را توصیف می‌کند که در صورت نبودن @deepseek-ai/dsh، آن را نصب کرده و روی یک مدل Ollama اجرا می‌کند، بنابراین پیش از تکیه بر pin زیر، بررسی کنید که چه نسخه‌ای را نصب می‌کند. اینکه آیا مدلی که به اندازه کافی کوچک است تا در VPS شما جای بگیرد، برای هدایت یک agent به اندازه کافی خوب است یا خیر، پرسش دشوارتری است و تفاوت بین Ollama و vLLM به عنوان یک سرور مدل محلی تعیین می‌کند که پاسخ این پرسش چقدر از RAM شما را اشغال می‌کند.

کلیدهایی که در UI تایپ می‌شوند، فقط‌نوشتنی (write-only) هستند. harness آن‌ها را در $DSH_HOME/.credentials.yaml ذخیره می‌کند و تنظیمات فقط یک ارجاع به اعتبارنامه را نگه می‌دارند، که نسخه‌های فعلی آن را در فایل patch پروفایل فعال، یعنی $DSH_HOME/profiles/<profile>/cordis.patch.yml می‌نویسند (پروفایل برای dsh web برابر با web است). مقدار پیش‌فرض $DSH_HOME برابر با ~/.dsh است. با فایل اعتبارنامه‌ها مانند یک فایل رمز عبور رفتار کنید، زیرا دقیقاً همین‌طور است: هر کسی که آن را بخواند می‌تواند بودجه API شما را خرج کند. اگر می‌خواهید به‌جای کلیک کردن در Settings، این فایل‌ها را مستقیماً ویرایش کنید، راهنمای فایل‌های پیکربندی dsh، کلیدها و endpointهای مدل نشان می‌دهد که هر کلید چه کاری انجام می‌دهد و در هر حالت چه چیزی از سیستم شما خارج می‌شود.

پیش‌نیازهای پیش از نصب

  • یک سرور مجازی (VPS) با سیستم‌عامل Ubuntu 24.04 یا یک توزیع لینوکس به‌روز دیگر، همراه با دسترسی SSH
  • نسخه Node.js 24.9 یا جدیدتر؛ زیرا شاخه اصلی پروژه و 0.2.2-alpha.2 اکنون >=24.9.0 را اعلام کرده‌اند و تست‌های CI این پروژه، Node 24 را با بررسی سازگاری روی Node 24.9 و Node 26 انجام می‌دهند و دیگر جابی برای Node 22 ندارند. نسخه‌های منتشرشده (tagged releases) از طریق 0.2.1-rc.4 همچنان Node 22.19 را به‌عنوان نسخه قابل‌قبول ذکر کرده‌اند، اما این نسخه دیگر حداقلِ مورد نیاز برای بیلد پروژه نیست.
  • یک حساب کاربری معمولی، نه root؛ زیرا ایجنت، دستورات shell را با دسترسی همان کاربری که پروسه را اجرا کرده است، اجرا می‌کند.
  • وجود pnpm در متغیر PATH، اگر قصد نصب پلاگین دارید؛ زیرا دستور پلاگین برای اجرا به آن نیاز دارد.
  • بسته بودن پورت 3080 روی فایروال سیستم و همچنین فایروال شبکه جداگانه ارائه‌دهنده سرور.

بسته nodejs در خودِ Ubuntu 24.04 قدیمی‌تر از نیاز این ابزار است؛ بنابراین در این نسخه، Node را از طریق NodeSource یا nvm نصب کنید و به سراغ apt install nodejs نروید. مخزن رسمی Ubuntu 26.10 نسخه Node 24.19.0 را ارائه می‌دهد که از حداقلِ Node 24.9 بالاتر است. اگر سرور مجازی شما تازه راه‌اندازی شده است، ایمن‌سازی SSH پیش از هر اقدام دیگری ارزش ده دقیقه وقت گذاشتن را دارد؛ زیرا تونلی که قرار است به آن وابسته باشید، تنها به اندازه امنیت سرور SSH پشت آن قابل‌اطمینان است.

نصب DeepSeek Harness روی یک VPS با نسخه ثابت

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

npx بسته را دانلود کرده و باینری dsh آن را اجرا می‌کند. web یک نام مستعار برای --profile web است که اپلیکیشن مرورگر را راه‌اندازی می‌کند و فرآیند، آدرسی را که روی آن در حال گوش دادن است چاپ می‌کند. مقدار پیش‌فرض http://127.0.0.1:3080 است. این اعداد یک تصمیم برای binding هستند و نه یک پیش‌فرض ظاهری؛ بخش چرا dsh یک آدرس loopback چاپ می‌کند توضیح می‌دهد که این harness پیش از آنکه از لپ‌تاپ خود به دنبال آن بگردید، به چه درخواست‌هایی پاسخ می‌دهد و به چه درخواست‌هایی پاسخ نخواهد داد.

نسخه را ثابت (Pin) کنید. npx @deepseek-ai/dsh web در لحظه اجرا، هر نسخه‌ای را که تگ latest به آن اشاره می‌کند شناسایی می‌کند، مگر اینکه پروژه‌ای که از آن استفاده می‌کنید قبلاً یک کپی نصب‌شده داشته باشد که در این صورت npx بی‌سروصدا از همان کپی استفاده می‌کند. در هر صورت، شما انتخاب‌کننده نسخه نیستید و پروژه تاکنون چندین release candidate منتشر کرده و اعلام کرده است که تغییرات ساختارشکن (breaking changes) در راه است. 0.1.0-rc.6 نسخه آگوست 2026 است که در اینجا ثابت شده است. در تاریخ 12 نوامبر 2026، latest به 0.2.2-rc.1 اشاره می‌کند؛ نسخه‌ای که یک URL راه‌اندازی توکنیزه چاپ می‌کند. گیت‌هاب نسخه پیش‌انتشار جدیدتر 0.2.2-rc.2 را فهرست کرده است، بنابراین انتقال به نسخه دیگر دقیقاً نوعی ارتقا است که باید پس از مطالعه مخزن (repository) به‌صورت آگاهانه انجام شود. نسخه ثابت به این معنی است که سیستمی که امروز راه‌اندازی می‌کنید، ماه آینده نیز به همان شکل رفتار می‌کند؛ بنابراین ارتقا به تصمیمی تبدیل می‌شود که شما می‌گیرید، نه حادثه‌ای که به‌طور اتفاقی با آن مواجه می‌شوید. زمانی که یک دستور ثابت‌شده همچنان build اشتباهی را اجرا می‌کند یا اصلاً نصب نمی‌شود، بخش خطاهای معمول نصب و نسخه dsh نحوه پاک‌سازی کش npx و بررسی اینکه npm از کدام Node استفاده می‌کند را پوشش می‌دهد.

برای استفاده روزمره، آن را یک‌بار نصب کنید تا در هر بار اجرا نیاز به شناسایی مجدد نباشد.

npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --help

اجرای خط دوم ارزشمند است، زیرا launcher و اپلیکیشن وب مجموعه‌فلگ‌های جداگانه‌ای دارند. dsh --help گزینه‌های مربوط به خودِ launcher را نمایش می‌دهد. dsh --profile web --help فلگ‌هایی را که اپلیکیشن وب می‌پذیرد نشان می‌دهد؛ جایی که --port، --host و فلگ تکرارپذیر --trusted-host قرار دارند.

اکنون تأیید کنید که روی چه آدرسی در حال گوش دادن است.

ss -tlnp | grep 3080

ستون آدرس محلی باید 127.0.0.1:3080 را نشان دهد. اگر 0.0.0.0:3080 را نشان می‌دهد، رابط کاربری روی تمام اینترفیس‌ها در حال گوش دادن است؛ بنابراین تنها فایروال‌های شما بین آن و اینترنت قرار دارند و باید پیش از انجام هر کار دیگری، فرآیند را متوقف کنید.

چرا هرگز نباید پورت 3080 را منتشر کنید

وب‌سرور موجود در 0.1.0-rc.6 فاقد لایه احراز هویت است. پیکربندی آن تنها شامل یک میزبان و پورت برای گوش دادن (listen) است و کل سطح حمله همین است. کنترل دسترسی برای استقرار در محیط‌های غیر از localhost، یک تنظیم جداگانه برای میزبان‌های مورد اعتماد (trusted-host) است که به هیچ وجه جایگزین صفحه ورود نیست.

نسخه‌های جدیدتر یک لایه امنیتی اضافه کرده‌اند. از نسخه 0.2.0-rc.2 به بعد، در زمان راه‌اندازی، یک URL حاوی یک توکن تازه برای همان پردازش چاپ می‌شود؛ مرورگری که آن را باز می‌کند، یک کوکی نشست (session cookie) امضاشده دریافت کرده و بدون توکن به همان آدرس هدایت می‌شود. یک سد Host/Origin در مقابل /api فقط درخواست‌های loopback، آدرس bind خودِ listener و مراجعی که با --trusted-host نام می‌برید را می‌پذیرد. این یک اعتبارنامه واقعی است، اما مستندات خود پروژه هشدار می‌دهند که URL چاپ‌شده، یک اعتبارنامه است که فقط باید با کاربران مجاز به اشتراک گذاشته شود و پروتکل HTTP ساده، آن را بدون رمزنگاری ارسال می‌کند. از نسخه 0.2.1-alpha.2 به بعد، وب‌اپلیکیشن می‌تواند به یک آدرس محلی مشخص bind شود و با استفاده از --tls-cert و --tls-key، مستقیماً HTTPS ارائه دهد. این کار مشکل متن‌باز بودن (plaintext) را حل می‌کند، اما مشکل در معرض دید بودن (exposure) را خیر. این کار باعث می‌شود سوءاستفاده از پورتِ در معرض دید دشوارتر شود، اما به این معنی نیست که پورت باید منتشر شود.

حال در نظر بگیرید چه چیزی پشت این پورت قرار دارد. این عامل (agent) فایل‌های موجود در فضای کاری را ویرایش کرده و دستورات shell را اجرا می‌کند، و اعتبارنامه‌های ارائه‌دهنده شما نیز در کنار آن روی دیسک قرار دارند. بنابراین در نسخه‌های قدیمی، یک پورت 3080 باز، در واقع یک shell از راه دور با رابط کاربری چت است که با دسترسی کاربری که آن را اجرا کرده و با کلید API شما در حال فعالیت است. برای این کار نیازی به اکسپلویت نیست؛ تنها چیزی که مهاجم نیاز دارد، شماره پورت است. در نسخه‌های دارای توکن راه‌اندازی، مهاجم به توکن نیز نیاز دارد که هر کسی بتواند ترمینال، لاگ‌های سرویس یا ترافیک رمزنگاری‌نشده شما را بخواند، به آن دسترسی دارد.

رابط خط فرمان (CLI) نیز با این موضوع موافق است. از نسخه 0.1.0-rc.6 به بعد، این ابزار عمداً از --host 0.0.0.0 پشتیبانی نمی‌کند و به‌جای اجرا، خطای استفاده (usage error) می‌دهد؛ نسخه‌های جدیدتر 0.2.2-alpha.2 نیز آن را در زمان راه‌اندازی رد می‌کنند. این امتناع یک قابلیت امنیتی است، پس به دنبال وصله‌ای برای حذف آن نباشید.

اگر استفاده از تونل برای شما مناسب نیست، دو روش استقرار دیگر منطقی هستند. سرور را در یک شبکه overlay خصوصی قرار دهید تا آدرسی داشته باشد که فقط دستگاه‌های خودتان بتوانند به آن مسیریابی کنند؛ این همان کاری است که یک سرور کنترل Headscale خود-میزبانی شده برای شما انجام می‌دهد. یا یک reverse proxy در مقابل آن قرار دهید که پیش از رسیدن درخواست به پورت 3080، آن را احراز هویت کند؛ برای مثال یک سرور Authentik single sign-on که forward auth انجام می‌دهد. یک reverse proxy بدون احراز هویت در مقابل سرویس، یک کنترل امنیتی نیست؛ صرفاً یک URL طولانی‌تر است.

دسترسی به رابط کاربری وب از طریق تونل SSH

این دستور را روی لپ‌تاپ خود اجرا کنید، نه روی سرور.

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

-L پورت 3080 را روی لپ‌تاپ شما باز می‌کند و هر چیزی که به آن متصل شود را از طریق نشست رمزنگاری‌شده SSH هدایت می‌کند. بخش 127.0.0.1:3080 روی سرور resolve می‌شود، بنابراین اتصال از طریق loopback به harness می‌رسد، دقیقاً همان‌طور که انگار پشت همان دستگاه نشسته‌اید. -N می‌گوید که یک shell از راه دور باز نکنید، زیرا شما فقط به این forward نیاز دارید و نه چیز دیگری.

سپس http://127.0.0.1:3080 را در مرورگر محلی خود باز کنید. در نسخه‌ای که دارای launch token است، به جای آن، آدرس کامل startup که سرور چاپ کرده است (شامل token) را باز کنید؛ وقتی harness از طریق SSH اجرا می‌شود، همچنان خط startup را چاپ می‌کند اما تلاشی برای باز کردن مرورگر برای شما انجام نمی‌دهد. اگر پورت 3080 روی لپ‌تاپ شما اشغال است، عدد سمت چپ را تغییر دهید: ssh -N -L 3180:127.0.0.1:3080 you@your-server، سپس به http://127.0.0.1:3180 بروید و پورت را در آدرس دارای token به همان صورت تغییر دهید. عدد سمت چپ محلی است و عدد سمت راست متعلق به سرور است، بنابراین فقط عدد سمت چپ تغییر می‌کند.

آن را در ~/.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 refused)، معمولاً به این معنی است که تونل برقرار است اما هیچ سرویسی در سمت دیگر گوش نمی‌دهد، زیرا SSH پورت را صرف‌نظر از اینکه harness در حال اجرا باشد یا خیر، forward می‌کند. وضعیت سرور را با دستور ss که در بالا ذکر شد، بررسی کنید.

تداوم اجرای harness پس از خروج از سیستم

یک دستور npx با بستن shell شما متوقف می‌شود. یک سرویس کاربری systemd اما باقی می‌ماند و harness را پس از کرش یا reboot دوباره بالا می‌آورد. unit در اینجا عمداً حداقلی در نظر گرفته شده است؛ اگر می‌خواهید harness تحت یک حساب کاربری محدودشده اجرا شود، نسخهٔ آن در unit قفل (pin) شده باشد و لاگ‌هایی داشته باشید که واقعاً قابل جستجو باشند، راهنمای headless systemd برای dsh تمام این موارد را پوشش می‌دهد.

loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dsh

enable-linger اهمیت دارد زیرا سرویس‌های کاربری معمولاً با پایان آخرین نشست شما متوقف می‌شوند، بنابراین بدون آن، harness لحظه‌ای که tunnel را می‌بندید از کار می‌افتد. مسیر مطلق (absolute path) چاپ‌شده توسط command -v dsh را بردارید و در unit قرار دهید، زیرا systemd در PATH که 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 از دایرکتوری فراخواننده به عنوان محل پیش‌فرض فایل‌سیستم استفاده می‌کند، بنابراین سرویسی که در جای اشتباهی شروع شود، agent را به پوشهٔ اشتباهی هدایت می‌کند. البته آن دایرکتوری فقط یک پیش‌فرض است: یک Web UI جدید تا زمانی که در بخش Choose workspace موردی اضافه نکنید، هیچ workspace انتخابی ندارد و راهنمای پروژه به شما می‌گوید دایرکتوری‌ای که dsh را در آن شروع کرده‌اید اضافه کنید. این راهنما هیچ نشانگر نسخه‌ای ندارد و همین عبارت در 0.1.0-rc.7 نیز وجود دارد، پس در نسخهٔ pinned نیز انتظار آن را داشته باشید. دایرکتوری unit را روی پروژه تنظیم کنید، سپس همان workspace را در UI انتخاب کنید.

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

unitای که از شروع خودداری می‌کند، تقریباً همیشه به دلیل مسیر اشتباه ExecStart یا نسخهٔ Nodeای است که باینری آن را رد می‌کند، و journalctl --user -u dsh -n 50 مشخص می‌کند کدام است. در نسخه‌ای که دارای launch token است، journal همچنین جایی است که URL شروعِ توکن‌دار در آن قرار می‌گیرد و هر restart یک URL جدید چاپ می‌کند. همین الگو زنده نگه داشتن هر coding agent روی یک VPS را پوشش می‌دهد و حالت‌های شکست (failure modes) نیز یکسان هستند.

یک افزونه چه کارهایی می‌تواند انجام دهد

افزونه ماژولی است که سرویس‌ها، رویدادهای تایپ‌شده و اثرات برگشت‌پذیر را به یک زمینه مشترک اضافه می‌کند. نقاط توسعه (extension points) بخش‌هایی هستند که ارزش مطالعه دقیق دارند:

  • ثبت یک ارائه‌دهنده مدل در ctx.llm
  • افزودن ابزارهای مرتبط با مدل در ctx.tools
  • فراهم کردن backend پوسته (shell) در پشت ctx.shell
  • فراهم کردن دسترسی به سیستم فایل یا سیاست‌های امنیتی در پشت ctx.fs
  • ثبت دستورات انسانی در ctx.commands
  • اجرای کارهای پس‌زمینه از طریق ctx.jobs
  • بسته‌بندی فرآیندهای ایجاد شده با یک backend از نوع ctx.sandbox
  • رهگیری درخواست‌ها و فراخوانی ابزارها از طریق رویدادهای agent/* و tools/*
  • گسترش وضعیت نشست‌های پایدار (durable session state)
  • هدایت رابط کاربری (UI) از طریق ctx.agents

این لیست را از دید یک مهاجم بخوانید. یک افزونه می‌تواند لایه سیستم فایل و لایه پوسته را تأمین کند و در میان تمامی فراخوانی‌های ابزاری که مدل انجام می‌دهد، قرار بگیرد. هیچ پنجره تأیید دسترسی بین یک افزونه و این نقاط اتصال وجود ندارد، زیرا افزونه صرفاً کدهای عادی Node است که در همان فرآیندی بارگذاری می‌شود که سایر اجزا در آن قرار دارند. نصب یک افزونه به معنای اجرای کد یک غریبه با دسترسی‌های عامل (agent) شماست و دسترسی‌های عامل شما، همان دسترسی‌های کاربر Unix شماست.

این همان تصمیم اعتماد است که هنگام متصل کردن یک سرور MCP به یک عامل روی VPS اتخاذ می‌کنید، که در آن MCP مخفف پروتکل زمینه مدل (Model Context Protocol) است. به همین دلیل است که اجرای ایمن یک عامل کدنویسی روی VPS با حساب کاربری که تحت آن اجرا می‌شود آغاز می‌گردد، نه با خود مدل؛ و به همین دلیل است که حملات زنجیره تأمین npm ضربات سنگینی به سرورها وارد می‌کنند: مرحله نصب، همان لحظه نفوذ است و هیچ هشداری به شما داده نمی‌شود.

منشأ افزونه‌ها

افزونه‌ها در پروفایل‌ها قرار دارند. پروفایل یک ترکیب نام‌گذاری‌شده است که در $DSH_HOME ذخیره می‌شود و مقدار پیش‌فرض آن ~/.dsh است؛ هر دایرکتوری پروفایل، افزونه‌های خارج از درخت (out-of-tree) نصب‌شده را در خود نگه می‌دارد. رابط خط فرمان (CLI) با ارسال مستقیم آرگومان‌های شما به pnpm و استفاده از دایرکتوری پروفایل به عنوان دایرکتوری کاری، آن‌ها را مدیریت می‌کند.

dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-ui

از آنجا که آرگومان‌ها بدون تغییر به pnpm می‌رسند، add، remove، update و why دقیقاً همان‌طور که در هر پروژه pnpm رفتار می‌کنند، عمل می‌کنند و یک افزونه می‌تواند یک بسته npm یا یک ارجاع به GitHub باشد. pnpm باید ابتدا در PATH موجود باشد. در Node 24، دستور corepack enable pnpm آن را در مسیر قرار می‌دهد. Node 25 توزیع Corepack را متوقف کرد، بنابراین در Node 25 و نسخه‌های جدیدتر، آن را با npm install -g pnpm نصب کنید.

کشف افزونه‌ها از طریق یک موضوع (topic) در GitHub انجام می‌شود. نویسندگان افزونه، موضوع dsh-plugin را به مخزن خود اضافه می‌کنند و مرور آن موضوع، روش یافتن افزونه‌های موجود است. موضوع، برچسبی است که نویسنده به مخزن خود اعمال می‌کند. هیچ‌کس آن را بررسی یا تأیید نمی‌کند و صفحه موضوع بر اساس تعداد ستاره‌ها رتبه‌بندی می‌شود که نشان‌دهنده محبوبیت است، نه امنیت.

نسخه‌های فعلی شامل یک بسته آزمایشی برای نمایه‌های افزونه سفارشی (Custom plugin indexes) هستند. آن را در بخش Plugins فعال کنید تا در تب Discover بتوانید یک نمایه اضافه کنید؛ نمایه یک فایل JSON است که از URL ارائه‌شده توسط شما دریافت می‌شود. این ابزار هیچ نمایه‌ای از خود ارائه نمی‌دهد، فرمت فایل را بررسی می‌کند اما عناوین، نویسندگان یا منابع ادعاشده توسط یک بازار را تأیید نمی‌کند و هر کسی در مسیر شبکه می‌تواند نمایه‌ای را که از طریق http: ساده ارائه می‌شود، بازنویسی کند. بازار در اینجا صرفاً یک کاتالوگ است که توسط شخص دیگری نوشته شده و به معنای بررسی امنیتی نیست.

چهار عادت برای مدیریت این وضعیت توصیه می‌شود. پیش از نصب، کد منبع را بخوانید، زیرا اکثر افزونه‌ها به اندازه‌ای کوچک هستند که در ده دقیقه قابل خواندن باشند. به جای دنبال کردن یک شاخه (branch)، نسخه دقیق یا commit خاص را ثابت (pin) کنید. ابزار را با کاربری اجرا کنید که مالک هیچ چیز دیگری نیست و روی یک VPS که آمادگی بازسازی کامل آن را دارید، کار کنید. به عامل (agent) یک کلید API اختصاصی با محدودیت هزینه جداگانه بدهید که از کلیدی که سرویس‌های عملیاتی (production) شما استفاده می‌کنند، متمایز باشد. هنگامی که می‌خواهید افزونه‌ای را بررسی کنید و بدانید کدام فایل‌ها دارای ریسک هستند، راهنمای بررسی افزونه‌های dsh شما را با مانیفست، نقطه ورود و نقاط توسعه‌ای که یک افزونه ثبت می‌کند، آشنا می‌کند.

اگر ترجیح می‌دهید پیش از انتخاب نهایی، طراحی‌ها را مقایسه کنید، ابزار چندعاملی Omnigent همان مسئله را با ساختار متفاوتی حل می‌کند و پس از استفاده از افزونه‌ها، تفاوت‌ها و اولویت‌ها آشکار می‌شوند. اگر در نهایت تصمیم گرفتید به جای انتخاب یک گزینه، دو یا سه مورد از آن‌ها را روی یک سیستم نگه دارید، قرار دادن تمام ابزارها پشت یک API خودمیزبان (self-hosted) شما را از ایجاد تونل برای هر پورت بی‌نیاز می‌کند، به شرط آنکه یک سرویس دیگر را به loopback متصل کرده و از همان ابتدا یک رمز عبور واقعی برای آن تعیین کنید.

چه چیزی زودتر از همه دچار مشکل می‌شود

نسخه Node قدیمی است. شاخه اصلی پروژه و 0.2.2-alpha.2 به Node 24.9 یا جدیدتر نیاز دارند. تست‌های CI این پروژه، Node 24 را به همراه یک بررسی سازگاری روی Node 24.9 و Node 26 تست می‌کنند و هیچ پشتیبانی برای Node 22 وجود ندارد. نسخه‌های تگ‌شده قدیمی‌تر تا 0.2.1-rc.4، نسخه Node 22.19 را قابل‌قبول می‌دانستند، اما پروژه دیگر با آن build نمی‌شود. یک runtime قدیمی هنگام شروع کار با خطا مواجه می‌شود، زیرا کد از سینتکس و APIهایی استفاده می‌کند که در آن نسخه وجود ندارند. پیش از هر کار دیگری، node --version را اجرا کنید.

پورت 3080 قبلاً اشغال شده است. یک harness دوم، یک پردازش معلق (stale) یا یک برنامه نامرتبط دیگر که از پورت 3080 استفاده می‌کند. آن را با ss -tlnp | grep 3080 پیدا کنید، سپس آن را متوقف کنید یا harness را با dsh web --port 3180 در جای دیگری اجرا کنید. --port متعلق به اپلیکیشن وب است، بنابراین باید پس از web اجرا شود.

مرورگر نمی‌تواند از طریق تونل متصل شود. تأیید کنید که به 127.0.0.1 مراجعه کرده‌اید و نه آدرس عمومی سرور، زیرا پورت فوروارد شده فقط روی لپ‌تاپ شما وجود دارد. سپس تأیید کنید که harness روی سرور در حال گوش دادن (listening) است، زیرا SSH فوروارد را برقرار می‌کند، صرف‌نظر از اینکه آیا در سمت دیگر پاسخی دریافت می‌شود یا خیر.

دستور dsh plugin بلافاصله با خطا مواجه می‌شود. این دستور یک wrapper برای pnpm است، بنابراین نبود فایل باینری pnpm باعث توقف آن پیش از شروع کار هرگونه پلاگین می‌شود. در Node 25 و نسخه‌های جدیدتر، این وضعیت پیش‌فرض است، زیرا Corepack دیگر همراه با Node عرضه نمی‌شود.

ایجنت نمی‌تواند پروژه شما را ببیند. یک رابط کاربری وب (Web UI) تازه تا زمانی که یک workspace اضافه نکنید، هیچ فضای کاری انتخاب‌شده‌ای ندارد و session composer تا آن زمان غیرقابل دسترس باقی می‌ماند. این پردازش از دایرکتوری که در آن شروع شده فقط به عنوان مکان پیش‌فرض فایل‌سیستم استفاده می‌کند، بنابراین unitای که WorkingDirectory آن دایرکتوری home شماست، ایجنت را به دایرکتوری home شما هدایت می‌کند. workspace را در رابط کاربری انتخاب کنید یا unit را اصلاح کرده و دوباره بارگذاری (reload) کنید.

FAQ

آیا قرار دادن رابط کاربری وب DeepSeek Harness روی پورت 3080 امن است؟

خیر. در 0.1.0-rc.6 پین‌شده، وب‌سرور فاقد سیستم احراز هویت داخلی است و ایجنتِ پشت آن، فایل‌ها را ویرایش کرده و دستورات shell را با دسترسی کاربری که پروسه را اجرا کرده است، اجرا می‌کند؛ ضمن آن‌که API key ارائه‌دهندهٔ شما نیز روی همان دیسک ذخیره شده است. از 0.2.0-rc.2 به بعد، شامل 0.2.2-rc.1، نسخه latest از npm در تاریخ 12 نوامبر 2026، و نسخه پیش‌انتشار جدیدتر 0.2.2-rc.2، آدرس URL شروع‌به‌کار حاوی یک توکن راه‌اندازی است که مرورگر آن را با یک session cookie معاوضه می‌کند. با این حال، آن URL یک اعتبارنامه محسوب می‌شود که در حالت HTTP ساده به‌صورت رمزنگاری‌نشده ارسال می‌گردد، بنابراین توصیه ما تغییر نمی‌کند. listener را روی 127.0.0.1 نگه دارید و از طریق یک SSH tunnel به آن دسترسی پیدا کنید. یک شبکه overlay خصوصی یا یک reverse proxy که پیش از رسیدن درخواست به پورت، آن را احراز هویت کند نیز کارآمد است. از نسخه 0.1.0-rc.6 به بعد، CLI استفاده از --host 0.0.0.0 را رد کرده و با خطای usage خارج می‌شود، و 0.2.2-alpha.2 نیز همچنان آن را نمی‌پذیرد؛ که این خود نشان‌دهنده نظر نویسندگان پروژه در مورد این ایده است.

آیا به یک API key از DeepSeek نیاز دارم یا می‌توانم از مدل محلی استفاده کنم؟

هر دو روش امکان‌پذیر است، زیرا این harness یک محیط اجرا (runtime) است و نه یک مدل. در بخش Settings و سپس Models، می‌توانید یک کلید را در کارت DeepSeek یا یک ارائه‌دهنده کاتالوگ وارد کنید، یا گزینه "Add model provider" و سپس "Custom model API" را انتخاب کرده و یک base URL بدهید که از استانداردهای OpenAI Chat Completions، OpenAI Responses، Anthropic Messages یا Gemini API پشتیبانی کند. یک سرور محلی Ollama روی http://127.0.0.1:11434/v1/ پاسخ می‌دهد و هر رشته‌ای را در فیلد API key می‌پذیرد. کلیدها در $DSH_HOME/.credentials.yaml ذخیره می‌شوند که مسیر پیش‌فرض آن ~/.dsh/.credentials.yaml است.

نصب یک پلاگین DeepSeek Harness دقیقاً چه دسترسی‌هایی به آن می‌دهد؟

دسترسی‌های همان اکانتی که harness را اجرا می‌کند. یک پلاگین در واقع کدهای Node است که در همان پروسه بارگذاری می‌شود و نقاط گسترش (extension points) شامل بک‌اند shell، لایه فایل‌سیستم، رجیستری ابزارها و رویدادهایی است که هر فراخوانی ابزار را در بر می‌گیرند. هیچ مکانیزم sandbox ای پلاگین را از این بخش‌ها جدا نمی‌کند، مگر آن‌که خود پلاگین sandbox اختصاصی‌اش را فراهم کند. پیش از نصب، سورس‌کد را مطالعه کنید و harness را با کاربری اجرا کنید که مالک هیچ فایل یا دیتای مهمی نباشد.

کدام نسخه را نصب کنم و آیا در آینده همچنان کار خواهد کرد؟

یک نسخه دقیق را نصب کنید، برای مثال npx @deepseek-ai/dsh@0.1.0-rc.6 web. این نسخه آگوست 2026 است که در اینجا پین شده است. در تاریخ 12 نوامبر 2026، تگ latest در npm به 0.2.2-rc.1 اشاره دارد؛ گیت‌هاب نسخه پیش‌انتشار جدیدتر 0.2.2-rc.2 را که در 11 نوامبر منتشر شده لیست می‌کند و CLI فعلی به Node 24.9 یا جدیدتر نیاز دارد. این پروژه خود را یک نسخه پیش‌نمایش توسعه‌دهنده (developer preview) می‌نامد و اعلام کرده که تغییرات ناسازگار (breaking changes) مورد انتظار است، بنابراین یک دستور بدون نسخه پین‌شده ممکن است از یک روز تا روز بعد رفتار متفاوتی داشته باشد. پیش از ارتقا، مخزن پروژه را بررسی کنید و انتظار داشته باشید که کلیدهای پیکربندی و رابط‌های پلاگین تا زمانی که نسخه با 0 شروع می‌شود، تغییر کنند.

آیا این مقاله مفید بود؟