📚Гайд

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

• Данный софт имеет открытый исходный код

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

---

🌐 Прокси

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

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

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

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

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

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

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

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

---

📊 Фарм

💡 Особенности распределения нагрузки

В отличие от платных решений, где используется распределение задач по логическим потокам процессора (CPU threads), в данном софте применяется обычная потоковая модель, то есть вся нагрузка обрабатывается на одном ядре.

Это означает, что чем больше потоков (аккаунтов) вы запускаете одновременно — тем выше нагрузка на одно ядро процессора. Поэтому важно учитывать баланс между количеством потоков и реальной производительностью вашей машины.

---

🧩 Как работает параметр threads

Параметр threadsуказывает, сколько аккаунтов будет одновременно фармить в одной консоли.

Пример:

• threads: 1000 означает, что 1000 аккаунтов обрабатываются одновременно (внутри одного ядра).

• Чем выше значение — тем выше одновременная нагрузка и потенциальные задержки в работе.

---

📌 Рекомендации

• Не запускайте слишком много аккаунтов в одной консоли. Оптимально — до 5000 аккаунтов на один запуск.

• Если вы планируете фармить например 1000 аккаунтов, рекомендуется ставить не менее 400–500 threads , чтобы все аккаунты успевали стабильно фармить.

---

⚠️ Важно: всегда следите за нагрузкой на CPU. При превышении возможностей машины возможны зависания, снижение скорости или пропуски в фарме.

---

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

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

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

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

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

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

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

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

---

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

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

  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
  # Проверка уникальности прокси. (смотрите выше)
  

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_tasks_attempts: 3
  # Количество попыток для прохождения заданий.

  max_attempts_to_receive_app_id: 3
  # Количество попыток для получения APP ID
  
  max_attempts_to_verify_email: 3
  # Количество попыток для верификации емейла
  
  max_attempts_to_send_keepalive: 3
  # Количество попыток для отправки "пинг" запросов к серверу во время фарма


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

  max_captcha_solving_time: 60
  # Максимальное время ожидания решения капчи (в секундах).

  two_captcha_api_key: ""
  anti_captcha_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	Для регистрации новых аккаунтов
verify_accounts.txt	email:email_password	Для верификации
login_accounts.txt	email:account_password	Поддержка логина как по паролю, так и через почту
export_stats_accounts.txt	email	Для экспорта статистики
farm_accounts.txt	email	Для запуска фарма
complete_tasks_accounts.txt	email	Для выполнения заданий
referral_codes.txt	FPlNRnGjDbPN9uA	Реферальный код