Установка VpnHood! CLIENT на Linux

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

Перед началом работы

Ключ доступа от того, кто управляет сервером, так как у VpnHood! CLIENT нет собственных серверов.
Убедитесь, что ваша машина соответствует требованиям для Linux.

Установка

Выполните эту команду и ответьте на её единственный вопрос: запускать ли службу VPN при загрузке системы. Команда сама выберет сборку для вашего процессора.

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood/releases/latest/download/VpnHoodClient-linux.sh)"

Она установит службу VPN и команду vhclient. На машине с графической средой она также добавит VpnHood! CLIENT в меню приложений.

Подключение

В графической среде откройте VpnHood! CLIENT из меню приложений, добавьте ключ доступа и подключитесь.

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

vhclient profile add 'vh:...'

vhclient connect

vhclient status

vhclient profile add также принимает путь к файлу с ключом. Если профилей несколько, выберите тот, через который подключаться: vhclient profile set-default.

Команды

Они работают в терминале под любой учётной записью администратора, без sudo. vhclient --help выводит их все, а vhclient connect --help объясняет отдельную команду.

Команда	Назначение
`vhclient connect`	Подключается и ждёт результата. `--location` выбирает локацию из списка `vhclient locations`.
`vhclient disconnect`	Отключается. Служба продолжает работать.
`vhclient status`	Показывает подключение и готовящееся обновление. `--watch` выводит их непрерывно.
`vhclient locations`	Выводит список локаций серверов, к которым можно подключиться.
`vhclient profile list`	Выводит список ваших профилей и отмечает тот, через который выполняется подключение.
`vhclient profile add`	Добавляет профиль из ключа доступа или из файла с ключом.
`vhclient profile remove`	Удаляет профиль.
`vhclient profile set-default`	Выбирает профиль, который использует `vhclient connect`.
`vhclient ui`	Открывает окно приложения.
`vhclient service status`	Показывает, работает ли служба.
`vhclient service log`	Показывает журнал службы. `-f` следит за ним в реальном времени.
`vhclient service restart`	Перезапускает службу, из-за чего VPN отключается. Запрашивает ваш пароль.

Подключение при запуске

С функцией «Всегда включен» VPN подключается при запуске компьютера, ещё до входа пользователя. Пока сервер недоступен, приложение повторяет попытки, с каждым разом ожидая дольше. Попытки прекращаются, когда вы отключаетесь, когда управление перехватывает другое VPN-приложение или когда сервер отклоняет подключение. Включите функцию в настройках приложения или этой командой:

vhclient always-on on

Kill Switch

Kill Switch не выпускает ничего за пределы VPN-туннеля — даже при ошибке, сбое и перезагрузке. С until-disconnect блокировка снимается при отключении, а с lockdown она сохраняется и после него:

vhclient kill-switch until-disconnect

Чтобы снять блокировку, выполните vhclient kill-switch off. Если служба остановлена, выполните эту команду с sudo.

Обновления

Приложение обновляется само: при загрузке системы и каждые 12 часов оно ищет новую версию, скачивает её и устанавливает, пока VPN отключён. Параметр «Автоматические обновления» в настройках приложения выключает это. Эта команда сразу устанавливает новую версию, даже если обновления выключены, а на время установки VPN отключается:

vhclient update

Параметры установки

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

Параметр	Назначение
`-q`	Без вопросов. При новой установке приложение запускается при загрузке системы и обновляется само; при обновлении сохраняется сделанный вами выбор.
`-noautostart`	Не запускает службу при загрузке системы.
`-noautoupdate`	Не обновляет приложение автоматически.
`-autoupdate`	Снова включает автоматическое обновление приложения после `-noautoupdate`.
`-nodesktop`	Устанавливает только службу и команды: без пункта меню и без библиотек для окна.
`-desktop`	Устанавливает пункт меню и библиотеки для окна, даже если графическая среда не обнаружена.
`-help`	Выводит список параметров.

Например, без вопросов и без графической среды:

sudo su -c "bash <( wget -qO- https://github.com/vpnhood/VpnHood/releases/latest/download/VpnHoodClient-linux.sh) -q -nodesktop"

Удаление

Щёлкните правой кнопкой мыши по VpnHood! CLIENT в меню приложений и выберите «Uninstall» или выполните эту команду:

sudo /opt/VpnHoodClient/vhuninstall

Настройки останутся в /opt/VpnHoodClient/storage на случай повторной установки. Чтобы удалить и их, добавьте -purge.

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

Что вы видите	Что делать
`The VpnHoodClient service is not running.`	Выполните `sudo vhclient service start`, затем посмотрите `vhclient service log`.
Пункт меню ничего не делает	Выполните `vhclient ui` в терминале, чтобы узнать причину. Обычно это библиотека, которой нет после установки с `-nodesktop`.
В окне сказано, что приложением может пользоваться только администратор	Добавьте свою учётную запись в группу `sudo` или в `wheel`, если в системе используется она, а затем войдите в систему снова.
Приложение сообщает, что управление перехватило другое VPN-приложение	Одновременно может быть подключено только одно приложение, созданное на основе VpnHood!, поэтому подключение другого отключает это. Оно останется отключённым, даже с функцией «Всегда включен», пока вы не подключите его снова.
`Could not set the VPN's DNS servers.`	Выполните `sudo systemctl enable --now systemd-resolved`, затем сделайте `/etc/resolv.conf` ссылкой на `/run/systemd/resolve/stub-resolv.conf`, как указано в сообщении.
`The kill switch needs nftables (nft), which is not installed.`	Установите пакет `nftables` или выключите Kill Switch.
Подключено, но ничего не загружается	Посмотрите `vhclient service log -n 100`.
`The VPN cannot use its interface name`	У другого VPN есть интерфейс с именем `VpnHoodClient`, и сообщение указывает, чей он. Остановите этот VPN или, если он удалён, а интерфейс остался, выполните `sudo ip link delete VpnHoodClient`.

Что дальше

Выберите, что пойдёт через VPN, с помощью раздельного туннелирования