# Настройка Агента на ОС Linux Ubuntu/Debian/Astra и прочих клонов
Для настройки фильтрации cкачайте установочный дистрибутив по ссылке.
Установить программу можно двумя способами.
##### Первый способ
1. Откройте **Менеджер файлов** и дважды кликните на скаченный файл.
2. Откроется окно с установкой, в котором кликните **Установить**.
3. Введите пароль от учетной записи пользователя.
4. Дождитесь установки программы, по окончанию закройте данное окно.
5. Перезагрузите компьютер → **Перезапуск**.
6. После перезагрузки компьютера в трее появится иконка Агента, нажмите **Развернуть окно**. ##### 
7. Откроется окно программы Агент SkyDNS. Введите ваши учетные данные от личного кабинета SkyDNS → **Вход**. ##### 
8. Придумайте PIN-код, он нужен для доступа к настройкам программы и включения/отключения фильтрации. ##### 
9. Еще раз введите придуманный вами PIN-код для доступа к настройкам программы.
10. На этом установку и настройку программы можно считать завершенной. В окне Агента вы можете выбрать профиль фильтрации, по которому будет фильтроваться это устройство, включать/отключать фильтрацию, а также посмотреть информацию о системе. ##### 
##### Второй способ
Откройте Терминал и запустите установку пакета командой – sudo dpkg –i ~/Загрузки/skydns\*.deb
В случае rpm пакета - sudo rpm –i ~/Загрузки/skydns\*.rpm
Стандартно, при скачивании файлов, они попадают в папку **Загрузки**, название вашей папки может отличаться.
### Переход на SkyDNS Agent 5.0.0 в Linux
При переходе с **SkyDNS Agent 3.5.1** на **SkyDNS Agent 5.0.0** можно использовать один из двух вариантов:
- полностью удалить старую версию и установить новую;
- установить новую версию поверх старой.
Перед переходом учитывайте особенности DNS-конфигурации, описанные ниже.
#### Вариант 1. Удалить старый агент и установить 5.0.0
1. Полностью удалите старый агент.
Для Ubuntu/Debian:
```bash
sudo apt purge <пакет SkyDNS Agent>
```
2. Проверьте DNS-конфигурацию системы.
После удаления старого агента `/etc/resolv.conf` может содержать `8.8.8.8` вместо прежних DNS-настроек.
3. Если необходимо сохранить исходную DNS-конфигурацию, восстановите её.
Например, на Ubuntu 24.04 с `systemd-resolved`:
```bash
sudo rm -f /etc/resolv.conf
sudo ln -s ../run/systemd/resolve/stub-resolv.conf /etc/resolv.conf
sudo systemctl restart systemd-resolved
```
Если DNS управляется другим способом, восстановите его штатными средствами системы.
4. Установите SkyDNS Agent 5.0.0:
```bash
sudo apt install /путь/к/пакету-5.0.0.deb
```
5. Авторизуйте новый агент.
Если `8.8.8.8` подходит для вашей сети, восстанавливать DNS перед установкой не требуется.
---
#### Вариант 2. Установить 5.0.0 поверх старого агента
Предварительно удалять старую версию не требуется.
Установите Agent 5.0.0 с новой конфигурацией:
```bash
sudo DEBIAN_FRONTEND=noninteractive apt-get -y \
-o Dpkg::Options::="--force-confnew" \
install /путь/к/пакету-5.0.0.deb
```
После установки:
1. Проверьте DNS.
2. Если необходимо сохранить исходную DNS-конфигурацию, восстановите её.
3. Авторизуйте Agent 5.0.0.
Старая авторизация при обновлении не переносится, поэтому новую версию необходимо авторизовать заново.
Если агент не появился в системном трее, перезапустите службу:
```bash
systemctl --user restart agentskydnsgui.service
```
##### Что важно знать о DNS
Старые версии агента при удалении или обновлении могут изменить `/etc/resolv.conf`, установив DNS `8.8.8.8`.
Это не обязательно приводит к проблемам. Если `8.8.8.8` доступен и подходит для вашей сети, Agent 5.0.0 можно использовать с этой конфигурацией.
Однако если используются:
- корпоративные DNS-серверы;
- внутренние домены;
- VPN;
- Split DNS,
рекомендуется восстановить исходную DNS-конфигурацию.
**Важно:** Agent 5.0.0 сохраняет текущее DNS-состояние при первой авторизации. Поэтому, если вы хотите, чтобы исходная DNS-конфигурация использовалась для последующего восстановления, её необходимо восстановить **до первой авторизации**.