HowTo Yggdrasil - yggdrasil:install

Установка в Android

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Apr 2026 19:25:49 +0000

Установка в Android

Приложение можно установить из репозитория бесплатных приложений F-Droid: https://f-droid.org/packages/eu.neilalexander.yggdrasil/

Либо вручную из apk-файла, доступного для скачивания в официальном репозитории на GitHub: https://github.com/yggdrasil-network/yggdrasil-android/releases

Ссылки

https://yggdrasil-network.github.io/installation.html#-android

Установка в Debian

anonymous@undisclosed.example.com (Anonymous) — Mon, 15 Dec 2025 09:42:01 +0000

Установка в Debian

Обновим все уже установленные пакеты в системе [не обязательно]

# apt update && apt upgrade

Установка пакета dirmngr

(пакет нужен для работы с ключами GPG (ключ нужен для загрузки пакетов из репозитория разработчикка yggdrasil)

# apt-get install dirmngr

Загрузка ключа

# gpg --fetch-keys https://neilalexander.s3.dualstack.eu-west-2.amazonaws.com/deb/key.txt

Примечание
Если по каким-то причинам скачать ключ таким образом не удаётся, попробуйте скачать его используя VPN (через браузер), и далее используйте команду: # gpg --import /path/to/key.txt После импорта скачанный ключ можно удалить: # rm /path/to/key.txt

Примечание

Если по каким-то причинам скачать ключ таким образом не удаётся, попробуйте скачать его используя VPN (через браузер), и далее используйте команду:

# gpg --import /path/to/key.txt

После импорта скачанный ключ можно удалить:

# rm /path/to/key.txt

Экспорт ключа в каталог для apt

# gpg --export 1C5162E133015D81A811239D1840CDAC6011C5EA | tee /etc/apt/trusted.gpg.d/yggdrasil-keyring.gpg > /dev/null

Добавляем репозиторий

# echo 'deb [signed-by=/etc/apt/trusted.gpg.d/yggdrasil-keyring.gpg] http://neilalexander.s3.dualstack.eu-west-2.amazonaws.com/deb/ debian yggdrasil' | tee /etc/apt/sources.list.d/yggdrasil.list

Установка Yggdrasil

# apt update && apt install yggdrasil

Примечание
Если автоматически скачать не удалось, скачиваем нужный deb-пакет через VPN (через браузер): wget https://github.com/yggdrasil-network/yggdrasil-go/releases/download/v0.5.12/yggdrasil-0.5.12-amd64.deb Устанавливаем: # dpkg -i yggdrasil-0.5.12-amd64.deb Удаляем скачанный пакет: # rm yggdrasil-0.5.12-amd64.deb Поскольку системе не удаётся получить информацию из репозитория автоматически, можно удалить добавленный репозиторий для того, чтобы в дальнейшем не возникало проблем с обновлением информации о пакетах. # rm /etc/apt/sources.list.d/yggdrasil.list Будем надеяться, в дальнейшем эта проблема решится… ¯\_(ツ)_/¯

Примечание

Если автоматически скачать не удалось, скачиваем нужный deb-пакет через VPN (через браузер):

wget https://github.com/yggdrasil-network/yggdrasil-go/releases/download/v0.5.12/yggdrasil-0.5.12-amd64.deb

Устанавливаем:

# dpkg -i yggdrasil-0.5.12-amd64.deb

Удаляем скачанный пакет:

# rm yggdrasil-0.5.12-amd64.deb

Поскольку системе не удаётся получить информацию из репозитория автоматически, можно удалить добавленный репозиторий для того, чтобы в дальнейшем не возникало проблем с обновлением информации о пакетах.

# rm /etc/apt/sources.list.d/yggdrasil.list

Будем надеяться, в дальнейшем эта проблема решится… ¯\_(ツ)_/¯

Настройка

Сервис установлен, осталось его сконфигурировать (как минимум, нужно прописать в конфигурационный файл 2-3 ближайших к вам пира).

Сделать этоможно вручную, отредактировав файл /etc/yggdrasil/yggdrasil.conf (см. статью Конфигурационный файл Yggdrasil на русском).

Но есть способ настроить автоматическое обновление пиров в конфигурационном файле.

Автоматическое конфигурирование пиров в конфиге Yggdrasil

Для автоматической настройки пиров можно использовать утилиту peers_updater.

Скачиваем:

wget https://github.com/ygguser/peers_updater/releases/download/0.3.4/x86_64-unknown-linux-gnu.zip

Распаковываем:

# apt install unzip
# mkdir -p /opt/peers_updater
# unzip -d /opt/peers_updater/ x86_64-unknown-linux-gnu.zip

Удаляем архив:

# rm x86_64-unknown-linux-gnu.zip

Запускаем peers_updater, чтобы прописать пиры в конфиг:

# /opt/peers_updater/peers_updater -c /etc/yggdrasil/yggdrasil.conf -u

Если всё прошло без ошибок, в конфиге уже должны появиться пиры с минимальным для вас latency.

Теперь можно прописать peers_updater в crontab для того, чтобы пиры обновлялись автоматически (иногда какие-то могут уходить в offline, и могут добавляться новые, с меньшей latency)

# crontab -e

В конец файла прописываем:

20 0 1,15 * * /opt/peers_updater/peers_updater -c /etc/yggdrasil/yggdrasil.conf -u -r >/dev/null 2>&1

Запуск Yggdrasil

Включаем автозапуск и сразу запускаем yggdrasil

# systemctl enable --now yggdrasil

Проверяем работу:

ping -6 -c4 21e:a51c:885b:7db0:166e:927:98cd:d186

Установка завершена.

Далее, рекомендую ознакомиться со статьёй: Установка firewall на yggdrasil сервер

Ссылки

Installation (EN): https://yggdrasil-network.github.io/installation.html

Установка в iOS

anonymous@undisclosed.example.com (Anonymous) — Thu, 02 Apr 2026 19:25:17 +0000

Установка в iOS

Yggdrasil для iOS поддерживается разработчиками Yggdrasil, в частности, neilalexander. На данный момент бета-версия Yggdrasil для iOS доступна для тестирования на платформе TestFlight.

Необходимо установить платформу TestFlight для тестирования бета-версий приложений под iOS: в AppStore вводиим соответствующий поисковый запрос “TestFlight”, у нужного приложения нажимаем кнопку “Загрузить” (прямая ссылка на приложение TestFlight: https://apps.apple.com/ru/app/testflight/id899247664).

Далее, в браузере (напр., Safari) переходим по ссылке: https://testflight.apple.com/join/jZNsIkRr, ссылка автоматически перехватится приложением TestFlight и откроет страничку приложения Yggdrasil c кнопкой “Установить”.

Замечание
Период в тестирования приложения в TestFlight нужно периодически продлевать, разработчики не всегда делают это во время. Если приложение не доступно, обращайтесь сюда: https://github.com/yggdrasil-network/yggdrasil-ios/issues

При первом запуске Yggdrasil на iOS будет предложено установить новый профиль VPN - необходимо согласиться. Этот профиль будет активирован при нажатии переключателя “Enable” в приложении Yggdrasil.

Как и в PC-версии приложения, необходимо указать пиры, к которым вы будете подключены, либо задействовать Multicast Peer Discovery для поиска узлов Yggdrasil в вашей локальной сети. Настройка соответствующих параметров предусмотрена в GUI: Configuration → Peers.

Можно вручную отредактировать конфигурационный файл Yggdrasil для iOS - для этого необходимо его экспортировать, отредактировать любым способом, а затем импортировать. Экспорт и импорт делается с помощью GUI (Configuration → Settings → Export (или Import)).

Ссылки

https://yggdrasil-network.github.io/installation.html#-ios

Установка на роутер Keenetic

anonymous@undisclosed.example.com (Anonymous) — Tue, 14 Apr 2026 17:05:54 +0000

Установка на роутер Keenetic

Просто оставлю здесь ссылку: https://forum.keenetic.ru/topic/14515-yggdrasil-%D0%BD%D0%B0-keenetic/

Если кто-то соберётся описать и здесь - welcome ;)

Ссылки

Инструкции на другом ресурсе (RU): https://forum.keenetic.ru/topic/14515-yggdrasil-%D0%BD%D0%B0-keenetic/

Установка в MikroTik

anonymous@undisclosed.example.com (Anonymous) — Sat, 28 Feb 2026 00:10:43 +0000

Установка в MikroTik

Как многие знают в MikroTik с архитектурой ARM32, ARM64, x86 есть поддержка Docker container тестировал на RBD52G-5HacD2HnD c MikroTik RouterOS 7.21.3 по мотивам GitHub litew, Docker litew и GitHub werwolf, Docker werwolf (у меня они не заработали может я не полностью изучил документацию)

Образы для Docker container

готовый образ под ARM32 v0.5.13 поддерживает 3-и переменные peers, listen, eth

Примерные настройки

Примерные настройки т.к. можно добавить в существующий bridge или создать новый

# создание bridge

/interface/bridge/add name=containers

# добавление интерфейса в bridge

/interface/bridge/port add bridge=containers interface=veth1

# добавления IPv4

/ip/address/add address=172.17.0.1/24 interface=containers

# создание виртуального интерфейса

/interface/veth/add name=veth1 address=172.17.0.2/24 gateway=172.17.0.1

# указываются через “,” Список публичных пиров

/container/envs/add list=ENV_YGG key=peers value="tls://peer1,tcp://peer2,quic://peer3"

# передаваемый сетевой интерфейс в контейнер например veth1

/container/envs/add list=ENV_YGG key=eth value="veth1"

# подключения других нелокальных узлов *не обязательный параметр

/container/envs/add list=ENV_YGG key=listen value="tcp://0.0.0.0:7991,tls://[::]:7991"

# монтирование папки

/container/mounts/add list=yggdrasil src=usb1/conf/yggdrasil dst=/config

# создание контейнера

/container/add file=usb1/tmp/yggdrasil-arm.tar interface=veth1 root-dir=usb1/img/yggdrasil mountlists=yggdrasil envlist=ENV_YGG name=yggdrasil start-on-boot=yes logging=yes

в логах можно посмотреть какой будет шлюз

300:адрес выдаваемой пользователю сети::1/64

# правила для DNS если нужна поддержка доменов ygg список DNS можно посмотреть тут

/ip dns static add forward-to=301:84f7:4bc0:2f3a::53 regexp=".*(\\.ygg)\$" type=FWD

# добавить IPv6

/ipv6 address add address=300:адрес выдаваемой пользователю сети::/64 eui-64=yes interface=LAN

# добавить маршрут

/ipv6 route add disabled=no distance=1 dst-address=200::/7 gateway=300:адрес

выдаваемой пользователю сети::1 pref-src=“” routing-table=main scope=30 target-scope=10 # настройка Nat

/ipv6 firewall nat add action=masquerade chain=srcnat

Скриншот настроек

Установка в Windows 7

anonymous@undisclosed.example.com (Anonymous) — Thu, 09 Apr 2026 13:05:56 +0000

Установка в Windows 7

Разработчики рекомендуют перед установкой Yggdrasil на Windows 7 и Server 2008 R2 установить заплатку KB2921916:

KB2921916 64-bit: https://download.wireguard.com/windows-toolchain/distfiles/Windows6.1-KB2921916-x64.msu
KB2921916 32-bit: https://download.wireguard.com/windows-toolchain/distfiles/Windows6.1-KB2921916-x86.msu

По информации из чата в Telegram для успешной установки Yggdrasil в Windows 7 требуется преварительная установка следующих пакетов обновлений:

Оригинальные сообщения в telegram:

Скачать установщик Yggdrasil можно по ссылке: https://github.com/yggdrasil-network/yggdrasil-go/releases

Важно использовать правильный установщик для вашей архитектуры — обязательно используйте установщик x64 в 64-разрядной версии Windows и установщик x86 в 32-разрядной версии Windows.

После установки конфигурационный файл Yggdrasil можно будет найти по пути: %ALLUSERSPROFILE%\Yggdrasil\yggdrasil.conf

Yggdrasil устанавливается как служба Windows, которая автоматически запускается вместе с Windows. Запустить, остановить и перезапустить Yggdrasil можно с помощью оснастки MMC «Службы» (services.msc) или, в более поздних версиях Windows, вкладки «Службы» в диспетчере задач.

Требуется перезапускать службу Yggdrasil после каждого изменения файла конфигурации.

Ссылки

Windows 7 (RU): https://ru.wikipedia.org/wiki/Windows_7