> For the complete documentation index, see [llms.txt](https://jammers-organization.gitbook.io/jambit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jammers-organization.gitbook.io/jambit/depin/despeed/gaid.md).

# Гайд

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

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

***

## 🌐 **Прокси**

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

* **Как это работает:**\
  Каждому аккаунту назначается прокси из вашего списка и сохраняется в базе данных.\
  Если в процессе работы прокси даст сбой, софт автоматически подставит следующую доступную из списка.
* **Уникальность прокси (по умолчанию включена):**\
  Параметр `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`&#x20;

***

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

{% code overflow="wrap" fullWidth="true" %}

```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
  # Проверка уникальности прокси. (смотрите выше)
  
  gen_random_pass_for_accounts: true
  # Если true - будет генерироваться уникальный пароль при регистрации
  # Если false - будет использоваться пароль от почты
  
  auto_claim_daily_reward: true
  # Если 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_verify_attempts: 3
  # Количество попыток для верификации почты
  
  max_captcha_attempts: 10
  # Количество попыток для решения капчи
  
  max_farm_attempts: 3
  # Количество попыток для фарма 
  
  max_daily_reward_attempts: 3
  # Количество попыток для клейма ежедневной награды


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

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

  solvium_captcha_api_key: ""
  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-серверов для популярных почтовых доменов.
    # Если в списке нету вашего домена - добавьте самостоятельно.


```

{% endcode %}

***

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

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

<table><thead><tr><th width="252">📄 Файл</th><th width="328">🧾 Формат строки</th><th width="176">💬 Примечание</th></tr></thead><tbody><tr><td><code>proxies.txt</code></td><td><code>http://user:pass@ip:port</code><br><code>http://ip:port:user:pass</code><br><code>http://ip:port@user:pass</code></td><td>Поддерживаются только HTTP прокси</td></tr><tr><td><code>register_accounts.txt</code></td><td><code>email:email_password</code></td><td>Для регистрации новых аккаунтов</td></tr><tr><td><code>verify_accounts.txt</code></td><td><code>email:email_password:account_password</code></td><td>Для верификации</td></tr><tr><td><code>login_accounts.txt</code></td><td><code>email:account_password</code></td><td>Поддержка логина как по паролю, так и через почту</td></tr><tr><td><code>export_stats_accounts.txt</code></td><td><code>email</code></td><td>Для экспорта статистики</td></tr><tr><td><code>farm_accounts.txt</code></td><td><code>email</code></td><td>Для запуска фарма</td></tr><tr><td><code>referral_codes.txt</code></td><td><code>https://app.despeed.net/register?ref=sdsdf</code> or <code>sdsdf</code> </td><td>Реферальный код или ссылка</td></tr></tbody></table>
