مستندات

نمای کلی

AntminerTools یک Dashboard ابری برای ماینرهای Bitmain Antminer است. شما یک Connector Agent کوچک را روی هر PC یا Raspberry Pi در شبکه مزرعه‌تان اجرا می‌کنید؛ آن یک اتصال خروجی امن به ابر ما برقرار می‌کند و فرمان‌ها را به ماینرهای شما منتقل می‌کند. سپس از مرورگر یا موبایل خود hashrate زنده، دما، هشدارها، راه‌اندازی مجدد از راه دور، سودآوری و بیشتر را دریافت می‌کنید — بدون بازکردن حتی یک پورت در شبکه‌تان.

سه بخش:

• ماینرهای شما — روی LAN خصوصی شما، دست‌نخورده، با فرم‌ور اصلی Bitmain باقی می‌مانند.
• Connector Agent — یک برنامه سبک روی PC/Pi مزرعه که به‌صورت محلی با ماینرهای شما صحبت می‌کند و به بیرون به سمت ابر تونل می‌زند.
• Dashboard — جایی که همه‌چیز را از هر دستگاهی تماشا و کنترل می‌کنید.

شروع به کار

1. یک حساب رایگان بسازید در antminertools.com/register.
2. یک مزرعه بسازید — به Dashboard ← مزرعه‌ها ← «+ مزرعه جدید» بروید. یک مزرعه نماینده یک مکان فیزیکی است. هر مزرعه توکن امن مخصوص خود را می‌گیرد.
3. Agent را دانلود کنید — روی «⬇ Agent» روی کارت مزرعه کلیک کنید، سپس «📦 دانلود Agent ZIP». این از پیش برای آن مزرعه پیکربندی شده است.
4. Agent را اجرا کنید روی هر PC یا Raspberry Pi در همان شبکه ماینرهایتان (جزئیات در ادامه). کارت مزرعه ظرف چند ثانیه به ● متصل تغییر می‌کند.
5. شبکه را اسکن کنید — روی «🔍 اسکن» کلیک کنید و ماینرهایی را که پیدا می‌کند اضافه کنید.

Connector Agent

Agent یک برنامه سبک واحد است. آن با ماینرهای شما از طریق شبکه محلی (وب‌API Bitmain) صحبت می‌کند و یک اتصال خروجی رمزنگاری‌شده به AntminerTools را حفظ می‌کند. آن هرگز اتصالات ورودی را نمی‌پذیرد، بنابراین چیزی برای port-forward نیست و چیزی در معرض اینترنت قرار نمی‌گیرد.

نصب روی 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 خودش را برای اجرای خودکار پس از راه‌اندازی مجدد نصب می‌کند — پوشه Startup در Windows، و یک سرویس systemd (یا یک job با cron @reboot) روی Linux و Raspberry Pi. اگر PC مزرعه برق را از دست بدهد یا راه‌اندازی مجدد شود، Agent خودش برمی‌گردد.

به‌روزرسانی‌های خودکار

وقتی نسخه جدیدی منتشر می‌کنیم، Agentهای در حال اجرا آن را دانلود می‌کنند، تأیید می‌کنند، یک نسخه پشتیبان نگه می‌دارند، توکن شما را حفظ می‌کنند و به نسخه جدید راه‌اندازی مجدد می‌شوند — دیگر هرگز به PC مزرعه دست نمی‌زنید. نسخه‌های قدیمی به‌طور خودکار پاک می‌شوند.

بررسی وضعیت

روی PC مزرعه می‌توانید python antminer_agent.py --status را اجرا کنید تا ببینید متصل است یا نه، نسخه و زمان کارکرد آن را.

یافتن ماینرهای شما

به‌محض اینکه Agent وضعیت متصل را نشان داد، روی «🔍 اسکن» روی کارت مزرعه کلیک کنید. AntminerTools زیرشبکه شما را به‌طور خودکار از Agent تشخیص می‌دهد و آن را برای دستگاه‌های Antminer اسکن می‌کند.

• شمارنده زنده را تماشا کنید — «⛏ ۱ یافت شد… ۲… ۳…» — همان‌طور که هر IP را جاروب می‌کند.
• وقتی تمام شد، جدولی از هر ماینر یافت‌شده دریافت می‌کنید: IP، مدل، نام worker (از pool)، شماره سریال و MAC.
• هرکدام را می‌خواهید تغییر نام دهید، سپس روی «➕ افزودن همه موارد جدید» کلیک کنید (یا یکی‌یکی اضافه کنید).

همچنین می‌توانید یک ماینر را دستی اضافه کنید (ماینرها ← «+ افزودن ماینر») اگر روی زیرشبکه‌ای متفاوت است — کافی است IP، پورت و اطلاعات ورود آن را وارد کنید. ورود پیش‌فرض Antminer برابر root / root است.

پایش

نمای کلی هر ۱۰ ثانیه به‌روز می‌شود و کل ناوگان شما را نشان می‌دهد: ماینرهای آنلاین/آفلاین، hashrate کل، مصرف برق، بالاترین دما، قیمت BTC و درآمد و سود روزانه.

جزئیات ماینر

روی هر ماینر کلیک کنید تا صفحه جزئیات آن باز شود: hashrate زنده ۵ ثانیه‌ای و ۳۰ دقیقه‌ای، یک نمودار ۲۴ ساعته، دمای چیپ و PCB به تفکیک هر chain، سرعت فن‌ها (یا تشخیص خنک‌سازی آبی)، مصرف برق، بازده بر حسب J/TH، زمان کارکرد، فرم‌ور، شماره سریال و وضعیت زنده pool با share‌های پذیرفته‌شده/ردشده.

نمای مزرعه

هر کارت مزرعه hashrate و مصرف برق کل را نشان می‌دهد، به‌علاوه یک نشان سلامت دما: سبز عادی، کهربایی گرم، و یک هشدار قرمز چشمک‌زن 🔥 غیرعادی اگر هر ماینری به ۸۵ °C برسد. روی شمارنده ماینرها ضربه بزنید تا یک پاپ‌آپ زنده از هر ماینر آن مزرعه باز شود.

کنترل از راه دور

صفحه جزئیات هر ماینر یک پنل کنترل دارد:

• 🔄 راه‌اندازی مجدد — یک ماینر هنگ‌کرده را از هر کجا راه‌اندازی مجدد کنید.
• ▶ عادی / 😴 خواب / 🚀 Turbo / 🌿 Eco — تغییر حالت‌های کاری. خواب در ساعات گران برق، Eco برای کاهش گرما، Turbo زمانی که سود بالاست.
• 💡 چشمک LED — چراغ را روشن‌وخاموش کنید تا یک دستگاه را در رک پیدا کنید.
• 🔃 به‌روزرسانی آمار — یک poll فوری اجباری.

برای راه‌اندازی مجدد چند ماینر به‌طور همزمان، دکمه «🔄 راه‌اندازی مجدد» روی کارت مزرعه پنلی باز می‌کند با hashrate فعلی، میانگین ۲۴ ساعته و زمان آخرین مشاهده هر ماینر — یکی را راه‌اندازی مجدد کنید، یا راه‌اندازی مجدد همه را با یک کلیک انجام دهید.

هشدارها و خودکارسازی

به هشدارها ← «+ قانون جدید» بروید. یک تریگر، یک آستانه و یک اقدام انتخاب کنید:

تریگرها

• 🌡️ دما بالاتر از آستانه (مثلاً ۸۵ °C)
• ⚠️ افت hashrate به صفر (ماینر هنگ کرده یا pool خود را از دست داده)
• 📉 hashrate پایین‌تر از آستانه (هش‌بورد در حال افت)
• 🔌 ماینر آفلاین می‌شود

اقدامات

• 📨 فقط هشدار — در صفحه هشدارهای شما ثبت می‌شود.
• 😴 خواب خودکار — یک ماینر داغ‌شده را به‌طور خودکار به خواب می‌برد پیش از آنکه به هش‌بورد آسیب بزند.
• 🔄 راه‌اندازی مجدد خودکار — یک ماینر گیرکرده را بدون اقدام دستی راه‌اندازی مجدد می‌کند.

قوانین برای همه ماینرهای شما اعمال می‌شوند، در هر poll بررسی می‌شوند و یک دوره خنک‌شدن قابل‌تنظیم دارند تا هرگز با پیام انبوه مواجه نشوید. در پلن Unlimited، هشدارها به ایمیل شما نیز ارسال می‌شوند.

دسکتاپ از راه دور · پلن Unlimited

در پلن Unlimited، کارت‌های مزرعه متصل یک دکمه «🖥️ راه دور» نشان می‌دهند. روی آن کلیک کنید تا دسکتاپ کامل PC مزرعه شما درست در Dashboard باز شود — موس را حرکت دهید، تایپ کنید، پیکربندی‌ها را ویرایش کنید، Windows را راه‌اندازی مجدد کنید — از هر کجا. این از طریق همان تونل Agent کار می‌کند، بنابراین باز هم port forwarding وجود ندارد و چیز اضافه‌ای برای نصب نیست.

• کلیک و تایپ کنید تا PC را کنترل کنید؛ در صورت نیاز از دکمه Ctrl+Alt+Del استفاده کنید.
• روی موبایل، برای کلیک ضربه بزنید و از دکمه ⌨ کلیدها برای صفحه‌کلید روی صفحه استفاده کنید.
• هر نشست برای حساب شما خصوصی است و هنگام بستن پنجره پایان می‌یابد؛ هر نشست ثبت می‌شود.

سودآوری و ارز

در تنظیمات ← اقتصاد ماینینگ، ارز نمایش خود را انتخاب کنید (۱۶۶ ارز در دسترس، هر ساعت از نرخ‌های زنده تبادل به‌روز می‌شوند) و قیمت برق و کارمزد pool خود را وارد کنید. سپس نمای کلی درآمد روزانه واقعی، هزینه برق و سود را نشان می‌دهد — به تفکیک روز، هفته، ماه و سال — به‌علاوه قیمت سربه‌سر برق و هزینه به‌ازای هر BTC استخراج‌شده، که به‌صورت زنده از سختی شبکه و قیمت BTC محاسبه می‌شوند.

ماشین‌حساب سودآوری به شما امکان می‌دهد سناریوهای فرضی (قیمت برق متفاوت، ماینرهای بیشتر) را بدون تغییر تنظیمات ذخیره‌شده خود بررسی کنید.

پلن‌ها و صورت‌حساب

ارتقا

ارتقاها بلافاصله اعمال می‌شوند. پیش از هر کسر، مبلغ دقیق تسهیم‌شده به شما نشان داده می‌شود و از شما تأیید خواسته می‌شود؛ محدودیت‌های جدید شما لحظه‌ای که پرداخت موفق شود باز می‌شوند.

تنزل

تنزل‌ها برای پایان دوره صورت‌حساب فعلی شما زمان‌بندی می‌شوند — تا آن زمان پلن فعلی و همه امکانات آن را بدون هزینه اضافی نگه می‌دارید. صفحه پلن‌ها تاریخ دقیق را نشان می‌دهد و پلن بعدی شما را مشخص می‌کند. می‌توانید یک تنزل زمان‌بندی‌شده را هر زمان با «حفظ [پلن فعلی]» لغو کنید.

پرداخت و تاریخچه

پرداخت‌ها به‌طور امن توسط Stripe انجام می‌شوند — اطلاعات کارت هرگز به سرورهای ما نمی‌رسد. در صفحه پلن‌ها می‌توانید کارت ثبت‌شده را ببینید و آن را به‌روز کنید، و تاریخچه کامل سفارش‌ها را با رسیدهای قابل دانلود مشاهده کنید. هر زمان لغو کنید؛ ماینرها و تاریخچه شما هنگام تغییر پلن هرگز حذف نمی‌شوند.

امنیت

• تونل فقط‌خروجی — Agent از طریق TLS به بیرون تماس می‌گیرد (همان پورت HTTPS). هیچ‌چیز در شبکه شما منتظر اتصالات ورودی نمی‌ماند.
• توکن به‌ازای هر مزرعه — هر مزرعه با توکن امضاشده مخصوص خود احراز هویت می‌کند که می‌توانید هر زمان آن را باطل و بازتولید کنید.
• اطلاعات ورود رمزنگاری‌شده — رمزهای عبور ماینرها در حالت سکون با AES-256-GCM رمزنگاری می‌شوند و فقط هنگام انتقال یک فرمان در حافظه رمزگشایی می‌شوند.
• تاب‌آور — اتصال مجدد خودکار با تأخیر تدریجی و چندین endpoint relay با جابه‌جایی خودکار، Dashboard شما را در میان سکسکه‌های ISP و CDN زنده نگه می‌دارند.

ماینرهای پشتیبانی‌شده

هر Bitmain Antminer که فرم‌ور اصلی را با رابط وب استاندارد اجرا می‌کند: S23، خانواده S21 (شامل XP و Hydro)، خانواده S19، T21، L9، L7، Kaspa KS5/KS7، KA3 و بیشتر. مدل‌های Hydro و immersion برای سنسورهای دمای خنک‌سازی آبی و تشخیص نبود فن مدیریت ویژه می‌شوند. فرم‌ورهای شخص ثالث که API سازگار با Bitmain را حفظ می‌کنند نیز معمولاً کار می‌کنند.

عیب‌یابی

مزرعه «آفلاین» نشان می‌دهد

Agent در حال اجرا نیست یا نمی‌تواند به اینترنت برسد. روی PC مزرعه، مطمئن شوید پنجره/سرویس Agent در حال اجراست (python antminer_agent.py --status) و PC اینترنت دارد. Agent به‌محض بازگشت اتصال، خودش دوباره متصل می‌شود.

اسکن چیزی پیدا نمی‌کند

بررسی کنید زیرشبکه با ماینرهای شما مطابقت دارد (اسکن آن را به‌طور خودکار تشخیص می‌دهد، اما می‌توانید ویرایش کنید) و اطلاعات ورود درست است (پیش‌فرض root/root). PC اجراکننده Agent باید روی همان LAN ماینرها باشد.

یک ماینر آفلاین نشان داده می‌شود اما در حال هش‌کردن است

ممکن است وب‌API آن در دسترس نباشد یا اطلاعات ورود تغییر کرده باشد. IP ماینر را مستقیماً روی LAN باز کنید تا مطمئن شوید و در صورت نیاز نام کاربری/رمز عبور آن را در AntminerTools به‌روز کنید.

نمی‌توان یک مزرعه را حذف کرد

ابتدا Agent را روی PC آن مزرعه خاموش کنید، حدود ۹۰ ثانیه صبر کنید تا کارت آفلاین را نشان دهد، سپس حذف کنید. این کار مانع می‌شود یک Agent هنوز‌در‌حال‌اجرا دوباره مانند یک شبح ظاهر شود.

دسکتاپ از راه دور اجرا نمی‌شود

به پلن Unlimited و یک Agent متصل نیاز دارد. اولین اجرا یک دستیار ضبط صفحه نصب می‌کند (~۱۵ ثانیه). روی یک Raspberry Pi بدون دسکتاپ (headless)، دسکتاپ از راه دور در دسترس نیست.

پرسش‌های متداول

آیا باید پورت باز کنم یا از VPN استفاده کنم؟

خیر. Agent فقط یک اتصال خروجی برقرار می‌کند — پشت هر روتر، CGNAT، 4G/5G یا Starlink با پیکربندی صفر شبکه کار می‌کند.

آیا روی موبایل من کار می‌کند؟

بله — کل Dashboard کاملاً واکنش‌گراست. می‌توانید پایش کنید، هشدار بگیرید، ماینرها را راه‌اندازی مجدد کنید، صورت‌حساب را مدیریت کنید و حتی از یک موبایل دسکتاپ از راه دور اجرا کنید.

آمار هر چند وقت به‌روز می‌شود؟

هر ۱۵ ثانیه به‌ازای هر ماینر آنلاین؛ Dashboard نمایش را هر ۱۰ ثانیه به‌روز می‌کند.

آیا پلن رایگان وجود دارد؟

بله — ۱ مزرعه و تا ۴ ماینر با پایش کامل، کنترل از راه دور و هشدارهای Dashboard. پلن‌های پولی ظرفیت و امکانات اضافه می‌کنند.

هنوز گیر کرده‌اید؟ یک حساب بسازید و از Dashboard خود با ما تماس بگیرید، یا وبلاگ را برای راهنماها و نکات بخوانید.