Binary Userbot - Linux / VPS

Binary Userbot - Linux / VPS

bincore

Быстрый старт

sudo apt update

sudo apt install -y git python3 python3-pip python3-venv ffmpeg nano

git clone https://github.com/binary166/BinaryUserBot

cd BinaryUserBot

if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then cd BinaryUserBot; fi

python3 -m venv .venv

source .venv/bin/activate

python -m pip install --upgrade pip setuptools wheel

if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; else python -m pip install telethon aiohttp yt-dlp; fi

nano config.py

python main.py

Ниже идет более подробная помощь, обновление и ответы на вопросы.

Эта инструкция подходит для Ubuntu, Debian, Fedora, RHEL, CentOS, Arch Linux, Manjaro и большинства VPS на Linux.

1. Что нужно заранее

Подготовьте:

  • Telegram-аккаунт, на котором будет работать userbot.
  • Linux-ПК или VPS.
  • Python 3.10+, лучше 3.11+.
  • Git.
  • FFmpeg.
  • Telegram API_ID и API_HASH.
  • Ваш Telegram User ID.
  • OpenRouter API Token, если нужны AI-функции.

Репозиторий:

https://github.com/binary166/BinaryUserBot

2. Обязательная подписка

Перед первым запуском обязательно подпишитесь с того Telegram-аккаунта, на котором будет работать userbot:

Это обязательное условие для нормальной работы функций, связанных со скам-базой, новостями, обновлениями, модулями и поддержкой проекта.

3. Получение Telegram API ID и API Hash

  1. Откройте 
  2. https://my.telegram.org.
  3. Войдите по номеру телефона Telegram.
  4. Перейдите в API development tools.
  5. Создайте приложение. Название и описание можно указать любые.
  6. Скопируйте:App api_id
  7. App api_hash

Пример:

API_ID = 12345678

API_HASH = "abcdef123456abcdef123456abcdef12"

Не передавайте эти данные другим людям.

4. Получение Telegram User ID

  1. Откройте Telegram.
  2. Напишите боту 
  3. https://t.me/userinfobot.
  4. Скопируйте числовой ID.

Пример:

MY_ID = 750545571

5. Получение OpenRouter API Token

Токен нужен для AI-команд, например .gpt, .ac, .lol, .troll.

  1. Откройте 
  2. https://openrouter.ai.
  3. Зарегистрируйтесь или войдите.
  4. Перейдите в Settings -> API Keys.
  5. Создайте ключ через Create Key.
  6. Скопируйте токен.

Если AI-функции не нужны:

OR_TOKEN = ""

6. Установка зависимостей

Ubuntu / Debian

sudo apt update

sudo apt install -y git python3 python3-pip python3-venv ffmpeg nano

Проверка:

python3 --version

git --version

ffmpeg -version

Fedora / RHEL / CentOS

Для Fedora и новых RHEL:

sudo dnf install -y git python3 python3-pip python3-virtualenv ffmpeg nano

Для старых CentOS:

sudo yum install -y git python3 python3-pip nano

Если ffmpeg не находится, подключите EPEL/RPM Fusion или установите FFmpeg способом для вашей версии системы.

Arch Linux / Manjaro

sudo pacman -Syu --needed git python python-pip ffmpeg nano

7. Скачивание проекта

Перейдите в домашнюю папку и скачайте репозиторий:

cd ~

git clone https://github.com/binary166/BinaryUserBot

cd BinaryUserBot

В некоторых версиях проекта внутри может быть еще одна папка BinaryUserBot. Проверьте и перейдите в нее, если там лежит main.py:

if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then

cd BinaryUserBot

fi

Проверьте, что вы в папке с main.py:

ls

Если main.py не видно:

find . -name main.py

Перейдите в папку, которую покажет команда.

8. Виртуальное окружение Python

Создайте окружение:

python3 -m venv .venv

Активируйте:

source .venv/bin/activate

Обновите инструменты установки:

python -m pip install --upgrade pip setuptools wheel

9. Установка Python-библиотек

Если в проекте есть requirements.txt:

python -m pip install -r requirements.txt

Если файла нет:

python -m pip install telethon aiohttp yt-dlp

10. Настройка config.py

Откройте файл:

nano config.py

Заполните основные поля:

API_ID = 12345678

API_HASH = "abcdef123456abcdef123456abcdef12"

PHONE = "+79001234567"

PASSWORD_2FA = ""

MY_ID = 123456789

OR_TOKEN = ""

Расшифровка:

  • API_ID - число с my.telegram.org.
  • API_HASH - строка с my.telegram.org.
  • PHONE - ваш номер Telegram в международном формате.
  • PASSWORD_2FA - пароль двухфакторной аутентификации Telegram. Если его нет, оставьте "".
  • MY_ID - ваш числовой Telegram ID.
  • OR_TOKEN - токен OpenRouter. Если AI не нужен, оставьте "".

Сохранить в nano:

Ctrl + O

Enter

Ctrl + X

11. Первый запуск

Убедитесь, что окружение активно:

source .venv/bin/activate

Запустите:

python main.py

При первом запуске Telegram может попросить:

  1. Ввести код из Telegram.
  2. Ввести пароль 2FA, если он установлен.

После успешного входа появится файл *.session. Не передавайте его другим людям.

12. Проверка работы

  1. Откройте Telegram.
  2. Проверьте, что аккаунт подписан на:@GID_ScamBase
  3. @Binary_News
  4. @binary_ub
  5. Напишите .help в чате.
  6. Если бот отвечает, установка завершена.

13. Повторный запуск

cd ~/BinaryUserBot

if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then

cd BinaryUserBot

fi

source .venv/bin/activate

python main.py

14. Автозапуск через systemd

Этот способ рекомендуется для VPS.

Перейдите в папку с main.py:

cd ~/BinaryUserBot

if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then

cd BinaryUserBot

fi

source .venv/bin/activate

Проверьте пути:

pwd

which python

Создайте сервис:

APP_DIR="$(pwd)"

PYTHON_BIN="$(which python)"

SERVICE_USER="$(whoami)"


sudo tee /etc/systemd/system/binary-userbot.service > /dev/null <<EOF

[Unit]

Description=Binary Userbot

After=network-online.target

Wants=network-online.target


[Service]

Type=simple

User=$SERVICE_USER

WorkingDirectory=$APP_DIR

ExecStart=$PYTHON_BIN main.py

Restart=on-failure

RestartSec=10

Environment=PYTHONUNBUFFERED=1


[Install]

WantedBy=multi-user.target

EOF

Запустите сервис:

sudo systemctl daemon-reload

sudo systemctl enable binary-userbot

sudo systemctl start binary-userbot

Проверить статус:

sudo systemctl status binary-userbot

Логи в реальном времени:

sudo journalctl -u binary-userbot -f

Перезапуск:

sudo systemctl restart binary-userbot

Остановка:

sudo systemctl stop binary-userbot

15. Запуск через tmux

Если systemd не нужен:

sudo apt install -y tmux

tmux new -s binarybot

Внутри сессии:

cd ~/BinaryUserBot

if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then

cd BinaryUserBot

fi

source .venv/bin/activate

python main.py

Выйти без остановки:

Ctrl + B, затем D

Вернуться:

tmux attach -t binarybot

16. Обновление

Остановите бота и выполните:

cd ~/BinaryUserBot

if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then

cd BinaryUserBot

fi


git pull

source .venv/bin/activate

python -m pip install --upgrade pip setuptools wheel


if [ -f requirements.txt ]; then

python -m pip install -r requirements.txt --upgrade

else

python -m pip install --upgrade telethon aiohttp yt-dlp

fi


python main.py

Если бот работает через systemd:

sudo systemctl restart binary-userbot

17. Резервная копия

Сохраните:

  • config.py
  • *.session
  • settings.json, если есть
  • notes.json, если есть
  • папку modules, если есть

Файл *.session равен доступу к аккаунту. Не отправляйте его никому.

18. Частые ошибки

ModuleNotFoundError

source .venv/bin/activate

python -m pip install telethon aiohttp yt-dlp

main.py не найден

find . -name main.py

Перейдите в папку, которую покажет команда.

ffmpeg не найден

Ubuntu / Debian:

sudo apt install -y ffmpeg

Arch / Manjaro:

sudo pacman -S ffmpeg

Fedora:

sudo dnf install -y ffmpeg

FloodWaitError

Это лимит Telegram. Подождите указанное время и не перезапускайте бота слишком часто.

AI-команды не работают

Проверьте:

  • заполнен ли OR_TOKEN;
  • активен ли ключ OpenRouter;
  • есть ли доступ к модели;
  • нет ли лишних пробелов в токене.

Команды .scam или .lastnews не работают

Проверьте обязательную подписку:

  • @GID_ScamBase
  • @Binary_News
  • @binary_ub

19. Короткая команда установки для Ubuntu / Debian

sudo apt update

sudo apt install -y git python3 python3-pip python3-venv ffmpeg nano

cd ~

git clone https://github.com/binary166/BinaryUserBot

cd BinaryUserBot

if [ -d BinaryUserBot ] && [ -f BinaryUserBot/main.py ]; then cd BinaryUserBot; fi

python3 -m venv .venv

source .venv/bin/activate

python -m pip install --upgrade pip setuptools wheel

if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; else python -m pip install telethon aiohttp yt-dlp; fi

nano config.py

python main.py





Report content on this page

Report Page

Please submit your DMCA takedown request to dmca@telegram.org