HowTo Yggdrasil

img_1282.jpeg - удалено

admin@undisclosed.example.com (Thunar) — Mon, 04 May 2026 12:17:15 +0000

Yggdrasil как socks-прокси - [Yggstack на Android]

newbie@undisclosed.example.com (newbie) — Mon, 04 May 2026 12:05:22 +0000

Yggdrasil как socks-прокси

С первых релизов разработчикам Yggdrasil периодически задавали вопрос о возможности запуска Yggdrasil без создания tun-интерфейса. В качестве аргумента за такой подход приводили значительное упрощение встраивания Yggdrasil в другие проекты, например, в браузер или даже в web-приложение…

И вот, в качестве эксперимента, один из разработчиков Yggdrasil (neilalexander) создал ветку проекта, в которой не используется tun-интерфейс и реализован стек сетевых протоколов, который позволяет использовать Yggdrasil в качестве socks5-прокси. Позже ветка проекта превратилась в проект с отдельным репозиторием.

Отличительные особенности такого подхода:

для запуска Yggdrasil не требуются права суперпользователя, повышается безопасность
для доступа к web-ресурсам сети необходимо настроить браузер на использование socks5-прокси
для других узлов сети становятся доступны только конкретные, указанные при запуске, TCP-порты, а не весь хост

Кроме описанного выше, в проекте yggstack реализована встроенная система DNS. C помощью этой системы можно получить доступ к ресурсам по доменному имени вида <публичный ключ>.pk.ygg.

Для примера, адрес этой wiki будет выглядеть так: http://000000002ae375e65f5470ee29eb563a0ada764c7a3f1efaa5f5a4af91dad1cb.pk.ygg/ (доступно через socks-прокси yggstack).

Установка

Готовые бинарные файлы под различные архитектуры можно скачать здесь: https://github.com/yggdrasil-network/yggstack/releases

Самостоятельная сборка

Примечание:
Для сборки необходим go-lang 1.22 и выше. Читайте об его установке: Установка Go.

Клонирование репозитория и сборка:

git clone https://github.com/yggdrasil-network/yggstack

cd yggstack

./build

Обратите внимание, что вы можете выполнять кросс-компиляцию для других платформ и архитектур, указав переменные среды GOOS и GOARCH, например: GOOS=windows ./build или GOOS=linux GOARCH=mipsle ./build.

Использование

Параметры socks-прокси и расшаривания/проброса TCP-портов задаются в командной строке.

Пример запуска socks-proxy (подобно ssh -D):

./yggstack -useconffile=/etc/yggdrasil/yggdrasil.conf -socks 127.0.0.1:1080

Так же, возможны «пробросы» на локальные или удаленные порты (подобно ssh -L, ssh -R).

Примеры можно посмотреть здесь: https://github.com/yggdrasil-network/yggstack#run-yggstack

Yggstack на Android

Для Android существует приложение yggstack-android с GUI.

Репозиторий / описание (EN): https://github.com/DrewCyber/yggstack-android
Описание (RU): https://github.com/DrewCyber/yggstack-android/blob/main/README_RU.md

Ссылки

Репозиторий yggstack (EN): https://github.com/yggdrasil-network/yggstack

- ↷ Страница перемещена из archive:yggdrasil:yggdrasil_as_socks_proxy в ...

newbie@undisclosed.example.com (newbie) — Mon, 04 May 2026 11:45:14 +0000

Виртуальная система с подключением к Yggdrasil через VSOCK ...

ps@undisclosed.example.com (p.s.) — Mon, 04 May 2026 01:22:44 +0000

Виртуальная система с подключением к Yggdrasil через VSOCK

Способ организации виртуальной системы без сетевого интерфейса, с подключением исключительно к сети Yggdrasil посредством VSOCK.
Удобен для изоляции программного обеспечения гостевой системы от несанкционированных Интернет-соединений, без использования iptables и дополнительных правил маршрутизации.

Ветка Yggdrasil с поддержкой VSOCK

git clone https://github.com/nagy/yggdrasil-go.git
cd yggdrasil-go
git checkout vsock
./build

Host

yggdrasil.conf

Listen: [vsock://host:1234]

или vsock://2:1234

Guest

Запуск гостевой системы осуществляется с добавлением соответствующего сокет-интерфейса:

qemu-system-x86_64 ... -device vhost-vsock-pci,id=vhost-vsock-pci0,guest-cid=3

Для подключения к хост-сокету, для внутреннего узла Yggdrasil указывается соответствующий адрес в Peers:

yggdrasil.conf

Peers: [vsock://host:1234]

или vsock://2:1234

Для обновлений программного обеспечения гостевой операционной системы без сетевого интерфейса, можно использовать локальные зеркала Yggdrasil или указав прокси:

/etc/apt/apt.conf.d/proxy.conf

Acquire::http::Proxy "http://[324:71e:281a:9ed3::fa11]:3128/";

Таким же образом, можно настроить DNS .

Смотрите также

Проброс unix через vsock используя socat

Ссылки

Инструкция для QEMU / Virtual Machine Manager GUI (UA): Yggdrasil | Интернет

Публичный пир - [Unix socket] add unix-vsock connection example

ps@undisclosed.example.com (p.s.) — Mon, 04 May 2026 01:15:02 +0000

Публичный пир

Публичным пиром сети называется устройство, к которому в оверлейном режиме может подключиться любой желающий. Проще говоря: узел сети, к которому можно подключиться через Интернет и соединиться таким образом с глобальным сегментом сети Yggdrasil.

Список публичных пиров доступен в официальном репозитории проекта Public Peers, а так же на сайте: https://publicpeers.neilalexander.dev/ (список на этом сайте генерируется автоматически на базе информации с GitHub и имеет колонку с признаком доступности узлов (online/offline)).

Публичные пиры, к которым вы хотите быть подключены, прописываются в файле конфигурации yggdrasil.conf (/etc/yggdrasil.conf или %programdata%\yggdrasil\yggdrasil.conf) в секции Peers:

Peers: [
    # Чехия, Revertron
    tcp://195.123.245.146:7743
    # netherlands
    tcp://51.15.118.10:62486
]

Комментарии не обязательны, но они могут пригодиться.

TLS

Начиная с версии 0.3.11 Yggdrasil поддерживает соединения по протоколу TLS. Это позволяет скрыть пиринговое соединение внутри обычного сеанса TLS, что в некоторых случаях может помочь обойти брандмауэр или фильтры DPI, блокирующие пиринговый трафик Yggdrasil.

Публичные пиры, поддерживающие TLS идентифицируются префиксом tls:// вместо tcp://.

Обратите внимание, что из-за дополнительного уровня шифрования производительность через одноранговые узлы TLS может быть немного хуже, чем через обычные одноранговые узлы tcp://.

QUIC

Начиная с версии 0.5 RC1 Yggdrasil поддерживает соединения по протоколу QUIC.

Публичные пиры, поддерживающие QUIC идентифицируются префиксом quic://.

На данный момент, использование QUIC в Yggdrasil не даёт каких-либо преимуществ, передача данных по этому протоколу может быть даже медленнее, чем при использовании других протоколов.

ws / wss

Начиная с версии 0.5.7 Yggdrasil поддерживает соединения по протоколу WebSocket.

Публичные пиры, поддерживающие WebSocket, в секциях Listen и (или) Peers конфигурационного файла идентифицируются префиксами ws:// или wss://.

wss:// используется для подключения к публичному пиру, находящемуся за обратным прокси HTTPS (HTTPS reverse proxy).

Примеры:

ws://1.1.1.1:1234
ws://1.1.1.1:1234/path 
wss://1.1.1.1:1234
wss://1.1.1.1:1234/path

Подробнее в статье: Пиринг через websocket.

Unix socket

В версии Yggdrasil 0.4.5 появилась возможность пиринга с использованием Unix сокетов. Это не вполне релевантно статье о публичных пирах, т.к., Unix сокеты можно использовать только на одной машине, но тем не менее, об этом стоит упомянуть и здесь.

Эту возможность можно использовать в случае запуска Yggdrasil на одной машине с использованием средств виртуализации или с разделением по network namespaces, или, например, для соединения Yggdrasil c Yggmail.

Для использования пиринга через Unix сокет можно прописать в секцию Peers конфигурационного файла такую строку: unix:///path/to/socket.sock

Пример:

В конфигурационном файле Yggdrasil, в секции Listen прописываем:

Listen:
    [
      tcp://192.168.1.2:23485
      unix:///var/run/yggdrasil.sock
    ]

Таким образом к нашему пиру можно будет подключиться по IP 192.168.1.2, на порт 23485 и через Unix сокет по пути /var/run/yggdrasil.sock

Yggmail теперь можно запускать так:

yggmail -peer=unix:///var/run/yggdrasil.sock -database=/home/USER/mail/yggmail.db -smtp=192.168.1.2:1025 -imap=192.168.1.2:1143

Проброс unix через vsock используя socat

Для соединения виртуальных машин без сетевого интерфейса, можно использовать готовую реализацию роутера с поддержкой vsock. Также, можно организовать проброс unix - vsock - unix с использованием socat:

Хост:

Listen: [
    unix:///run/yggdrasil/peer.sock
]

не путать с адресом административого сокета

socat VSOCK-LISTEN:5000,fork UNIX-CONNECT:/run/yggdrasil/peer.sock

Гостевые машины:

socat UNIX-LISTEN:/run/yggdrasil/bridge.sock,fork,mode=777 VSOCK-CONNECT:2:5000

интерфейс VirtIO должен быть предварительно добавлен в настройках гостевой машины

Peers: [
    unix:///run/yggdrasil/bridge.sock
]

Как выбрать публичные пиры

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

Для выбора пиров, во-первых можно просто воспользоваться упомянутым выше сайтом, на котором собраны все публичные пиры с offline / online статусами.

Ниже перечислены средства автоматизации процесса выбора пиров.

Yggdrasil peers updater

Утилита предназначена для проверки доступности пиров и автоматического их обновления в конфигурационном файле Yggdrasil, а так же, с помощью метода admin API - addPeer.

Для вывода отсортированного по скорости доступа списка доступных пиров используется флаг -p.

С другими параметрами можно ознакомиться из описания (RU): https://github.com/ygguser/peers_updater/blob/master/README_ru.md

PeerYgg (Пирог)

Утилита-клон Yggdrasil peers updater на GoLang.

Из минусов: отсутствует обновление пиров через admin API или конфигурацию

Готовые бинарники для следующих архитектур: Windows, Linux (X64, Arm, MIPS, MIPSLE, ARMv5, ARMv6, ARMv7), MacOS (Intel, Apple Silicon)

Подробнее про утилиту: https://github.com/GenkaOk/PeerYgg/blob/main/README.ru.md

Скрипт на python

zhoreeq разработал скрипт, который в отсортированном виде выводит информацию о времени отклика пиров, его можно использовать при выборе пиров для своего конфигурационного файла (необходимо наличие установленного python3):

Клонируем репозиторий с публичными пирами:

git clone https://github.com/yggdrasil-network/public-peers.git

Клонируем репозиторий со скриптом:

git clone https://github.com/zhoreeq/peer_checker.py.git

Запускаем скрипт (параметром указывается каталог с публичными пирами):

python ./peer_checker.py/peer_checker.py ./public-peers/

Пример вывода скрипта:

Dead peers:

tcp://[2a04:5b81:2010::90]:2000 	 africa/south-africa.md
tcp://[2804:49fc::ffff:ffff:5b5:e8be]:58301 	 south-america/brazil.md
...

Alive peers (sorted by latency):

URI 	 Latency (ms) 	 Location
tcp://95.165.99.73:5353 	 6.679 	 europe/russia.md
tcp://yggno.de:18226 	 16.892 	 europe/russia.md
...

Как стать публичным пиром?

Любой желающий может стать публичным пиром. Для этого, чтобы другие пользователи могли подключиться к вашему узлу, как к публичному пиру, необходимо иметь прямой доступ в Интернет (белый IP). Также крайне желательно использовать для пиринга весьма производительное «железо» и широкий сетевой канал. Производительность сервера важна при больших нагрузках, т.к. нативные криптографические операции сети весьма требовательны и в случае недостатка мощности в работе пира будут возникать сбои. В настройках файерволла операционной системы необходимо открыть порт, который будет прослушивать Yggdrasil (любой, на ваше усмотрение).
В файле конфигурации Yggdrasil добавляем в поле Listen:

  Listen: [
  # Для прослушивания всех IPv4 интерфейсов на порту 7991
  tcp://0.0.0.0:7991 
  # Для прослушивания всех IPv6 интерфейсов на порту 7992
  tcp://[::]:7992
  ]

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

Приоритеты

В Yggdrasil версии 0.4.6 появилась возможность задать приоритеты для соединения с одним и тем же узлом, если у узла несколько интерфейсов. Приоритет указывается с помощью параметра URI пира ?priority=X в секциях Peers или Listen, или c помощью параметра Priority в секции MulticastInterfaces.

Приоритет — это число из диапазона от 0 до 254 (по умолчанию 0), чем ниже значение, тем выше приоритет.

Ограничение подключений паролем

Начиная с версии 0.5 RC1 можно использовать «рукопожатие» с дополнительным паролем.

Пример:

Для секции Listen: tls://[::]:12345?password=123456abcdef
Для секции Peers: tls://a.b.c.d:12345?password=123456abcdef

Пароль должен совпадать на обеих сторонах, иначе соединение не установится.

Так же, пароль допустимо использовать в секции MulticastInterfaces.

Максимальная допустимая длина пароля - 64 символа.

Ограничение подключений публичным ключом

Для секции Listen: tls://[::]:12345?key=PUBLICKEY

Подключиться сможет только тот, чей публичный ключ совпадает с PUBLICKEY.

Особые замечания

0. Не забудьте перезапустить службу Yggdrasil, чтобы изменения вступили в силу:

  # Debian/Ubuntu:
sudo systemctl restart yggdrasil
  # Windows:
net.exe stop "Yggdrasil Service" && net.exe start "Yggdrasil Service"

1. Другие частники сети будут считаться подключенными локально, будто они с вами в одной локальной сети. Учитывайте это при настройке безопасности.
2. Редактируя файл конфигурации в Windows, не используйте стандартный блокнот и Office Word. Это испортит кодировку файла и служба Yggdrasil не сможет запуститься. Для редактирования конфига в Windows следует использовать текстовые редакторы вроде AkelPad, Notepad2 и NotePad++.

Ссылки

Публичные пиры (EN): https://github.com/yggdrasil-network/public-peers
Yggdrasil peer checker (EN): https://github.com/zhoreeq/peer_checker.py

notblood.webp - создано

ps@undisclosed.example.com (p.s.) — Fri, 06 Mar 2026 00:59:30 +0000

2026-02-28_02-40.png

altnetanon@undisclosed.example.com (Miko) — Fri, 27 Feb 2026 23:44:12 +0000

2026-02-28_02-33.png - создано

altnetanon@undisclosed.example.com (Miko) — Fri, 27 Feb 2026 23:34:52 +0000

2026-02-28_02-35.png - создано

altnetanon@undisclosed.example.com (Miko) — Fri, 27 Feb 2026 23:34:52 +0000

2026-02-28_00-34.png

altnetanon@undisclosed.example.com (Miko) — Fri, 27 Feb 2026 23:29:44 +0000

2026-02-28_00-33.png - создано

altnetanon@undisclosed.example.com (Miko) — Fri, 27 Feb 2026 23:25:21 +0000

2026-02-28_00-24.png - создано

altnetanon@undisclosed.example.com (Miko) — Fri, 27 Feb 2026 22:41:11 +0000

2026-02-28_00-25.png - создано

altnetanon@undisclosed.example.com (Miko) — Fri, 27 Feb 2026 22:41:11 +0000

bittorrent_dht_yggdrasil.png - создано

zahero@undisclosed.example.com (zahero) — Mon, 10 Nov 2025 09:34:33 +0000

meshchat_reticulum-network-map.jpg - создано

ps@undisclosed.example.com (p.s.) — Tue, 04 Nov 2025 17:59:20 +0000

p.odt - удалено

admin@undisclosed.example.com (Thunar) — Wed, 29 Oct 2025 18:26:32 +0000

half-life-arm-server-cortex-a7-1gb-ram.png - создано

ps@undisclosed.example.com (p.s.) — Thu, 14 Aug 2025 09:20:19 +0000

kevachat-npsapp.png

d4708@undisclosed.example.com (d4708) — Wed, 01 May 2024 22:54:22 +0000

gemini_protocol_alt-web-protocols-comparison.png - удалено

admin@undisclosed.example.com (Thunar) — Sat, 20 Apr 2024 20:57:45 +0000

alt-web-protocols-comparison.png - создано

d4708@undisclosed.example.com (d4708) — Sat, 20 Apr 2024 20:43:32 +0000