tg-ws-proxy-go/README.md

TG WS Proxy Go

SOCKS5-прокси для Telegram Desktop на Go. Ускоряет Telegram через WebSocket к серверам Telegram.

---

📥 Скачать (v2.0.5)

Windows	Linux	macOS
⬇️ .exe (9 MB)	⬇️ amd64 (8.9 MB)	⬇️ Intel / ⬇️ ARM

---

🚀 Быстрый старт

Windows

1. Скачай TgWsProxy_windows_amd64.exe
2. Дважды кликни
3. Telegram откроет настройки прокси → нажми "Включить"

Linux/macOS

chmod +x TgWsProxy_*
./TgWsProxy_linux_amd64  # или TgWsProxy_darwin_amd64

Всё! Telegram работает через прокси.

---

⚙️ Опции (для профи)

TgWsProxy.exe [флаги]

Флаг	Описание	По умолчанию
--port	Порт SOCKS5	1080
--host	Хост	127.0.0.1
--dc-ip	DC:IP (через запятую)	авто
--auth	Логин:пароль для прокси	—
--http-port	HTTP прокси (для браузеров)	0 (выкл)
--upstream-proxy	Цепочка через другой прокси	—
-v	Подробные логи	false

Примеры

Просто запустить:

TgWsProxy.exe

HTTP прокси для браузеров (порт 8080):

TgWsProxy.exe --http-port 8080

Теперь браузер можно настроить на 127.0.0.1:8080.

Через другой прокси (Tor, SSH):

TgWsProxy.exe --upstream-proxy "socks5://127.0.0.1:9050"

С паролем:

TgWsProxy.exe --auth "user:pass"

---

🔧 Что нового в v2.0.5

• ⚡ atomic.Int64 для статистики — 0 блокировок
• 🧹 stdlib вместо велосипедов — -100 строк
• 🚀 оптимизация аллокаций — MTProto быстрее на 50%
• 📱 Android/iOS — все оптимизации совместимы

📖 Полные изменения

---

📊 Почему Go?

	Python	Go
Размер	~50 MB	~8 MB
Зависимости	pip	stdlib
Запуск	~500 ms	~50 ms
Память	~50 MB	~10 MB

---

🗂️ Структура

tg-ws-proxy-go/
├── cmd/proxy/          # CLI приложение
├── internal/
│   ├── proxy/          # Ядро прокси
│   ├── socks5/         # SOCKS5 сервер
│   ├── websocket/      # WebSocket клиент
│   ├── mtproto/        # MTProto парсинг
│   ├── pool/           # WebSocket pooling
│   ├── config/         # Конфигурация
│   └── telegram/       # Авто-настройка Telegram
├── mobile/             # Android/iOS bindings
├── go.mod
├── Makefile
└── README.md

---

🛠️ Сборка

# Windows
go build -o TgWsProxy.exe ./cmd/proxy

# Linux
GOOS=linux GOARCH=amd64 go build -o TgWsProxy_linux ./cmd/proxy

# macOS
GOOS=darwin GOARCH=amd64 go build -o TgWsProxy_macos_amd64 ./cmd/proxy
GOOS=darwin GOARCH=arm64 go build -o TgWsProxy_macos_arm64 ./cmd/proxy

# Все платформы
make all

---

📱 Android/iOS

# AAR библиотека
gomobile bind -target android -o android/tgwsproxy.aar ./mobile

Все оптимизации совместимы с gomobile (Go 1.21+).

---

🔍 Решение проблем

Прокси не подключается:

1. Проверь, запущен ли TgWsProxy.exe
2. Убедись, Telegram настроен на 127.0.0.1:1080
3. Проверь логи: %APPDATA%\TgWsProxy\proxy.log

Telegram не открывается: Открой вручную: tg://socks?server=127.0.0.1&port=1080

Антивирус блокирует: Ложное срабатывание. Добавь в исключения. Код открытый.

---

📖 Документация

• ❓ FAQ — частые вопросы
• 📝 Release Notes — изменения v2.0.5
• 👨‍💻 QWEN.md — guidelines для разработчиков

---

🤝 Contributing

1. Fork → branch → PR
2. go test ./...
3. gofmt -w .
4. Без эмоций. По делу.

---

📄 License

MIT License

---

v2.0.5 | Built with ❤️ using Go 1.21