HowTo Yggdrasil - yggdrasil:bittorrent

BitTorrent

anonymous@undisclosed.example.com (Anonymous) — Wed, 22 Oct 2025 08:13:18 +0000

BitTorrent

BitTorrent - пиринговый (P2P) сетевой протокол для обмена файлами по сети.

Протокол имеет ряд преимуществ перед моделью “клиент-сервер”, в виду своей децентрализованной p2p модели: главные из которых - безотказность работы при отключении отдельно взятого узла и снижение затрат на обслуживающие сервера данных. Поскольку данные хранятся и распространяются между многими хранилищами, протокол также подразумевает снижение нагрузки на пропускной канал.

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

Yggdrasil

Протокол Yggdrasil обеспечивает защищенный канал связи, устойчивый к блокировкам глобальных маршрутизаторов а также мониторинга трафика со стороны провайдера (например, факт автоматической отправки анонсов на сомнительные ресурсы, при открытии файла .bittorent). Для внутрисетевых сервисов, совмещение протоколов BitTorrent и Yggdrasil позволяет не привязываться к условиям ISP или VPS провайдера, DNS и других сервисов, обычно необходимых для работы протокола BitTorrent в сети интернет.

Адрес узла Yggdrasil статичен и может использоваться в качестве URL анонс-сервера или пирингового узла, в том числе для построения перманентного DHT, при этом подлинность гарантируется приватным ключем обладателя и не имеет срока истечения.

Для частного пользователя - это возможность заменить использование платных прокси-серверов и VPN.

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

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

Статьи внутри раздела

Ссылки

О BitTorrent на Wikipedia (RU): https://ru.wikipedia.org/wiki/BitTorrent
Узнать больше о соседе: https://iknowwhatyoudownload.com/ru/peer

βtracker

anonymous@undisclosed.example.com (Anonymous) — Sun, 25 Jan 2026 15:01:03 +0000

βtracker

βtracker - альтернативная ветка развития YGGtracker, предоставляющая программный комплекс для автоматического трекинга и агрегации без участия модератора и ручного добавления торрентов в каталог.

Система создавалась для сети Yggdrasil, но может работать с любой другой, поддерживающей стек IPv4/IPv6 или в гибридном режиме.
Пользователю, для добавления торрентов в каталог, достаточно добавить актуальные трекеры в свой клиент (раздачу)

Система βtracker включает в себя:

aquatic_udp - форк UDP трекера aquatic с поддержкой генерации бинарного дампа info-hash
aquatic-crawler - кравлер, собирающий дамп info-hash по API и загружающий контент для предпросмотра (jpeg, txt, log и тд по фильтру regex и другим настройкам)
βtracker - веб-интерфейс для собранной файловой базы aquatic-crawler с функциями пользовательского поиска по индексу и scrape (статистика активных пиров)
- btracker-gemini - опциональная реализация каталожной части для протокола Gemini

Схематически, принцип работы выглядит следующим образом:

torrent client > aquatic_udp > infohash.bin < aquatic-crawler > * /preload/info-hash.torrent > β
torrent client               <-----------------------|          * /preload/info-hash/data      |
               <-------------------------------------|          * /preload/.info-hash/tmp      |
                             <-------------------------- scrape -------------------------------|

Установка

Для сборки потребуется инфраструктура Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

можно выбрать набор “minimal”, требующий меньше дискового пространства

Все компоненты удобно запускать от общего системного пользователя:

useradd -m btracker

Общая файловая база данных (которая наполняется aquatic-crawler и которую будет читать пользователь Web-UI) расположена в пространстве Веб-сервера:

mkdir -p /var/www/btracker

aquatic_udp

git clone https://github.com/YGGverse/aquatic.git
cd aquatic
git checkout info-hash-api
cargo build --release -p aquatic_udp
sudo install target/release/aquatic_udp /usr/local/bin/aquatic_udp

Стандартная конфигурация генерируется командой:

aquatic_udp -p > /home/btracker/aquatic_udp.toml

После чего, указываются следующие изменения:

/home/btracker/aquatic_udp.toml

#..

[network]
# слушаем соединения пиров на указанном интерфейсе IPv6
use_ipv4 = false
use_ipv6 = true
address_ipv6 = "[302:68d0:f0d5:b88d::fdb]:6969"
set_only_ipv6 = true

[statistics]
# включить дамп info-hash
write_bin_to_file = true

# куда сохранять дамп info-hash (для адресов IPv6)
bin_info_hash_ipv6_file_path = "/path/to/hash.bin"

#..

/etc/systemd/system/aquatic-udp.service

[Unit]
After=network-online.target
Wants=network-online.target

[Service]
Type=simple

User=btracker
Group=btracker

# если Yggdrasil или другой сервис стартует с задержкой (можно указать в After)
# ExecStartPre=/bin/sleep 10s

ExecStart=/usr/local/bin/aquatic_udp -c /home/btracker/aquatic_udp.toml

# StandardOutput=file:///path/to/aquatic_udp/debug.log
# StandardError=file:///path/to/aquatic_udp/error.log

[Install]
WantedBy=multi-user.target

systemctl enable aquatic-udp
systemctl start aquatic-udp

Разрешить входящие подключения к трекеру только для узлов сети Yggdrasil:

ufw allow from 0200::/7 to 302:68d0:f0d5:b88d::fdb port 6969 proto udp

заменить “302:68d0:f0d5:b88d::fdb” на актуальный адрес, или указать “any”

aquatic-crawler

git clone https://github.com/YGGverse/aquatic-crawler.git
cd aquatic-crawler
cargo build --release
sudo install target/release/aquatic-crawler /usr/local/bin/aquatic-crawler

/etc/systemd/system/aquatic-crawler.service

[Unit]
After=network.target
Wants=network.target

[Service]
Type=simple

User=btracker
Group=btracker

# Количество нод,
# требуется для инициализации раздач, содержащих большое количество файлов
# в связи с текущей реализацией librqbit - в частности, при возникновении ошибки:
# "Error opening '/path/to/file' in read/write mode."
LimitNOFILE=65536

# настройки логирования
# Environment="RUST_LOG=trace"
Environment="RUST_LOG=aquatic_crawler=warn"
Environment="NO_COLOR=1"

# таймер запуска, значение может зависеть от других служб, например сервиса Yggdrasil
# ExecStartPre=/bin/sleep 15

ExecStart=/usr/local/bin/aquatic-crawler\
        # путь к файлу hash.bin (генерируемого aquatic_udp)
        --infohash=/path/to/hash.bin\
        # адрес трекера для получения данных раздачи от активных пиров (используется сервер aquatic_udp)
        # * может быть несколько трекеров, для каждого указывается отдельный аргумент
        --tracker=udp://[302:68d0:f0d5:b88d::fdb]:6969\
        # куда загружать данные (например картинки для предпросмотра в каталоге btracker)
        # в большинстве случаев, это публичное пространство /var/www/...
        --preload=/var/www/btracker/public\
        # опционально: ограничение размера файлов (в байтах)
        --preload-max-filesize=10000000\
        # опционально: ограничение количества файлов
        --preload-max-filecount=5\
        # опционально: условие filename, при котором файл будет сохранён
        # в данном случае, нужны изображения для предпросмотра и текстовые файлы для дополнительной индексации поиска
        --preload-regex=\.(png|gif|jpeg|jpg|webp|svg|log|nfo|txt)$

# куда сохранять журнал
# /var/log или /home/btracker
StandardOutput=file:///path/to/debug.log
StandardError=file:///path/to/error.log

[Install]
WantedBy=multi-user.target

приватность: ограничить коммуникацию librqbit посредством PEX, можно по диапазону IP: --blocklist=file:///path/to/blocklist.txt
все доступные опции: aquatic-crawler --help

Запуск:

systemctl enable aquatic-crawler
systemctl start aquatic-crawler

При запуске, кравлер начнёт сканировать hash.bin дамп трекера и наполнять директорию, указанную в –preload, она будет использована в качестве базы данных для каталожной части / Web UI.

Для дополнительной информации, смотрите страницу wiki.

btracker

git clone https://github.com/yggverse/btracker.git
cd btracker
cargo build --release
sudo install target/release/btracker /usr/local/bin/btracker

в связи с текущей реализацией шаблонизатора, необходимо скопировать директории public и templates в пространство WorkingDirectory (см. настройки systemd)

/etc/systemd/system/btracker.service

[Unit]
After=network.target
Wants=network.target

[Service]
Type=simple

User=btracker
Group=btracker

# реализация фреймворка Rocket, требует наличия рабочей директории
WorkingDirectory=/var/www/btracker

ExecStart=/usr/local/bin/btracker\
        # опционально: заголовок каталога (стандартно βtracker)
        # --title="Yggdrasil-only BitTorrent tracker"\
        # опционально: описание каталога (также отображается в title)
        --description="Yggdrasil-only BitTorrent tracker"\
        # локальный порт (для прокси nginx)
        --port=1234\
        # директория с данными aquatic-crawler
        --public=/var/www/btracker/public\
        # опционально: трекер для запросов статистики пиров (scrape)
        --scrape=udp://[302:68d0:f0d5:b88d::fdb]:6969\
        # опционально: трекер (или трекеры) для анонса
        --tracker=udp://[302:68d0:f0d5:b88d::fdb]:6969\
        --tracker=udp://tracker.ygg:6969

# реализация Rocket журналирует сюда события 404, временно отключено
# https://github.com/rwf2/Rocket/issues/2951
# StandardOutput=file:/path/to/debug.log
StandardOutput=null
StandardError=file:///path/to/error.log

[Install]
WantedBy=multi-user.target

доступные опции: btracker --help

Запуск:

systemctl enable btracker
systemctl start btracker

nginx

/etc/systemd/system/btracker.service

server {
    listen 80;

    location / {
        proxy_pass http://127.0.0.1:1234;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

см. также вариант с кешированием статики

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

systemctl reload nginx

DHT

anonymous@undisclosed.example.com (Anonymous) — Tue, 16 Dec 2025 09:12:55 +0000

DHT

Сами по себе торрент-пиры в сети Yggdrasil в числе узлов DHT друг у друга не появятся (точнее, это очень маловероятно: два клиента с интерфейсами Yggdrasil должны через публичную сеть запустить одни и те же торренты и обменяться альтернативными адресами, либо попасть при обходе миллионов меняющихся участников DHT на живой анонс такого адреса). С другой стороны, препятствий к работе отдельной DHT внутри сети в целом нет. Более того, она уже существует.

Теория

Как известно, узлы DHT в процессе работы поддерживают актуальность набора кандидатов с разной степенью удалённости координат для отправки через них запросов (на первом шаге). Старые и ставшие недоступными узлы удаляются, новые добавляются в процессе обхода сети при поиске хэшей активных торрентов или случайных идентификаторов, выбранных внутри нужного диапазона координат, который требуется пополнить. Имеющий сколько-то живых произвольных узлов клиент быстро находит через них более близкие и нужные. Откуда они берутся изначально? Либо сохраняются в момент завершения прежней сессии (в надежде, что при следующем включении хоть кто-то ещё будет онлайн; это совсем не гарантируется, если пройдёт неделя, месяц или год), либо получаются с публичных серверов инициализации, прописанных в каждом клиенте или библиотеке и готовых любому выдать актуальный набор свежих узлов.

Очевидно,^{[citation needed]} что добавлять отдельную функцию получения внутрисетевых адресов конкретно для клиентов в Yggdrasil либо в код программ и библиотек, либо на узлы DHT по умолчанию никому из их авторов пока не интересно. Некоторые клиенты (например, Tixati) позволяют указать собственный набор узлов для запуска DHT, так что если вы выписали на бумажку или получили от друга перечень адресов и портов торрент-клиентов на адресах Yggdrassil, их можно туда запихнуть.

Но есть и другой полезный источник: все пиры, с которыми клиент соединяется, записываются в потенциальные узлы DHT. В большинстве клиентов порт для приёма сообщений DHT совпадает с портом для связи с пирами (по UDP) так что достаточно его проверить. В тех, где это не так, клиент во время приветствия при соединении может получить от пира отдельное указание на то, на каком порту работает DHT, и использовать его.

Недавно у пользователей древнейших версий uTorrent переставал работать DHT, как раз из-за того, что такой же древний адрес для инициализации их DHT уходил в офлайн. На «Рутрекере», где адреса трекера много лет заблокированы для дорогих россиян, активно жаловались, что почему-то пиров больше нет. Действительно: трекер не работает, DHT не работает, откуда пиры возьмутся? Починить можно было достаточно просто, добавив в клиент хотя бы один гарантированно популярный торрент с гарантированно рабочим трекером (например, свежий образ Debian или Ubuntu). Трекер выдаёт сотню случайных пиров, у них в большинстве случаев включена работа DHT, можно с их помощью стартовать, добавив в список узлов. Сами файлы никакой роли не играют, их можно даже не качать, главное живых пиров получить.

Тем же методом можно пользоваться и в Yggdrasil. Добавляем в клиент торрент, на котором есть внутрисетевые пиры, с добавленными адресами внутрисетевых трекеров (в надежде, что хотя бы один-то рабочий окажется), получаем с них адреса узлов для старта DHT. Если хотя бы несколько участников будут постоянно держать его в клиенте, любой новозапущенный клиент так может стать участником внутрисетевой DHT.

Осталось выбрать этот офффициальный волшебный торрент. Поскольку подойдёт любой, возникает искушение продемонстрировать собственный вкус и застолбить место тем, что тебе лично нравится, или популярно на этой неделе, или иронично комментирует всю эту затею. Нет, всё-таки полезнее будет что-то абстрактное и воспроизводимое, вроде файла нулевого размера с заданным именем и фиксированного размера блока для создаваемого торрента… А впрочем, зачем нам торрент? Хэша достаточно, чтобы получить пиров, которые в обычной ситуации обменяются метаданными. А нам и метаданные не нужны. Просто берём и используем хэш 0000000000000000000000000000000000000000 в качестве места встречи клиентов.

Нет, с ним проблемка. В каких-то программах всё работает как надо, но вот libtorrent считает, что такое значение хэша не разрешено (вероятно, потому, что в коде оно используется для других целей, а для реальных данных случайно не получится никогда), так что клиенты на его основе отпадают. Кроме того, мы не одни такие умные (или криворукие), из публичной IPv4 DHT на этот хэш начинают валиться мусорные пиры, которые, похоже, даже не все являются торрент-клиентами. Зачем нам куча бесполезных соединений? Придётся придумать некий Универсальный Уникальный Идентификатор для нашей задачи… А вот и он: 000000000000000059676764726173696c444854.

С этого момента любой участник сети с работающим торрент-клиентом может просто добавить волшебную магнитную ссылку и автоматически пополнить внутрисетевую IPv6 DHT. Вуаля!

magnet:?xt=urn:btih:000000000000000059676764726173696C444854&tr=http%3A%2F%2F%5B200%3A1e2f%3Ae608%3Aeb3a%3A2bf%3A1e62%3A87ba%3Ae2f7%5D%2Fannounce&tr=http%3A%2F%2F%5B21e%3A6565%3A9c87%3Aa49d%3Adafa%3A92c1%3Ab33f%3Af21%5D%3A1337%2Fannounce&tr=udp%3A%2F%2F%5B202%3A68d0%3Af0d5%3Ab88d%3A1d1a%3A555e%3A2f6b%3A3148%5D%3A6969

Любые торренты, анонсируемые в неё прочими участниками, будут доступны и без указания внутрисетевого трекера, с автоматическим поиском пиров, прямо как в привычной публичной сети. Можете в своём клиенте подсмотреть хранящиеся на вашем узле чужие хэши (если он такое позволяет) и добавить для тестовой загрузки любой.

Теоретически, если число участников станет таким большим, что на одном хэше возникнет толкучка, или кто-то специально запустит ботов, замусоривающих списки пиров, или фиктивные узлы DHT вблизи выбранного, можно добавить альтернативы от 100000000000000059676764726173696c444854 до F00000000000000059676764726173696c444854 и так далее для следующих битов. Эти же хэши можно добавить в клиент при первом старте для быстрого пополнения списка узлов, хотя на текущий момент число участников таково, что уже первая парочка автоматических поисковых проходов по узлам DHT перебирает и добавляет всех имеющихся.

Практика

Проверим, что это не выдумка, в разных клиентах, установленных с нуля, со стандартными настройками.

Tixati

В Tixati панель DHT подробно выводит всё, что творится в клиенте, вдобавок можно максимально подробный журнал вести. Не могу не привести в пример. Кроме того, при помощи файлика tixati_local_instance_check.txt (см. инструкцию) можно быстро запустить хоть десять портативных клиентов с разными настройками и тестировать, как они друг с другом работают.

Запускаем программу, после начальных окошек и предупреждений сразу нажимаем на кнопку раздела DHT, а в нём на кнопку Stop.
В настройках Network — Connections для интерфейса IPv4 выбираем Disabled. Если в системе есть другие сети IPv6, для интерфейса IPv6 выбираем интерфейс или адрес Yggdrasil, чтобы работать только с ним.
Идём обратно в раздел DHT, нажимаем Start. На вкладке Node Table видим, что DHT для IPv4 отключен, а для IPv6 пытается соединиться с публичными адресами, которые получены с сервера разработчика (о чём написано в Event Log), но через Yggdrasil в глобальную IPv6-сеть не выйти, и это бесполезно.
Идём в раздел Transfers и добавляем магнитную ссылку, указанную выше. (Полную, с трекерами, конечно. Если вы хотите добавить без трекеров, вы не поняли, как оно работает.) После добавления на вкладке Trackers в свойствах торрента должны появиться какие-то результаты, а на вкладке Peers — подключившиеся-отключившиеся или ждущие метаданных пиры. Столбец с названием клиента добавляется кнопкой Layout — Select Columns — Peers View — Client.
Опять идём в раздел DHT, видим, что таблицы узлов IPv6 пополняются сначала полученными с трекера пирами, а потом найденными через них. На Port Blocked можно не обращать внимания, это просто догадка на основе успешности соединений. (Ещё видим, что кто-то поленился подкрутить в клиенте случайный идентификатор узла.)
На вкладке Peer DB наблюдаем, как другие участники анонсируют хэши своих торрентов через наш узел. Пока людей мало, каждый узел видит чуть ли не пол-сети, по мере увеличения числа узлов каждому будут доставаться только всё более и более близкие к его координате хэши.

qBittorrent

Запускаем программу, в Tools — Options — Advanced — Network Interface ставим интерфейс Yggdrasil. Если на одном и том же компьютере несколько клиентов одновременно тестируете, можно в настройках libtorrent разрешить несколько соединений с одного IP-адреса, иначе они в тех или иных сочетаниях иногда не желают на одном и том же адресе друг друга видеть.
В строке состояния видим 0 пиров DHT. В qBittorrent DHT всегда при старте инициализируется путём запроса на общий узел libtorrent, и параллельно, кажется, подмешиваются старые пиры, сохранённые вместе с имеющимися в клиенте торрентами. Нам не доступно ни то, ни другое.
Добавляем общую магнитную ссылку. На вкладке трекеров видим результаты запроса, на вкладке пиров иногда видим пиров, но qBittorrent очень быстро их стирает при завершении обмена данными (или не показывает вовсе, если данные не передаются).
В строке состояния циферки узлов DHT начинают расти и выходят на ожидаемое число. Можно пользоваться.

Можно было бы не отключать сеть IPv4, работало бы точно так же, но в этом клиенте вообще нет никаких данных о работе DHT, кроме общего числа узлов, пришлось ориентироваться по нему.

BiglyBT

В BiglyBT есть отдельная, исторически не совместимая с остальными клиентами реализация DHT. Думаю, её тоже можно запустить с пирами внутри сети, но для этого потребуется постоянно иметь более одного клиента в Yggdrasil и разбираться с отдельным набором настроек. Поэтому мы рассмотрим только общую Mainline DHT, которая подключается соответствующим плагином.

Запускаем программу, после обновления стандартных плагинов и предложений понаставить новых видим уведомление о том, что в системе обнаружен адрес IPv6 и его работа включена.
Ставим плагин mlDHT, открыв ссылку biglybt://install-plugin/mlDHT. Сервера BiglyBT расположены на AWS, подверженном блокировкам, так что в России быстрее будет скачать файл со странички плагинов руками, чтобы не ждать проверки основного и запасного вариантов автоматического обновления.
Даже если не видим вышеупомянутого уведомления, всё равно идём в Tools — Options — Connection — Advanced Network Settings и проверяем, что IPv6 включен, а интерфейс выбираем Ygdrassil.
В Tools — Options — Plugins — Mainline DHT проверяем, что IPv6 по умолчанию включен. Можно выбрать Only use Connected Peers to Bootstrap, чтобы он зря не пытался соединиться с публичными узлами.
View — Mainline DHT (IPv6) открывает панель статистики DHT. Если мы не запускали клиент раньше, там должно быть пусто. Если запускали, то старые пиры могут сами начать слать сообщения на тот же самый порт 49001, который указан по умолчанию (и отличается от случайно выбираемого порта для соединений с пирами в основных настройках). Но в статистике нами добавленных всё равно пока ноль.
Идём в раздел Library, добавляем волшебную ссылку, закрываем окошко ожидания данных с крутилкой. Если не видим добавленного торрента, ищем на панели кнопку Advanced List, показывающую и загрузки, и раздачи одновременно. В свойствах торрента на вкладке Sources отображается активность трекеров (opentrackr.org добавляется по умолчанию, в настройках плагина Magnet URI Handler это можно убрать). Рядом вкладка с пирами.
Возвращаемся в статистику DHT, видим, что пиров в таблице теперь не ноль, хранимых данных тоже стало больше, и для иллюстрации расчерчены ёмкости с полосками. Цвет означает наличие или отсутствие отклика, а если догадаетесь навести курсор, увидите в подсказке адрес и прочую информацию для каждого пира. Ещё можно включить нужный уровень отчёта и открыть его через View — Log Views — Mainline DHT Log, там тоже вплоть до каждого сообщения можно отслеживать.

Вообще, для нормальной работы BiglyBT ещё настраивать и настраивать, отключать ненужное (например, встроенные DHT до перезагрузки так и продолжают работать на публичном IPv4 адресе, а вы и не заметили), но для демонстрации сойдёт.

Несовместимость с публичным IPv6

Можно заметить, что иногда в таблице появляются адреса IPv6 публичных диапазонов. Ничего страшного тут нет, их автоматически выкинет из-за недоступности. Происходить это может по разным причинам:

У каких-то пиров в Yggdrasil есть и публичный IPv6-адрес, позволяющий участвовать в глобальной DHT, или они ещё как-то узнают о пирах, которых передают в ответ на запросы.
Если это не отключено, клиент в фоне получает кандидатов с сервера инициализации.
Если DHT для адресов IPv4 работает, её участники, имеющие оба типа адресов или получившие анонсы с IPv6-адресами, нам их сообщают вместе с IPv4-адресами.

Ирония в том, что если у вас всё-таки есть работающее глобальное IPv6 соединение вдобавок к виртуальной локалке Yggdrasil, то всё описанное выше работать не будет. Поскольку отдельную реализацию DHT строго для диапазона адресов Yggdrasil вдобавок к двум имеющимся в клиентах пока не делают, при наличии обеих сетей местные адреса клиент станет воспринимать так же, как и все прочие публичные. Сам он их хранить не будет, так как не слишком вероятно, что их идентификаторы совпадут с желаемыми, и более подходящие публичные пиры их вытеснят, а в анонсах другим узлам эти адреса будут расцениваться как нерабочий мусор, поскольку почти все участники глобальной сети не имеют доступа к этому диапазону. Они просто затеряются в толпе глобальных.

По этой причине торрент-клиент придётся использовать либо в режиме связи строго внутри Yggdrasil, либо в режиме публичной сети для IPv4 и Yggdrasil для IPv6, если хочется, чтобы DHT внутри сети работал. (Просто получать пиров с внутрисетевых трекеров, без DHT, конечно, можно будет и не отказываясь от публичной сети IPv6.) Ну, или ждать, когда для 20 странных человек в клиентах сделают отдельную независимую DHT.

Jackett

anonymous@undisclosed.example.com (Anonymous) — Wed, 22 Oct 2025 08:13:18 +0000

Jackett

Jackett - это агрегатор и поисковый сервер торрентов с открытым исходным кодом.

На момент написания материала, включает интеграцию 595 приватных и публичных торрент каталогов.

По своей сути, это проксирующий серер для унификации и обработки поисковых запросов для тематического ПО, поддерживающего протокол Torznab. Также, может использоваться как локальный сайт для поиска торрентов или интеграции в другие проекты, например Telegram.

Пользователю не требуется посещать разные торрент-каталоги, устанавливать для каждого из них плагин в свой торрент-клиент, а также посещать поисковые системы (блокирующие поисковые результаты по торрент тематике).
Владельцам сайтов - не требуется создавать плагины для каждого программного обеспечения, достаточно интегрировать сервис для Jackett и поиск будет доступен для всех приложений, использующих этот сервер в качестве поискового провайдера.

Установка

На официальном сайте, имеется подробная инструкция для разных операционных систем.

Jackett можно запустить из бинарного файла jackett или скомпиллировать из исходников и добавить в системный сервис.

После запуска службы, веб интерфейс доступен по адресу:

http://localhost:9117

Для интеграции ПО, необходимо указать этот адрес в качестве URL провайдера, добавив ключ API (доступен в локальной веб-панели)

Интеграции

Sonarr
Radarr
SickRage
CouchPotato
Mylar3
Lidarr
DuckieTV
qBittorrent
Nefarious

Ссылки

Официальный сайт проекта

Opentracker

anonymous@undisclosed.example.com (Anonymous) — Wed, 22 Oct 2025 08:13:19 +0000

Opentracker

Для организации трекера в сети Yggdrasil, подойдет любой сервер, с поддержкой IPv6, одним из таких является Opentracker - сервер с открытым исходным кодом, написанный на языке C.

Opentracker не требует базы данных, так как вся информация о пирах хранится в оперативной памяти.

Установка

Выполняем официальную инструкцию, предварительно раскомментировав строку -DWANT_V6 в файле Makefile, таким образом сервер будет оперировать исключительно IPv6

cvs -d :pserver:cvs@cvs.fefe.de:/cvs -z9 co libowfat  
cd libowfat  
make
cd ..
# LEGACY: cvs -d:pserver:anoncvs@cvs.erdgeist.org:/home/cvsroot co opentracker
git clone git://erdgeist.org/opentracker
cd opentracker
make

Настройки доступа

Opentracker работает на порту 6969, поэтому для входящих подключений добавим правило в iptables с помощью утилиты ufw

ufw allow 6969

В случае, если хотим обслуживать соединения исключительно в сети yggdrasil

ufw allow from 0200::/7 to any port 6969

Автозапуск

Добавляем запуск сервера при старте системы, я использовал crontab

@reboot /path/opentracker -p 6969 -P 6969

Проксирование

Для корректного приема подключений, opentracker должен быть скомпилирован с флагом:

-DWANT_IP_FROM_PROXY

При этом, прокси-сервер должен передавать серверу opentracker клиентский IP, иначе в качестве сидов будет передан локальный IP.

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

Подключение

Для тестирования раздачи, а также приёма подключений в сети Yggdrasil, торрент-клиент необходимо настроить для прослушивания локального интерфейса или адреса, иначе пир будет идентифицирован по IP сети по-умолчанию (Интернет) и передавать этот адрес трекеру.

На примере qBittorrent, сделать это можно в Preferences - Advanced - Network interface или Optional IP address to bind to

При наличии фаервол, условием для проверки сидирования данных в сети Yggdrasil является открытие порта, определенного случайно или заданного явно в настройках BitTorrent клиента.

Также, при смене параметров интернет-подключения (VPN или proxy), важно перезапустить BitTorrent клиент.

Ссылки

qBittorrent

anonymous@undisclosed.example.com (Anonymous) — Wed, 22 Oct 2025 08:13:18 +0000

qBittorrent

Свободный BitTorrent клиент, написанный с использованием фреймворка Qt и библиотеки libtorrent.

Пиринг в Yggdrasil

По-умолчанию, клиент прослушивает все сетевые интерфейсы и отлично подходит для обмена файлами в сети Yggdrasil.

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

Для этого, достаточно указать интерфейс или адрес Yggdrasil из списка доступных:

Preferences → Advanced → Network interface или Optional IP address to bind to

Поскольку трафик между пирами Yggdrasil шифруется по-умолчанию, для снижения нагрузки, штатное шифрование можно отключить:

Preferences → BitTorrent → Privacy → Encription mode → Disable

Сидирование

Загружая файлы посредством протокола BitTorrent, принято делиться раздачей с другими.

Для этого достаточно открыть порт в фаервол:

ufw allow from 0200::/7 to any port [Listening Port]

[Listening Port] - автоматически выданный клиентом порт в разделе Preferences → Connections

Обратите внимание, что UPnP в контексте Yggdrasil не используется, поэтому включение этой опции никак не влияет на участие в сидинге.

Не забываем анонсировать свою раздачу как минимум одному трекеру в сети Yggrasil. Сделать это можно выбрав соответствующий файл, во вкладке Trackers → Add trackers…

Подробная настройка сид-сервера на базе qBittorrent, описана в разделе Сервер на базе qBittorrent

Встроенный трекер

В клиенте qBittorrent имеется встроенный торрент-трекер, активировать который можно в разделе меню:

Advanced → Enable embedded tracker

Разрешаем покдключение к трекеру из сети Yggdrasil (по-умолчанию 9000):

ufw allow from 0200::/7 to any port 9000

Затем, можно поделиться ссылкой вида http://[address]:9000/announce с другими или добавить в список внутрисетевых сервисов

* Организовать легковесный торрент-трекер можно также с помощью специализированного ПО, например Opentracker

Темы оформления

Клиент поддерживает альтернативные темы оформления в формате .qbttheme

Следует учитывать, что темы для десктоп клиента несовместимы с клиентом Web UI.
Для изменения внешнего вида Web UI, вместо файла .qbttheme, используются альтернативные клиенты.

Альтернативный Web UI

Чтобы создать альтернативный Web UI, достаточно скопировать директорию

cp src/webui/www /somelocation/newtheme

Минимальный набор файлов представлен директориями:

/private - все страницы клиента, доступные после авторизации
/public - страница логина

После нужных изменений, путь к альтернативному клиенту можно в опции:

Preferences → Web UI → Use alternative Web UI

В последних версиях qBittorrent была убрана поддержка обработки мульти-язычных строк, поэтому придется удалить конструкции из файлов html авто-заменой

QBT_TR\((.*)\)QBT_TR\[CONTEXT=.*\]

Результатом можно поделиться на GitHub, добавив страницу проекта в список List of known alternate WebUIs

Контрибуция

Для отправки PR в официальный репозиторий, чтобы исключить конфликты обновлений, желательно разбивать правки на отдельные ветки:

git checout master
git checkout -b my-webui-fix

Важно перед отправкой тестировать форматирование и валидность кода:

cd src/webui/www
npm install
npm run lint && npm run format

Сборка из исходников

Актуальные инструкции по компиляции, описаны в файле INSTALL а также разделе официальной Wiki

При использовании последней версии из репозитория, с большой вероятностью, версии зависимостей в штатных репозиториях окажутся устаревшими.
В частности, может дополнительно понадобиться сборка последних версий libboost, libtorrent и Qt.

Автоматическая сборка

Для сборки серверного клиента без графической оболочки (qbittorrent-nox), есть удобная утилита qbittorrent-nox-static, которая соберет все зависимости автоматически.

Удобна тем, что также поддерживает различные платформы, в том числе ARM.

Ручная сборка

libboost

Официальная инструкция:

git clone --recursive https://github.com/boostorg/boost.git
cd boost
./bootstrap.sh
./b2

Главная ветка включает межверсионные изменения последней версии.
На практике, для разрешения зависимостей, используются релизы (это касается и остальных пакетов). Загружаем архив нужной версии и пропускаем шаг git/clone.

Для глобальной установки:

./b2 install

libtorrent

git clone --recurse-submodules https://github.com/arvidn/libtorrent.git
cd libtorrent
./configure
make

* возможно для конфигурации потребуется указать путь к boost, например ./configure –with-boost-libdir=/usr/lib/arm-linux-gnueabihf/

Для глобальной установки:

make install

qt

Необходимую для qBittorrent версию проще всего установить из официального онлайн-установщика (для загрузки потребуется регистрация на сайте).

Также библиотеки (qtbase и qttools) можно загрузить из архива релизов и собрать вручную.

В таком случае, важно учитывать наличие доступных ресурсов - для сборки qtbase понадобится порядка 3Гб ОЗУ и до 5Гб дискового пространства.

Если есть возможность подключения внешнего накопителя, буфер памяти можно увеличить через файл подкачки:

fallocate -l 4G /mount/swapfile
chmod 600 /mount/swapfile
mkswap /mount/swapfile
swapon /mount/swapfile

по завершению:

swapoff /mount/swapfile
rm /mount/swapfile

При монтировании дополнительного дискового пространства посредством /etc/fstab, важно добавить флаги user,exec иначе при сборке cmake выдаст ошибку “Permission denied”.

qtbase

Процесс компиляции выглядит примерно так:

cd /mount/qtbase-everywhere-src-6.5.3
cmake -B build
cmake --build build --parallel 4

* 4 - количество потоков

Можно указать параметры для отдельных дистрибутивов, например Debian/Ubuntu

-DCMAKE_BUILD_TYPE=RelWithDebInfo 
-DCMAKE_INSTALL_PREFIX=/usr/local

В этом примере, собранные файлы будут расположены в директории

/mount/qtbase-everywhere-src-6.5.3/build/lib/cmake

Для глобальной установки:

cd /mount/qtbase-everywhere-src-6.5.3/build
cmake --install .

qttools

Как указано в файле dependencies.yaml, сборка требует предустановленной библиотеки qtbase, приступаем только если выполнили предыдущий шаг.

cd /mount/qttools-everywhere-src-6.5.3
qt-configure-module .
cmake --build .

Для глобальной установки:

cmake --install .

qbittorrent-nox

Для сборки серверной версии с помощью cmake - отключаем графическую среду флагом

-DGUI=OFF

Если пакеты Qt не установлены глобально, при компиляции qBittorrent с помощью cmake, нужно указать дополнительный флаг c префиксом директории:

-DCMAKE_PREFIX_PATH='/home/USERNAME/Qt/6.5.3/gcc_64/lib/cmake'

Подробнее о доступных опциях сборки и их значениями по-умолчанию, можно почитать в разделе Compilation

git clone https://github.com/qbittorrent/qBittorrent.git
cd qBittorrent
cmake -B build -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DGUI=OFF
cmake --build build

Готовый бинарный пакет qbittorrent-nox будет доступен в директории /build

Решение проблем

Потребление памяти

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

Чтобы избежать перебоев в работе других служб, можно добавить лимиты на процесс, указав объем доступной памяти:

nano /etc/systemd/system/qbittorrent-nox.service

* qbittorrent-nox - серверный клиент qbittorrent

[Service]
MemoryHigh=256M
MemoryMax=512M
MemorySwapMax=512M

В версии 5 (из ветки unstable) проблема пока что не наблюдалась.

Установить альфа версию для требуемого дистрибутива можно из списка на официальной странице загрузок, раздел “Other Binary Packages”
Например, репозиторий Ubuntu:

add-apt-repository ppa:qbittorrent-team/qbittorrent-unstable

Совместимость

Протоколы

qBittorrent по-умолчанию генерирует торрент-файлы гибридного формата.

Клиенты (например, Transmission) не имеющие поддержку протокола 2 версии, не смогут открыть файл.

Таким образом, при создании торрент-файлов лучше явно указывать формат версии 1.

Magnet

Автоматически сгенерированный из magnet ссылки .torrent файл (при включенной опции авто-сохранения .torrent файлов), может не содержать фрагментов (pieces) что сделает его не совместимым при импорте.

В качестве решения, для раздач лучше генерировать новый .torrent файл после загрузки содержимого.

Зависание скачиваний

В 4 версии клиента замечено зависание (stalled) при скачивании файлов. Частой причиной этому может быть использование только первого трекера (оффлайн) из списка доступных.

Решение описано в официальной инструкции по дополнительным настройкам:

Preferences → Advanced → Always announce to all trackers

Также можно отметить

Preferences → Advanced → Always announce to all trackers in a tier

WebUI открывается как файл

В большинстве случаев связано с настройками MIME.

В дистрибутивах Linux, можно попробовать очистить кеш в директории

/home/USERNAME/local/share/mime

Ошибка авторизации плагинов

При использовании приватных трекеров или таких, что требуют авторизации для осуществления поиска, следует:

Зайти на сайт и авторизироваться из браузера, возможно есть запрос Captcha
Перезапустить сервис клиента - причиной может быть внутреннее кеширование клиентом предыдущих настроек

Ссылки

Официальный сайт qBittorrent
Частые вопросы
Альтернативные темы (Десктоп)
Альтернативные клиенты (Web UI)
Поисковые плагины

Внутрисетевые:
- YGGtracker - (Реестр узлов)
- Порты qBt_SE:
  - Rutor (http://[321:c99a:91a1:cd2c::16]/)
  - Rutracker (http://[321:c99a:91a1:cd2c::18]/forum/) - для поиска необходима авторизация

Сидбокс

anonymous@undisclosed.example.com (Anonymous) — Mon, 27 Oct 2025 10:03:55 +0000

Сидбокс

Сидбокс (англ. Seedbox) - частное автономное устройство, выполняющее функцию сбора, хранения и распространения данных или сетевых мета-данных (информации об узлах) другим узлам в сети.

Зачастую реализуется на базе одноплатного компьютера, в виду низкой энергозатратности и отсутствием шума.

В отличии от десктоп сидирования, устройство обеспечивает высокий показатель up-time.

Примеры устройств

Сидбоксинг

Культура и сообщество энтузиастов, мотивированных свободой обмена данными: метео, bittorrent, и другие направления.

Yggdrasil

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

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

Поскольку Yggdrasil обеспечивает соединение пиров путем туннелирования, не нужно настраивать маршрутизацию (проброс) портов на роутере, активировать опцию UPnP, достаточно разрешить выданный BitTorrent клиентом порт в настройках фаервол (при использовании модели whitelist)

Аппаратная часть

Контроллер

Выбор устройства

Для организации раздач в локальной сети Yggdrasil, требования к производительности минимальны, в большинстве случаев подойдет ARM платформа с 1 Гб оперативной памяти и внешним накопителем.

Использование для этой цели старого ноутбука, с постоянно подключенным зарядным устройством нежелательно для АКБ, если в устройстве не предусмотрен аппаратный модуль активной зарядки, обеспечивающий питание устройства напрямую, в случае, когда аккумулятор заряжен.

Оптимальным выбором для создания сид-бокса будет Raspbery Pi. Из бюджетных вариантов, существует множество альтернатив, например для BitTorrent раздач подойдет Orange Pi PC Plus, имеющий на борту процессор Allwinner H3 SoC Quad-core Cortex-A7, 1GB LPDDR3 SDRAM и встроенную память 8GB eMMC Flash.

Операционные системы

Обычно для обслуживания сид-сервера, используется операционные системы семейства Linux.

Например, Orange Pi предоставляет для загрузки свои официальные образы - Android, Linux, и другие, с адаптацией под характеристики каждой модели.

Также, существуют независимые проекты с открытым исходным кодом для множества устройств, например Armbian, DietPi и другие.

Не смотря на то, что большинство одноплатных компьютеров поставляется с предустановленной ОС, лучше установить последнюю версию подходящего для своих нужд дистрибутива.

Для установки операционной системы, после создания установочного образа (удобно использовать Balena etcher), подключаемся с помощью SSH, VNC или локально, если имеется внешний монитор, например, с HDMI адаптером. Если используется портативный LCD дисплей, лучше запитывать его от отдельного источника питания USB, так как потребление тока может превышать 2 Ампера, что нежелательно для питания от микрокомпьютера напрямую.

Охлаждение

Основной нагрузкой на процессор, при организации сида BitTorrent, является вычисление Info Hash при создании и валидации содержимого раздач (что в прочем можно оптимизировать в настройках выбранного клиента).

Поэтому желательно установить на модули процессора, питания и памяти дополнительные радиаторы пассивного охлаждения, которые можно приобрести в радио-любительских магазинах. В операционной системе Linux, контроль температуры датчиков удобно осуществлять с помощью утилиты sensors, установить которую можно командой:

apt install lm-sensors

Расширение памяти

Программное расширение

Если контроллер обладает малым объемом ОЗУ, расширить встроенную оперативную память можно с помощью файла подкачки на диске.

Чтобы добавить раздел swap на встроенную память, выполняем команды

fallocate -l 2G /swapfile

назначаем права root

chmod 600 /swapfile

форматируем файл

mkswap /swapfile

после чего подключаем командой

swapon /swapfile

для подключения /swapfile при загрузке системы, добавим в /etc/fstab

# <file system>   <mount point>   <type>   <options>   <dump> <pass>
/swapfile         none            swap     sw          0      0

Память swap желательно размещать на легко заменяемых носителях с высокой скоростью записи/чтения.

Если накопитель используется также и для других нужд, важно предусмотреть отдельный раздел. На дисках HDD, желательно размещать swap в начале разделов.

Подробнее о подготовке внешнего носителя данных, можно прочитать в разделе Подготовка носителя

Хранение данных

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

Для небольшого файло-обменного сервера, может быть использована обычная USB “флешка” на 128 Gb или внешний HDD диск, например Seagate Basic STJL1000400 2.5 USB 3.0 с 1TB ST1000LM035-FR на борту.

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

Поскольку внешний накопитель будет использоваться для раздач BitTorrent, лучше отдать предпочтение HDD.

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

Внешний накопитель

Рассмотрим пример создания разделов и форматирования с помощью утилит parted и mkfs.

Подключаем накопитель и находим его в списке:

parted -l

В моем случае это /dev/sda, поэтому он будет указан в качестве примеров ниже и важно заменить актуальным, во избежание потери данных.

Переходим в редактирование разделов

parted /dev/sda

Документацию интерфейса можно получить командой

help mkpart

Указываем стандарт разметки, GPT

mklabel gpt

В зависимости от целей и способа монтирования диска, можно создать несколько разделов.

Поскольку не знаю, сколько места может потребоваться для каждого пользователя (планируется расширять память новыми устройствами аппаратно) создаю один общий логический раздел для директории /home и указываю размер 0-100%. Отступы (alignment) раздела при этом будут созданы автоматически.

mkpart logical ext4 0% 100%

Проверяем разметку разделов

print free

Если всё устраивает, сохраняем изменения командой

quit

Форматируем раздел, например в журналируемую файловую систему Ext4

mkfs -t ext4 /dev/sda1

Далее необходимо узнать UUID раздела командой

lsblk -o PATH,SIZE,RO,TYPE,MOUNTPOINT,UUID,MODEL

и для автоматического монтирования после запуска системы, указать в

/etc/fstab

результат должен быть примерно таким:

# <file system>                                 <mount point>       <type>      <options>                                                       <dump>  <pass>
UUID=cf3151b5-dc12-1248-95d4-4de43dga3273       /mnt/sda1           ext4        defaults,noatime,rw,user,auto                                   0       2

если на монтируемом устройстве планируется запускать исполняемые файлы или производить сборку (например cargo), следует в “options” добавить флаг “exec”
для съемных накопителей желательно добавить флаг “nofail”, что позволит системе загружаться независимо от наличия (и состояния) устройства

Пример подключения в home

Копируем данные пользователей, предварительно остановив все службы, работающие с домашним каталогом, например, qbittorent-nox

service qbittorent-nox stop

производим резервное копирование и удаляем каталог /home

cp /home /home.bak
rm -R /home

монтируем диск

mount /dev/sda1 /home

копируем (или переносим) данные на носитель

cp /home.bak /home

каждому пользователю рекурсивно возвращаем права

chown -R qbittorent-nox:qbittorent-nox /home/qbittorent-nox

запускаем службы

service qbittorent-nox start

По аналогии, можно создать несколько разделов, задав при этом нужные точки монтирования.

Желательно размещать swap, временные файлы и журналы на внешних дисках для увеличения срока эксплуатации внутренней памяти микрокомпьютера.

Сетевой накопитель

Можно также подключить удалённый накопитель, расположенный на другом устройстве.

curlftpfs

Утилита для монтирования удалённой директории посредством FTP и CURL.

/usr/bin/curlftpfs -o allow_other ftp://user:password@[host]:21/source /target

Поскольку монтирование происходит от root, права доступа к ресурсу будут ограничены для остальных служб. Чтобы разрешить доступ к директории другим службам/пользователям, добавлен флаг -o allow_other.

Для подключения диска при авто-запуске, можно использовать crontab, fstab и другие утилиты, но в виду зависимости использующего софта от этой директории, лучше всего добавить команды в инициализацию сервиса:

[Service]
Type=forking
ExecStartPre=+/usr/bin/curlftpfs -o allow_other ftp://user:password@[host]:21/source /target
ExecStop=+/usr/bin/umount /target

* Знак “+” нужен для выполнения данных команд от root, в то время как основной сервис в ExecStart выполняется от своего пользователя.
* * Разрешить монтирование для других пользователей можно в файле /etc/fuse.conf раскомментировав параметр user_allow_other

Следует заметить, что curlftpfs имеет ряд недостатков, например очистка памяти, проблемы с правами доступа на виртуальных машинах и тд.

sshfs

Смонтировать сетевое устройство можно также с помощью SSH.

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

/usr/bin/sshfs -o password_stdin user@server:/source '/target' <<< 'password'

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

rclone

Многофункциональная утилита для синхронизации с популярными облачными платформами, также поддерживает различные протоколы - SSH, FTP и другие.

Для монтирования сетевого диска, используется команда rclone mount.

Прежде, чем смонтировать удалённый ресурс, необходимо настроить подключение с помощью rclone config

Монтирование:

/usr/bin/rclone mount remote:/source /target &

при операциях записи, необходимо включить минимальный уровень кеширования, указав флаг –vfs-cache-mode writes
при запуске через systemd, важно указывать путь к файлу профиля через –config
rclone, в отличии от других альтернатив, не требует запуска от администратора
пример локального зеркала FTP для qbittorrent-nox

Маршрутизация

В локальной сети, обычно, сидирующее устройство подключается к роутеру посредством интерфейса Ethernet, не занимая при этом эфир Wifi.

При одновременном сидировании в различные сети, в том числе - интернет, обойти ограничения NAT и расширить географию раздач можно добавлением интерфейса VPN, например с помощью CLI установщика OpenVPN. Таким образом, раздачи будут осуществляться на интерфейсы eth0 (ISP), tun0 (Yggdrasil), tun1 (VPN) и т.д.

Использование каналов можно проверить с помощью утилиты ifstat

* Проброс портов и активация UPnP на роутере для работы BitTorrent-сервера в сети Yggdrasil не требуется.

Сервер на базе qBittorrent

Общая информация о клиенте, доступна в разделе qBittorrent

Устанавливаем серверный клиент qbittorrent-nox

apt install qbittorrent-nox

добавляем пользователя

adduser --system --group qbittorrent-nox

настраиваем авто-запуск

nano /etc/systemd/system/qbittorrent-nox.service

[Unit]
Description=qBittorrent Command Line Client
After=network.target

[Service]
Type=forking
User=qbittorrent-nox
Group=qbittorrent-nox
UMask=007
ExecStart=/usr/bin/qbittorrent-nox -d --webui-port=8080
Restart=on-failure

[Install]
WantedBy=multi-user.target

* чтобы ограничить использование памяти, можно добавить лимиты в секцию [Service]:

MemoryHigh=256M
MemoryMax=512M
MemorySwapMax=512M

активируем

systemctl enable qbittorrent-nox

запускаем

systemctl start qbittorrent-nox

проверяем сервис и порт

systemctl status qbittorrent-nox
netstat -tupnl | grep 8080

добавляем правила iptables для подключения к веб-панели

ufw allow from ADMIN_REMOTE_IP to any port 8080

заходим в админ-панель указав admin/adminadmin в качестве логина по-умолчанию

http://SEED_SERVER_IP:8080

указываем базовые настройки

Connection → Listening Port - этот порт необходимо добавить в правила iptables для сидирования раздач в Yggdrasil (см. далее)
Speed → Global Rate Limits - ограничиваем скорость, чтобы сид-сервер не занимал весь пропускной канал на пиках
Web UI → Authentication → Username / Password - указываем логин пароль, отличный от стандартного
BitTorrent → Automatically add these trackers to new downloads - удобно указать адреса трекеров для автоматического добавления к загружаемым торрентам и магнет-ссылкам, например трекеры в сети Yggdrasil
Advanced → Always announce to all trackers, Always announce to all trackers in a tier - активируем работу со всеми доступными трекерами в списке каждого торрента (подробнее)
Advanced → qBittorrent Section → Optional IP address to bind to - IPv6 из списка, если хотим делиться только в сети Yggdrasil или оставляем по-умолчанию для раздач всем сетям (адрес своего узла в сети Yggdrasil можно получить с помощью команды yggdrasilctl getSelf)
Advanced → Enable embedded tracker - Включив данную опцию, можно активировать сервер торрент-трекера и опубликовать его в списке внутрисетевых сервисов (см. также Opentracker)

Сохраняем настройки и открываем Listening Port (для раздач в сеть интернет, достаточно поддержки роутером и наличия включённой опции UPnP)

ufw allow from 0200::/7 to any port [Listening Port]

данные профиля сохранены в директории пользователя qbittorrent-nox

/home/qbittorrent-nox/.config/qBittorrent

в частности, журналы для отладки проблем

/home/qbittorrent-nox/.local/share/qBittorrent/logs

Расширение доступа

По умолчанию, qbittorrent-nox работает с файлами только в рамках собственного каталога /home/qbittorrent-nox

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

Для этого, добавляем пользователя qbittorrent-nox в соответствующую группу, указав флаг append:

usermod -a -G family qbittorrent-nox

Разрешаем bash в файле /etc/passwd

qbittorrent-nox:...:/home/qbittorrent-nox:/usr/bin/bash

Совместным каталогам группы family назначаем права не ниже 0770

Общий доступ к файлам

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

Таким образом, загрузив файл с одного устройства и продолжив его раздачу, можно открыть файл на другом, при этом не занимать дисковое пространство клиентской машины.

Файловые менеджеры различных дистрибутивов достаточно удобны в настройке.

Например в графической среде Gnome, в файловом менеджере переходим в левом меню + Other Locations и указываем в нижнем трее адрес подключения - ftp, ssh, smb или другой.

Соответственно на файловом сервере должно быть установлен и настроен соответствующий сервис, а также разрешено подключение в правилах iptables.

Утилиты

anonymous@undisclosed.example.com (Anonymous) — Wed, 22 Oct 2025 08:13:18 +0000

Утилиты

В разделе рассмотрены различные утилиты для создания локальных коллекций и оформления торрент-раздач.

Веб

wget

Локальное зеркало веб-сайта:

wget -e robots=off --relative --recursive --timestamping --page-requisites --convert-links --adjust-extension --no-remove-listing "url"

в поздних версиях GNU Wget2 / 2.2.0 команды --relative, --no-remove-listing являются устаревшими
некоторые сайты могут зависеть от внешних ресурсов, в таком случае, необходимо добавить аргумент --domains, например --domains=pbs.twimg.com

GIT

Собрать только измененные файлы в архив .zip - удобно для дополнений к раздачам при выпуске обновлений:

zip modified-files.zip $(git ls-files --modified)

YouTube

yt-dlp

yt-dlp - это форк известной CLI утилиты youtube-dl, позволяющий загружать плейлисты и отдельные ролики с YouTube.

API YouTube постоянно обновляется, и прежде чем приступить к загрузке контента, важно установить последнюю версию из исходников или загрузить готовую сборку в разделе релизов.

Создадим целевую директорию для загружаемого плейлиста:

mkdir NAME

cd NAME

Загрузка осуществляется одной командой, по-умолчанию используется формат оригинала, на момент написания материала - webm

yt-dlp CHANNEL_URL|PLAYLIST_URL|VIDEO_URL

По-умолчанию, будет загружена версия в максимально возможном качестве. Если нужно уменьшить размер файлов в релизе, например до 1080p, нужно указать дополнительный флаг:

yt-dlp CHANNEL_URL|PLAYLIST_URL|VIDEO_URL -S res:1080

Чтобы загрузить весь канал и автоматически разложить видео по директориям с названием плей-листа, можно использовать флаг output и макросы, например:

yt-dlp CHANNEL_URL/playlists -o '%(uploader)s/%(playlist)s/%(title)s.%(ext)s'

Если нужно сохранить только аудио-дорожку, указываем флаг extract-audio или сокращенно - x
По-умолчанию, будет использован оригинальный аудио-кодек или opus, если нужно осуществить пост-конвертацию, например в mp3 или vorbis (ogg), добавляется флаг audio-format
Качество аудио указывается параметром audio-quality в значении от 0-10 (5 по-молчанию)

yt-dlp CHANNEL_URL|PLAYLIST_URL|VIDEO_URL --extract-audio --audio-format vorbis

Узнать все доступные опции, можно командой

yt-dlp --help

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

yt-dlp-web-ui

Локально-ориентированная графическая оболочка для загрузки в браузере:

https://github.com/marcopeocchi/yt-dlp-web-ui

FreeTube

FreeTube - это альтернативный клиент, с открытым исходным кодом, для приватного просмотра и загрузки видео с YouTube.

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

Интерфейс содержит инструменты для удобной загрузки субтитров, видео и аудео дорожек.

На момент написания материала, к недостаткам можно отнести отсутствие возможности загружать видео в более высоком качестве, чем 720p/25fps
Поэтому проект больше подойдет для локального просмотра видео YouTube без наличия аккаунта, рекламы а также без географических ограничений.

Transmission

anonymous@undisclosed.example.com (Anonymous) — Wed, 22 Oct 2025 08:13:18 +0000

Transmission

Популярный BitTorrent клиент с открытым исходным кодом, отличающийся простотой интерфейса.

Для работы в сети Yggdrasil требует дополнительных настроек, так как по-умолчанию прослушивает интерфейс сетевой карты, не имея соответствующих опций в графической оболочке. Таким образом, при наличии подключения к интернет, вероятной точкой выхода в сеть будет IP провайдера, в то время как подключения Yggdrasil, например, на tun0 - будут недоступны.

Transmission оптимально использовать в паре с другими клиентами: например, Transmission - для интернет раздач и qBittorrent - для сидирования в локальную сеть Yggdrasil.

На момент написания материала, Transmission поддерживает работу magnet-ссылок только 1-й версии.

Графический интерфейс

Создание торрент-файлов

Для создания “раздачи”, сначала необходимо сегенерировать torrent-файл, указав в клиенте путь к файлу или директории. Сделать это можно в пункте меню “File” - “New…”

Файл с расширением .torrent будет включать в себя основной компонент протокола - info-hash - своего рода контрольную сумму файла, разделенного на фрагменты. Значение этой хеш-суммы позволяет идентифицировать файл в сети BitTorrent, подобно тому, как это реализовано в протоколе IPFS.

Вычисление info-hash требует некоторого времени, и во многом зависит от мощности процессора и размера файла.

После того, как torrent-файл был создан, клиент автоматически предложит добавить его в список раздач.

Теперь, чтобы поделиться файлом с другими, достаточно передать принимающей стороне файл .torrent или скопировать magnet-ссылку в пункте меню “Torrent” - “Copy magnet link to clipboard” Если идентичный info-hash (то есть файл) уже имеется в реестре DHT принимающего узла, он также будет загружаться с узлов, находящихся в сети.

После загрузки файла (а также в процессе загрузки его фрагментов), при условии наличия открытого порта или UPnP, принимающий узел также может начинать раздавать файл (или его загруженные фрагменты) другим.

transmission-cli

transmission-cli - набор утилит transmission для работы из командной строки.

Создание торрент-файлов

transmission-create -o ПутьКФайлу.torrent -c "Комментарий" -t "http://[201:23b4:991a:634d:8359:4521:5576:15b7]:2023/announce" ПутьКфайлу.mkv

здесь:

http://[201:23b4:991a:634d:8359:4521:5576:15b7]:2023/announce - это адрес трекера, который будет использоваться для анонса
Комментарий - опциональный параметр, также используется в протоколе Magnet для поиска в локальном и P2P реестрах

По-желанию или при необходимости можно вывести на экран magnet-ссылку, получаемую из torrent-файла:

transmission-show -m ПутьКФайлу.torrent

Торрент-файлом или полученной magnet-ссылкой можно поделиться с сообществом, разместив их на YGGtracker или другим удобным вам способом.

Ссылки

Официальный сайт Transmission

YGGtracker

anonymous@undisclosed.example.com (Anonymous) — Wed, 22 Oct 2025 08:13:18 +0000

YGGtracker

Проект c открытым исходным кодом для организации раздач BitTorrent в сети Yggdrasil

Версия 1 (архив)
Версия 2

Ссылки

Исходный код на GitHub
Рецепты
Локализация
Новости проекта
Поисковый плагин для qBittorrent
Утилита для автозагрузки востребованных торрентов

HowTo Yggdrasil - yggdrasil:bittorrent

BitTorrent

BitTorrent

Yggdrasil

Статьи внутри раздела

Ссылки

βtracker

βtracker

Установка

aquatic_udp

aquatic-crawler

btracker

nginx

DHT

DHT

Теория

Практика

Tixati

qBittorrent

BiglyBT

Несовместимость с публичным IPv6

Jackett

Jackett

Установка

Интеграции

Ссылки

Похожие проекты

Opentracker

Opentracker

Установка

Настройки доступа

Автозапуск

Проксирование

Подключение

Ссылки

qBittorrent

qBittorrent

Пиринг в Yggdrasil

Сидирование

Встроенный трекер

Темы оформления

Альтернативный Web UI

Контрибуция

Сборка из исходников

Автоматическая сборка

Ручная сборка

libboost

libtorrent

qt

qtbase

qttools

qbittorrent-nox

Решение проблем

Потребление памяти

Совместимость

Протоколы

Magnet

Зависание скачиваний

WebUI открывается как файл

Ошибка авторизации плагинов

Ссылки

Сидбокс

Сидбокс

Примеры устройств

Сидбоксинг

Yggdrasil

Аппаратная часть

Контроллер

Выбор устройства

Операционные системы

Охлаждение

Расширение памяти

Программное расширение

Хранение данных

Внешний накопитель

Пример подключения в home

Сетевой накопитель

curlftpfs

sshfs

rclone