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

دلیل نمایش http://127.0.0.1:3080 در dsh چیست؟

اگر dsh آدرس http://127.0.0.1:3080 را نمایش می‌دهد به این معناست که رابط وب فقط روی localhost فعال است. برای دسترسی امن از راه دور، از SSH tunnel استفاده کنید.

معنای dsh web: http://127.0.0.1:3080 چیست

هنگامی که پروفایل وب DeepSeek Harness را روی یک VPS اجرا می‌کنید، خطی مشابه زیر چاپ شده و برنامه منتظر می‌ماند:

dsh web: http://127.0.0.1:3080/?token=...

127.0.0.1 آدرس loopback است. این آدرسی است که یک ماشین برای برقراری ارتباط با خودش از آن استفاده می‌کند. سوکتی که به 127.0.0.1 متصل (bind) شده باشد، فقط اتصالات را از پردازش‌های همان ماشین می‌پذیرد و نه از هیچ جای دیگر. بنابراین، آن خط دو نکته را همزمان به شما می‌گوید: رابط کاربری وب (Web UI) در کجا گوش می‌دهد و چه کسی اجازه دسترسی به آن را دارد. فقط ماشینی که dsh روی آن در حال اجراست. بخش ?token= در انتها، یک اعتبارنامه تصادفی جدید است که پردازش با هر بار اجرا تولید می‌کند. جزئیات بیشتر در ادامه آمده است.

به همین دلیل است که وقتی URL را در مرورگر لپ‌تاپ خود کپی می‌کنید، هیچ اتفاقی نمی‌افتد. 127.0.0.1 لپ‌تاپ شما، خودِ همان لپ‌تاپ است. Harness روی 127.0.0.1 سرور VPS شما گوش می‌دهد که یک ماشین متفاوت با پشته loopback مجزا است. هیچ مشکلی وجود ندارد. شما باید اتصال را به آن سمت منتقل کنید.

فایل README رسمی، مقدار پیش‌فرض را به صراحت بیان می‌کند: «این دستور به‌صورت پیش‌فرض رابط کاربری وب را روی http://127.0.0.1:3080 اجرا کرده و برای اجرای محلی، آن را در مرورگر پیش‌فرض باز می‌کند.» از طریق SSH مرورگری برای باز شدن وجود ندارد، بنابراین URL برای استفاده دستی در اختیار شما قرار می‌گیرد. آدرس bind از افزونه میزبان وب‌سرور، یعنی @deepseek-ai/dsh-host-webserver می‌آید. در نسخه 0.2.0-rc.2 که این راهنما بر آن تأکید دارد، کلید host آن به این صورت مستند شده است: «میزبان شنونده؛ دو مقدار پشتیبانی‌شده loopback و all-interfaces هستند». تا زمانی که آن را تغییر ندهید، مقدار پیش‌فرض همان loopback است. اگر مفهوم پورت‌ها برای شما جدید است، نحوه عملکرد پورت‌ها در لینوکس مدل آدرس-به‌علاوه-پورت که اساس این موضوع است را پوشش می‌دهد.

چرا رابط کاربری وب فقط به localhost متصل می‌شود

dsh یک ابزار واسط (harness) است که در واقع برنامه‌ای است که مدل را در بر می‌گیرد: این برنامه مدیریت حلقه اجرا، فراخوانی ابزارها و مجوزهایی که آن فراخوانی‌ها تحت آن‌ها اجرا می‌شوند را بر عهده دارد. زبانه مرورگر، یک سطح کنترل برای فرآیندی است که دستورات shell را اجرا می‌کند، فایل‌ها را در دایرکتوری کاری انتخابی شما می‌خواند و می‌نویسد، و از کلید API مدل شما استفاده می‌کند. هر کسی که بتواند آن صفحه را بارگذاری کند، می‌تواند تمام این کارها را با دسترسی کاربری که dsh را اجرا کرده است، انجام دهد. شبکه تنها راه دسترسی به این سطح از اختیارات نیست: افزونه‌ای که نصب می‌کنید در همان فرآیند و با همان مجوزها اجرا می‌شود؛ به همین دلیل است که بررسی دقیق افزونه dsh پیش از نصب به همان اندازه اهمیت دارد که تصمیم‌گیری درباره اینکه سرور روی چه پورتی گوش دهد.

بنابراین پورت 3080 یک داشبورد فقط‌خواندنی نیست. بارگذاری آن صفحه به معنای اجرای دستورات روی سرور است.

با باز کردن URL چاپ‌شده، مستقیماً به لیست نشست‌ها (session list) هدایت می‌شوید. هیچ صفحه ورود یا حساب کاربری وجود ندارد. آنچه دسترسی به صفحه را کنترل می‌کند، توکنی است که در انتهای URL قرار دارد: صفحه اصلی آن را با یک کوکی نشست امضاشده معاوضه کرده و به یک آدرس تمیز هدایت می‌کند. پس از آن، هر فراخوانی RPC و جریان WebSocket که رابط کاربری بدون کوکی معتبر انجام دهد، با خطای 401 Unauthorized مواجه می‌شود. البته همه چیز روی این پورت محدود نشده است. مستندات افزونه Connection بیان می‌کند که دارایی‌های ایستا (static assets) عمومی باقی می‌مانند و خود وب‌سرور هیچ احراز هویت سراسری یا سیاست مبدأ (origin policy) ندارد، بنابراین هر افزونه‌ای که مالک یک مسیر (route) است، قوانین خاص خود را اعمال می‌کند. در آن مسیرهای محافظت‌شده، افزونه Connection همچنین زمانی که هدر Host نه loopback باشد و نه میزبانی که صراحتاً به آن اعتماد کرده‌اید، پاسخ 403 می‌دهد. روی loopback، این یک لایه امنیتی دوم منطقی پشت کنترل دسترسی واقعی است که همان سیستم‌عامل است که فقط به فرآیندهای محلی اجازه عبور می‌دهد. این دلیلی برای عمومی کردن پورت نیست. توکن در تاریخچه ترمینال شما و در هر لاگی که خروجی زمان راه‌اندازی را ثبت کرده باشد، باقی می‌ماند. راهنمای reverse proxy خود پروژه می‌گوید که نه بررسی Host و نه URL تبلیغ‌شده، از خود پورت شنود محافظت نمی‌کنند. مستندات وب‌سرور هشدار می‌دهد که اتصال به آدرسی غیر از loopback، «همچنان مسیرهای محافظت‌نشده و دارایی‌های ایستا را در معرض آن شبکه قرار می‌دهد». و در نسخه 0.2.0-rc.2، افزونه وب‌سرور هیچ TLS داخلی ندارد. اسکنرهای خودکار به‌طور مداوم پورت‌های غیرمعمول را بررسی می‌کنند، بنابراین فرض کنید پورت 3080 عمومی، شناسایی شده است.

پورت 3080 را در فایروال خود باز نکنید و تنظیمات host وب‌سرور را روی 0.0.0.0 یا IP عمومی خود در یک VPS عمومی قرار ندهید. این ترکیب باعث می‌شود اجرای دستورات روی سرور شما تنها به اندازه یک URL لو رفته با هر کسی که متصل شود، فاصله داشته باشد.

نسخه‌های فعلی از قبل شما را به این سمت هدایت می‌کنند: فلگ --host خودِ اپلیکیشن وب از اتصال به تمام رابط‌ها (interfaces) خودداری می‌کند. با این حال، در نسخه 0.2.0-rc.2، کلید پیکربندی host در افزونه وب‌سرور همچنان 0.0.0.0 را می‌پذیرد، بنابراین ویرایش پیکربندی همچنان می‌تواند آن را در معرض خطر قرار دهد. مستندات وب‌سرور در شاخه پیش‌فرض پروژه و در نسخه 0.2.1-rc.5 که تگ latest در npm اکنون به آن اشاره دارد، فراتر می‌رود: این نسخه آدرس نامشخص را هنگام بارگذاری رد کرده و یک تنظیم اختیاری tls اضافه می‌کند. این نسخه همچنان هر آدرس مشخصی از یک رابط محلی را می‌پذیرد، بنابراین تنظیم host روی IP عمومی VPS، رابط کاربری را همچنان در معرض دید قرار می‌دهد.

همین استدلال برای هر runtime عاملی که روی سرور قرار می‌دهید صدق می‌کند، و به همین دلیل است که اجرای ایمن یک عامل کدنویسی روی VPS از همان قانون شروع می‌شود: پورت کنترل عامل باید خصوصی بماند و چیزی که به آن اعتماد دارید، شما را به آن متصل کند.

چگونه رابط کاربری وب dsh را از لپ‌تاپ خود باز کنم؟

سه روش مطمئن وجود دارد و در هر کدام از آن‌ها، harness همچنان به loopback محدود باقی می‌ماند.

  • یک تونل SSH. هیچ سرویس جدیدی روی رابط عمومی (public interface) گوش نمی‌دهد و شما از قبل اعتبارنامه‌های لازم را دارید. این روشی است که باید استفاده کنید.
  • یک شبکه overlay خصوصی، تا رابط کاربری از دستگاه‌های خودتان قابل دسترسی باشد و برای دیگران نامرئی بماند.
  • یک reverse proxy که TLS (امنیت لایه انتقال) را خاتمه می‌دهد و پیش از ارسال هر درخواستی، درخواست رمز عبور می‌کند.

تفاوت این روش‌ها در نحوه هدایت مرورگر شما به loopback است. در هیچ‌کدام از این روش‌ها نباید harness را از روی loopback منتقل کنید.

دسترسی به آن با SSH tunnel

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

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

اجازه دهید در حال اجرا بماند، سپس آدرس کامل dsh چاپ‌شده، یعنی http://127.0.0.1:3080/?token=... که شامل توکن است را در مرورگر محلی خود باز کنید. رابط کاربری وب بارگذاری می‌شود، توکن را با یک session cookie معاوضه می‌کند و توکن را از نوار آدرس حذف می‌نماید. مرورگر شما 127.0.0.1:3080 را به عنوان Host ارسال می‌کند که همان loopback است، بنابراین tunnel بدون نیاز به پیکربندی اضافی، از بررسی Host عبور می‌کند.

آرگومان -L شامل سه فیلد است که با دو نقطه از هم جدا شده‌اند. اولی پورتی است که روی لپ‌تاپ شما باز می‌شود. دومی و سومی آدرس و پورتی هستند که هر اتصال به آن هدایت می‌شود. نکته مهم این است: 127.0.0.1 در فیلد میانی، توسط سرور SSH روی VPS و پس از رسیدن ترافیک شما به آنجا، ترجمه (resolve) می‌شود. این یعنی loopback مربوط به VPS، نه لپ‌تاپ شما. این دقیقاً همان آدرسی است که dsh چاپ می‌کند و به همین دلیل است که tunnel کار می‌کند، در حالی که اتصال مستقیم مرورگر کار نمی‌کند.

-N به SSH می‌گوید که هیچ دستور راه دوری را اجرا نکند، بنابراین شما فقط یک forwarder دریافت می‌کنید و نه یک shell. برای یک tunnel در پس‌زمینه که در صورت شکست، با صدای بلند خطا می‌دهد:

ssh -N -f -o ExitOnForwardFailure=yes -o ServerAliveInterval=30 -L 3080:127.0.0.1:3080 you@your-vps

-f پس از احراز هویت، آن را به پس‌زمینه می‌فرستد. ExitOnForwardFailure=yes اهمیت بیشتری از آنچه به نظر می‌رسد دارد: بدون آن، SSH حتی زمانی که forward برقرار نشده باشد نیز با موفقیت متصل می‌شود؛ در نتیجه شما یک نشست فعال دارید اما tunnel بدون هیچ هشداری قطع است. ServerAliveInterval=30 هر 30 ثانیه یک keepalive ارسال می‌کند تا یک tunnel غیرفعال، در برابر timeoutهای NAT (ترجمه آدرس شبکه) در روترهای کافه‌ها و هتل‌ها زنده بماند.

آنچه باید ببینید

روی VPS، تأیید کنید که چه چیزی واقعاً در حال گوش دادن است:

ss -ltnp | grep 3080

یک نتیجه سالم، آدرس loopback را نشان می‌دهد:

LISTEN 0  511  127.0.0.1:3080  0.0.0.0:*  users:(("node",pid=1042,fd=21))

اگر ستون آدرس محلی به جای آن 0.0.0.0:3080 را نشان می‌دهد، رابط کاربری وب روی تمام اینترفیس‌ها، از جمله اینترفیس عمومی، در حال اجراست. IP عمومی VPS شما در آن ستون به معنای همان exposure (قرارگیری در معرض خطر) است. قبل از انجام هر کار دیگری، آن را متوقف کرده و bind را اصلاح کنید. اگر ss سوکت را نشان می‌دهد اما فیلد users: خالی است، آن را با sudo اجرا کنید، زیرا در غیر این صورت نام پردازش برای سوکتی که متعلق به کاربر دیگری است، مخفی می‌ماند.

زمانی که tunnel از شروع امتناع می‌کند

SSH این پیام را چاپ کرده و خارج می‌شود:

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

این مشکل مربوط به لپ‌تاپ شماست، نه سرور. چیزی در سیستم محلی شما از قبل پورت 3080 را اشغال کرده است، که اغلب یک tunnel قدیمی است که فراموش کرده‌اید. به جای آن یک پورت محلی آزاد انتخاب کنید:

ssh -N -L 3081:127.0.0.1:3080 you@your-vps

فقط فیلد اول تغییر کرد، بنابراین اکنون به http://127.0.0.1:3081/?token=... با همان توکن مرور می‌کنید، در حالی که harness همچنان روی 3080 گوش می‌دهد. این دو عدد هرگز نیازی به یکسان بودن ندارند. کوکی نشست به host و port موجود در نوار آدرس وابسته است، بنابراین یک پورت محلی جدید دوباره به URL توکن نیاز دارد.

اگر tunnel بالا می‌آید اما مرورگر گزارش می‌دهد که اتصال رد شده یا پاسخ خالی است، ترافیک به VPS رسیده اما در مقصد چیزی پیدا نکرده است. یا dsh خارج شده است، یا پورت متفاوتی را bind کرده است. با ss -ltnp | grep 3080 روی سرور بررسی کنید. اگر صفحه به جای آن 401 Unauthorized پاسخ می‌دهد، tunnel سالم است و مرورگر شما صرفاً کوکی معتبری برای آن آدرس ندارد: URL چاپ‌شده را دوباره، با احتساب توکن، باز کنید. پس از راه‌اندازی مجدد، URL را از خروجی جدید بردارید، زیرا هر پردازش یک توکن تازه تولید می‌کند.

یک نکته دیگر که کاربران را به دردسر می‌اندازد: یک npx @deepseek-ai/dsh web در پیش‌زمینه با بسته شدن shell از بین می‌رود، بنابراین به محض خروج (logout)، harness متوقف می‌شود. آن را داخل tmux یا تحت یک systemd user service شروع کنید، که همان مشکلی است که در نگه داشتن یک coding agent در حال اجرا روی VPS حل شده است. تحت systemd، خط dsh web:، توکن و همه چیز در لاگ سرویس قرار می‌گیرد، پس آن را از آنجا بخوانید. در حالی که روی بخش SSH کار می‌کنید، ایمن‌سازی SSH روی VPS ارزش انجام دادن دارد، زیرا tunnel باعث می‌شود ورود SSH شما تنها درِ ورودی به agent باشد.

دسترسی از طریق یک شبکه overlay خصوصی

یک شبکه overlay به VPS و لپ‌تاپ شما آدرس‌هایی در یک شبکه خصوصی می‌دهد که فقط دستگاه‌های شما به آن متصل می‌شوند. Tailscale انتخاب رایجی است و دستور serve آن دقیقاً برای این مورد مناسب است: tailscaled روی VPS اجرا می‌شود و به localhost:3080 متصل می‌گردد، بنابراین harness روی loopback باقی می‌ماند.

tailscale serve --bg localhost:3080
tailscale serve status

رابط کاربری (UI) سپس با نام دستگاه شما در داخل tailnet، از طریق HTTPS و بدون باز بودن هیچ پورتی روی اینترفیس عمومی، قابل دسترسی است. این کار مستلزم فعال بودن گواهی‌های HTTPS برای tailnet شماست، در غیر این صورت serve گواهی‌ای برای ارائه نخواهد داشت. از آنجا که مرورگر شما اکنون آن نام tailnet را به عنوان Host ارسال می‌کند، harness را با نام مورد اعتماد (trusted) اجرا کنید، وگرنه فراخوانی‌های API آن با خطای 403 مواجه می‌شوند. ورودی بدون پورت با هر پورتی مطابقت دارد:

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=... را باز کنید و توکن را از خط چاپ‌شده منتقل کنید. برای غیرفعال کردن مجدد آن، دستور را با off تکرار کنید:

tailscale serve --https=443 off

از serve استفاده کنید، هرگز از funnel استفاده نکنید. Funnel همان مقصد را در اینترنت عمومی منتشر می‌کند، که باعث می‌شود یک agent runtime روی یک پورت باز قرار بگیرد و تنها محافظ آن یک توکن URL باشد. این دو دستور تقریباً یکسان به نظر می‌رسند اما عملکردهای متضادی دارند، بنابراین پیش از تایپ هر کدام، تفاوت بین Tailscale Serve و Funnel را مطالعه کنید. Tailscale به عنوان یک شبکه خصوصی به بررسی خودِ راه‌اندازی می‌پردازد.

دسترسی از طریق reverse proxy با احراز هویت

این گزینه‌ای است که در واقع یک پورت را روی اینترنت منتشر می‌کند، بنابراین احراز هویت تنها مانع بین یک غریبه و اجرای دستورات روی سرور شماست. زمانی این روش را انتخاب کنید که چندین نفر به UI نیاز دارند و استفاده از تونل برای هر کدام غیرعملی است.

برنامه harness روی 127.0.0.1:3080 باقی می‌ماند. nginx روی همان سرور اجرا می‌شود، بنابراین می‌تواند به loopback دسترسی داشته باشد و روی پورت 443 با یک گواهی و یک فایل رمز عبور گوش می‌دهد.

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;
    }
}

فایل رمز عبور را ایجاد کرده و nginx را reload کنید:

sudo apt install -y apache2-utils
sudo htpasswd -c /etc/nginx/dsh.htpasswd you
sudo nginx -t && sudo systemctl reload nginx

nginx -t باید syntax is ok و به دنبال آن test is successful را چاپ کند. reload با یک فایل خراب شکست می‌خورد و پیکربندی در حال اجرا را دست‌نخورده باقی می‌گذارد، بنابراین به‌جای restart کورکورانه، خطا را بخوانید.

سه مورد از آن خطوط proxy صرفاً تزئینی نیستند. هدرهای Upgrade و Connection اجازه می‌دهند handshake مربوط به WebSocket عبور کند و بدون آن‌ها، صفحه بارگذاری می‌شود اما هرگز به‌روزرسانی نمی‌شود. proxy_read_timeout 3600s زمان انتظار عدم فعالیت (inactivity timeout) در nginx را از 60 ثانیه به یک ساعت افزایش می‌دهد؛ این مقدار طول کل اجرای یک agent را محدود نمی‌کند. نسخه 0.2.0-rc.2 که ثابت شده است، به‌صورت پیش‌فرض هر دو ثانیه یک‌بار WebSocket ping ارسال می‌کند و آن اتصال را در طول یک مرحله طولانی agent فعال نگه می‌دارد. proxy_buffering off بافرینگ را برای پاسخ‌های HTTP پروکسی‌شده غیرفعال می‌کند؛ این گزینه فریم‌های WebSocket را کنترل نمی‌کند. پیکربندی nginx reverse proxy، خط به خط بقیه موارد را توضیح می‌دهد و انتخاب بین nginx، Caddy و Traefik انجام همین کار با گواهی‌های خودکار را پوشش می‌دهد.

برنامه harness نیز باید از وجود پروکسی مطلع باشد. proxy_set_header Host $host نام دامنه رو به مرورگر را بدون تغییر عبور می‌دهد، که همان چیزی است که راهنمای پروکسی پروژه درخواست می‌کند، بنابراین dsh را با آن نام به عنوان trusted شروع کنید، در غیر این صورت پاسخ 403 را دریافت خواهید کرد:

npx @deepseek-ai/dsh@0.2.0-rc.2 web --trusted-host dsh.example.com

سپس هر شخص یک‌بار https://dsh.example.com/?token=... را با توکن موجود در خط dsh web: باز می‌کند و مرورگر پس از آن session cookie را نگه می‌دارد. backend آن کوکی را بدون پرچم Secure تنظیم می‌کند و راهنمای پروکسی از پروکسی می‌خواهد که آن را روی HTTPS اضافه کند. در nginx نسخه 1.19.3 یا جدیدتر، proxy_cookie_flags ~ secure; در بلوک location این کار را انجام می‌دهد.

صرف‌نظر از اینکه کدام پروکسی را انتخاب می‌کنید، پورت 3080 را در فایروال بسته نگه دارید تا تنها مسیر ورود، از طریق پروکسی احراز هویت‌شده باشد. اصول فایروال ufw قوانین آن را پوشش می‌دهد. احراز هویت پایه (Basic authentication) روی TLS یک حداقل است، نه یک مدل امنیتی کامل: هر کسی که آن رمز عبور و URL توکن را داشته باشد، به یک shell روی سرور شما دسترسی دارد. هر زمان که می‌توانید، تونل را ترجیح دهید.

چگونه پورت گوش‌دهی dsh web را تغییر دهم؟

--port متعلق به برنامه وب است، نه لانچر. مستندات CLI این مثال را مستقیماً ارائه می‌دهد:

dsh --profile web --port 8080

dsh web یک نام مستعار برای --profile web است، بنابراین dsh web --port 8080 همان دستور است. لانچر فقط پرچم‌های (flags) مربوط به خود را تجزیه می‌کند و هر چیزی که پس از آن‌ها بیاید را به پروفایل در حال اجرا تحویل می‌دهد. بنابراین پرچم‌های لانچر باید در ابتدا قرار بگیرند و اولین توکنی که لانچر تشخیص نمی‌دهد، شروع آرگومان‌های برنامه محسوب می‌شود. --port را همیشه بعد از پروفایل قرار دهید، هرگز قبل از آن ننویسید.

به جای فرض کردن آدرس، URL چاپ شده توسط دستور را بخوانید، زیرا آن خط آدرسی که سرور واقعاً روی آن Bind شده است را به همراه توکنی که نیاز دارید گزارش می‌دهد. سپس فیلد آخر تونل خود را مطابق با آن به‌روزرسانی کنید:

ssh -N -L 3080:127.0.0.1:8080 you@your-vps

برای تغییر دائمی، پورت به جای خط فرمان، در پیکربندی پروفایل قرار می‌گیرد. پروفایل‌های web و headless در اولین استفاده از قالب‌های پیش‌فرض در مسیر ~/.dsh به‌طور خودکار مقداردهی اولیه می‌شوند. همان دایرکتوری جایی است که کلید API و تنظیمات endpoint مدل شما در آن قرار دارد، بنابراین پیکربندی کلیدها، مدل‌ها و endpointهای dsh مطالعه مکمل مناسبی است، چرا که در هر صورت قصد ویرایش این فایل‌ها را دارید. برای مشاهده آنچه پس از ترکیب تمام لایه‌ها واقعاً اعمال شده است:

dsh --dump-config

آدرس گوش‌دهی از دو کلید در افزونه وب‌سرور، یعنی host و port می‌آید. در نسخه 0.2.0-rc.2 سایر کلیدهای آن فقط فشرده‌سازی پاسخ را تنظیم می‌کنند و در نسخه 0.2.1-rc.2 و شاخه پیش‌فرض، یک کلید اختیاری tls اضافه شده است. تنظیم port روی 0 از سیستم‌عامل درخواست یک پورت آزاد می‌کند، که در مستندات به عنوان "صفر درخواست یک پورت تخصیص‌یافته توسط سیستم‌عامل" ذکر شده است. این کار تضمین می‌کند که هرگز با تداخل مواجه نشوید، اما برای تونل مناسب نیست، زیرا شماره پورت با هر بار راه‌اندازی مجدد تغییر می‌کند.

چرا dsh با خطای address already in use شکست می‌خورد؟

به این دلیل که یک پردازش دیگر قبلاً آن آدرس و پورت را در اختیار گرفته است و هسته سیستم‌عامل اجازه bind شدن مجدد را نمی‌دهد. Node این وضعیت را به شکل زیر گزارش می‌کند:

Error: listen EADDRINUSE: address already in use 127.0.0.1:3080

پیش از انجام هر تغییری، پردازش مالک را پیدا کنید:

sudo ss -ltnp | grep 3080

فیلد users:(("node",pid=1042,fd=21)) نام پردازش و PID آن را مشخص می‌کند. پاسخ معمول، وجود یک dsh قدیمی است که تصور می‌کردید متوقف شده، اما اغلب همچنان در یک پنجره tmux جداشده (detached) در حال اجراست. آن را با kill 1042 متوقف کنید یا نمونه جدید را روی پورت دیگری اجرا نمایید. توجه داشته باشید که 127.0.0.1:3080 و 0.0.0.0:3080 نیز با یکدیگر تداخل دارند، زیرا bind کردن روی تمامی اینترفیس‌ها، شامل loopback نیز می‌شود.

نسخه را ثابت کنید، زیرا این یک نسخه پیش‌نمایش توسعه‌دهنده است

فایل README در این مورد صریح است: DeepSeek Harness در مرحله پیش‌نمایش توسعه‌دهنده قرار دارد و به‌سرعت در حال تغییر است، بنابراین تغییرات ناسازگار با نسخه‌های قبلی رخ خواهد داد. اگر این سرعتِ تغییر دلیلی است که باعث تردید شما شده، مقایسه dsh با Claude Code و Omnigent آن را در برابر دو ابزار مشابه در نقاط مختلف این مسیر بررسی می‌کند.

یک npx @deepseek-ai/dsh web بدون نسخه، هیچ نسخه خاصی را مشخص نمی‌کند، بنابراین شما کنترلی بر اینکه کدام بیلد اجرا می‌شود ندارید. مستندات npm می‌گوید نام بسته‌ای که مشخص‌کننده نسخه ندارد، «با هر نسخه‌ای که در پروژه محلی موجود باشد مطابقت داده می‌شود» و بسته‌ای که در پروژه موجود نباشد، در پوشه‌ای در کش npm نصب می‌شود. اینکه کدام بیلد اجرا شود به وضعیت آن ماشین بستگی دارد؛ بنابراین یک راه‌اندازی مجدد (restart) می‌تواند باعث اجرای یک CLI متفاوت از آنچه تست کرده‌اید، با فلگ‌های متفاوت شود. نسخه را ثابت (pin) کنید تا راه‌اندازی مجدد به معنای ارتقای ناخواسته نباشد:

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

تا نوامبر 2026 (بررسی‌شده در 2026-11-01)، تگ latest در npm به 0.2.1-rc.5 اشاره دارد که در تاریخ 2026-10-30 در GitHub منتشر شده است. GitHub نسخه 0.2.1-rc.4 را در تاریخ 2026-10-28 در ساعت 02:49 UTC ثبت کرده است، که تقریباً چهار روز و یازده ساعت پس از 0.2.1-rc.3 در تاریخ 2026-10-23 در ساعت 15:26 UTC است. بنابراین در ماشینی که نسخه محلی ندارد، یک npx @deepseek-ai/dsh ساده اکنون یک نسخه کاندیدای انتشار 0.2.1 را دریافت می‌کند، نه بیلدی که این راهنما ثابت کرده است. نسخه 0.2.0-rc.2 که در اینجا ثابت شده، در تاریخ 2026-09-29 در GitHub منتشر شد. بیلد 0.1.0-rc.7 که این راهنما در ماه اوت ثابت کرده بود، اکنون چندین نسخه پیش‌نمایش عقب‌تر است و از سری 0.1 عبور کرده و به 0.2 رسیده است. پیش از پذیرش یک npx ساده، بررسی کنید که چه چیزی را دریافت می‌کند:

npm view @deepseek-ai/dsh version

دستور npm view @deepseek-ai/dsh dist-tags تمام تگ‌ها را یک‌جا فهرست می‌کند؛ این روشی است که پیش از ثابت کردن نسخه، می‌توانید تفاوت بین یک نسخه کاندیدای انتشار و یک نسخه آلفا را تشخیص دهید.

اگر نصب با نسخه ثابت انجام نشد، یا npx پس از ثابت کردن نسخه جدید همچنان بیلد قدیمی را اجرا می‌کند، خطاهای نصب و نسخه که ممکن است رخ دهد نحوه پاک‌سازی کش npx و بررسی اینکه Node شما از کدام npm استفاده می‌کند را توضیح می‌دهد.

در نسخه‌های پیش‌نمایش، فلگ‌ها بین لانچر و اپلیکیشن وب جابه‌جا می‌شوند. اگر --port دیگر مطابق آنچه در این راهنما توضیح داده شده عمل نمی‌کند، به‌جای حدس زدن، از خودِ اپلیکیشن لیست فلگ‌هایش را بخواهید:

dsh --profile web --help

برای خودِ مراحل نصب، تنظیم فضای کاری و کلید مدل، به نصب DeepSeek Harness روی یک VPS مراجعه کنید. برای یک راهنمای کوتاه‌تر فقط در مورد مرحله دسترسی، دسترسی به رابط کاربری وب dsh روی یک VPS بدون توضیحات اضافی، نحوه برقراری تونل را پوشش می‌دهد.

FAQ

چرا نمی‌توانم http://127.0.0.1:3080 را در مرورگر لپ‌تاپ خود باز کنم؟

زیرا 127.0.0.1 به دستگاهی اشاره دارد که در حال تایپ با آن هستید. رابط کاربری وب DeepSeek Harness به آدرس loopback سرور VPS متصل (bind) شده است، بنابراین فقط پردازش‌های روی همان VPS می‌توانند به آن متصل شوند. لپ‌تاپ شما loopback جداگانه خود را دارد و هیچ سرویسی روی پورت 3080 آن گوش نمی‌دهد. پورت را از طریق SSH با دستور ssh -N -L 3080:127.0.0.1:3080 you@your-vps فوروارد کنید و سپس آدرس کامل چاپ‌شده، یعنی http://127.0.0.1:3080/?token=... را به‌صورت محلی باز کنید. بخش میانی آرگومان -L در سمت سرور تحلیل می‌شود و همین موضوع باعث می‌شود به harness اشاره کند. اگر توکن را حذف کنید، تا زمانی که مرورگر شما یک session cookie دریافت نکند، با 401 Unauthorized مواجه خواهید شد.

آیا اتصال رابط کاربری وب dsh به 0.0.0.0 روی یک VPS عمومی امن است؟

خیر. رابط کاربری وب، سطح کنترل عاملی است که دستورات shell را اجرا کرده و فایل‌ها را با دسترسی کاربری که dsh را اجرا می‌کند، ویرایش می‌نماید. این رابط هیچ حساب کاربری و صفحه ورودی ندارد: تنها اعتبارنامه، توکن موجود در آدرس چاپ‌شده است، دارایی‌های ثابت (static assets) بدون آن ارائه می‌شوند و مستندات خود پروژه نیز تأکید دارند که پورت گوش‌دهنده محافظت‌نشده است. اتصال به تمام اینترفیس‌ها روی یک IP عمومی، اجرای دستورات روی سرور شما را تنها به اندازه یک آدرس لو‌رفته در دسترس هر کسی که به پورت 3080 دسترسی داشته باشد، قرار می‌دهد. اتصال مستقیم به IP عمومی نیز همین ریسک را به همراه دارد. اتصال را روی 127.0.0.1 نگه دارید، پورت 3080 را در فایروال ببندید و از یک تونل SSH، یک شبکه خصوصی (overlay network) یا یک reverse proxy که نیاز به رمز عبور دارد، استفاده کنید.

چگونه رابط کاربری وب dsh را پس از بستن نشست SSH فعال نگه دارم؟

یک npx @deepseek-ai/dsh web که در پیش‌زمینه اجرا می‌شود، فرزند shell ورود شماست و با خروج از آن shell، کشته می‌شود. آن را درون یک نشست tmux اجرا کرده و با Ctrl-b d جدا (detach) شوید، یا آن را به عنوان یک systemd user service با قابلیت lingering فعال اجرا کنید. تونل و harness مستقل از یکدیگر هستند: تا زمانی که harness والد پایداری داشته باشد که پس از خروج شما از سیستم زنده بماند، می‌توانید تونل SSH را هر چند بار که بخواهید بدون تأثیر بر harness در حال اجرا، قطع و وصل کنید.

چرا رابط کاربری وب dsh هنگام اجرای طولانی عامل (agent) پشت nginx متوقف می‌شود؟

اتصال WebSocket و لاگ خطای nginx را بررسی کنید. مقدار پیش‌فرض proxy_read_timeout در nginx برای فاصله بین خواندن‌ها 60 ثانیه است، اما نسخه 0.2.0-rc.2 به‌طور پیش‌فرض هر دو ثانیه یک‌بار پینگ WebSocket ارسال می‌کند، بنابراین یک مرحله طولانی اجرای عامل به‌تنهایی باعث فعال شدن آن timeout نمی‌شود. proxy_read_timeout 3600s; اجازه عدم فعالیت را تا یک ساعت افزایش می‌دهد. proxy_buffering off; بافرینگ را برای پاسخ‌های HTTP غیرفعال می‌کند، نه فریم‌های WebSocket. هدرهای Upgrade و Connection را با proxy_http_version 1.1; ارسال کنید تا handshake مربوط به WebSocket با موفقیت انجام شود. بدون این هدرها، صفحه بارگذاری می‌شود اما هرگز به‌روزرسانی دریافت نمی‌کند.

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