From 7f295428a73452a7c3a1bb1cdc8b3c1813e5917b Mon Sep 17 00:00:00 2001
From: zarazaex69 <zarazaex@tuta.io>
Date: Mon, 11 May 2026 18:20:49 +0300
Subject: [PATCH] doc: add top tips

---
 docs/about.md    | 41 +++++++++++++++++++++++++++++++++++++++--
 docs/fast.md     |  8 ++++++++
 docs/manual.md   |  8 ++++++++
 docs/settings.md |  2 +-
 4 files changed, 56 insertions(+), 3 deletions(-)

diff --git a/docs/about.md b/docs/about.md
index d3e16e8..8430d39 100644
--- a/docs/about.md
+++ b/docs/about.md
@@ -442,7 +442,7 @@ Transport определяет как именно данные упаковыв
 - Работает везде где есть VideoTrack (jazz, telemost, wbstream)
 - Большой пинг из-за батчинга фреймов
 - KCP параметры: MTU 1400, окно 4096, conv ID `0xC0FFEE01`
-- Рекомендуется: `-vp8-fps 60 -vp8-batch 64`
+- Рекомендуется: `-vp8-fps 60 -vp8-batch 64` (если возникают проблемы с производительностью или стабильностью, попробуйте снизить FPS вдвое, например до 30)
 
 ### seichannel
 
@@ -912,7 +912,44 @@ WB Stream - текущий приоритет. Основа уже реализ
 
 ## 21. Частые ошибки
 
-### `Connection refused` на порту SOCKS5 + `i/o timeout` при резолве
+### `i/o timeout` при резолве или "днслик" (DNS leak)
+
+**Симптомы:**
+- Клиент не может зарезолвить адрес SFU (например `stream.wb.ru`).
+- DNS запросы "утекают" мимо туннеля.
+
+**Причина:** порт 53 (стандартный DNS) может перехватываться или блокироваться провайдером.
+
+**Решение:** использовать DNS сервер на 443 порту. Многие публичные DNS серверы (например Google) поддерживают запросы на 443 порту.
+
+```sh
+# в скрипте или через флаг -dns укажите:
+8.8.8.8:443
+```
+
+---
+
+### Сборка вылетает / Ошибка компиляции (не хватает ОЗУ)
+
+**Симптомы:** процесс сборки (`mage build`, `go build` или внутри Docker/Podman) внезапно прерывается с ошибкой `signal: killed` или `out of memory`.
+
+**Причина:** для сборки проекта (особенно с тяжелыми зависимостями или в контейнере) может не хватать оперативной памяти (нужно минимум 2ГБ, лучше 4ГБ+).
+
+**Решение:** включите **SWAP** (файл подкачки). На Linux это делается так:
+
+```bash
+sudo fallocate -l 4G /swapfile
+sudo chmod 600 /swapfile
+sudo mkswap /swapfile
+sudo swapon /swapfile
+# чтобы сохранить после перезагрузки:
+echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
+```
+
+---
+
+### `Connection refused` на порту SOCKS5
+ + `i/o timeout` при резолве
 
 **Симптомы:**
 ```
diff --git a/docs/fast.md b/docs/fast.md
index 4c766c8..253f6eb 100644
--- a/docs/fast.md
+++ b/docs/fast.md
@@ -43,6 +43,14 @@ pacman -S curl        # Arch / CacheOS / Manjaro
 dnf install curl      # Fedora
 ```
 
+### swap (ОЗУ)
+
+Если у вас меньше 4ГБ оперативной памяти, сборка может вылетать. **Обязательно включите SWAP**:
+
+```bash
+sudo fallocate -l 4G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
+```
+
 ---
 
 ## Шаг 1: Скачать репозиторий
diff --git a/docs/manual.md b/docs/manual.md
index 9fb6bc8..4c7f0f8 100644
--- a/docs/manual.md
+++ b/docs/manual.md
@@ -75,6 +75,14 @@ go version
 # go version go1.26.x linux/amd64
 ```
 
+### Шаг 2.5: swap (ОЗУ)
+
+Проекту нужно минимум 2-4ГБ ОЗУ для сборки. Если памяти мало, **включите SWAP**:
+
+```bash
+sudo fallocate -l 4G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile
+```
+
 ---
 
 ## Шаг 3: Установить mage
diff --git a/docs/settings.md b/docs/settings.md
index 9d6424d..e4dd6f5 100644
--- a/docs/settings.md
+++ b/docs/settings.md
@@ -42,7 +42,7 @@
 | `-key` | Ключ шифрования hex 64 символа. Генерация: `openssl rand -hex 32` |
 | `-link` | Всегда `direct` |
 | `-data` | Всегда `data` |
-| `-dns` | DNS-сервер, например `1.1.1.1:53` |
+| `-dns` | DNS-сервер, например `1.1.1.1:53` (попробуйте `8.8.8.8:443` если есть DNS-лики или блокировки) |
 
 ---