الوثائق

نظرة عامة

AntminerTools هي لوحة تحكّم سحابية لأجهزة التعدين Bitmain Antminer. تشغّل وكيل ربط (Connector Agent) صغيرًا على أي حاسوب أو Raspberry Pi على شبكة مزرعتك؛ ويُنشئ اتصالًا صادرًا آمنًا إلى سحابتنا ويمرّر الأوامر إلى أجهزة التعدين لديك. ومن متصفحك أو هاتفك تحصل بعدها على hashrate مباشر ودرجات حرارة وتنبيهات وإعادة تشغيل عن بُعد وربحية والمزيد — دون فتح أي منفذ على شبكتك.

الأجزاء الثلاثة:

• أجهزة التعدين لديك — تبقى على شبكتك المحلية (LAN) الخاصة، دون مساس، تعمل ببرنامج Bitmain الثابت الأصلي.
• وكيل الربط (Connector Agent) — برنامج خفيف على حاسوب/Pi المزرعة يتحدث إلى أجهزة التعدين لديك محليًا ويُنشئ نفقًا للخارج إلى السحابة.
• Dashboard — حيث تراقب كل شيء وتتحكّم فيه، من أي جهاز.

البدء

1. أنشئ حسابًا مجانيًا على antminertools.com/register.
2. أنشئ مزرعة — انتقل إلى Dashboard ← المزارع ← «+ مزرعة جديدة». تمثّل المزرعة موقعًا فعليًا واحدًا. تحصل كل مزرعة على رمزها الآمن الخاص.
3. نزّل الوكيل (Agent) — اضغط «⬇ Agent» على بطاقة المزرعة، ثم «📦 نزّل حزمة الوكيل ZIP». تأتي مُعدّة مسبقًا لتلك المزرعة.
4. شغّل الوكيل (Agent) على أي حاسوب أو Raspberry Pi على الشبكة نفسها التي تعمل عليها أجهزة التعدين (التفاصيل أدناه). تتحوّل بطاقة المزرعة إلى ● متصل خلال ثوانٍ.
5. افحص الشبكة — اضغط «🔍 افحص» وأضف أجهزة التعدين التي يعثر عليها.

وكيل الربط (Connector Agent)

الوكيل (Agent) برنامج خفيف واحد. يتحدث إلى أجهزة التعدين لديك عبر الشبكة المحلية (واجهة ويب Bitmain) ويحافظ على اتصال صادر مشفّر واحد بـ AntminerTools. لا يقبل أبدًا اتصالات واردة، فلا يوجد ما يُوجَّه منفذه ولا شيء مكشوف للإنترنت.

التثبيت على Windows

1. فك ضغط المجلد المُنزَّل في أي مكان (مثل سطح المكتب).
2. انقر نقرًا مزدوجًا على START_AGENT.bat.
3. يُثبَّت Python والمكتبات المطلوبة تلقائيًا في المرة الأولى. أبقِ النافذة مفتوحة — أو دعه يعمل في الخلفية؛ فهو يُعاد تشغيله عند كل تسجيل دخول.

التثبيت على Linux / Raspberry Pi

cd AntminerTools-Agent-YourFarm
python3 antminer_agent.py

يلزم Python 3.8+ (مثبّت مسبقًا على Raspberry Pi OS). تُثبَّت الاعتماديات تلقائيًا.

البدء التلقائي عند إعادة الإقلاع

يثبّت الوكيل (Agent) نفسه ليبدأ تلقائيًا بعد إعادة الإقلاع — مجلد بدء التشغيل على Windows، وخدمة systemd (أو مهمة cron @reboot) على Linux وRaspberry Pi. إذا فقد حاسوب المزرعة الطاقة أو أُعيد تشغيله، يعود الوكيل (Agent) وحده.

التحديثات التلقائية

عندما نطلق إصدارًا جديدًا، تنزّله الوكلاء (Agents) العاملة وتتحقق منه وتحتفظ بنسخة احتياطية وتحافظ على رمزك وتعيد التشغيل إلى الإصدار الجديد — فلن تلمس حاسوب المزرعة مجددًا أبدًا. تُنظَّف الإصدارات القديمة تلقائيًا.

فحص الحالة

على حاسوب المزرعة يمكنك تشغيل python antminer_agent.py --status لمعرفة ما إذا كان متصلًا وإصداره ووقت تشغيله.

العثور على أجهزة التعدين لديك

بمجرد أن يُظهر الوكيل (Agent) متصل، اضغط «🔍 افحص» على بطاقة المزرعة. يكتشف AntminerTools شبكتك الفرعية تلقائيًا من الوكيل (Agent) ويفحصها بحثًا عن أجهزة Antminer.

• راقب العدّاد المباشر — «⛏ عُثر على 1… 2… 3…» — بينما يمسح كل عنوان IP.
• عند الانتهاء، تحصل على جدول بكل جهاز تعدين عُثر عليه: IP والطراز واسم worker (من pool) والرقم التسلسلي وعنوان MAC.
• أعد تسمية أيٍّ منها، ثم اضغط «➕ أضف كل الجديد» (أو أضف واحدًا في كل مرة).

يمكنك أيضًا إضافة جهاز تعدين يدويًا (أجهزة التعدين ← «+ أضف جهاز تعدين») إذا كان على شبكة فرعية مختلفة — فقط أدخِل IP والمنفذ وبيانات الدخول. بيانات دخول Antminer الافتراضية هي root / root.

المراقبة

تُحدَّث النظرة العامة كل 10 ثوانٍ وتعرض أسطولك بأكمله: أجهزة التعدين المتصلة/غير المتصلة، وإجمالي hashrate، وسحب الطاقة، وأعلى درجة حرارة، وسعر BTC، والإيراد والربح اليومي.

تفاصيل جهاز التعدين

انقر على أي جهاز تعدين لفتح صفحة تفاصيله: hashrate مباشر لـ 5 ثوانٍ و30 دقيقة، ومخطّط على مدى 24 ساعة، ودرجات حرارة الرقائق واللوحة المطبوعة (PCB) لكل سلسلة، وسرعات المراوح (أو اكتشاف التبريد المائي)، والطاقة، والكفاءة بوحدة J/TH، ووقت التشغيل، والبرنامج الثابت، والرقم التسلسلي، وحالة pool المباشرة مع الأنصبة المقبولة/المرفوضة.

عرض المزرعة

تعرض كل بطاقة مزرعة إجمالي hashrate والطاقة، إضافةً إلى شارة صحّة الحرارة: أخضر عادي، وكهرماني دافئ، وإنذار أحمر وامض 🔥 غير طبيعي إذا بلغ أي جهاز تعدين 85 °C. انقر على عدّاد أجهزة التعدين لفتح نافذة منبثقة مباشرة بكل جهاز تعدين في تلك المزرعة.

التحكّم عن بُعد

تحتوي صفحة تفاصيل كل جهاز تعدين على لوحة تحكّم:

• 🔄 إعادة تشغيل — أعد تشغيل جهاز تعدين متجمّد من أي مكان.
• ▶ عادي / 😴 نوم / 🚀 Turbo / 🌿 Eco — بدّل أوضاع العمل. النوم في ساعات الطاقة المكلفة، وEco لخفض الحرارة، وTurbo عندما تكون الأرباح مرتفعة.
• 💡 وميض LED — أومض الضوء للعثور على وحدة في الرف.
• 🔃 تحديث الإحصاءات — افرض استطلاعًا فوريًا.

لإعادة تشغيل الكثير دفعة واحدة، يفتح زر «🔄 إعادة التشغيل» على بطاقة المزرعة لوحةً تعرض hashrate الحالي لكل جهاز تعدين ومتوسط 24 ساعة ووقت آخر ظهور — أعد تشغيل واحدًا، أو أعد تشغيل الكل بنقرة واحدة.

التنبيهات والأتمتة

انتقل إلى التنبيهات ← «+ قاعدة جديدة». اختر مُشغّلًا وعتبة وإجراءً:

المُشغّلات

• 🌡️ الحرارة فوق العتبة (مثل 85 °C)
• ⚠️ هبوط hashrate إلى الصفر (تجمّد جهاز التعدين أو فقَد pool الخاص به)
• 📉 hashrate دون العتبة (لوحة تعدين متدهورة)
• 🔌 انقطاع اتصال جهاز التعدين

الإجراءات

• 📨 تنبيه فقط — يُسجَّل في صفحة التنبيهات لديك.
• 😴 نوم تلقائي — يُنوّم تلقائيًا جهاز تعدين محمومًا قبل أن يتلف لوحة تعدين.
• 🔄 إعادة تشغيل تلقائية — يعيد تشغيل جهاز تعدين عالق دون أي إجراء يدوي.

تنطبق القواعد على كل أجهزة التعدين لديك، وتُفحص عند كل استطلاع، ولها فترة تهدئة قابلة للضبط كي لا تُغرَق بالرسائل أبدًا. في خطة Unlimited، تُرسَل التنبيهات أيضًا إلى بريدك الإلكتروني.

سطح المكتب البعيد · خطة Unlimited

في خطة Unlimited، تعرض بطاقات المزارع المتصلة زر «🖥️ عن بُعد». اضغطه لفتح سطح المكتب الكامل لحاسوب مزرعتك مباشرةً في Dashboard — حرّك الفأرة، واكتب، وعدّل الإعدادات، وأعد تشغيل Windows — من أي مكان. يعمل عبر نفق الوكيل (Agent) نفسه، فما زال لا يوجد توجيه منافذ، ولا شيء إضافي لتثبيته.

• انقر واكتب للتحكّم في الحاسوب؛ استخدم زر Ctrl+Alt+Del عند الحاجة.
• على الهاتف، انقر للنقر واستخدم زر ⌨ مفاتيح للوحة المفاتيح على الشاشة.
• كل جلسة خاصة بحسابك وتنتهي عند إغلاقك النافذة؛ وتُسجَّل كل جلسة.

الربحية والعملة

في الإعدادات ← اقتصاديات التعدين، اختر عملة العرض (166 متاحة، تُحدَّث كل ساعة من أسعار الصرف المباشرة) وأدخِل سعر كهربائك ورسوم pool. عندئذٍ تعرض النظرة العامة الإيراد اليومي الحقيقي وتكلفة الكهرباء والربح — لكل يوم وأسبوع وشهر وسنة — إضافةً إلى سعر الكهرباء عند نقطة التعادل وتكلفة كل BTC مُعدّن، محسوبةً مباشرةً من صعوبة الشبكة وسعر BTC.

تتيح لك حاسبة الربحية تجربة سيناريوهات «ماذا لو» (سعر طاقة مختلف، أو أجهزة تعدين أكثر) دون تغيير إعداداتك المحفوظة.

الخطط والفوترة

الترقية

تُطبَّق الترقيات فورًا. قبل أي خصم يُعرَض لك المبلغ المُقسَّط بدقة ويُطلب منك التأكيد؛ وتُفتح حدودك الجديدة لحظة نجاح الدفع.

التخفيض

تُجدوَل التخفيضات لنهاية دورة الفوترة الحالية — تحتفظ بخطتك الحالية وكل ميزاتها حتى ذلك الحين، دون أي رسوم إضافية. تعرض صفحة الخطط التاريخ الدقيق وتشير إلى خطتك التالية. يمكنك إلغاء تخفيض مجدوَل في أي وقت بـ «أبقِ [الخطة الحالية]».

الدفع والسجل

تُعالَج المدفوعات بأمان عبر Stripe — لا تلمس بيانات البطاقة خوادمنا أبدًا. في صفحة الخطط يمكنك رؤية البطاقة المسجّلة وتحديثها، وعرض سجل طلباتك الكامل مع إيصالات قابلة للتنزيل. ألغِ في أي وقت؛ لا تُحذف أجهزة التعدين وسجلّها أبدًا عند تغيير الخطط.

الأمان

• نفق صادر فقط — يتصل الوكيل (Agent) للخارج عبر TLS (المنفذ نفسه لـ HTTPS). لا شيء على شبكتك يستمع للاتصالات الواردة.
• رموز لكل مزرعة — تُصادق كل مزرعة برمزها المُوقَّع الخاص الذي يمكنك إبطاله وإعادة توليده في أي وقت.
• بيانات اعتماد مشفّرة — تُشفَّر كلمات مرور أجهزة التعدين أثناء التخزين بـ AES-256-GCM ولا تُفكّ إلا في الذاكرة عند تمرير أمر.
• مرن — إعادة اتصال تلقائية مع تراجع زمني ونقاط مُرحّل متعددة مع تحوّل احتياطي تُبقي Dashboard حيًّا خلال تعثّرات مزوّد الخدمة وCDN.

أجهزة التعدين المدعومة

كل Bitmain Antminer يعمل ببرنامج ثابت أصلي مع واجهة الويب القياسية: S23، وعائلة S21 (بما فيها XP وHydro)، وعائلة S19، وT21، وL9، وL7، وKaspa KS5/KS7، وKA3 والمزيد. تحصل طرازات hydro وimmersion على معالجة خاصة لمستشعرات حرارة التبريد المائي واكتشاف انعدام المراوح. كما تعمل عادةً البرامج الثابتة من جهات خارجية التي تُبقي على واجهة API المتوافقة مع Bitmain.

استكشاف الأخطاء

المزرعة تظهر «غير متصل»

الوكيل (Agent) لا يعمل أو لا يستطيع الوصول إلى الإنترنت. على حاسوب المزرعة، تأكد من أن نافذة/خدمة الوكيل (Agent) تعمل (python antminer_agent.py --status)، وأن للحاسوب إنترنت. يعيد الوكيل (Agent) الاتصال تلقائيًا بمجرد عودة الاتصال.

الفحص لا يجد شيئًا

تحقق من أن الشبكة الفرعية تطابق أجهزة التعدين لديك (يكتشفها الفحص تلقائيًا، لكن يمكنك تحريرها)، وأن بيانات الدخول صحيحة (الافتراضي root/root). يجب أن يكون حاسوب الوكيل (Agent) على شبكة LAN نفسها لأجهزة التعدين.

جهاز تعدين يظهر غير متصل لكنه يعدّن

قد تكون واجهة الويب API الخاصة به غير قابلة للوصول أو تغيّرت بيانات الاعتماد. افتح IP جهاز التعدين مباشرةً على شبكة LAN للتأكد، وحدّث اسم المستخدم/كلمة المرور في AntminerTools عند الحاجة.

تعذّر حذف مزرعة

أوقِف الوكيل (Agent) على حاسوب تلك المزرعة أولًا، وانتظر نحو 90 ثانية حتى تُظهر البطاقة «غير متصل»، ثم احذف. يمنع هذا وكيلًا (Agent) لا يزال يعمل من الظهور مجددًا كشبح.

سطح المكتب البعيد لا يبدأ

يتطلب خطة Unlimited ووكيلًا (Agent) متصلًا. يثبّت أول تشغيل أداة مساعدة لالتقاط الشاشة (~15 ثانية). على Raspberry Pi بلا شاشة ودون سطح مكتب، لا يتوفّر سطح المكتب البعيد.

الأسئلة الشائعة

هل أحتاج إلى فتح منافذ أو استخدام VPN؟

لا. يُنشئ الوكيل (Agent) اتصالًا صادرًا فقط — ويعمل خلف أي راوتر أو CGNAT أو 4G/5G أو Starlink دون أي إعداد للشبكة.

هل يعمل على هاتفي؟

نعم — فـ Dashboard بأكمله متجاوب بالكامل. يمكنك المراقبة وتلقّي التنبيهات وإعادة تشغيل أجهزة التعدين وإدارة الفوترة وحتى استخدام سطح المكتب البعيد من هاتف.

كم مرة تُحدَّث الإحصاءات؟

كل 15 ثانية لكل جهاز تعدين متصل؛ ويحدّث Dashboard العرض كل 10 ثوانٍ.

هل توجد خطة مجانية؟

نعم — مزرعة واحدة وحتى 4 أجهزة تعدين مع مراقبة كاملة وتحكّم عن بُعد وتنبيهات في Dashboard. تضيف الخطط المدفوعة سعةً وميزات.

أما زلت عالقًا؟ أنشئ حسابًا وتواصل معنا من Dashboard، أو اقرأ المدوّنة للأدلة والنصائح.