SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

ما معنى dsh web: http://127.0.0.1:3080 عند تشغيل DeepSeek؟

يظهر هذا الرابط لأن واجهة dsh تعمل محلياً فقط على خادمك. تعلم كيفية الوصول إليها بأمان عبر نفق SSH وتجنب مخاطر فتح المنفذ 3080 للعامة على الإنترنت.

ما المقصود بـ 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. وهو العنوان الذي تستخدمه الآلة للاتصال بنفسها. تقبل socket المرتبطة بـ 127.0.0.1 الاتصالات من العمليات الموجودة على الآلة نفسها، ولا تقبلها من أي مكان آخر. لذلك يوضح لك هذا السطر أمرين في الوقت نفسه: العنوان الذي تستمع عليه Web UI، والجهة المسموح لها بالوصول إليها. المسموح هو الآلة التي يعمل عليها dsh فقط. أما الجزء ?token= في النهاية فهو credential عشوائي جديد ينشئه process عند كل تشغيل. سنشرح ذلك لاحقاً.

لهذا السبب لا يفعل URL شيئاً عند لصقه في المتصفح على حاسوبك المحمول. إن 127.0.0.1 الخاص بحاسوبك المحمول هو حاسوبك المحمول. يستمع harness على 127.0.0.1 الخاص بـ VPS، وهي آلة مختلفة لها loopback stack مختلف. لا يوجد عطل. تحتاج إلى تمرير الاتصال بين الآلتين.

يوضح README الرسمي الإعداد الافتراضي صراحةً: "يبدأ الأمر Web UI على http://127.0.0.1:3080 افتراضياً ويفتحها في المتصفح الافتراضي عند التشغيل محلياً." عند استخدام SSH، لا يوجد متصفح لفتحه، لذلك يترك لك URL لتستخدمه يدوياً. يأتي عنوان bind من webserver host plugin، @deepseek-ai/dsh-host-webserver. في إصدار 0.2.0-rc.2 الذي يثبّته هذا الدليل، يوثّق مفتاح host على النحو التالي: "مضيف الاستماع؛ والقيمتان المدعومتان هما loopback وall-interfaces". تحصل على loopback ما لم تغيّره بنفسك. وإذا كانت المنافذ جديدة عليك، يشرح كيفية عمل المنافذ في Linux نموذج العنوان مع المنفذ الذي يعتمد عليه كل ذلك.

لماذا يرتبط Web UI بـlocalhost فقط

dsh هو agent harness، أي البرنامج الذي يحيط بالنموذج: فهو يدير الحلقة، واستدعاءات الأدوات، والصلاحيات التي تعمل بها هذه الاستدعاءات. وعلامة تبويب المتصفح هي واجهة تحكم لعملية تنفذ أوامر shell، وتقرأ الملفات وتكتبها في دليل workspace الذي اخترته، وتستهلك مفتاح API الخاص بالنموذج. يمكن لأي شخص يستطيع تحميل تلك الصفحة تنفيذ كل ذلك بصفته المستخدم الذي يشغّل dsh. وليست الشبكة الوسيلة الوحيدة للوصول إلى هذه الصلاحيات: إذ يعمل أي plugin تثبّته داخل العملية نفسها وبالصلاحيات نفسها. لذلك فإن فحص dsh plugin قبل تثبيته يتطلب القدر نفسه من العناية الذي تتطلبه عملية تحديد ما إذا كان الخادم سيستمع على منفذ معيّن.

لذلك، فإن المنفذ 3080 ليس لوحة معلومات للقراءة فقط. يؤدي تحميل الصفحة إلى منح صلاحية تنفيذ الأوامر على الخادم.

افتح URL المطبوع، وستنتقل مباشرة إلى قائمة الجلسات. لا توجد شاشة تسجيل دخول ولا حسابات مستخدمين. وما يحمي الصفحة هو token في نهاية URL: تستبدله الصفحة الجذرية بـsigned session cookie ثم تعيد التوجيه إلى عنوان نظيف. بعد ذلك، تحصل كل RPC call وكل WebSocket stream تنشئهما الواجهة من دون cookie صالح على 401 Unauthorized. لكن لا تخضع كل الموارد الموجودة على المنفذ للحماية. توضّح وثائق Connection plugin أن static assets تبقى عامة، وأن webserver نفسه لا يوفّر مصادقة على مستوى الخادم أو سياسة origin. لذلك يفرض كل plugin يملك route قواعده الخاصة. في تلك routes المحمية، يعيد Connection plugin أيضاً 403 عندما لا يكون header Host عنوان loopback أو مضيفاً وثقت به صراحة. وعلى loopback، يشكّل ذلك طبقة ثانية معقولة خلف التحكم الفعلي في الوصول، إذ يسمح نظام التشغيل بمرور العمليات المحلية فقط. لكنه ليس سبباً لنشر المنفذ. يوجد token في سجل التمرير الخاص بالطرفية، وفي أي log التقط مخرجات بدء التشغيل. يوضّح دليل reverse proxy الخاص بالمشروع أن فحص Host وURL المعلن لا يحميان منفذ الاستماع نفسه. وتحذّر وثائق webserver من أن ربطه بعنوان غير loopback «يظل يعرّض routes غير المحمية وstatic assets لهذه الشبكة». وفي الإصدار 0.2.0-rc.2، لا يوفّر webserver plugin طبقة TLS خاصة به. وتفحص الماسحات الآلية المنافذ غير الشائعة باستمرار، لذلك تعامل مع منفذ 3080 المنشور على أنه سيُكتشف.

لا تفتح المنفذ 3080 في firewall، ولا تضبط host الخاص بـwebserver على 0.0.0.0 أو على عنوان IP العام لخادم VPS عام. يترك هذا الجمع تنفيذ الأوامر على خادمك على بُعد URL مسرّب واحد من أي شخص يتصل به.

تدفعك الإصدارات الحالية بالفعل إلى هذا الإعداد: إذ يرفض flag --host الخاص بتطبيق الويب نفسه الارتباط بجميع الواجهات. لكن في الإصدار 0.2.0-rc.2، يظل مفتاح الإعداد host الخاص بـwebserver plugin يقبل 0.0.0.0، لذلك يمكن لتعديل الإعدادات أن يعرّضه للخطر. وتذهب وثائق webserver في الفرع الافتراضي للمشروع، وكذلك في الإصدار 0.2.1-rc.5 الذي يشير إليه tag latest في npm حالياً، إلى أبعد من ذلك: فهي ترفض العنوان غير المحدد عند التحميل، وتضيف إعداد tls اختيارياً. لكنها لا تزال تقبل أي عنوان محدد واحد لواجهة محلية. لذلك يؤدي ضبط host على عنوان IP العام لخادم VPS إلى تعريض UI بالطريقة نفسها.

ينطبق المنطق نفسه على كل agent runtime تضعه على خادم. ولهذا تبدأ بتشغيل coding agent بأمان على VPS من القاعدة نفسها: يبقى منفذ التحكم الخاص بالagent خاصاً، وتتولى جهة تثق بها إيصالك إليه.

كيف تفتح واجهة Web لـ dsh من حاسوبك المحمول؟

هناك 3 طرق مباشرة، وتُبقي كل واحدة منها الـharness مرتبطاً بواجهة loopback.

  • نفق SSH. لا توجد خدمة جديدة تستمع على الواجهة العامة، ولديك بيانات الاعتماد مسبقاً. استخدم هذه الطريقة.
  • شبكة overlay خاصة، بحيث يمكن الوصول إلى الواجهة من أجهزتك فقط وتبقى غير مرئية للجميع سواك.
  • Reverse Proxy ينهي TLS (أمان طبقة النقل) ويطلب كلمة مرور قبل أن يمرّر أي طلب.

الفرق بينها هو المسار الذي ينقل متصفحك إلى loopback. لا ينبغي أن تتضمن أي منها نقل الـharness خارج loopback.

الوصول إليه عبر نفق SSH

نفّذ هذا الأمر على حاسوبك المحمول، وليس على VPS:

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

اتركه قيد التشغيل، ثم افتح عنوان URL الكامل dsh المطبوع، http://127.0.0.1:3080/?token=... مع تضمين الرمز المميز، في المتصفح المحلي. تُحمّل واجهة Web UI، وتستبدل الرمز المميز بملف تعريف ارتباط للجلسة، ثم تحذف الرمز المميز من شريط العناوين. يرسل متصفحك 127.0.0.1:3080 باعتباره Host، وهو عنوان loopback، لذلك يمر النفق بفحص Host دون إعداد إضافي.

تحتوي الوسيطة -L على 3 حقول تفصل بينها نقطتان. الحقل الأول هو المنفذ الذي سيفتحه النفق على حاسوبك المحمول. والحقلان الثاني والثالث هما العنوان والمنفذ اللذان سيُعاد توجيه كل اتصال إليهما. التفصيل المهم هو أن 127.0.0.1 في الحقل الأوسط يُحلّ بواسطة خادم SSH على VPS، بعد وصول حركة الشبكة إليه. وهو يشير إلى loopback الخاص بـVPS، وليس إلى loopback الخاص بحاسوبك. وهذا هو العنوان الذي طبعه dsh تحديداً، ولذلك يعمل النفق بينما يفشل اتصال المتصفح المباشر.

تخبر -N برنامج SSH بعدم تشغيل أمر عن بُعد، لذلك تحصل على إعادة توجيه فقط دون shell. لإنشاء نفق يعمل في الخلفية ويُظهر الفشل بوضوح بدلاً من تجاهله:

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

تنقله -f إلى الخلفية بعد المصادقة. وتعد ExitOnForwardFailure=yes أهم مما يبدو: من دونها، يتصل SSH بنجاح حتى عندما يتعذر إعداد إعادة التوجيه، فتحصل على جلسة عاملة ونفق متوقف دون تحذير. ترسل ServerAliveInterval=30 رسالة keepalive كل 30 ثانية، حتى يبقى النفق قائماً عند انتهاء مهلات 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 بدلاً من ذلك، فهذا يعني أن Web UI متاحة على كل واجهة، بما فيها الواجهة العامة. وينطبق الأمر نفسه إذا ظهر عنوان IP العام الخاص بـVPS في ذلك العمود. أوقفها وأصلح عنوان الربط قبل تنفيذ أي إجراء آخر. إذا طبع ss المقبس لكنه ترك الحقل users: فارغاً، فشغّله باستخدام sudo، لأن اسم العملية الخاصة بمقبس يملكه مستخدم آخر يكون مخفياً بخلاف ذلك.

عندما يرفض النفق البدء

يطبع SSH الرسالة التالية ثم يخرج:

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

هذه المشكلة في حاسوبك المحمول، وليست في الخادم. هناك شيء محلي يستخدم المنفذ 3080، وغالباً يكون نفقاً سابقاً نسيت إيقافه. اختر منفذاً محلياً متاحاً بدلاً منه:

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

تغيّر الحقل الأول فقط، لذلك تتصفح الآن إلى http://127.0.0.1:3081/?token=...، باستخدام الرمز المميز نفسه، بينما تواصل harness الاستماع على 3080. لا يلزم أن يتطابق الرقمان. يرتبط ملف تعريف ارتباط الجلسة بالمضيف والمنفذ الموجودين في شريط العناوين، لذلك يحتاج المنفذ المحلي الجديد إلى عنوان URL الذي يتضمن الرمز المميز مرة أخرى.

إذا بدأ النفق لكن أبلغ المتصفح عن اتصال مرفوض أو رد فارغ، فهذا يعني أن حركة الشبكة وصلت إلى VPS ولم تجد شيئاً في الطرف البعيد. إما أن dsh خرج، أو أنه ربط منفذاً مختلفاً. تحقق باستخدام ss -ltnp | grep 3080 على الخادم. وإذا أجابت الصفحة بدلاً من ذلك بـ401 Unauthorized، فالنفق يعمل، لكن متصفحك لا يحتوي على ملف تعريف ارتباط صالح لهذا العنوان: افتح عنوان URL المطبوع مرة أخرى مع تضمين الرمز المميز. بعد إعادة التشغيل، خذ عنوان URL من المخرجات الجديدة، لأن كل عملية تنشئ رمزاً مميزاً جديداً.

هناك أمر آخر يسبب مشكلات للمستخدمين هنا. تتوقف عملية npx @deepseek-ai/dsh web الأمامية عند إغلاق shell الخاص بها، لذلك توقف harness بمجرد تسجيل الخروج. شغّلها داخل tmux أو ضمن خدمة systemd للمستخدم، وهي المشكلة نفسها التي يحلها إبقاء coding agent قيد التشغيل على VPS. في systemd، يظهر السطر dsh web:، مع الرمز المميز وكل ما يتبعه، في سجل الخدمة، لذا اقرأه من هناك. وأثناء عملك على جانب SSH، يجدر بك أولاً تعزيز أمان SSH على VPS، لأن النفق يجعل تسجيل دخول SSH الخاص بك الباب الوحيد إلى agent.

الوصول عبر شبكة تراكبية خاصة

تمنحك شبكة تراكبية عناوين لخادم 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 مع الوثوق بالاسم، وإلا فستتلقى استدعاءات 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 على منفذ مفتوح ولا يحميها سوى رمز URL. يبدو الأمران متشابهين تقريباً، لكنهما ينفّذان وظيفتين متعاكستين، لذلك اقرأ الفرق بين Tailscale Serve وFunnel قبل كتابة أيٍّ منهما. يشرح Tailscale كشبكة خاصة إعداد الشبكة نفسه.

الوصول إليه عبر Reverse Proxy يتحقق من كلمة مرور

هذا هو الخيار الذي ينشر منفذاً فعلياً على الإنترنت، لذلك تكون المصادقة هي الحاجز الوحيد بين شخص غريب وتنفيذ الأوامر على خادمك. اختره عندما يحتاج عدة أشخاص إلى واجهة المستخدم ويكون إنشاء نفق لكل شخص غير عملي.

يبقى الـ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;
    }
}

أنشئ ملف كلمات المرور ثم أعد التحميل:

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. يفشل التحميل عند وجود ملف معطوب، ويُبقي الإعداد قيد التشغيل كما هو، لذلك اقرأ الخطأ بدلاً من إعادة التشغيل عشوائياً.

ثلاثة من أسطر الـproxy هذه ضرورية وليست للزينة. تسمح رأسا Upgrade وConnection بمرور مصافحة WebSocket، وبدونهما تُحمّل الصفحة لكنها لا تتحدّث أبداً. يرفع proxy_read_timeout 3600s مهلة عدم النشاط في nginx من 60 ثانية إلى ساعة، لكنه لا يحدّد المدة الإجمالية لتشغيل الوكيل. يرسل الإصدار المثبّت 0.2.0-rc.2 نبضات WebSocket كل ثانيتين افتراضياً، ما يحافظ على الاتصال نشطاً أثناء خطوة وكيل طويلة. يعطّل proxy_buffering off التخزين المؤقت لاستجابات HTTP التي يمررها الـproxy، ولا يتحكم في إطارات WebSocket. يشرح إعداد Reverse Proxy في nginx، سطراً بسطر بقية الإعداد، بينما يوضّح الاختيار بين nginx وCaddy وTraefik كيفية تنفيذ الأمر نفسه باستخدام شهادات تلقائية.

يحتاج الـharness إلى معرفة الـproxy أيضاً. يمرر proxy_set_header Host $host الاسم الذي يراه المتصفح من دون تغيير، وهذا ما يطلبه دليل الـproxy الخاص بالمشروع، لذلك ابدأ dsh مع الوثوق بهذا الاسم، وإلا فسيرد بـ403:

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

يفتح كل شخص https://dsh.example.com/?token=... مرة واحدة باستخدام الرمز المميز الموجود في سطر dsh web:، ثم يحتفظ المتصفح بملف تعريف الارتباط الخاص بالجلسة. يعيّن backend ملف تعريف الارتباط هذا من دون العلامة Secure، ويطلب دليل الـproxy من الـproxy إضافتها عند استخدام HTTPS. في nginx 1.19.3 أو إصدار أحدث، ينفّذ proxy_cookie_flags ~ secure; ذلك داخل كتلة location.

أبقِ المنفذ 3080 مغلقاً في جدار الحماية مهما كان الـproxy الذي تختاره، بحيث يكون المسار الوحيد للدخول عبر الـproxy الذي يفرض المصادقة. يشرح أساسيات جدار الحماية ufw القواعد. المصادقة الأساسية عبر TLS هي الحد الأدنى وليست نموذج أمان مكتملًا: من يملك كلمة المرور ورابط الرمز المميز يملك shell على خادمك. فضّل النفق عندما تستطيع.

كيف أغيّر المنفذ الذي يستمع عليه dsh web؟

ينتمي --port إلى تطبيق الويب، وليس إلى المشغّل. تعرض وثائق CLI المثال مباشرة:

dsh --profile web --port 8080

dsh web هو اسم مستعار لـ --profile web، لذلك فإن dsh web --port 8080 هو الأمر نفسه. يحلّل المشغّل أعلامه فقط، ويمرّر كل ما يليها إلى profile الذي شغّله. لذلك تأتي أعلام المشغّل أولاً، ويبدأَت معاملات التطبيق عند أول token لا يتعرّف عليه المشغّل. ضع --port بعد profile، وليس قبله.

اقرأ URL الذي يطبعه الأمر بدلاً من افتراضه، لأن هذا السطر يعرض العنوان الذي ربط به الخادم فعلياً، إلى جانب الرمز المميز الذي ستحتاج إليه. ثم حدّث الحقل الأخير في tunnel ليطابقه:

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

لتغيير دائم، يوجد المنفذ في إعدادات profile بدلاً من سطر الأوامر. يهيّئ profileان web وheadless نفسيهما تلقائياً عند أول استخدام من القوالب المضمّنة، ضمن ~/.dsh. يوجد في الدليل نفسه إعدادات API key ونقطة نهاية model، لذلك فإن إعداد مفاتيح dsh والنماذج ونقاط النهاية هو المرجع المرتبط الذي يمكنك قراءته عند تعديل هذه الملفات. لعرض الإعداد الفعلي بعد دمج جميع الطبقات:

dsh --dump-config

يأتي عنوان الاستماع من مفتاحين في webserver plugin، هما host وport. في 0.2.0-rc.2، تضبط مفاتيحه الأخرى ضغط الاستجابة فقط، بينما يضيف 0.2.1-rc.2 وdefault branch مفتاح tls اختيارياً. يؤدي ضبط port على 0 إلى طلب منفذ مجاني من نظام التشغيل، وفق التوثيق: "يطلب الصفر منفذاً يعيّنه نظام التشغيل". يضمن ذلك عدم حدوث تعارض، لكنه غير مناسب لـ tunnel لأن الرقم يتغير عند كل إعادة تشغيل.

لماذا يفشل dsh بسبب أن العنوان مستخدم بالفعل؟

لأن عملية أخرى تشغل هذا العنوان والمنفذ بالفعل، ولذلك ترفض النواة عملية الربط الثانية. يعرض 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 منفصلة. أوقف ذلك المثيل باستخدام kill 1042، أو شغّل المثيل الجديد على منفذ مختلف. لاحظ أن 127.0.0.1:3080 و0.0.0.0:3080 يتعارضان أيضاً، لأن الربط على جميع الواجهات يشمل واجهة loopback بالفعل.

ثبّت الإصدار لأن هذه نسخة معاينة للمطورين

README واضح بشأن ذلك: DeepSeek Harness في مرحلة معاينة للمطورين ويتغير بسرعة، وستطرأ تغييرات تكسر التوافق. إذا كان هذا الإيقاع هو سبب ترددك، فتقارن كيفية مقارنة dsh مع Claude Code وOmnigent بينه وبين أداتَي harness تمر كل منهما بمرحلة مختلفة على المنحنى نفسه.

لا يحدد npx @deepseek-ai/dsh web غير المثبّت أي إصدار، لذلك لا تتحكم في الإصدار الذي سيبدأ. توضح وثائق npm أن اسم الحزمة من دون محدِّد «سيُطابق أي إصدار موجود في المشروع المحلي»، وأن الحزمة غير الموجودة في المشروع تُثبّت في مجلد داخل ذاكرة npm المؤقتة. ويتوقف الإصدار الذي يبدأ على ما يوجد في ذلك الجهاز، لذلك قد تؤدي إعادة التشغيل إلى تشغيل CLI مختلف عن الذي اختبرته، مع flags مختلفة. ثبّت الإصدار حتى لا تصبح إعادة التشغيل ترقية:

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

اعتباراً من November 2026 (وفق تحقق أُجري في 2026-11-01)، يشير وسم npm latest إلى 0.2.1-rc.5، الذي أُصدر على GitHub في 2026-10-30. ويسجل 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 المجرّد الآن release candidate بالإصدار 0.2.1، لا الإصدار الذي يثبّته هذا الدليل. أُصدر 0.2.0-rc.2 المثبّت على GitHub في 2026-09-29. أما إصدار 0.1.0-rc.7 الذي ثبّته هذا الدليل في August، فقد أصبح متأخراً الآن عن إصدارات معاينة كثيرة، عبر بقية سلسلة 0.1 ووصولاً إلى 0.2. تحقّق مما سيجلبه npx المجرّد قبل اعتماده:

npm view @deepseek-ai/dsh version

يسرد npm view @deepseek-ai/dsh dist-tags كل tag دفعة واحدة، وبذلك تميّز release candidate عن alpha قبل تثبيته.

إذا رفض التثبيت استخدام الإصدار المثبّت، أو ظل npx يشغّل الإصدار القديم بعد تثبيت إصدار جديد، فتشرح أخطاء التثبيت والإصدار التي يسببها ذلك كيفية مسح ذاكرة npx المؤقتة والتحقق من npm الذي يضمّه Node.

تنتقل flags بين launcher وتطبيق الويب عبر إصدارات المعاينة. إذا توقف --port عن العمل بالطريقة الموضحة في هذا الدليل، فاطلب من التطبيق قائمة flags الخاصة به بدلاً من التخمين:

dsh --profile web --help

للتثبيت نفسه، وإعداد workspace، ومفتاح النموذج، راجع تثبيت DeepSeek Harness على VPS. ولشرح أقصر لخطوة الوصول وحدها، توضّح الوصول إلى Web UI الخاصة بـ dsh على VPS إعداد tunnel من دون شرح المنطق وراء ذلك.

FAQ

لماذا لا يمكنني فتح http://127.0.0.1:3080 في متصفح الحاسوب المحمول؟

لأن 127.0.0.1 يشير إلى الجهاز الذي تكتب عليه. ترتبط واجهة DeepSeek Harness Web UI بعنوان loopback الخاص بـVPS، لذلك لا يمكن الاتصال بها إلا من عمليات تعمل على VPS. لدى الحاسوب المحمول عنوان loopback منفصل، ولا توجد عليه أي خدمة تستمع على المنفذ 3080. أعد توجيه المنفذ عبر SSH باستخدام ssh -N -L 3080:127.0.0.1:3080 you@your-vps، ثم افتح محلياً عنوان URL الكامل المطبوع، وهو http://127.0.0.1:3080/?token=.... يُحل الحقل الأوسط من الوسيطة -L على جانب الخادم، وهذا ما يجعله يشير إلى harness. إذا حذفت الرمز المميز، فستحصل على 401 Unauthorized إلى أن يحتفظ المتصفح بملف تعريف ارتباط للجلسة.

هل من الآمن ربط واجهة dsh Web UI بالعنوان 0.0.0.0 على VPS عام؟

لا. واجهة Web UI هي سطح التحكم في agent ينفّذ أوامر shell ويعدّل الملفات باسم المستخدم الذي يشغّل dsh. لا تحتوي على حسابات مستخدمين ولا شاشة تسجيل دخول. بيانات الاعتماد الوحيدة هي الرمز المميز الموجود في عنوان URL المطبوع. وتُخدّم الأصول الثابتة من دونه. كما توضح وثائق المشروع نفسها أن منفذ الاستماع غير محمي. يؤدي الربط بجميع الواجهات على عنوان IP عام إلى جعل تنفيذ الأوامر على خادمك متاحاً لأي شخص يصل إلى المنفذ 3080 بمجرد تسرّب عنوان URL. ويحمل الربط بعنوان IP العام مباشرة الخطر نفسه. أبقِ الربط على 127.0.0.1، وأبقِ المنفذ 3080 مغلقاً في جدار الحماية، واستخدم نفق SSH أو شبكة overlay خاصة أو reverse proxy يطلب كلمة مرور.

كيف أُبقي واجهة dsh Web UI قيد التشغيل بعد إغلاق جلسة SSH؟

إن npx @deepseek-ai/dsh web يعمل في المقدمة هو عملية فرعية لـshell تسجيل الدخول، لذلك يُنهى عند خروج ذلك الـshell. شغّله داخل جلسة tmux وافصل الجلسة باستخدام Ctrl-b d، أو شغّله كخدمة systemd للمستخدم مع تفعيل lingering. النفق وharness مستقلان عن بعضهما. يمكنك إسقاط نفق SSH وإعادة إنشائه متى شئت من دون التأثير في harness قيد التشغيل، ما دام لـharness نفسه أب يعمل مدة أطول من مدة تسجيل دخولك.

لماذا تتجمد واجهة dsh Web UI في منتصف تشغيل agent طويل خلف nginx؟

تحقق من اتصال WebSocket ومن سجل أخطاء nginx. تبلغ قيمة proxy_read_timeout الافتراضية في nginx 60 ثانية بين عمليات القراءة، لكن الإصدار المثبت 0.2.0-rc.2 يرسل نبضات WebSocket كل ثانيتين افتراضياً، لذلك لا تتسبب خطوة agent طويلة وحدها في تجاوز مهلة الانتظار. تزيد proxy_read_timeout 3600s; مدة السماح بالخمول إلى ساعة. تعطل proxy_buffering off; التخزين المؤقت لاستجابات HTTP، وليس لإطارات WebSocket. مرّر رأسي Upgrade وConnection باستخدام proxy_http_version 1.1; حتى تنجح مصافحة WebSocket. من دون هذين الرأسين تُحمّل الصفحة، لكنها لا تتلقى أي تحديث.

هل كان هذا المقال مفيدًا؟