Первые шаги

Начало работы на Linux

6 мин чтенияОткрыть как Markdown ↗

Этот гайд ведёт вас от чистой машины до подключения. Он покрывает установку из двух частей, вход, подключение и то, где получить помощь. Про каждый экран и каждую настройку читайте тур по Linux.

URnetwork использует выходные устройства, которые держат участники. На ретранслируемых путях провайдеры не получают ваш исходный IP. Нативные приложения к тому же могут шифровать трафик до провайдера, как только вы включите Постквантовое шифрование (Post Quantum Encryption); поставляется оно выключенным. Полная модель — в статье Как работает URnetwork.

Что понадобится

URnetwork для Linux — нативное десктопное приложение GTK4 в паре с системным демоном, который владеет туннелем. Целевые системы — Ubuntu 22.04 и новее и эквивалентные выпуски семейства Debian, на amd64 и arm64; нужны systemd и /dev/net/tun. Это обычная десктопная или серверная установка.

Установка

Приложение устанавливается двумя частями, потому что туннелю нужна привилегия, а GUI не должен иметь её никогда:

  • urnetworkd — маленький root-демон под systemd. Он владеет /dev/net/tun, маршрутами и DNS. GUI-зависимостей у него нет вовсе, поэтому он спокойно ставится на безголовую машину.
  • Приложение URnetwork — десктопное приложение GTK4/libadwaita, поставляемое как AppImage и работающее от вашего обычного пользователя. Root ему не нужен никогда.

Обе части берутся с github.com/urnetwork/build/releases.

1. Установите демон

На Debian, Ubuntu и производных используйте .deb:

Text
sudo apt install ./urnetwork-daemon_<version>_<arch>.deb

или установочный tarball на дистрибутивах без dpkg:

Text
tar xf urnetwork-daemon-<version>-<arch>.install.tar.gz
sudo urnetwork-daemon/install.sh

Установщик выполняет предполётные проверки (systemd, glibc, /dev/net/tun) и печатает, что собирается сделать; install.sh --dry-run показывает план, ничего не трогая. Он создаёт системную группу urnetwork, устанавливает демон, его юнит systemd, desktop-запись, иконки и лаунчер /usr/bin/urnetwork, затем включает и запускает службу. Запуск при установке безопасен: демон стартует вхолостую. Он не поднимет туннель, пока аутентифицированный десктопный клиент его не попросит.

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

GUI-AppImage пакетом намеренно не устанавливается. Он живёт в вашем домашнем каталоге, чтобы заменять сам себя без root:

Text
mkdir -p ~/.local/lib/urnetwork
cp URnetwork-<version>-<arch>.AppImage ~/.local/lib/urnetwork/URnetwork.AppImage
chmod +x ~/.local/lib/urnetwork/URnetwork.AppImage

/usr/bin/urnetwork находит его там и запускает, поэтому desktop-запись, меню приложений и ссылки urnetwork:// продолжают работать сквозь обновления приложения. AppImage требуют libfuse2; .deb объявляет эту зависимость за вас.

3. Добавьте себя в группу urnetwork

Командовать демоном могут только root и члены группы urnetwork, поэтому ваш собственный пользователь должен в неё вступить:

Text
sudo usermod -aG urnetwork "$USER"

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

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

Вход

Запустите URnetwork из меню приложений или командой urnetwork. Приложение открывается на вариантах входа. Выберите модель идентичности, которая вам комфортна:

  • Войти через Google (Sign in with Google) или Войти через Apple (Sign in with Apple). Браузер открывает страницу входа самого провайдера, а когда вы закончите там, возвращает вас в приложение.
  • Создать мгновенный аккаунт (Create Instant Account). Без почты, без телефона, без пароля. Отметьте согласие с условиями и нажмите Создать аккаунт (Create Account): приложение создаст настоящую постоянную сеть и один раз покажет её сид-фразу — список слов, который и есть учётные данные. Сохраните её, прежде чем нажать Я сохранил сид-фразу (I've Saved My Seedphrase).
  • Сид (Seed). Войдите снова по сид-фразе, которую выдал мгновенный аккаунт. Это собственная фраза URnetwork; URnetwork никогда не просит сид-фразу криптокошелька.
  • Код аутентификации (Auth code). Уже вошли на другом устройстве? Сгенерируйте там одноразовый код авторизации — в любом приложении URnetwork или на ur.io, — вставьте его и нажмите Войти с кодом аутентификации (Log in with Auth Code).
  • Bittensor. Выберите Talisman, TAO.com или WalletConnect. Браузер откроет мост кошелька, кошелёк подпишет сообщение, а приложение сделает остальное.
  • Solana. Тот же путь, через Phantom или Solflare.
  • Email или телефон. Введите и нажмите Начать (Get started). Существующий аккаунт спросит свой пароль, а Забыли пароль? (Forgot your password?) пришлёт ссылку для сброса. Новый перейдёт к созданию аккаунта: имя сети, пароль не короче 12 символов и необязательный реферальный код, а затем одноразовый код, отправленный на этот адрес, подтвердит его.

Вход через Google, Apple или кошелёк, для которого ещё нет сети, дальше попросит дать ей имя.

Каждая сеть начинает с бесплатного тарифа — дневного лимита данных, который обновляется каждый день. Pro ($5/месяц или $40/год) добавляет к нему большой месячный лимит; покупается в приложении через Получить UR Pro (Get UR Pro). Текущие цифры: ur.io/products.

Разрешение на туннель

При подключении диалог согласия не появляется, потому что привилегию вы выдали при установке. Демон работает от root и владеет туннельным устройством; приложение работает от вас и просит демона через его управляющий сокет. Сокет закрыт проверяемыми ядром учётными данными пира: root или член группы urnetwork. Ничто другое в системе туннель запустить не может.

О том, что URnetwork записывает о ваших подключениях, читайте в модели угроз.

Подключение

  1. Нажмите Подключить (Connect) в приложении.
  2. Туннель поднимается. Запроса разрешения нет, потому что туннельное устройство открывает демон, а не приложение.
  3. Глобус и строка состояния оживают, и появляется значок в трее, если ваш десктоп такое поддерживает.

Выбор локации

Умолчание — лучший доступный (best available). Сеть непрерывно подбирает вам быстрых, надёжных провайдеров. Для большинства сеансов это правильный выбор.

Чтобы выбрать, где ваш трафик выходит:

  1. Нажмите строку локации, чтобы открыть выбор.
  2. Листайте список стран или наберите запрос в поиске. Регионы, города и устройства появляются в результатах поиска, поэтому наберите название города, чтобы найти его.
  3. Выберите локацию. Приложение переподключится через тамошних провайдеров.

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

Убедитесь, что работает

Зайдите на любой сайт «какой у меня IP». Вы должны увидеть адрес и город провайдера, а не ваши. Дальше о поднятом туннеле говорят глобус и строка состояния приложения — и значок в трее там, где десктоп его показывает.

Если что-то не так

Если приложение сообщает, что служба недоступна, устарела или собрана иначе, чем приложение, — это реальное состояние с реальным решением: см. устранение неполадок в туре. Две половины намеренно сверяются по версии, поэтому наполовину обновлённая установка говорит об этом, а не ломается странным образом. При проблемах с туннелем первым делом проверьте journalctl -u urnetworkd -f. feedback.ur.io выходит на команду, а FAQ отвечает на частые вопросы.

Что дальше

  • Пройдите тур. Каждый экран и каждая настройка: разделение с демоном, поведение маршрутизации и DNS и его пределы, листы (собственный DNS, правила разделения, живые контракты), переопределение локации устройства, kill switch (аварийный стоп; по умолчанию выключен) и устранение неполадок.
  • Раздайте своё подключение. Режим раздачи — в органах управления на главном экране приложения: Авто, Всегда, Сеть (только устройства вашего собственного аккаунта, никогда не публика) или Никогда (Auto, Always, Network, Never), и начинает он с Никогда. Десктоп или сервер на Linux с хорошим каналом — ровно тот узел, который нужен сети; обзор покрывает фильтрацию злоупотреблений, которая работает на вашей машине до того, как трафик её покинет. Для безголовой машины ту же работу делает автономная провайдерская CLI с github.com/urnetwork/build/releases: urnetwork auth с кодом из любого приложения, затем urnetwork provide. Провайдеры участвуют в протоколе UR; ur.xyz документирует, как работают вознаграждения.
  • Попробуйте другую платформу: Android, iOS, macOS, Windows и браузер.