Run_userBot

📦 راهنمای کامل نصب و راه‌اندازی

---

🔹 پیش‌نیاز مشترک: دریافت API_ID و API_HASH

قبل از هر چیز، این دو مقدار را از تلگرام بگیر:

میتونی از این ربات بگیری :

@ApiID_ApiHash_Bot

اگه موفق نشدی :

1. به سایت my.telegram.org برو.

2. با شماره‌ای که می‌خواهی یوزربات روی آن اجرا شود، لاگین کن.

3. وارد API development tools شو.

4. یک اپ بساز (اسم و پلتفرم دلخواه، مثلاً MyUserbot و Other).

5. مقادیر api_id (عددی) و api_hash (رشته ۳۲ کاراکتری) را کپی کن.

بعد در فایل کد، این دو خط را ویرایش کن:

```python

_API_ID = 1234567

_API_HASH = "your_api_hash_here"

```

➖♦️➖♦️➖♦️➖♦️➖♦️➖

🔹 روش ۱: نصب روی Pydroid 3 (اندروید، ساده‌ترین)

گام ۱ — نصب Pydroid

1. از Google Play، Pydroid 3 را نصب کن.

2. اگر اندروید ۱۱ یا بالاتر داری، افزونه Pydroid Repository Plugin را هم نصب کن (برای pip).

گام ۲ — نصب کتابخانه‌ها

1. Pydroid را باز کن → منوی سه‌خط بالا-چپ → Pip.

2. در کادر جستجو بنویس pyrogram → Install.

3. دوباره جستجو کن tgcrypto → Install (برای سرعت و پایداری بهتر).

گام ۳ — ساخت پوشه و فایل

1. با یک فایل‌منیجر، پوشه‌ای بساز مثلاً:

  ```

  /storage/emulated/0/Userbot/

  ```

2. فایل کد را با نام userbot.py داخلش ذخیره کن.

گام ۴ — اجرا

1. در Pydroid، فایل userbot.py را باز کن.

2. دکمه ▶ (Run) را بزن.

3. اولین بار از تو می‌پرسد:

  · شماره تلفن (با کد کشور، مثلاً +989123456789)

  · کد تأیید که تلگرام در اپ رسمی برایت می‌فرستد

  · (اگر دو مرحله‌ای داری) رمز عبورت

4. پیام 🚀 Userbot running... را ببینی، یعنی آماده است.

⚠️ نکات مخصوص Pydroid

· بعد از اجرا، صفحه Pydroid را نبند؛ اگر ببندی یوزربات خاموش می‌شود.

· برای اینکه پس‌زمینه بماند، در تنظیمات اندروید اجازه «اجرای پس‌زمینه» به Pydroid بده.

· اگر خطای SSL گرفتی، مطمئن شو tgcrypto نصب است.

➖♦️➖♦️➖♦️➖♦️➖♦️➖

🔹 روش ۲: نصب روی Termux (اندروید، حرفه‌ای‌تر)

گام ۱ — نصب Termux

از F-Droid یا GitHub رسمی Termux نصب کن (نسخه Google Play قدیمی است و کار نمی‌کند).

گام ۲ — به‌روزرسانی و نصب پایتون

```bash

pkg update && pkg upgrade -y

pkg install python -y

pkg install git nano -y

```

گام ۳ — نصب کتابخانه‌ها

```bash

pip install -U pip

pip install -U pyrogram tgcrypto

```

گام ۴ — دسترسی به حافظه (برای انتقال فایل از دانلودها)

```bash

termux-setup-storage

```

اجازه دسترسی را بده.

گام ۵ — ساخت پوشه و انتقال فایل

```bash

mkdir -p ~/userbot && cd ~/userbot

cp /sdcard/Download/userbot.py .

nano userbot.py  # API_ID و API_HASH را ویرایش کن

```

در nano:

· Ctrl+O → Enter برای ذخیره

· Ctrl+X برای خروج

گام ۶ — اجرا

```bash

python userbot.py

```

شماره و کد تأیید را وارد کن. تمام.

گام ۷ — اجرای همیشگی در پس‌زمینه

اگر ترمینال را ببندی، یوزربات خاموش می‌شود. برای جلوگیری:

راه ۱ — استفاده از tmux:

```bash

pkg install tmux -y

tmux new -s bot

python userbot.py

# برای جدا شدن: Ctrl+B بعد D

# برای برگشتن: tmux attach -t bot

```

راه ۲ — استفاده از nohup:

```bash

nohup python userbot.py > bot.log 2>&1 &

```

لاگ‌ها در bot.log ذخیره می‌شوند.

⚠️ نکات مخصوص Termux

· در اندروید ۱۲+، سیستم ممکن است Termux را بکشد. در تنظیمات باتری، Unrestricted بگذار.

· اگر خطای SSL گرفتی: pkg install openssl -y.

· اگر خطای Permission denied روی /sdcard گرفتی: دوباره termux-setup-storage بزن و اجازه بده.

➖♦️➖♦️➖♦️➖♦️➖♦️➖

🔹 روش ۳: نصب روی سرور (Ubuntu / Debian VPS)

گام ۱ — اتصال به سرور

```bash

ssh root@YOUR_SERVER_IP

```

گام ۲ — به‌روزرسانی و نصب پیش‌نیازها

```bash

apt update && apt upgrade -y

apt install python3 python3-pip python3-venv git nano screen -y

```

گام ۳ — ساخت محیط مجازی (توصیه‌شده)

```bash

mkdir -p /opt/userbot && cd /opt/userbot

python3 -m venv venv

source venv/bin/activate

```

گام ۴ — نصب کتابخانه‌ها

```bash

pip install -U pip

pip install -U pyrogram tgcrypto

```

گام ۵ — انتقال فایل کد

```bash

nano userbot.py

```

محتوای کد را داخلش پیست کن، API_ID و API_HASH را بگذار، ذخیره کن (Ctrl+O، Enter، Ctrl+X).

اگر روی کامپیوتر فایل داری، با scp بفرست:

```bash

scp userbot.py root@YOUR_SERVER_IP:/opt/userbot/

```

گام ۶ — اجرای اولیه و لاگین

```bash

python userbot.py

```

شماره و کد تأیید را وارد کن. بعد از لاگین موفق، Ctrl+C بزن تا ببندی (چون فایل سشن ساخته شده).

گام ۷ — اجرای دائمی

راه ۱ — با screen (ساده):

```bash

screen -S userbot

python userbot.py

# جدا شدن: Ctrl+A بعد D

# برگشتن: screen -r userbot

```

راه ۲ — با systemd (حرفه‌ای، ری‌استارت خودکار):

فایل سرویس بساز:

```bash

nano /etc/systemd/system/userbot.service

```

محتوای زیر را پیست کن:

```ini

[Unit]

Description=Telegram Userbot

After=network.target

[Service]

Type=simple

WorkingDirectory=/opt/userbot

ExecStart=/opt/userbot/venv/bin/python /opt/userbot/userbot.py

Restart=always

RestartSec=10

User=root

[Install]

WantedBy=multi-user.target

```

فعال‌سازی:

```bash

systemctl daemon-reload

systemctl enable userbot

systemctl start userbot

systemctl status userbot    # مشاهده وضعیت

journalctl -u userbot -f    # مشاهده زنده لاگ‌ها

```

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

⚠️ نکات مخصوص سرور

· حتماً روی سرور IP خارج از ایران یا با VPN باشد، چون تلگرام روی IP ایران محدودیت دارد.

· فایل سشن (my_account.session) در پوشه /opt/userbot/ ساخته می‌شود. پشتیبان بگیر. اگر گم شود باید دوباره لاگین کنی.

· سرور باید swap داشته باشد اگر RAM کم است، چون Pyrogram حافظه می‌خورد.

🌍➖🌍➖🌍➖🌍➖🌍➖🌍➖🌍

🎯 خلاصه سریع

پلتفرم دستور نصب اجرا

Pydroid 3 نصب از Play + pip install pyrogram tgcrypto دکمه ▶

Termux pkg install python && pip install pyrogram tgcrypto python userbot.py

سرور apt install python3-pip && pip install pyrogram tgcrypto systemctl start userbot

قبل از هر چیز:

یا از این ربات بگیر:

@ApiID_ApiHash_Bot

یا اگه موفق نشدی :

1. API_ID و API_HASH از my.telegram.org

2. ویرایش دو خط بالا در کد

3. اجرا و لاگین با شماره + کد تأیید

4. عضو کانال @BotSorce برای پشتیبانی