اكتشاف Bonjour

​

Bonjour واسع النطاق (DNS-SD أحادي الإرسال) عبر Tailscale

1. شغّل خادم DNS على مضيف Gateway بحيث يمكن الوصول إليه عبر Tailnet.
2. انشر سجلات DNS-SD لـ _openclaw-gw._tcp ضمن منطقة مخصصة (مثال: openclaw.internal.).
3. هيّئ DNS المقسّم في Tailscale بحيث يُحل النطاق الذي اخترته عبر خادم DNS هذا للعملاء، بما في ذلك iOS.

​

إعدادات Gateway

{
  gateway: { bind: "tailnet" }, // للشبكة الطرفية فقط (موصى به)
  discovery: { wideArea: { enabled: true, domain: "openclaw.internal" } },
}

​

إعداد خادم DNS لمرة واحدة (مضيف Gateway، على macOS فقط)

openclaw dns setup --apply

• الاستماع على المنفذ 53 على واجهات Tailscale الخاصة بـ Gateway فقط
• خدمة النطاق الذي اخترته (مثال: openclaw.internal.) من ~/.openclaw/dns/<domain>.db

dns-sd -B _openclaw-gw._tcp openclaw.internal.
dig @<TAILNET_IPV4> -p 53 _openclaw-gw._tcp.openclaw.internal PTR +short

​

إعدادات DNS في Tailscale

• أضف خادم أسماء يشير إلى عنوان IP الخاص بـ Tailnet لـ Gateway ‏(UDP/TCP 53).
• أضف DNS مقسّمًا بحيث يستخدم نطاق الاكتشاف خادم الأسماء هذا.

​

أمان مستمع Gateway

​

ما الذي يُعلَن عنه

​

أنواع الخدمات

• _openclaw-gw._tcp - منارة نقل Gateway، تستخدمها عُقد macOS/iOS/Android.

​

مفاتيح TXT (تلميحات غير سرية)

• سجلات TXT الخاصة بـ Bonjour/mDNS غير موثّقة. يجب ألا يتعامل العملاء مع TXT بوصفه مرجعًا موثوقًا للتوجيه.
• ينبغي للعملاء إجراء التوجيه باستخدام نقطة نهاية الخدمة التي جرى حلها (SRV + A/AAAA). تعامل مع lanHost وtailnetDns وgatewayPort وgatewayTlsSha256 كتلميحات فقط.
• ينبغي كذلك للاستهداف التلقائي عبر SSH استخدام مضيف الخدمة الذي جرى حله، وليس تلميحات TXT وحدها.
• يجب ألا يسمح تثبيت TLS مطلقًا لقيمة gatewayTlsSha256 مُعلنة بتجاوز تثبيت محفوظ سابقًا.
• ينبغي لعُقد iOS/Android التعامل مع الاتصالات المباشرة المستندة إلى الاكتشاف على أنها مقصورة على TLS، وطلب تأكيد صريح من المستخدم قبل الوثوق ببصمة لأول مرة.

​

تصحيح الأخطاء على macOS

# تصفح المثيلات
dns-sd -B _openclaw-gw._tcp local.

# حل مثيل واحد (استبدل <instance>)
dns-sd -L "<instance>" _openclaw-gw._tcp local.

​

تصحيح الأخطاء في سجلات Gateway

• bonjour: advertise failed ...
• bonjour: suppressing ciao netmask assertion ...
• bonjour: ... name conflict resolved / hostname conflict resolved

​

تصحيح الأخطاء على Node بنظام iOS

​

متى ينبغي تفعيل Bonjour

openclaw plugins enable bonjour

​

متى ينبغي تعطيل Bonjour

OPENCLAW_DISABLE_BONJOUR=1

openclaw plugins disable bonjour

​

محاذير Docker

• يبدأ Bonjour تلقائيًا على مضيفي macOS ويتطلب التفعيل الاختياري في الأنظمة الأخرى. لا يؤدي تركه معطّلًا إلى إيقاف Gateway — بل يتخطى فقط إعلان البث المتعدد داخل الشبكة المحلية.
• لا يؤدي تعطيل Bonjour إلى تغيير gateway.bind؛ إذ يظل Docker يستخدم OPENCLAW_GATEWAY_BIND=lan افتراضيًا حتى يعمل منفذ المضيف المنشور.
• لا يؤدي تعطيل Bonjour إلى تعطيل DNS-SD واسع النطاق. استخدم الاكتشاف واسع النطاق أو Tailnet عندما لا يكون Gateway والـ Node على الشبكة المحلية نفسها.
• لا تؤدي إعادة استخدام OPENCLAW_CONFIG_DIR نفسها خارج Docker إلى استمرار سياسة التعطيل التلقائي للحاوية.
• عيّن OPENCLAW_DISABLE_BONJOUR=0 فقط لشبكات المضيف أو macvlan أو شبكة أخرى يُعرف أن بث mDNS المتعدد يمر عبرها؛ وعيّنها إلى 1 لفرض التعطيل.

​

استكشاف أخطاء Bonjour المعطّل وإصلاحها

1. تحقق مما إذا كان Gateway يعمل في الوضع التلقائي أو وضع التشغيل القسري أو وضع الإيقاف القسري:
   docker compose config | grep OPENCLAW_DISABLE_BONJOUR
   
2. تحقق من إمكانية الوصول إلى Gateway نفسه عبر المنفذ المنشور:
   curl -fsS http://127.0.0.1:18789/healthz
   
3. استخدم هدفًا مباشرًا عند تعطيل Bonjour:
   • واجهة التحكم أو الأدوات المحلية: http://127.0.0.1:18789
   • عملاء الشبكة المحلية: http://<gateway-host>:18789
   • العملاء عبر الشبكات: Tailnet MagicDNS أو عنوان IP لـ Tailnet أو نفق SSH أو DNS-SD واسع النطاق
4. إذا فعّلت Plugin ‏Bonjour عمدًا في Docker وفرضت الإعلان باستخدام OPENCLAW_DISABLE_BONJOUR=0، فاختبر البث المتعدد من المضيف:
   dns-sd -B _openclaw-gw._tcp local.
   
   إذا كان التصفح فارغًا، أو أظهرت سجلات Gateway إخفاقات متكررة في استقصاء ciao، فأعد OPENCLAW_DISABLE_BONJOUR=1 واستخدم مسارًا مباشرًا أو عبر Tailnet.

​

أوضاع الفشل الشائعة

• لا يتجاوز Bonjour حدود الشبكات: استخدم Tailnet أو SSH.
• البث المتعدد محظور: تعطّل بعض شبكات Wi-Fi بروتوكول mDNS.
• توقّف المعلِن في مرحلة الاستقصاء/الإعلان: قد تؤدي الأجهزة المضيفة التي يُحظر فيها البث المتعدد، أو جسور الحاويات، أو WSL، أو التغيّرات المتكررة في الواجهات إلى إبقاء المستجيب في حالة غير معلَنة. يظل Gateway متاحًا عبر المسارات المباشرة أو SSH أو Tailnet أو DNS-SD واسع النطاق؛ عطّل Bonjour للشبكة المحلية باستخدام discovery.mdns.mode: "off" أو OPENCLAW_DISABLE_BONJOUR=1 عندما لا يكون البث المتعدد متاحًا.
• شبكات جسور Docker: يُعطَّل Bonjour تلقائيًا داخل الحاويات المكتشفة. اضبط OPENCLAW_DISABLE_BONJOUR=0 فقط للشبكة المضيفة أو macvlan أو شبكة أخرى تدعم mDNS.
• السكون/التغيّرات المتكررة في الواجهات: قد يُسقط macOS نتائج mDNS مؤقتًا؛ أعد المحاولة.
• يعمل التصفح لكن تفشل عملية الحل: أبقِ أسماء الأجهزة بسيطة (تجنّب الرموز التعبيرية أو علامات الترقيم)، ثم أعد تشغيل Gateway. يُشتق اسم مثيل الخدمة من اسم المضيف، لذا قد تربك الأسماء شديدة التعقيد بعض أدوات الحل.

​

أسماء المثيلات المُهَرَّبة (\032)

​

التمكين / التعطيل / الإعداد

​

مستندات ذات صلة

• سياسة الاكتشاف واختيار وسيلة النقل: الاكتشاف
• إقران Node والموافقات: إقران Gateway