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

Этот гайд ведёт вас от чистой машины до подключения. Он покрывает
установку из двух частей, вход, подключение и то, где получить помощь.
Про каждый экран и каждую настройку читайте
[тур по Linux](/docs/tour-linux).

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

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

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](https://github.com/urnetwork/build/releases).

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

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

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

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

```
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:

```
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`, поэтому
ваш собственный пользователь должен в неё вступить:

```
sudo usermod -aG urnetwork "$USER"
```

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

Сторонние оценки безопасности — и их рамки — разобраны в
[модели угроз](/docs/threat-model).

## Вход

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

- **Почта или телефон.** Введите и продолжайте. Приложение найдёт ваш
  аккаунт или предложит создать его, проверив одноразовым кодом.
- **Создать аккаунт (Create account).** Имя сети, почта или телефон,
  пароль и необязательный реферальный код.
- **Вход по коду (Sign in with code).** Уже вошли на другом устройстве?
  Сгенерируйте там одноразовый код авторизации — в любом приложении
  URnetwork или на [ur.io](https://ur.io) — и вставьте его.
- **Попробовать гостевой режим (Try Guest Mode).** Один клик создаёт
  настоящую, постоянную сеть, не передав ничего. Кнопка старше нынешнего
  процесса регистрации: фраза восстановления этого аккаунта
  отбрасывается, а не показывается вам, поэтому пути назад в него с
  другой машины нет. Считайте его одноразовым для оценки. Добавьте почту,
  телефон или кошелёк, прежде чем на него полагаться.
- **Вход через Bittensor (Sign in with Bittensor).** Ваш браузер
  открывает кошельковый мост, ваш кошелёк подписывает сообщение, дальше
  приложение берёт всё на себя.
- **Вход через Solana (Sign in with Solana).** Тот же процесс, через
  Phantom или Solflare.

Входа через Google или Apple на Linux нет. Если хотите аккаунт без почты,
который можно сохранить, приложения для телефона и Mac предлагают
**Создать мгновенный аккаунт** (Create Instant Account) в одно касание —
он показывает свою фразу восстановления. Создайте его там и перенесите на
эту машину кодом авторизации.

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

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

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

О том, что URnetwork записывает о ваших подключениях, читайте в
[модели угроз](/docs/threat-model).

## Подключение

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

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

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

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

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

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

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

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

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

Если приложение сообщает, что служба недоступна, устарела или собрана
иначе, чем приложение, — это реальное состояние с реальным решением: см.
[устранение неполадок](/docs/tour-linux#troubleshooting) в туре. Две
половины намеренно сверяются по версии, поэтому наполовину обновлённая
установка говорит об этом, а не ломается странным образом. При проблемах
с туннелем первым делом проверьте `journalctl -u urnetworkd -f`.
[feedback.ur.io](https://feedback.ur.io) выходит на команду, а
[FAQ](/docs/faq) отвечает на частые вопросы.

## Что дальше

- **Пройдите [тур](/docs/tour-linux).** Каждый экран и каждая настройка:
  разделение с демоном, поведение маршрутизации и DNS и его пределы,
  листы (собственный DNS, правила разделения, живые контракты),
  переопределение локации устройства, kill switch (аварийный стоп; по
  умолчанию выключен) и устранение неполадок.
- **Раздайте своё подключение.** Режим раздачи — в органах управления на
  главном экране приложения: **Авто**, **Всегда**, **Сеть** (только
  устройства вашего собственного аккаунта, никогда не публика) или
  **Никогда** (Auto, Always, Network, Never), и начинает он с
  **Никогда**. Десктоп или сервер на Linux с хорошим каналом — ровно тот
  узел, который нужен сети; [обзор](/docs/overview) покрывает фильтрацию
  злоупотреблений, которая работает на вашей машине до того, как трафик
  её покинет. Для безголовой машины ту же работу делает автономная
  провайдерская CLI с
  [github.com/urnetwork/build/releases](https://github.com/urnetwork/build/releases):
  `urnetwork auth` с кодом из любого приложения, затем
  `urnetwork provide`. Провайдеры участвуют в протоколе UR;
  [ur.xyz](https://ur.xyz) документирует, как работают вознаграждения.
- **Попробуйте другую платформу:**
  [Android](/docs/getting-started-android),
  [iOS](/docs/getting-started-ios), [macOS](/docs/getting-started-macos),
  [Windows](/docs/getting-started-windows) и
  [браузер](/docs/getting-started-browser).
