mirror of
https://github.com/hackdiaz-dev/free-turn-proxy.git
synced 2026-10-12 09:41:53 +02:00
samosvalishe
daf8cece80
- генерация 18 параметров amneziawg 3.1 и docker-compose для freeturn-awg - команды cli и rpc v2 для управления пирами и вывода qr-кодов (direct и relay) - раздельная установка, переконфигурация и раздельное удаление компонентов - набор из 27 автоматических bats-тестов установщика - актуализация документации по прямому режиму и развёртыванию
75 lines
4.5 KiB
Markdown
75 lines
4.5 KiB
Markdown
# Быстрый Старт
|
|
|
|
## Требования
|
|
- **VPS с публичным IP** (скрипт установки сам развернет Docker и VPN-бэкенд AmneziaWG 3.1 / WireGuard).
|
|
- **Активная ссылка VK Calls**: `https://vk.ru/call/join/...` (создайте сами, звонок не завершайте).
|
|
|
|
---
|
|
|
|
## Шаг 1: Запуск Сервера (VPS)
|
|
|
|
Интерактивный скрипт поднимет Docker Compose со службами `free-turn-proxy` и `freeturn-awg` (AmneziaWG 3.1), сгенерирует ключи обфускации, создаст первого клиента и выведет **QR-код прямо в терминале**:
|
|
|
|
```bash
|
|
curl -fsSL https://raw.githubusercontent.com/samosvalishe/free-turn-proxy/master/scripts/install.sh | sudo bash
|
|
```
|
|
|
|
> [!TIP]
|
|
> **Прямое подключение (Direct AWG):** Отсканируйте выведенный терминальный QR-код в официальном приложении **AmneziaWG/AmneziaVPN** на телефоне (или импортируйте `.conf` на ПК) - туннель готов к работе сразу!
|
|
>
|
|
> **Добавление новых клиентов:** Выполните на сервере:
|
|
> ```bash
|
|
> sudo bash install.sh client add myphone
|
|
> ```
|
|
|
|
---
|
|
|
|
## Шаг 2: Запуск Клиента Free Turn Proxy (ПК)
|
|
|
|
Если прямой UDP до вашего VPS блокируется провайдером, запустите клиент `free-turn-proxy`. Он перенаправит трафик через TURN-релей провайдера под видом аудиозвонка. Клиент автоматически создаёт маршруты-исключения для IP TURN-серверов (`-routes`).
|
|
|
|
**Linux:**
|
|
```bash
|
|
curl -L -o client https://github.com/samosvalishe/free-turn-proxy/releases/latest/download/client-linux-amd64
|
|
chmod +x client
|
|
sudo ./client -listen 127.0.0.1:9000 -peer <vps_ip>:56000 -link "<vk-link>" -obf-profile rtpopus3 -obf-key <ВАШ_КЛЮЧ> -client-id <ВАШ_CLIENT_ID> -routes
|
|
```
|
|
|
|
**Windows (PowerShell от администратора):**
|
|
```powershell
|
|
Invoke-WebRequest -Uri https://github.com/samosvalishe/free-turn-proxy/releases/latest/download/client-windows-amd64.exe -OutFile client.exe
|
|
.\client.exe -peer <vps_ip>:56000 -provider vk -link "<vk-link>" -listen 127.0.0.1:9000 -n 12 -streams-per-cred 12 -obf-profile rtpopus3 -obf-key <ВАШ_КЛЮЧ> -dns-servers 192.168.31.1 -dns-mode doh -client-id <ВАШ_CLIENT_ID> -routes
|
|
```
|
|
|
|
**macOS:**
|
|
```bash
|
|
# Apple Silicon (M1/M2/M3): client-darwin-arm64 | Intel: client-darwin-amd64
|
|
sudo ./client -listen 127.0.0.1:9000 -peer <vps_ip>:56000 -link "<vk-link>" -obf-profile rtpopus3 -obf-key <ВАШ_КЛЮЧ> -client-id <ВАШ_CLIENT_ID> -routes
|
|
```
|
|
|
|
> **Важно:** В настройках вашего VPN-клиента (AmneziaWG или WireGuard) при работе через прокси используйте релейный конфиг (`client-1-relay.conf`, где `Endpoint = 127.0.0.1:9000` и `MTU = 1280`). Включайте VPN *только после того*, как клиент выведет `Ensuring route to ...`.
|
|
|
|
> [!TIP]
|
|
> **Упрощение:** Вместо длинных флагов можно передать ссылку `freeturn://` (генерируется установщиком) или подписку (`-sub`):
|
|
> ```bash
|
|
> sudo ./client "freeturn://eyJ2Ijox..." -link "<vk-link>" -routes
|
|
> ```
|
|
> Подробнее в [uri.md](uri.md) и [sub.md](sub.md).
|
|
|
|
---
|
|
|
|
## Шаг 3: Мобильные Устройства (Termux)
|
|
|
|
На мобильных сетях маршруты не нужны, но есть своя специфика (блокировка DNS, добавление в исключения VPN).
|
|
|
|
```bash
|
|
termux-wake-lock
|
|
# Скачивание: curl -L -o client https://github.com/samosvalishe/free-turn-proxy/releases/latest/download/client-android-arm64 && chmod +x client
|
|
|
|
# Обязательно укажите ваш ключ и DNS оператора (можно узнать в настройках APN)
|
|
./client -listen 127.0.0.1:9000 -peer <vps_ip>:56000 -link "<vk-link>" -obf-profile rtpopus3 -obf-key <ВАШ_КЛЮЧ> -dns-servers <ip_dns_оператора> -client-id <ВАШ_CLIENT_ID>
|
|
```
|
|
|
|
> Обязательно добавьте приложение Termux в исключения вашего VPN-клиента. Подробнее в [mobile.md](mobile.md).
|
|
|