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

الوصول إلى وكيل Hermes من هاتفك

تعرّف إلى طرق الوصول الثلاث إلى Hermes على VPS: شبكة Tailscale خاصة، أو HTTPS عام مع تسجيل دخول، أو SSH، وكيف تلغي الوصول عند فقدان هاتفك.

الطرق الثلاث للوصول إلى وكيل Hermes من هاتفك

للوصول إلى وكيل Hermes من هاتفك، تستخدم لوحة الويب الخاصة به. والقرار الفعلي هو ما يوجد أمام هذه اللوحة. الخيار الأول هو شبكة mesh خاصة، حيث تستمع اللوحة إلى عنوان Tailscale فقط، ولا يواجه أي منفذ الإنترنت. الخيار الثاني هو نقطة نهاية عامة خلف reverse proxy مع TLS (أمان طبقة النقل) وتسجيل دخول. ويكون تسجيل الدخول هذا هو وسيلة الحماية الوحيدة لمحطة طرفية إلى خادمك. الخيار الثالث هو SSH (shell الآمن) من تطبيق طرفية. ويتطلب هذا الخيار أقل قدر من الإعداد، ويمنح أكبر قدر من الوصول.

يبدأ هذا الدليل من حيث ينتهي تشغيل وكيل Hermes على VPS خاص بك. الوكيل مثبت، ويستجيب في سطر الأوامر، وتريد الآن الوصول إليه من هاتفك.

الأوامر أدناه مخصصة للوسم v2026.8.3، الذي نُشر في 3 August 2026 وحمل الاسم v0.20.0 في ملاحظات الإصدار. تصدر Hermes إصدارات متكررة، لذلك ثبّت الجهاز على وسم بدلاً من متابعة main. يقبل المثبّت commit:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/v2026.8.3/scripts/install.sh | bash -s -- --commit 3c27eb6234bf
hermes --version

استخدم المثبّت من ذلك الوسم لإجراء هذا التثبيت. يتوقع المثبّت الحالي نظام تبعيات PM الأحدث. يعرض hermes --version ما هو مثبت فعلياً. قارنه بالوسم قبل الوثوق بأي flag في هذه الصفحة.

ما يوفّره المستودع وما لا يوفّره

لا يوجد تطبيق iOS أو Android في مستودع Hermes. العميل الأصلي هو hermes desktop (الاسم المستعار hermes gui)، وهو تطبيق Electron لأنظمة macOS وWindows وLinux. ويمكنه الاتصال بوكيل بعيد بدلاً من وكيل محلي: اضبط عنوان URL البعيد على http://<server-address>:9119 من Settings ضمن Gateway، أو صدّر HERMES_DESKTOP_REMOTE_URL=http://<server-address>:9119 قبل تشغيله. يحل ذلك مشكلة استخدام حاسوب محمول ثانٍ. لكنه لا يوفّر شيئاً للهاتف.

الواجهة التي تستخدمها من الهاتف هي hermes dashboard، أي واجهة المتصفح. تدير الإعدادات والجلسات ومهام cron والمهارات والسجلات ومنصات المراسلة، وتضمّن طرفية: إذ يشغّل الخادم hermes --tui خلف PTY (طرفية زائفة)، ثم يبث المخرجات إلى الصفحة. على الشاشة الضيقة، تتحول أداة تبديل الجلسات إلى لوحة منزلقة، لذلك يبقى التخطيط مناسباً للهاتف.

توفّر الإصدارات الأحدث أيضاً مساحة العمل Desktop في المتصفح عبر hermes webapp. وهذه واجهة Gateway منفصلة، لها منفذها وإعدادات URL العامة الخاصة بها؛ وتغطي التعليمات أدناه لوحة المعلومات.

تستمع لوحة المعلومات، افتراضياً، على 127.0.0.1:9119 وتفتح علامة تبويب في المتصفح على الخادم نفسه. وهذا لا يفيد في VPS (خادم خاص افتراضي) بلا واجهة رسومية. شغّلها من دون فتح المتصفح، ثم افحص المقبس:

hermes dashboard --no-open
ss -lntp | grep 9119

لا يمكن الوصول إلى مستمع على 127.0.0.1:9119 إلا من الخادم. ويمكن الوصول إلى مستمع على 0.0.0.0:9119 من كل شبكة يتصل بها الجهاز، بما في ذلك الشبكة العامة. يحدد ذلك السطر وحده مدى تعريضك للخطر، لذلك اقرأه بدلاً من افتراضه.

الخيار 1: شبكة خاصة باستخدام Tailscale

اختر هذا الخيار ما لم يكن لديك سبب يمنعك من ذلك. Tailscale هو VPN شبكي (شبكة خاصة افتراضية) مبني على WireGuard. يحصل كل جهاز تسجّله على عنوان ثابت، ويتصل بالأجهزة الأخرى مباشرة أو عبر مرحّل مشفّر. ينضم هاتفك إلى الشبكة نفسها، لذلك لا تحتاج لوحة المعلومات إلى منفذ عام على الإطلاق.

على الخادم:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
tailscale ip -4

ثبّت تطبيق Tailscale على الهاتف وسجّل الدخول باستخدام الحساب نفسه. يعرض tailscale status على الخادم الهاتف باسمه. اربط لوحة المعلومات الآن بالعنوان الذي طبعه tailscale ip -4:

hermes dashboard --host 100.101.102.103 --port 9119 --no-open

يعني الربط بعنوان الشبكة، بدلاً من 0.0.0.0، أن المقبس لا يقبل إلا الاتصالات الموجّهة إلى عنوان IP الخاص بهذه الشبكة. لن يعثر فحص لمنافذ عنوان IP العام على شيء في المنفذ 9119، لأن لا شيء يستمع على ذلك العنوان. لكن هذا لا يربط المقبس بواجهة Tailscale. توضح وثائق Linux ذلك صراحة: عناوين IP مملوكة للمضيف بأكمله، وليس لواجهات معينة. ويمكن لحزمة موجّهة إلى 100.101.102.103 تصل عبر الواجهة العامة من جهاز على شبكة المزوّد نفسها أن تصل إلى لوحة المعلومات. لفرض استخدام الواجهة أيضاً، اترك ufw على الإعداد الافتراضي لمنع حركة المرور الواردة، واسمح بالمنفذ على الشبكة فقط باستخدام sudo ufw allow in on tailscale0 to any port 9119 proto tcp. أكّد المستمع باستخدام ss -lntp | grep 9119 مرة أخرى.

يحدّد عنوان الربط أيضاً المصادقة، وهذه هي النقطة التي يغفلها بعض المستخدمين. في v2026.8.3، لا تحتوي لوحة المعلومات المرتبطة بـ127.0.0.1 على تسجيل دخول حتى عند إعداد public_url. أما على أي عنوان آخر، فبوابة المصادقة إلزامية، ويرفض الخادم بدء التشغيل عند عدم إعداد مزوّد. يسمّي المشروع ذلك الفشل الآمن. شغّل الخادم تفاعلياً للمرة الأولى، وسيعرض إعداد اسم مستخدم وكلمة مرور في الحال، ويحفظهما في dashboard.basic_auth داخل ~/.hermes/config.yaml. يمكنك إعداد المزوّد نفسه من خلال ~/.hermes/.env بدلاً من ذلك، وهذه هي الطريقة المستخدمة في المثال التطبيقي الرسمي للمشروع:

HERMES_DASHBOARD_BASIC_AUTH_USERNAME=you
HERMES_DASHBOARD_BASIC_AUTH_PASSWORD_HASH=scrypt$16384$8$1$...
HERMES_DASHBOARD_BASIC_AUTH_SECRET=a-long-random-string

أنشئ ذلك السر باستخدام openssl rand -base64 32، وهو الأمر المستخدم في وثائق لوحة المعلومات الخاصة بالمشروع. يطلب تعليق الإعداد 32 بايت عشوائياً أو أكثر، بترميز base64 أو hex. بعد ذلك، اتركه كما هو. يوقّع هذا السر رموز جلسات مزوّد كلمات المرور، لذلك يؤدي تغييره إلى تسجيل خروج كل جهاز يستخدم ذلك المزوّد. يحتوي الملف نفسه على مفاتيح API الخاصة بالنماذج، لذا احفظه بشكل خاص باستخدام chmod 600 ~/.hermes/.env.

اختبر البوابة من جهاز آخر على الشبكة قبل الاعتماد عليها:

curl -s http://100.101.102.103:9119/api/status | jq '.auth_required, .auth_providers'

يعني true متبوعاً بـ["basic"] أن البوابة مفعّلة وأن مزوّد كلمات المرور هو الذي يجيب. توضح وثائق المشروع الخاصة بهذا المزوّد الأمر بصرامة: صُمّم لشبكة موثوقة أو VPN، ولا يناسب لوحة معلومات مكشوفة على الإنترنت العام. وهذا هو الوضع الذي لديك تماماً عند استخدام شبكة خاصة.

يتطلب إعداد Tailscale Serve التالي لاستخدام HTTPS داخل tailnet إصداراً أحدث يدعم public_url في فحوصات Host وWebSocket Origin. ولا يعمل على تثبيت v2026.8.3، إذ لا يقبل الربط مع loopback إلا أسماء Host الخاصة بـloopback، بغض النظر عن public_url. التزم بعنوان IP المباشر للشبكة المذكور أعلاه عند استخدام ذلك التثبيت. بعد الترقية والتحقق من هذه الفحوصات، يوجّه Serve الطلبات إلى عنوان loopback هنا. لذلك، شغّل لوحة المعلومات في هذا الإعداد على 127.0.0.1 بدلاً من عنوان الشبكة، ثم نفّذ:

sudo tailscale serve --bg localhost:9119
sudo tailscale serve status

تطلب وثائق لوحة معلومات Hermes الحالية بعد ذلك استخدام مصدر HTTPS الذي يطبعه tailscale serve status بوصفه عنوان URL العام:

dashboard:
  public_url: "https://vps.tail1234.ts.net"

من دون ذلك السطر، ترفض لوحة المعلومات اسم MagicDNS في الترويسة Host. وبما أن الاسم ليس مضيف loopback، تبقي البوابة الخاصة بالمصادقة مفعّلة حتى عندما تستمع الواجهة الخلفية على loopback. ينهي Tailscale جلسة TLS باستخدام شهادة صادرة لاسم MagicDNS الخاص بالجهاز، لذلك يتوقف المتصفح عن عرض التحذير، وتحصل cookie الجلسة على العلم Secure. فعّل MagicDNS وشهادات HTTPS من صفحة DNS في وحدة تحكم إدارة Tailscale أولاً، واقرأ إقرار الموافقة أثناء وجودك هناك: تُنشر أسماء أجهزتك واسم DNS الخاص بـtailnet في سجل الشفافية العام للشهادات، ويمكن لأي شخص قراءته.

التكلفة الفعلية هنا هي خادم التنسيق. تُشفّر حركة المرور بين هاتفك وVPS من طرف إلى طرف، بما في ذلك عند مرورها عبر مرحّل Tailscale DERP، لكن الحساب الذي يقرّر الأجهزة التي تنتمي إلى الشبكة لا يوجد على أجهزتك. إذا كان ذلك مهماً، فشغّل مستوى التحكم بنفسك باستخدام Headscale، خادم تحكم Tailscale المستضاف ذاتياً، ووجّه العملاء إليه باستخدام tailscale up --login-server https://headscale.example.com. وإذا كنت تفضّل إلغاء الشبكة وإعداد النظراء يدوياً، فراجع المقارنة بين WireGuard العادي وTailscale لمعرفة ما ستتخلى عنه.

الخيار 2: نقطة HTTPS عامة، والمشكلة الخفية فيها

أحياناً لا تكون الشبكة المتداخلة متاحة. قد لا يسمح لك هاتف العمل بتثبيت عميل VPN. عندها تضع لوحة المعلومات خلف Reverse Proxy. يتطلب إعداد HTTPS على loopback هذا أيضاً دعم اسم المضيف العام الأحدث الموضح أعلاه؛ لا يجعل public_url الإعداد يعمل على v2026.8.3. أبقِ لوحة المعلومات على loopback ودَع Caddy يتولى الشهادة:

hermes.example.com {
  reverse_proxy 127.0.0.1:9119
}

يجلب Caddy الشهادة ويجددها تلقائياً، كما يمرر reverse_proxy ترقيات WebSocket دون توجيهات إضافية، وهو ما تحتاج إليه الوحدة الطرفية المضمّنة في لوحة المعلومات. في nginx، يجب أن تضيف رأسي Upgrade وConnection بنفسك، ويشرح إصدار شهادة Let's Encrypt باستخدام Certbot على nginx جانب TLS من هذه المهمة. أخبر Hermes باسمها العام حتى تشير استدعاءات تسجيل الدخول إلى المضيف الصحيح:

dashboard:
  public_url: "https://hermes.example.com"

وهنا تكمن المشكلة الخفية. تعتمد بوابة المصادقة على عنوان الربط، لا على العنوان الذي جاء منه الطلب. تعمل الإصدارات الحالية أيضاً على تفعيل البوابة عندما يعرّف dashboard.public_url (أو HERMES_DASHBOARD_PUBLIC_URL) مضيفاً غير loopback، حتى مع وجود الواجهة الخلفية على loopback. لذلك يفعّل الإعداد أعلاه البوابة، وترفض لوحة المعلومات بدء التشغيل إلى أن تهيئ موفراً. اترك public_url غير مضبوط، فتبقى البوابة معطلة، لكن Reverse Proxy وحده لا يحدد من يُسمح له بالدخول. تتحقق لوحة المعلومات أيضاً من الرأس Host. في إعداد loopback هذا، تقبل الإصدارات الحالية أسماء loopback والمضيف الذي يعلنه public_url، وتجيب عن أي قيمة أخرى بالرمز 400. لا يقبل v2026.8.3 المثبت هنا إلا أسماء loopback، ولا يفحص public_url مطلقاً. يمرر Caddy قيمة Host التي أرسلها المتصفح دون تغيير، ولذلك يُرفض المقطع أعلاه من دون public_url ولا تُعرض خدمته. يكمن الخطر في Reverse Proxy يعيد كتابة Host إلى عنوان الواجهة الخلفية. يفعل nginx ذلك افتراضياً، إذ يرسل الهدف proxy_pass ما لم تضبط proxy_set_header Host بنفسك. ويمر الطلب عندها من الفحص ويصل إلى لوحة معلومات بلا تسجيل دخول. يضيف WebSocket الخاص بالطرفية فحص Origin: في الإصدار المثبت، يجب أن يستهدف رأس Origin، عند وجوده، المضيف المرتبط. يمنع ذلك متصفحاً على اسم مضيفك العام، لكن أي برنامج نصي لا يرسل Origin يتجاوز هذا الفحص. أياً كان ما ضبطته، تحقق مما نشرته فعلياً:

curl -s https://hermes.example.com/api/status | jq '.auth_required'

إذا طبع ذلك false، فلن يفصل الإنترنت عن طرفية على خادمك سوى عنوان URL واحد. لا توجد ثغرة مستغلة، ولن يسجل شيء في السجلات. وإذا فشل الطلب بالرمز 400 بدلاً من ذلك، فقد رفض فحص Host الطلب. في إصدار يدعم أسماء المضيفين العامة، أصلح ذلك بضبط public_url وموفر لتسجيل الدخول، لا بإعادة كتابة الرؤوس للتحايل على الفحص. على v2026.8.3، استخدم مسار IP المباشر للشبكة المتداخلة أو قم بالترقية أولاً. هناك طريقتان لإصلاح لوحة معلومات مفتوحة، ويجب أن تستخدم واحدة منهما على الأقل. إما أن تضع المصادقة في Reverse Proxy، باستخدام Authentik كموفر تسجيل دخول موحد مستضاف ذاتياً أمامه عبر forward auth، أو تهيئ موفر OIDC (OpenID Connect) الخاص بلوحة المعلومات:

HERMES_DASHBOARD_OIDC_ISSUER=https://auth.example.com/application/o/hermes/
HERMES_DASHBOARD_OIDC_CLIENT_ID=hermes-dashboard
HERMES_DASHBOARD_OIDC_SCOPES="openid profile email"

حتى عند تنفيذ هذا الخيار بصورة صحيحة، توجد حدود لا يمكنك خفضها. صفحة تسجيل دخول عامة هي صفحة يمكن لأي شخص الوصول إليها ومهاجمتها، وخلفها shell على VPS. اسم المستخدم وكلمة المرور حماية ضعيفة في هذه الحالة، ولذلك توصي الوثائق باستخدام OAuth أو OIDC عند الربط العام. طبّق حدّاً لمعدل محاولات تسجيل الدخول، وأبقِ ufw مغلقاً أمام كل شيء باستثناء منافذ Reverse Proxy وSSH، واقرأ access log من وقت إلى آخر.

الخيار 3: استخدام SSH و mosh من محطة طرفية على الهاتف

الطريقة الأقل جهداً: ثبّت تطبيق محطة طرفية (terminal) على هاتفك، وحمّل مفتاح SSH عليه، واستخدم واجهة النصوص الخاصة بالوكيل (agent).

ssh you@vps.example.com
tmux new -A -s phone
hermes --tui

يقوم tmux new -A -s phone بالاتصال بجلسة تحمل الاسم phone، أو ينشئها إذا لم تكن موجودة، مما يضمن استمرار عمل الوكيل عند انقطاع الاتصال، لتجد نفسك في نفس المكان عند العودة. هذا النمط هو نفسه المستخدم في تشغيل Claude Code من الهاتف.

استخدام SSH العادي عبر شبكة الهاتف المحمول غير مريح، لأن الاتصال ينقطع كلما تغير عنوان الهاتف أو دخل في وضع السكون. يحل mosh هذه المشكلة. يعمل mosh عبر بروتوكول UDP (بروتوكول حزم بيانات المستخدم) ويقوم بمزامنة حالة المحطة الطرفية بدلاً من تدفق البايتات، لذا تظل الجلسة قائمة عند الانتقال من شبكة Wi-Fi إلى شبكة البيانات الخلوية:

sudo apt install -y mosh
sudo ufw allow 60000:61000/udp

من الهاتف، شغّل mosh you@vps.example.com. يبدأ mosh تشغيل mosh-server عبر جلسة SSH الحالية، ثم ينقل الجلسة إلى منفذ UDP بين 60000 و 61000، ولهذا السبب يجب فتح هذا النطاق. تحتاج كل جلسة إلى منفذ خاص بها فقط، لذا في الخوادم التي تحتوي على عدد قليل من الجلسات المتزامنة، يمكنك فتح نطاق أصغر، مثل 60000 إلى 60010 بدلاً من ذلك.

التكلفة الأمنية هي التكلفة المعتادة. جلسة SSH هي عبارة عن shell، والـ shell تمنحك كل صلاحيات الحساب. تصبح مطالبات الموافقة الخاصة بالوكيل هي خط الدفاع الأخير بين هاتف مفتوح ومسروق وبين ملفاتك. استخدم حساباً مخصصاً غير حساب root لهذا الغرض، واعتمد على المفاتيح فقط، واعمل على تأمين SSH على خادم VPS قبل وضع أي مفتاح على جهاز تحمله معك.

ما الذي يتعطل على شبكة الهاتف المحمول

تتعطل أربعة أمور، ولا يمكن إصلاح أي منها بتغيير إعدادات قابلة للضبط.

تسجّل لوحة المعلومات خروجك بينما لا تنظر إليها. يعتمد توقيت ذلك على موفّر تسجيل الدخول. يصدر موفّر اسم المستخدم وكلمة المرور رمز وصول صالحاً لمدة 12 ساعة افتراضياً، وتحدده session_ttl_seconds ضمن dashboard.basic_auth، لكن هذه القيمة تتحكم فقط في معدل تحديث لوحة المعلومات في الخلفية، ولا تحدد مدة بقائك مسجلاً للدخول. ينشئ كل تحديث رمز تحديث جديداً صالحاً لمدة 30 يوماً، لذلك يستمر تسجيل الدخول باستخدام كلمة المرور إلى أن تمر 30 يوماً من دون تحديث. تؤدي إعادة تشغيل الواجهة الخلفية أيضاً إلى إنهاء الجلسة إذا لم تُضبط قيمة سر توقيع ثابتة عبر HERMES_DASHBOARD_BASIC_AUTH_SECRET أو dashboard.basic_auth.secret، لأن Hermes ينشئ عندئذ مفتاح توقيع جديداً في كل مرة يبدأ فيها. يصدر موفّر OAuth في Nous Portal رموز وصول ذات مدة صلاحية TTL تبلغ 15 دقيقة، ويجددها في الخلفية باستخدام رمز تحديث يتغير عند كل استخدام، لذلك لا يعيدك انتهاء صلاحية رمز الوصول وحده إلى /login. ما يعيدك هو فقدان جلسة التحديث. في الإصدارات السابقة للإصدار v0.21.3 (الوسم v2026.9.14، المنشور في 14 September 2026)، كان الهاتف عند عودته من الخلفية قد يرسل عدة طلبات في الوقت نفسه، ويعيد استخدام رمز التحديث الذي تغيّر للتو، فيفعّل آلية اكتشاف إعادة الاستخدام لدى الموفّر وتُلغى الجلسة بأكملها، فتعود إلى شاشة تسجيل الدخول وقد يختفي كل ما كنت تكتبه. يجعل الإصدار v0.21.3 هذه الطلبات تستخدم عملية تحديث واحدة مشتركة، وعلى جانب Nous Portal تمتد الآن مدة جلسة التحديث البالغة 30 يوماً في كل مرة يتغير فيها الرمز، مع أن مرور 30 يوماً من الخمول ينهي الجلسة. إذا بقيت على v2026.8.3 المثبّت أعلى هذه الصفحة، فتوقع تسجيل خروج إجباري أحياناً. لا يوجد عطل. سجّل الدخول مرة أخرى.

لا تصمد الطرفية المضمّنة أمام علامة تبويب في الخلفية افتراضياً. تنشئ طريقة اتصال الطرفية الموثقة في لوحة المعلومات واجهة TUI (واجهة مستخدم نصية) خلف PTY، وتنهيها بطريقة سليمة عند إغلاق علامة التبويب، ويؤدي فتحها مرة أخرى إلى إنشاء واجهة جديدة. تتخلص متصفحات الهاتف المحمول من علامات التبويب الموجودة في الخلفية لتحرير الذاكرة، لذلك يؤدي الانتقال إلى تطبيق آخر مدة كافية إلى إنهاء تلك الطرفية. تبقى محفوظات المحادثة آمنة، لأن الجلسات مخزنة على الخادم، وما زال hermes sessions list يعرضها. ويدعم الخادم المثبّت أيضاً اتصالاً اختيارياً للحفاظ على الجلسة نشطاً باستخدام رمز مرفق، ويحتفظ بـ PTY منفصل لمدة 30 دقيقة. إذا كنت تحتاج إلى جلسة تصمد، فاستخدم tmux عبر SSH.

تنقطع الاتصالات الخاملة بصمت. تسقط شركات الاتصالات المحمولة اتصالات TCP الخاملة لتحرير إدخالات جدول NAT (ترجمة عناوين الشبكة)، ويتوقف الهاتف عن خدمة الشبكة تقريباً بالكامل عند إطفاء الشاشة. تكون WebSocket التي ظلت صامتة فترة من الوقت قد انقطعت عادةً عند فتح القفل، ولا تعيد الصفحة الاتصال إلا بعد لمسها. لهذا يبدو mosh أفضل من SSH على الهاتف: فهو لم يكن يعتمد على اتصال يمكن فقدانه.

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

تصل الإشعارات عبر بوابة المراسلة

الحل للمشكلة الأخيرة هو البوابة، وهي طريقة مختلفة تماماً للوصول إلى الوكيل. يربط hermes gateway الوكيل بمنصات المراسلة، ومنها Telegram وDiscord وSlack وWhatsApp وSignal والبريد الإلكتروني. بعد ذلك تتحدث إلى وكيلك داخل تطبيق يملك قناة دفع على هاتفك، ويتولى التسليم في الخلفية، ويتعامل مع انقطاع الشبكة.

hermes gateway setup
hermes gateway install
hermes gateway status

يسجّل hermes gateway install البوابة كخدمة systemd، لذلك تعود إلى العمل بعد إعادة التشغيل. يمكن لمرحلة البوابة في برنامج التثبيت تنفيذ هذه الخطوة نيابةً عنك، لكن برنامج التثبيت لا ينشئ وحدة لـ hermes dashboard، لذلك لن تعود لوحة المعلومات إلى العمل تلقائياً بعد إعادة التشغيل. أنشئ وحدة للأجزاء التي تعتمد عليها، ويشرح إنشاء خدمات ومؤقتات systemd على VPS ملف الوحدة نفسه.

يمكن لمهمة مجدولة دفع نتيجة بالطريقة نفسها، من دون الحاجة إلى محادثة:

hermes send -t telegram -s "Backup report" -f /home/you/report.txt

التفويض هنا يرفض الوصول افتراضياً. عند عدم ضبط قائمة سماح أو اقتران معتمد، ومع كون GATEWAY_ALLOW_ALL_USERS غير مضبوط، يُرفض كل مستخدم، وهذا هو الإعداد الابتدائي الصحيح. سمِّ الحسابات التي تريد السماح لها في ~/.hermes/.env:

TELEGRAM_ALLOWED_USERS=123456789
GATEWAY_ALLOWED_USERS=123456789

أو استخدم الاقتران القائم على رمز بدلاً من لصق المعرّفات الرقمية. هذا هو الإعداد الافتراضي لمنصات الرسائل الخاصة التي تعتمد أسلوب الدردشة، ويمكنك ضبطه صراحةً باستخدام unauthorized_dm_behavior: pair في ~/.hermes/config.yaml. يتلقى الحساب غير المعروف الذي يرسل رسالة إلى الوكيل رمزاً مؤلفاً من ثمانية أحرف، ولا يحدث أي شيء آخر حتى توافق عليه:

hermes pairing list
hermes pairing approve telegram ABC12DEF
hermes pairing revoke telegram 123456789

تنتهي صلاحية الرموز بعد ساعة، ويمكن للمستخدم طلب رمز واحد كل عشر دقائق، وتؤدي خمس محاولات فاشلة إلى منع ذلك الحساب من الوصول.

الحد من نطاق الضرر الناتج عن سرقة هاتف

الهاتف الذي يمكنه الوصول إلى وكيلك هو هاتف يمكنه تنفيذ أوامر على خادمك، والهواتف تضيع. حدّد الآن ما يستطيع الشخص الذي يحمله فعله.

أبقِ الموافقات مفعّلة. تكون approvals.mode مضبوطة افتراضياً على smart، ما يطلب من نموذج مساعد تقييم المخاطر والموافقة تلقائياً على الأوامر منخفضة المخاطر فقط. ضبطها على off يعادل تشغيل كل شيء باستخدام --yolo، بينما تنفّذ HERMES_YOLO_MODE=1 الأمر نفسه عبر البيئة. لا تحمل هاتفاً يتصل بوكيل وهو في هذه الحالة. اضبط approvals.cron_mode: deny حتى لا تتمكن المهام المجدولة من الموافقة على نفسها أثناء نومك.

approvals:
  mode: smart
  cron_mode: deny

امنح الوكيل نطاقاً أصغر يمكنه إتلافه. تشغّل terminal.backend: docker الأوامر داخل حاوية تسقط جميع قدرات Linux باستثناء قائمة قصيرة، وتضبط no-new-privileges، وتضع حداً لعدد العمليات، بحيث تصبح الحاوية هي الحد الفاصل بدلاً من المطالبة. تثبّت terminal.cwd دليل العمل. وتقيّد HERMES_WRITE_SAFE_ROOT كلاً من write_file وpatch بالدلائل التي تحددها، ويُحظر أيّ كتابة خارجها من دون إتاحة موافقة تتجاوز هذا الحظر.

export HERMES_WRITE_SAFE_ROOT=/home/you/projects:/home/you/.hermes

يحظر Hermes مسبقاً الكتابة إلى ~/.ssh و~/.aws و~/.kube و/etc/sudoers، وإلى مخازن أسراره مثل ~/.hermes/.env. وتُحظر قراءة ملفات .env الخاصة بالمشروع من أي مكان آخر على القرص، لكنها تظل قابلة للكتابة. كما يرفض قائمة صارمة من الأوامر المدمّرة مهما كانت إعدادات الموافقة لديك. اعتبر ذلك حداً أدنى، لا خطتك الأمنية. شغّل الوكيل كمستخدم عادي، وليس كـroot. ينطبق المنطق نفسه على أي وكيل برمجي يظل قيد التشغيل دون مراقبة، ويشرح تشغيل Claude Code بأمان على VPS هذا الأمر بمزيد من التفصيل.

اكتب بعد ذلك خطوات إلغاء الصلاحيات قبل أن تحتاج إليها. تؤدي إزالة الجهاز من وحدة تحكم إدارة Tailscale إلى قطع الوصول إلى الشبكة المتداخلة فوراً. يؤدي تغيير HERMES_DASHBOARD_BASIC_AUTH_SECRET وإعادة التشغيل إلى إبطال كل جلسات لوحات المعلومات التي تستخدم موفّر كلمات المرور على جميع الأجهزة، لأن هذه القيمة توقّع رموز جلسة الموفّر. يؤدي حذف المفتاح العام للهاتف من ~/.ssh/authorized_keys إلى حظر عمليات تسجيل الدخول الجديدة عبر SSH باستخدام هذا المفتاح؛ أنهِ جلسات SSH وmosh الحالية بشكل منفصل. يزيل hermes pairing revoke telegram <user-id> حساب مراسلة. إذا كان الجهاز يحتوي على أي شيء يمكنه قراءة مفاتيح الموفّر لديك، فأبطِلها باستخدام hermes auth logout <provider> وأصدر مفاتيح جديدة من الموفّر.

تحقق من النتيجة بدلاً من افتراضها. هذه أوامر تشغّلها على جهازك، وما تطبعه يعتمد على إعداداتك:

tailscale status
hermes pairing list
hermes logs gateway -n 100
hermes status --deep

توجد السجلات ضمن ~/.hermes/logs/. اقرأها بعد وقوع حادث، واقرأها أحياناً حتى عندما لا يكون قد وقع حادث.

FAQ

هل يوجد تطبيق Hermes رسمي للهواتف على iOS أو Android؟

لا. يتضمن مستودع Hermes واجهة سطر أوامر، ولوحة تحكم ويب، وعميل سطح مكتب مبنياً على Electron لأنظمة macOS وWindows وLinux. لا توجد بنية رسمية من الطرف الأول لنظامي iOS أو Android. من الهاتف، استخدم لوحة تحكم الويب في متصفح، أو عميل SSH، أو منصة مراسلة متصلة عبر hermes gateway. توجد أيضاً عملاء للهواتف من جهات خارجية، لكنها شيفرة خارجية تحتفظ ببيانات اعتماد وكيلك، لذلك اقرأ الشيفرة قبل تثبيت أي منها.

لماذا تسجّل لوحة تحكم Hermes خروجي من الحساب على الهاتف؟

يعتمد ذلك على موفّر تسجيل الدخول. يصدر موفّر OAuth في Nous Portal رموز وصول مدة صلاحيتها 15 دقيقة، ويجددها في الخلفية باستخدام رمز تحديث متناوب، لذلك لا يعيدك انتهاء صلاحية رمز الوصول وحده إلى /login. في الإصدارات السابقة لـ v0.21.3 (الوسم v2026.9.14)، كان الهاتف العائد من الخلفية قد يرسل عدة طلبات في الوقت نفسه، ويعيد استخدام رمز التحديث الذي جرى تدويره للتو، فيؤدي ذلك إلى إبطال الجلسة بأكملها، وهو ما يفرض تسجيل الدخول مجدداً. يعالج v0.21.3 هذه المشكلة، كما تنتهي صلاحية جلسة التحديث التي تظل خاملة لمدة 30 يوماً. يعيّن موفّر اسم المستخدم وكلمة المرور رمز وصول افتراضياً مدة صلاحيته 12 ساعة، ويحدده session_ttl_seconds، ولا يتحكم ذلك إلا في معدل تحديث لوحة التحكم في الخلفية. يجدد الموفّر الرمز باستخدام رمز تحديث مدته 30 يوماً، ويُصدِر رمزاً جديداً عند كل تحديث، لذلك لا ينتهي تسجيل الدخول بكلمة المرور بعد 12 ساعة. مع هذا الموفّر، عيّن HERMES_DASHBOARD_BASIC_AUTH_SECRET إلى قيمة عشوائية ثابتة. من دون سر ثابت في هذا المتغير أو في dashboard.basic_auth.secret، ينشئ Hermes مفتاح توقيع جديداً عند كل تشغيل، وتخرج من الحساب بعد كل إعادة تشغيل.

هل يمكنني وضع لوحة تحكم Hermes على الإنترنت العام بأمان؟

فقط إذا تحققت بنفسك من المصادقة. تُفعَّل بوابة المصادقة وفقاً لعنوان الربط، وفي الإصدارات الحالية أيضاً عندما يحدد dashboard.public_url مضيفاً غير محلي، لذلك فإن لوحة تحكم مرتبطة بـ127.0.0.1 خلف reverse proxy من دون تعيين URL عام لا تطلب تسجيل الدخول. في الإصدار v2026.8.3، لا يؤدي تعيين public_url إلى تفعيل بوابة المصادقة المحلية، ولا يسمح باسم مضيف عام عبر فحوصات Host وWebSocket Origin. استخدم مسار عنوان IP المباشر للشبكة الخاصة، أو حدّث Hermes إلى إصدار يدعم أسماء المضيفين العامة قبل اتباع إعداد وكيل HTTPS. يرفض فحص Host الوكيل الذي يمرر اسم مضيفك العام، لكنه لا يرفض الوكيل الذي يعيد كتابة Host إلى عنوان الواجهة الخلفية، كما يفعل nginx افتراضياً. شغّل curl -s https://your-host/api/status | jq '.auth_required' واقرأ النتيجة. استخدم OAuth أو OIDC بدلاً من اسم المستخدم وكلمة المرور، لأن وثائق المشروع تذكر أن موفّر كلمة المرور مخصص للشبكات الموثوقة وشبكات VPN. تتجنب الشبكة الخاصة هذه المشكلة بالكامل، ولذلك فهي الخيار الافتراضي الأفضل.

هل أحتاج إلى حساب Tailscale، أم يمكنني استضافة مستوى التحكم بنفسي؟

يمكنك استضافته بنفسك. Headscale هو تنفيذ مفتوح لخادم تنسيق Tailscale، وتتصل به عملاء Tailscale الرسميون باستخدام tailscale up --login-server https://headscale.example.com. عندئذٍ تصبح مسؤولاً عن قائمة الأجهزة المسموح لها بالدخول إلى الشبكة الخاصة. وتتمثل الكلفة في أنك ستشغّل هذا الخادم وتنسخ بياناته احتياطياً، كما لن تتمكن أثناء توقفه من تسجيل جهاز أو إعادة مصادقته.

كيف أتلقى إشعاراً على هاتفي عندما ينهي الوكيل مهمة؟

استخدم بوابة المراسلة. لا تملك لوحة التحكم وSSH وسيلة لإيقاظ الهاتف، لأنه لا يوجد تطبيق Hermes على الجهاز لاستقبال إشعار دفع. صِل الوكيل بـTelegram أو Signal أو Discord أو منصة أخرى مدعومة باستخدام hermes gateway setup، ثم دع تطبيق تلك المنصة يرسل الإشعار. ويمكن لمهمة cron أيضاً إرسال رسالة واحدة باستخدام hermes send -t telegram -s "Job done" -f /path/to/report.txt، وتُسلَّم الرسالة من دون استدعاء النموذج.

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