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

Запустите собственный VPN-сервер на любой машине с Linux и публичным IP-адресом. VpnHood! MANAGER настроит управляемый сервер за вас, либо установите автономный сервер одной командой.

Ваш сервер

VpnHood! SERVER работает на подконтрольном вам оборудовании, например на VPS.
Ключ доступа

Создаётся в MANAGER или на сервере. Подключиться может любой, у кого есть ключ.
Ваши устройства

Добавьте ключ в приложение VpnHood! CLIENT на телефоне или компьютере.

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

Сервер с публичным IP-адресом на базе Linux (x64 или arm64). Системы, на которых работает сервер, перечислены в разделе Системные требования.
Root-доступ. Команды установки выполняются через sudo — пакет должен быть установлен в системе, даже если вы входите под root.
Открытый TCP-порт 443 в брандмауэре системы и хостинг-провайдера. Сервер принимает подключения через этот порт.

Установка автономного сервера

Выполните команду. Скрипт автоматически определит архитектуру (x64 или arm64) и установит сервер в /opt/VpnHoodServer.

sudo bash -c 'u=https://github.com/vpnhood/VpnHood.App.Server/releases/latest/download/VpnHoodServer-linux.sh; bash <(wget -qO- $u 2>/dev/null || curl -fsSL $u)'

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

Создание первого ключа доступа

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

sudo /opt/VpnHoodServer/vhserver gen

Ключ появится под заголовком --- AccessKey --- и будет начинаться с vh: — скопируйте всю строку целиком. Чуть выше, в строке HostEndPoints:, должен отображаться публичный IP-адрес вашего сервера.

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

Параметр	Назначение
`-name Phone`	Название, чтобы легко различать ключи.
`-maxClient 5`	Лимит одновременно подключенных устройств. По умолчанию: 2.
`-maxTraffic 50000`	Лимит на трафик в мегабайтах. По умолчанию: без ограничений.
`-maxSpeed 20`	Ограничение скорости на прием и отдачу в Мбит/с. По умолчанию: без ограничений.
`-expire 2030/01/25`	Срок действия ключа. По умолчанию: бессрочно.

Пример ключа для одного телефона с действием до конца 2030 года

sudo /opt/VpnHoodServer/vhserver gen -name Phone -maxClient 1 -expire 2031/01/01

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

Подключение

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

Запуск и остановка сервера

Сервер работает как служба VpnHoodServer — как при управлении через панель, так и в автономном режиме.

sudo systemctl status VpnHoodServer

sudo systemctl stop VpnHoodServer

sudo systemctl start VpnHoodServer

Журнал событий находится в /opt/VpnHoodServer/storage/logs/server.log.

Если вы установили сервер без системной службы, запускайте его вручную командой sudo /opt/VpnHoodServer/vhserver. Сервер работает до тех пор, пока вы не остановите его командой sudo /opt/VpnHoodServer/vhserver stop из другого терминала.

Обновления

Если автообновление не было отключено при установке, сервер обновляется до каждого нового релиза автоматически: служба VpnHoodServerUpdater проверяет обновления каждые 12 часов.

Чтобы отключить автообновление, снова выполните команду автономной установки и ответьте n на вопрос Keep the server up to date by itself (Y/n)?. Установщик сохранит ваш ответ и настройки, поэтому сервер останется на своей версии, пока вы сами не выполните эту команду снова.

Рекомендуем не отключать автообновления: некоторые новые версии закрывают уязвимости. Обновлённое приложение по-прежнему подключается к старому серверу, но не получает UDP от сервера версии ниже v9.0.859, а серверы старше VpnHood 9.1 приложения поддерживают только до апреля 2027 года.

Удаление

Чтобы удалить сервер, запустите команду деинсталляции. Она остановит сервер и удалит службы и файлы, сохранив настройки, ключи доступа и сертификаты в /opt/VpnHoodServer/storage на случай повторной установки.

sudo /opt/VpnHoodServer/vhuninstall

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

sudo /opt/VpnHoodServer/vhuninstall -purge