README.md

О проекте

Free Turn Proxy - прокси-туннель для инкапсуляции UDP-трафика поверх протокола TURN. Клиент извлекает временные TURN-учётки из ссылок на WebRTC-звонки и прозрачно маршрутизирует ваш VPN-трафик (WireGuard, AmneziaWG) до сервера на VPS, используя DTLS и мощные механизмы маскировки пакетов.

Разработка

Зависимости

• Go ≥ 1.26 - https://go.dev/dl/
• Task (runner) - go install github.com/go-task/task/v3/cmd/task@v3.40.0 или winget install Task.Task / brew install go-task

Остальные dev-инструменты (golangci-lint, govulncheck, goimports, goreleaser) ставит сам Task:

task tools:install

Команды

task                # список доступных задач
task build          # собрать client + server в dist/ для текущего хоста
task build:all      # кросс-сборка всех target через goreleaser snapshot
task build:ios      # сборка XCFramework для iOS в dist/Mobile.xcframework
task build:android  # сборка AAR архива для Android в dist/freeturn.aar
task test           # go test -race
task test:cover     # тесты + покрытие -> cover.html
task lint           # golangci-lint
task fmt            # gofmt + goimports (форматирование)
task fmt:check      # проверить форматирование (используется в CI)
task vet            # go vet
task vuln           # govulncheck
task ci             # полный набор: fmt:check + vet + lint + test + vuln
task tidy           # go mod tidy
task clean          # удалить dist/, cover.out, cover.html

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

• Быстрый старт
• Режимы
• Флаги
• Развёртывание
• Мобильные Устройства
• URI и форматы ссылок
• Подписки (Subscriptions)
• Провайдеры
• Решение проблем

Благодарности

Огромное спасибо за вклад и идеи:

• @cacggghp
• @Moroka8
• @alxmcp
• @TheAirBlow