📚Гайд

🔐 Важные заметки

• Лицензия по умолчанию предоставляет 2 сессии. Это означает, что вы можете запускать не более двух копий софта одновременно. Если вам требуется больше сессий — их можно приобрести отдельно.

• Все платные версии софта имеют закрытый исходный код и поддерживают работу на Windows и Linux (Ubuntu).

• Важно для пользователей Ubuntu: Необходимо установить базу данных PostgreSQL, так как SQLite не поддерживает многопроцессорный режим. 👉 [Гайд по установке PostgreSQL — CLICK]

• Для пользователей Windows: Поддерживаются обе базы данных: SQLite и PostgreSQL.

• Если вы планируете запускать более 500 нод: Устанавливайте софт только на Ubuntu, так как в Windows есть системное ограничение — максимум 512 открытых дескрипторов, которое невозможно обойти. 👉 [Гайд по увеличению лимита дескрипторов на Ubuntu — CLICK]

• В софте реализована полноценная поддержка TAP-соединений, полностью воспроизводящая оригинальную логику браузерного расширения. Это включает в себя низкоуровневую реализацию WebRTC, полную обработку offer/answer обмена, передачу ICE-кандидатов, маршрутизацию через NAT, а также корректную генерацию, приём TAP-сообщений и остальной функционал вебсокета.

---

🌐 Прокси

⚠️ Использование прокси — обязательно

• Как это работает: Каждому аккаунту назначается прокси из вашего списка и сохраняется в базе данных. Если в процессе работы прокси даст сбой, софт автоматически подставит следующую доступную из списка.

• Уникальность прокси (по умолчанию включена): Параметр check_uniqueness_of_proxies: True означает, что каждому аккаунту/ноде будет назначена уникальная прокси. Если в списке не хватает уникальных прокси, вы получите ошибку: No available proxies. В этом случае необходимо обновить список прокси и перезапустить программу.

• Когда можно отключить проверку уникальности: Отключение check_uniqueness_of_proxies допустимо только если все ваши прокси имеют одинаковый формат и не требуют раздельного использования.

Рекомендации по выбору прокси:

• Используйте резидентские прокси

• Генерируйте sticky-сессии (не rotate)

• Если прокси поддерживают TTL (time to live) — устанавливайте максимально возможное значение

---

📊 Фарм

📊 Распределение логических процессоров (cpu_thread_count)

Параметр cpu_thread_count определяет, сколько логических потоков процессора (threads) будет использоваться для фарма. От этого напрямую зависит скорость обработки нод и общая производительность системы.

Фарм использует логические потоки CPU для параллельной обработки задач:

• Каждый поток обслуживает часть нод независимо от других.

• Чем больше потоков вы задействуете, тем больше нод обрабатывается одновременно.

• Однако при перегрузке — особенно если задействованы все потоки без остатка — система может начать тормозить.

🧩 Как определить оптимальное значение cpu_thread_count

1. Узнайте количество логических потоков у вашего процессора. Пример: Ryzen 5 3600X — 6 ядер / 12 потоков.

2. Вычтите один поток для системных нужд. Это позволит избежать лагов и конфликтов с ОС, логами и другими процессами. Пример: 12 – 1 = 11 — безопасный максимум.

3. Выберите значение в зависимости от количества нод

📌 Рекомендации по количеству нод на 1 поток

• На обычных VPS рекомендуется распределять: ~1000–1200 нод на 1 логический поток.

• Если у вас мощный VPS или выделенный сервер с высокопроизводительным CPU: можно повышать лимит до 2000–5000 нод на поток.

⚠️ Обязательно тестируйте, насколько ваша система справляется с нагрузкой. У разных машин пропускная способность и стабильность могут сильно отличаться — найдите баланс между производительностью и стабильностью.

---

📁 Экспорт результатов

Все результаты работы каждого модуля автоматически сохраняются в папку results/название_модуля

Для каждого модуля создаются два отдельных файла:

• ✅ success.txt — список аккаунтов, которые успешно завершили выполнение задач.

• ❌ failed.txt — аккаунты, которые завершили работу с ошибкой (например, из-за плохого прокси, лимита или других сбоев).

🔍 Это позволяет быстро:

• Проверить, какие аккаунты успешно отработали

• Найти и повторно обработать только проблемные аккаунты из failed

---

⚙️ Конфигурация (settings.yaml)

LICENSE_KEY: "" 
# Ваш лицензионный ключ. Без него софт не запустится.

gradient_settings:
  sdk_version: "0.0.12"
  extension_version: "1.1.5"
  # Актуальная версия расширения и SDK
  
  ice_servers:
    - stun:stun.l.google.com:19302
#    - stun:stun.gradient.network:3478


application_settings:
  threads: 1 
  # Количество одновременных потоков (аккаунтов), которые будет запускать бот.
  # Применяется ко всем модулям, кроме фарма.

  cpu_thread_count: 6 
  # Количество логических потоков процессора, которые будут использоваться для фарма.
  # Подробнее см. в разделе про распределение нагрузки на CPU.
  
  recursion_limit: 10000
  # Рекурсивный лимит для python, не изменяйте это значение, если вы не знаете для чего оно

  database_url: "sqlite://./database.sqlite3"
  # Ссылка на базу данных.
  # Формат для PostgreSQL: postgres://user:password@localhost/dbname
  # Формат для SQLite: sqlite://./database.sqlite3

  skip_logged_accounts: true
  # Если true — аккаунты, уже находящиеся в БД, будут пропущены.
  # Если false — бот выполнит повторный вход (релогин).

  shuffle_accounts: true
  # Если true — аккаунты будут запускаться в случайном порядке.
  # Если false — запуск будет происходить строго по списку.

  check_uniqueness_of_proxies: true
  # Проверка уникальности прокси. (смотрите выше)
  

nodes_settings:
  enable_nodes_verification: false
  # Если true — будет проверяться не забанена ли нода (прокси)
  # Если забанена, прокси автоматически заменится.
  # Частота проверок регулируется параметром delay_between_verification.

  disable_auto_proxy_change: false
  # Если true — прокси не будет меняться при ошибках.
  # Рекомендуется включать только при использовании стабильных ISP/серверных прокси.

  max_active_nodes: 10
  # Максимальное количество активных нод для каждого аккаунта
  
  max_generate_nodes: 10
  # Максимальное количество нод для генерации
  # Если вы например сгенерировали ранее 11 и запустили снова генерацию - софт пропустит аккаунт так как лимит уже достигнут

  generate_count:
    min: 1
    max: 5
  # Количество нод для генерации (ОТ и ДО)
  # Максимально допустимого значения нету, но не рекомендуется генерировать больше 10 из за рисков бана

  delay_between_generation:
    min: 10
    max: 30
  # Задержка между генерацией нод (в секундах)

  delay_between_verification:
    min: 30
    max: 90
  # Задержка между верификацией нод (в минутах)
  # Относиться к enable_nodes_verification



attempts_and_delay_settings:
  delay_before_start:
    min: 30
    max: 60
    # Задержка перед началом работы каждого аккаунта (в секундах).
    # Значение выбирается случайно из указанного диапазона.

  error_delay: 5
  # Задержка после любой ошибки перед повторной попыткой (в секундах).

  max_register_attempts: 3
  # Количество попыток регистрации аккаунта.

  max_login_attempts: 3
  # Количество попыток входа в аккаунт.

  max_stats_attempts: 3
  # Количество попыток получения статистики.

  max_farm_attempts: 5
  # Количество попыток подключения к WebSocket (фарм).

  max_verify_node_attempts: 3
  # Количество попыток верификации ноды.
  
  max_generate_attempts: 5
  # Количество попыток для генерации нод
  
  max_twitter_connect_attempts: 3
  # Количество попыток для коннекта твитер аккаунта
  # Если попытка неудачная - софт автоматически удаляет auth_token и берет новый

  max_discord_connect_attempts: 3
  # Количество попыток для коннекта дискорд  аккаунта
  # Если попытка неудачная - софт автоматически удаляет auth_token и берет новый

captcha_settings:
  captcha_service: "anti_captcha"
  # Сервис для решения капчи: 2captcha, anticaptcha или solvium

  max_captcha_solving_time: 60
  # Максимальное время ожидания решения капчи (в секундах).
  
  proxy_for_client: ""
  # Прокси для клиента капчи если по какой то причине ваш сервер блокирует соединение
  # Формат: http://user:pass@ip:port

  two_captcha_api_key: ""
  anti_captcha_api_key: ""
  solvium_api_key: ""
  # API-ключи для выбранных капча-сервисов.


redirect_settings:
  enable: false
  email: ""
  password: ""
  imap_server: ""
  # Если включено — бот будет искать письма на этой почте.
  # Вместо пароля от почты, которую вы будете указывать в файле, можно указать любую строку — реальная авторизация будет происходить через redirect-почту.


imap_settings:
  use_proxy_for_imap: false
  # Если true — IMAP-подключение к почте будет происходить через прокси.

  use_single_imap:
    enable: false
    imap_server: "imap.gmail.com"
    # Включает использование одного IMAP-сервера для всех почтовых доменов (если у вас один домен на все почты).

  servers:
    gmail.com: imap.gmail.com
    yahoo.com: imap.mail.yahoo.com
    icloud.com: imap.mail.me.com
    mail.ru: imap.mail.ru
    gmx.com: imap.gmx.com
    gmx.net: imap.gmx.net
    gmx.de: imap.gmx.net
    onet.pl: imap.poczta.onet.pl
    onet.com.pl: imap.poczta.onet.pl
    op.pl: imap.poczta.onet.pl
    onet.eu: imap.poczta.onet.pl
    gazeta.pl: imap.gazeta.pl
    # Список IMAP-серверов для популярных почтовых доменов.
    # Если в списке нету вашего домена - добавьте самостоятельно.

---

📂 Форматы для файлов

Все файлы находятся в папке: config/data

📄 Файл	🧾 Формат строки	💬 Примечание
proxies.txt	http://user:pass@ip:port http://ip:port:user:pass http://ip:port@user:pass	Поддерживаются только HTTP прокси
register_accounts.txt	email:email_password	Для регистрации новых аккаунтов
login_accounts.txt	email:account_password	Для логина
export_stats_accounts.txt	email	Для экспорта статистики
farm_accounts.txt	email	Для запуска фарма
referral_codes.txt	5445fd https://app.gradient.network/signup?code=5445fd	Поддержка как кода, так и полной ссылки
generate_nodes_accounts.txt	email	Для генерации нод
connect_twitter_accounts.txt	email	Для привязки твитера
conecct_discord_accounts.txt	email	Для привязки дискорда
twitter_tokens.txt	auth_token	Авторизационные токены твитер аккаунтов
discord_tokens.txt	auth_token	Авторизационные токены дискорд аккаунтов