GotaTun

Реализация WireGuard^® в пространстве пользователя, форк BoringTun.

Лицензия

Весь исходный код в этом репозитории, если не указано иное, распространяется на условиях Mozilla Public License версии 2.0. Копию этой лицензии можно найти в файле «LICENSE» или по адресу https://www.mozilla.org/MPL/2.0/.

Вклады, сделанные до 5 марта 2026 года, распространяются на условиях старой лицензии BSD (3 пункта). Копию этой лицензии можно найти в файле «LICENSE-CLOUDFLARE».

Вклад

Если вы явно не укажете иное, любой вклад, намеренно предоставленный вами для включения в проект, как это определено в лицензии MPL-2.0, лицензируется на указанных выше условиях без каких-либо дополнительных условий.

Сборка

• Только библиотека: cargo build --lib --no-default-features --release [--target $(TARGET_TRIPLE)]
• Исполняемый файл: cargo build --bin gotatun --release [--target $(TARGET_TRIPLE)]

Установка

По умолчанию исполняемый файл помещается в папку ./target/release. Вы можете вручную скопировать его в нужное место или установить с помощью cargo install --bin gotatun --path ..

Nix

Чтобы собрать исполняемый файл, просто выполните nix build .#gotatun. Итоговый бинарный файл будет находиться в result/bin/gotatun.

Запуск

Согласно спецификации, для запуска туннеля используйте:

gotatun [-f/--foreground] INTERFACE-NAME

Затем туннель можно настроить с помощью wg, как обычный туннель WireGuard, либо любым другим инструментом.

Также его можно использовать с wg-quick, установив переменную окружения WG_QUICK_USERSPACE_IMPLEMENTATION в значение gotatun. Например:

sudo WG_QUICK_USERSPACE_IMPLEMENTATION=gotatun WG_SUDO=1 wg-quick up CONFIGURATION

Обратите внимание: wg-quick проигнорирует WG_QUICK_USERSPACE_IMPLEMENTATION в Linux, если у вас установлен модуль ядра wireguard.

Тестирование

Тестирование этого проекта требует выполнения нескольких условий:

• sudo: требуется для создания туннелей. При запуске cargo test у вас запросят пароль.
• Docker: вы можете установить его здесь. Если вы используете Ubuntu/Debian, можно выполнить apt-get install docker.io.

Поддерживаемые платформы

_{Другие целевые платформы могут работать, но мы тестируем только перечисленные}

Linux

Поддерживаются архитектуры x86-64 и aarch64. Поведение должно быть идентично поведению wireguard-go, за исключением следующего отличия:

При запуске gotatun сбрасывает привилегии. После сброса привилегий установить fwmark невозможно. Если fwmark требуется, например при использовании wg-quick, запускайте с флагом --disable-drop-privileges или установите переменную окружения WG_SUDO=1.

Вам нужно выдать исполняемому файлу capability CAP_NET_ADMIN с помощью: sudo setcap cap_net_admin+epi gotatun. sudo не требуется.

macOS

Поведение аналогично поведению wireguard-go. В частности, имя интерфейса должно быть utun[0-9]+ для явного имени или utun, чтобы ядро выбрало наименьший доступный номер. Если вы выберете utun в качестве имени интерфейса и будет определена переменная окружения WG_TUN_NAME_FILE, фактическое имя интерфейса, выбранное ядром, будет записано в файл, указанный этой переменной.

Расширения UAPI

См. UAPI — расширения протокола конфигурации wg.

---

Аудиты

По проекту были проведены независимые аудиты безопасности. См. каталог audit.

---

_{WireGuard является зарегистрированным товарным знаком Джейсона А. Доненфельда. GotaTun не спонсируется и не поддерживается Джейсоном А. Доненфельдом.}