From 0b06798a593f5bded58ec89b443c22f251974092 Mon Sep 17 00:00:00 2001 From: y0sy4 Date: Sun, 22 Mar 2026 21:21:16 +0300 Subject: [PATCH] Add FAQ and improve README for beginners --- FAQ.md | 205 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 97 ++++++++++++++++++++++++++ 2 files changed, 302 insertions(+) create mode 100644 FAQ.md diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 0000000..388d33c --- /dev/null +++ b/FAQ.md @@ -0,0 +1,205 @@ +# ❓ Частые вопросы (FAQ) + +## 📌 Для новичков + +### Что такое TG WS Proxy? + +**TG WS Proxy** — это программа, которая ускоряет работу Telegram в регионах, где он заблокирован или работает медленно. Она создаёт локальный прокси-сервер на вашем компьютере и перенаправляет трафик Telegram через WebSocket-соединения. + +### Зачем мне это нужно? + +- 🚀 **Ускорение Telegram** — если Telegram работает медленно +- 🔓 **Обход блокировок** — если Telegram заблокирован провайдером +- 🔒 **Безопасность** — весь трафик остаётся зашифрованным +- 💻 **Локально** — не нужны сторонние сервера, всё работает на вашем ПК + +### Это безопасно? + +**Да!** Программа: +- ✅ Не хранит ваши данные +- ✅ Не передаёт информацию третьим лицам +- ✅ Работает локально на вашем компьютере +- ✅ Имеет открытый исходный код (можно проверить) + +--- + +## 🚀 Установка и запуск + +### Как установить? + +**Windows:** +1. Скачайте `TgWsProxy_windows_amd64.exe` из [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases) +2. Сохраните в любую папку (например, `C:\Programs\TgWsProxy\`) +3. Запустите файл + +**macOS:** +1. Скачайте `TgWsProxy_darwin_amd64` (Intel) или `TgWsProxy_darwin_arm64` (Apple Silicon) +2. Откройте Терминал и выполните: + ```bash + chmod +x ~/Downloads/TgWsProxy_darwin_amd64 + ~/Downloads/TgWsProxy_darwin_amd64 + ``` + +**Linux:** +1. Скачайте `TgWsProxy_linux_amd64` +2. Откройте терминал и выполните: + ```bash + chmod +x ~/Downloads/TgWsProxy_linux_amd64 + ~/Downloads/TgWsProxy_linux_amd64 + ``` + +### Я запустил, но ничего не происходит! + +Это нормально! Программа работает в фоновом режиме. Проверьте: + +**Windows:** +- Откройте Диспетчер задач → Процессы +- Найдите `TgWsProxy.exe` + +**macOS/Linux:** +- Откройте Терминал +- Выполните `ps aux | grep TgWsProxy` + +### Как проверить что работает? + +1. Откройте браузер +2. Перейдите на `http://127.0.0.1:1080` +3. Если видите ошибку — **это хорошо!** Значит прокси работает (это не веб-сервер) + +Или посмотрите логи: +- **Windows:** `%APPDATA%\TgWsProxy\proxy.log` +- **Linux/macOS:** `~/.TgWsProxy/proxy.log` + +--- + +## 🔧 Настройка Telegram + +### Как настроить прокси в Telegram? + +**Автоматически:** +При запуске программа сама откроет Telegram с настройками прокси. Просто подтвердите! + +**Вручную:** + +**Telegram Desktop:** +1. Откройте **Настройки** → **Продвинутые** → **Тип подключения** → **Прокси** +2. Нажмите **Добавить прокси** +3. Выберите **SOCKS5** +4. Введите: + - **Сервер:** `127.0.0.1` + - **Порт:** `1080` + - **Логин:** (оставьте пустым) + - **Пароль:** (оставьте пустым) +5. Нажмите **Сохранить** + +**Telegram на Android:** +1. Настройки → Данные и память → Прокси-сервер +2. Включить прокси +3. Добавить прокси +4. Тип: **SOCKS5** +5. Хост: `127.0.0.1` +6. Порт: `1080` + +**Telegram на iOS:** +1. Настройки → Данные и память → Использовать прокси +2. Включить прокси +3. Добавить прокси +4. Тип: **SOCKS5** +5. Хост: `127.0.0.1` +6. Порт: `1080` + +### Telegram не открывается автоматически! + +Это нормально. Настройте вручную (см. выше) или: + +1. Откройте браузер +2. Перейдите по ссылке: `tg://socks?server=127.0.0.1&port=1080` +3. Telegram должен открыться с настройками прокси + +--- + +## 🔍 Решение проблем + +### "Прокси не подключается" + +**Проверьте:** +1. Запущена ли программа `TgWsProxy` +2. Не блокирует ли антивирус +3. Правильно ли настроен Telegram (127.0.0.1:1080) + +**Попробуйте:** +1. Перезапустите `TgWsProxy` +2. Перезапустите Telegram +3. Проверьте логи программы + +### "Слишком много подключений" + +Это нормально! Программа создаёт пул соединений для ускорения работы. + +### "Не работает IPv6" + +Программа поддерживает IPv6 через NAT64. Если у вас только IPv6: +- Попробуйте включить IPv4 на роутере +- Или используйте VPN для доступа к IPv4 + +### Антивирус блокирует программу! + +Это ложное срабатывание. Добавьте программу в исключения: +- Программа имеет открытый исходный код +- Не содержит вредоносного кода +- Работает только с Telegram + +### Как обновить программу? + +**Автоматически:** +При запуске программа проверит наличие новой версии и скачает её. + +**Вручную:** +1. Скачайте новую версию из [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases) +2. Замените старый файл новым +3. Перезапустите программу + +### Как удалить программу? + +Просто удалите файл `TgWsProxy.exe` (или аналогичный для вашей ОС) и папку с логами: +- **Windows:** `%APPDATA%\TgWsProxy\` +- **Linux/macOS:** `~/.TgWsProxy/` + +--- + +## ⚙️ Продвинутые настройки + +### Как изменить порт? + +```bash +TgWsProxy.exe --port 9050 +``` + +### Как использовать аутентификацию? + +```bash +TgWsProxy.exe --auth "username:password" +``` + +В Telegram укажите те же логин и пароль. + +### Как выбрать другие DC сервера? + +```bash +TgWsProxy.exe --dc-ip "2:149.154.167.220,4:149.154.167.220" +``` + +### Где логи программы? + +- **Windows:** `%APPDATA%\TgWsProxy\proxy.log` +- **Linux:** `~/.TgWsProxy/proxy.log` +- **macOS:** `~/.TgWsProxy/proxy.log` + +--- + +## 📞 Ещё вопросы? + +Если вы не нашли ответ на свой вопрос: +- 📖 Прочитайте [документацию](https://github.com/y0sy4/tg-ws-proxy-go#readme) +- 🐛 Создайте [Issue](https://github.com/y0sy4/tg-ws-proxy-go/issues) +- 💬 Спросите в [Discussions](https://github.com/y0sy4/tg-ws-proxy-go/discussions) diff --git a/README.md b/README.md index 225c943..c6480d8 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,16 @@ Ускоряет работу Telegram через WebSocket-соединения напрямую к серверам Telegram. +--- + +## 👶 Вы новичок? Начните здесь! + +1. **[📥 Скачать программу](https://github.com/y0sy4/tg-ws-proxy-go/releases)** — выберите свою платформу +2. **[❓ FAQ — Частые вопросы](FAQ.md)** — ответы на все вопросы +3. **[🚀 Быстрый старт](#быстрый-старт)** — инструкция по запуску + +--- + ## Почему Go версия лучше | Параметр | Python | Go | @@ -42,6 +52,55 @@ start run.bat ./TgWsProxy --port 9050 --dc-ip 2:149.154.167.220 ``` +--- + +## 📖 Подробная инструкция для новичков + +### Шаг 1: Скачивание + +1. Откройте страницу [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases) +2. Найдите свою платформу в таблице +3. Нажмите на ссылку скачивания (например, `TgWsProxy_windows_amd64.exe`) + +### Шаг 2: Установка + +**Windows:** +- Просто сохраните файл в любую папку (например, `C:\Programs\TgWsProxy\`) +- Создайте ярлык на рабочем столе (по желанию) + +**macOS/Linux:** +- Сохраните файл в папку `~/Applications/` +- Откройте терминал и выполните: + ```bash + chmod +x ~/Applications/TgWsProxy + ``` + +### Шаг 3: Запуск + +**Windows:** +- Дважды кликните на `TgWsProxy.exe` +- Откроется окно Telegram с настройками прокси + +**macOS/Linux:** +- Откройте терминал +- Выполните: `./TgWsProxy` + +### Шаг 4: Настройка Telegram + +Если Telegram не открылся автоматически: + +1. Откройте браузер +2. Перейдите по ссылке: `tg://socks?server=127.0.0.1&port=1080` +3. Подтвердите добавление прокси + +Или настройте вручную: +- **Настройки** → **Продвинутые** → **Прокси** → **Добавить** +- Тип: **SOCKS5** +- Сервер: **127.0.0.1** +- Порт: **1080** + +--- + ## Настройка Telegram Desktop ### Автоматическая настройка @@ -188,6 +247,44 @@ make android # Android (.aar библиотека) | Время запуска | <100 ms | | Задержка (pool hit) | <1 ms | +## 🔍 Решение проблем + +### Прокси не подключается + +**Проверьте:** +1. ✅ Запущена ли программа `TgWsProxy` +2. ✅ Правильно ли настроен Telegram (127.0.0.1:1080) +3. ✅ Не блокирует ли антивирус + +**Попробуйте:** +1. Перезапустите `TgWsProxy` +2. Перезапустите Telegram +3. Проверьте логи: `%APPDATA%\TgWsProxy\proxy.log` + +### Telegram не открывается автоматически + +Откройте вручную: `tg://socks?server=127.0.0.1&port=1080` + +Или настройте вручную (см. выше). + +### Антивирус блокирует программу + +Это ложное срабатывание. Добавьте программу в исключения: +- Программа имеет открытый исходный код +- Не содержит вредоносного кода + +### Как обновить? + +**Автоматически:** При запуске программа проверит и скачает обновление. + +**Вручную:** Скачайте новую версию из [Releases](https://github.com/y0sy4/tg-ws-proxy-go/releases) и замените файл. + +### Ещё вопросы? + +Смотрите **[❓ FAQ](FAQ.md)** — там ответы на все вопросы! + +--- + ## Требования - **Go 1.21+** для сборки