Skip to content

Latest commit

 

History

History
152 lines (103 loc) · 16.1 KB

README_fa.md

File metadata and controls

152 lines (103 loc) · 16.1 KB

Example Image

(Added by leokeuo ❤️)

هولدربات چیه؟

هولدر بات یک ربات سریع و ساده است که طراحی شده است تا به مشکل عدم وجود گزینه شروع تایمر پس از اولیین اتصال در رابط کاربری "پنل مرزبان" پاسخ دهد. با استفاده از رابط‌های برنامه‌نویسی پنل مرزبان، هولدر بات به کاربران امکان استفاده آسان از این ویژگی را در تلگرام فراهم کرده است. با ارتقاء به نسخه ۳.۰، هولدر بات قابلیت‌های خود را با معرفی ویژگی‌های ویژه ارتقا داده و در نسخه‌های بعدی به اوج خود رسیده است. اکنون، هولدر بات به عنوان یک دستیار حرفه‌ای برای کاربران پنل مرزبان خدمت می‌کند. برای کسب اطلاعات بیشتر، می‌توانید به بخش به‌روزرسانی‌ها مراجعه کنید یا به کانال تلگرام ما بپیوندید.

Important

شما می‌توانید با دادن یک ستاره به این پروژه در GitHub، حمایت خود را نشان دهید. ما یک کانال تلگرام برای اعلانات، نظرسنجی‌ها و تعامل با کاربران ایجاد کرده‌ایم. می‌توانید با @ErfjabHolderbot به ما بپیوندید. @ErfjabHolderbot.

چرا هولدربات؟

  • قابلیت پیکربندی خودکار پس از رسیدن به حداکثر حجم یا زمان.
  • قابلیت مدیریت مدیران پنل (تغییر رمز عبور یا سودو)
  • قابلیت افزودن یا حذف مدیران برای پنل
  • قابلیت تعیین ضریب مصرف گره
  • قابلیت مدیریت گره‌ها (غیرفعال‌سازی/فعال‌سازی/اتصال مجدد)
  • قابلیت نظارت و دریافت اعلان‌های قطع اتصال گره
  • قابلیت غیرفعال‌سازی/فعال‌سازی نظارت
  • قابلیت تغییر تایمر نظارت برای گره‌ها
  • قابلیت ایجاد کاربران به صورت عمده/تکی (در حال نگهداری)
  • قابلیت ایجاد کاربران از طریق قالب‌ها
  • قابلیت ایجاد قالب‌ها (حجم، زمان، ورودی)
  • قابلیت دریافت زمان آخرین آنلاین بودن، بروزرسانی زیرکاربر (تکی)
  • قابلیت مستقیم دریافت بارکد و متن لینک زیریا حذف کاربر
  • قابلیت دریافت نرم‌افزار استفاده شده توسط کاربر
  • قابلیت دریافت بارکد برای لینک ارسال شده مورد نظر
  • قابلیت جستجو و دریافت کاربران مشابه (مانند Did you Mean گوگل)
  • قابلیت دریافت لیست کاربران آنلاین/آفلاین (از ۱ دقیقه تا آخرین ۶۰ روز به صورت جدول و PDF)
  • قابلیت دریافت لیست زیرکاربران بروزرسانی/غیربروزرسانی (از ۱ دقیقه تا آخرین ۶۰ روز به صورت جدول و PDF)
  • رابط کاربری جدید، زیبا و ساده

Note

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

چگونه هولدربات نصب کنیم؟

برای استفاده از هولدر بات، شما به اطلاعات زیر نیاز دارید: ۱- نام : می‌توانید هر نامی که ترجیح می‌دهید وارد کنید. ۲- شما میتوانید چت آیدی را از @chatIDrobot بدست آورید. ۳- شما میتوانید بات توکن را از @botfather بدست آورید. ۴- نام کاربری پنل: نام کاربری ادمین سودو پنل خود را وارد کنید. ۵- رمز عبور پنل: رمز عبور ادمین سودو پنل خود را وارد کنید. ۶- دامنه پنل: دامنه پنل خود را به این شکل وارد کنید (sub.domain.com:port).

Warning

لطفاً توجه داشته باشید که هولدر بات در حال حاضر تنها برای نصب و استفاده بر روی سرورهای اوبونتو پشتیبانی می‌شود، و هرگونه مسئولیتی در مورد راه‌اندازی‌های دیگر با شما خواهد بود.

لطفاً برای نصب روی سرور خود از دستور زیر استفاده کنید

cd && cd .. && rm -f holderbot.sh* || true && sudo apt install && sudo apt-get install libjpeg-dev && wget https://raw.githubusercontent.com/erfjab/holderbot/main/holderbot.sh && chmod +x holderbot.sh && ./holderbot.sh

چگونه از هولدربات استفاده کنیم؟ (ویدیو)

click me

تمام توضیحات کامل و واضح است، اما اگر هنوز نقص یا کوتاهی‌هایی در توضیحات مشاهده می‌کنید، لطفاً یک مشکل ایجاد کنید و ما آن را برطرف خواهیم کرد. از همکاری شما متشکریم.

Warning

این آموزش‌ها به صورت اختصاصی برای نسخه 4 می‌باشند. نسخه‌های قبلی دیگر پشتیبانی نمی‌شوند.

🏛 صفحه اصلی (home page)

درباره صفحه اصلی، شما تمام دستورات لازم را لیست شده مشاهده خواهید کرد، همراه با توضیحات دقیقی که در پایین صفحه ارائه شده‌اند. در اینجا، علاوه بر وارد کردن دستورات، می‌توانید نام کاربری یا لینک اشتراک خود را نیز ارسال کنید. اگر کاربر وجود داشته باشد، آمار آن‌ها را دریافت خواهید کرد و اگر وجود نداشته باشد، می‌توانید با ویژگی جستجوی Holder Bot یک لیست از کاربران مشابه دریافت کنید.

وقتی آمار کاربر به شما ارسال می‌شود، سه گزینه مشاهده می‌کنید: "به‌روزرسانی"، "بارکد" و "حذف". برای به‌روزرسانی آمار کاربر، از دکمه "به‌روزرسانی" استفاده کنید. برای دریافت بارکد لینک اشتراک کاربر، از دکمه "بارکد" استفاده کنید. و برای حذف کاربر، از دکمه "حذف" استفاده کنید.

Note

نگران نباشید، قبل از انجام عملیات حذف، از شما درخواست تأیید خواهد شد.

🚀 ایجاد کاربر (create user)

شما دو گزینه برای ایجاد کاربر دارید: از طریق الگوها یا به صورت دستی. شما می‌توانید الگوهای آماده را با مراجعه به بخش 'الگوها' در این آموزش ایجاد کنید. وقتی کاربری ایجاد می‌کنید، اگر روی یکی از الگوهای خود کلیک کنید، ورودی، حجم و زمان پیش‌فرض انتخاب می‌شوند و از شما نام کاربری و تعداد مورد نظر خواسته خواهد شد. ربات به صورت خودکار نام‌های کاربری را شماره‌گذاری کرده و کاربران را ایجاد می‌کند.

اگر می‌خواهید این کار را به صورت دستی انجام دهید، از شما ورودی، حجم و زمان خواسته خواهد شد که برای موارد خاص مناسب‌تر است. الگوها کارتان را سریع‌تر انجام می‌دهند و به شما امکان ایجاد صدها کاربر در یک دهم ثانیه را می‌دهند.

🎖 اطلاع (notice)

به بخش پیام‌ها خوش آمدید! این ویژگی با حمایت مجموعه Gray اضافه شده است. ❤️ شما می‌توانید به کانال و ربات Gray collection برای خرید سرورها به صورت ساعتی و ماهانه، با تنوع گسترده‌ای از مکان‌ها و مشخصات، همراه با IP‌های تمیز با کمترین قیمت‌ها مراجعه کنید. قبل از فعال کردن اعلان، شما باید یک ورودی(Inbound) Shadowsocks با نام "Holderbot" در داخل پنل ایجاد کنید:

{
  "tag": "Holderbot",
  "listen": "0.0.0.0",
  "port": 2222,
  "protocol": "shadowsocks",
  "settings": {
    "clients": [],
    "network": "tcp,udp"
  }
}

سپس، در تنظیمات میزبان ورودی، پیام‌های مورد نظر خود را قرار می‌دهیم. پس از اعمال تغییرات، در داخل Holderbot، بر روی گزینه "تغییر وضعیت" در بخش اعلان کلیک می‌کنیم و این ویژگی فعال می‌شود. Holderbot هر 5 ثانیه یکبار کاربران را بررسی کرده و پیام‌ها را برای کاربران تکمیل شده فعال کرده و شما را بابت آن مطلع می‌سازد.

👤 کاربران (users)

در بخش کاربران، شما آمارهای عمومی پنل خود را دریافت می‌کنید. تعداد کاربران "همه"، "فعال شده"، "غیرفعال شده"، "در انتظار"، "محدود شده" و "منقضی شده"، همراه با تعداد کاربران آنلاین یا آفلاین در طی 24 ساعت گذشته، و اینکه لینک‌های آن‌ها به‌روز شده است یا خیر، ارائه می‌شود.

در پایین، گزینه‌هایی وجود دارد که با کلیک بر روی آن‌ها، یک لیست از نام‌های کاربری را به صورت فایل PDF ارائه می‌دهد. اگر بر روی دو گزینه آخر کلیک کنید، از شما پرسیده می‌شود که محدوده زمانی مورد نظر خود را وارد کنید، و بر اساس آن، آمارها را دریافت خواهید کرد.

Tip

اگر یک محدوده زمانی خاص در ذهن دارید، می‌توانید آن را بر اساس الگوی 'زمان دقیق/ساعت/روز' وارد کنید.

👨🏻‍💻 ادمین‌ها (admins)

شما می‌توانید در این بخش به صورت کامل مدیران پنل خود را مدیریت کنید. شما می‌توانید مدیران جدید اضافه کنید، مدیران را حذف کنید، رمز عبور مدیر را تغییر دهید و مجوزهای مدیر را تغییر دهید. فقط توجه داشته باشید که برای حذف مدیران sudo، تنها می‌توان آن را از سرور اصلی با استفاده از دستور CLI انجام داد. API‌ها اجازه دسترسی به این قابلیت را به ما نمی‌دهند.

🎗 نودها (nodes)

شما همچنین می‌توانید از اینجا سرورهای خود را مدیریت کنید، اتصال مجدد، غیرفعال‌سازی، فعال‌سازی یا تنظیم ضریب مصرف برای سرور مورد نظر خود را انجام دهید. برای مانیتورینگ و دریافت اعلان‌های قطع اتصال سرور، به بخش مانیتورینگ در این صفحه مراجعه کنید.

🗃 تمپلیت‌ها (templates)

با ایجاد الگوها، می‌توانید به راحتی وظایف تکراری را مدیریت کنید، مانند مشخص کردن حجم، مدت زمان و ورودی‌ها. در بخش الگوها، می‌توانید یک الگوی جدید ایجاد یا الگوهای موجود را حذف کنید. برای ایجاد یک الگوی جدید، به سادگی بر روی "➕ اضافه کردن الگو جدید" کلیک کنید. در مرحله اول، نام را بدون فاصله، عدد یا نماد وارد کنید. سپس حجم (به گیگابایت) و مدت زمان (به روز) را وارد کنید، و در نهایت ورودی‌ها را انتخاب کنید. هر ورودی انتخاب شده با علامت ➕ درگرفته شده است، در حالی که آن‌هایی که با علامت ➖ مشخص شده‌اند، شامل نمی‌شوند. پس از انجام انتخاب های خود، بر روی "✅ پایان" کلیک کنید تا الگو را ذخیره کنید. برای حذف یک الگو، به سادگی بر روی آن کلیک کنید، و از شما برای تأیید سوال خواهد شد. پس از تأیید، حذف خواهد شد.

Note

شما می‌توانید الگوها را در این بخش اضافه یا حذف کنید، اما فقط در بخش "🚀 ایجاد کاربر" از آن‌ها استفاده می‌کنید.

🎛 مانیتورینگ (monitoring)

مانیتورینگ برای سرورهای شما به صورت پیش‌فرض هنگام نصب HolderBot فعال است. شما می‌توانید آن را از این بخش فعال یا غیرفعال کنید. همچنین می‌توانید فاصله زمانی برای بررسی سرور را تعیین کنید و زمان انتظار برای بررسی بعدی را هنگام دریافت یک اعلان قطع اتصال سرور مشخص کنید.

🔍 جستجو (search)

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

Note

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

💬 راهنما (help)

راهنمایی در حل مشکلات، درخواست کمک، گزارش باگ، تماس با توسعه‌دهنده و موارد مشابه به شما ارسال می‌شود. علاوه بر این، یک فایل حاوی لاگ‌های Holder Bot به شما ارسال خواهد شد که در صورت نیاز برای اشکال‌زدایی و حل مشکل، می‌توانید آن را با توسعه‌دهنده به اشتراک بگذارید.

🖼 بارکد (QRcode)

شما می‌توانید با ارسال هر لینک یا متن بارکد آن را دریافت کنید. این ویژگی مختص به لینک‌های v2ray نیست و شما می‌تواند بارکد آن را در قالب کد ، برای هر لینکی دریافت کنید. این کار سریع و ساده است!

Tip

شما می‌توانید رنگ بارکد را در فایل "qr.py" در پوشه "Function" با استفاده از خط 8 (fill_color) با گزینه‌های مانند قرمز، صورتی، آبی، زرد و غیره تغییر دهید.

Telegram Badge