Установка WireGuard

Инструкции по установке WireGuard на различные операционные системы и устройства

Обзор

WireGuard доступен для широкого спектра операционных систем и платформ. Ниже приведены инструкции по установке для наиболее популярных систем. Если ваша система не указана в списке, вы также можете легко скомпилировать WireGuard из исходного кода.

Краткая таблица установки

Операционная система	Команда установки
Windows 10/11/2016/2019/2022/2025	Скачать MSI-установщик
macOS (App Store)	Установить из App Store
Ubuntu	`sudo apt install wireguard`
Debian	`# apt install wireguard`
Fedora	`sudo dnf install wireguard-tools`
Arch Linux	`sudo pacman -S wireguard-tools`
Android	Google Play или APK-файл
iOS	Установить из App Store
OpenSUSE/SLE	`sudo zypper install wireguard-tools`
Alpine	`# apk add -U wireguard-tools`
Gentoo	`# emerge wireguard-tools`
FreeBSD	`# pkg install wireguard`
OpenBSD	`# pkg_add wireguard-tools`

Подробные инструкции

Установка на сервере Ubuntu

WireGuard включён в репозитории Ubuntu, начиная с версии 20.04 (Focal Fossa). Для более ранних версий рекомендуется использовать PPA.

Ubuntu 20.04 и новее:

sudo apt update
sudo apt install wireguard

Ubuntu 18.04 (Bionic Beaver) и более ранние:

sudo add-apt-repository ppa:wireguard/wireguard
sudo apt update
sudo apt install wireguard

После установки модуль ядра и утилиты будут готовы к использованию. Модуль WireGuard автоматически загружается при создании интерфейса.

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

wg --version
modinfo wireguard

Установка на сервере Fedora

В Fedora WireGuard доступен в официальных репозиториях. Для установки требуются утилиты пользовательского пространства, так как модуль ядра встроен в ядро Linux начиная с версии 5.6.

Fedora 32 и новее (с ядром 5.6+):

sudo dnf install wireguard-tools

Fedora 31 и более ранние версии:

Для старых версий Fedora, где модуль ядра не встроен, необходимо установить модуль отдельно:

sudo dnf install wireguard-tools
sudo dnf copr enable jdoss/wireguard
sudo dnf install wireguard-dkms

Настройка автоматической загрузки модуля (для ядер < 5.6):

sudo modprobe wireguard
echo "wireguard" | sudo tee /etc/modules-load.d/wireguard.conf

Для Fedora 32 и новее модуль WireGuard встроен в ядро Linux, поэтому дополнительная установка модуля не требуется.

Установка на рабочей станции Fedora

На рабочей станции Fedora процесс установки аналогичен серверной версии. Однако для рабочей станции может потребоваться графический интерфейс для управления VPN-подключениями.

Установка базовых инструментов:

sudo dnf install wireguard-tools

Установка GUI-менеджера (опционально):

Для управления WireGuard через графический интерфейс можно установить NetworkManager:

sudo dnf install networkmanager-wireguard
sudo systemctl restart NetworkManager

После этого вы сможете настраивать WireGuard через стандартные сетевые настройки GNOME или KDE.

Настройка автозапуска (опционально):

Чтобы WireGuard автоматически поднимался при загрузке системы:

sudo systemctl enable wg-quick@wg0
sudo systemctl start wg-quick@wg0

Перед настройкой автозапуска убедитесь, что конфигурационный файл /etc/wireguard/wg0.conf существует и правильно настроен.

Установка на Android

WireGuard для Android доступен двумя способами:

Способ 1: Установка из Google Play Store

Откройте Google Play Store на вашем устройстве
Найдите “WireGuard”
Нажмите “Установить”
Дождитесь завершения установки

Прямая ссылка на Google Play

Способ 2: Установка из APK-файла

Если у вас нет доступа к Google Play, вы можете установить WireGuard напрямую из APK-файла:

Загрузите последнюю версию APK с официального сайта WireGuard или из репозитория релизов
На устройстве перейдите в Настройки → Безопасность и включите “Неизвестные источники”
Откройте загруженный APK-файл
Нажмите “Установить”
После установки запустите приложение

Импорт конфигурации на Android:

После установки приложения:

Откройте приложение WireGuard
Нажмите на кнопку “+” (плюс) в правом нижнем углу
Выберите “Импортировать из файла” или “Импортировать из архива”
Выберите конфигурационный файл (обычно имеет расширение .conf)
Нажмите “Сохранить”
Для активации VPN нажмите на переключатель рядом с именем конфигурации

Дополнительные дистрибутивы

Debian

Debian Bullseye (11) и новее:

# apt update
# apt install wireguard

Debian Buster (10) и более ранние:

Для старых версий Debian необходимо включить backports:

# echo "deb http://deb.debian.org/debian buster-backports main" >> /etc/apt/sources.list
# apt update
# apt -t buster-backports install wireguard

Arch Linux

Установка с модулем ядра (ядро 5.6+):

sudo pacman -S wireguard-tools

Для ядер < 5.6:

sudo pacman -S wireguard-lts  # для LTS-ядра
# или
sudo pacman -S wireguard-dkms linux-headers  # для DKMS с заголовками ядра

macOS

Установка из App Store:

Откройте App Store
Найдите “WireGuard”
Нажмите “Получить” или кнопку установки
Введите пароль Apple ID или используйте Touch ID

Прямая ссылка в App Store

Установка через Homebrew (только CLI-инструменты):

brew install wireguard-tools

Установка через MacPorts:

port install wireguard-tools

Для полной интеграции WireGuard в macOS рекомендуется использовать версию из App Store, которая включает графический интерфейс.

iOS

WireGuard доступен в App Store для iPhone и iPad:

Откройте App Store
Найдите “WireGuard”
Нажмите “Получить”
Подтвердите установку с помощью Face ID, Touch ID или пароля Apple ID

Прямая ссылка в App Store

После установки импортируйте конфигурацию через файлы или QR-код.

FreeBSD

# pkg install wireguard

OpenBSD

# pkg_add wireguard-tools

Alpine Linux

# apk add -U wireguard-tools

Gentoo

# emerge wireguard-tools

Для совместимости со старыми ядрами также доступен ebuild wireguard-modules:

# emerge wireguard-modules

OpenSUSE и SLE

sudo zypper install wireguard-tools

Slackware

sudo slackpkg install wireguard-tools

Mageia

sudo urpmi wireguard-tools

Termux (Android CLI)

pkg install wireguard-tools

NixOS

В конфигурации NixOS добавьте:

boot.extraModulePackages = [ config.boot.kernelPackages.wireguard ];
environment.systemPackages = [ pkgs.wireguard pkgs.wireguard-tools ];

Nix на Darwin (macOS CLI)

nix-env -iA nixpkgs.wireguard-tools

OpenWRT

opkg install wireguard

Дополнительные инструкции по установке и настройке можно найти в вики OpenWRT.

Enterprise Linux (RHEL/CentOS/Oracle)

Oracle Linux 8 (UEK6)

# dnf install oraclelinux-developer-release-el8
# dnf config-manager --disable ol8_developer
# dnf config-manager --enable ol8_developer_UEKR6
# dnf config-manager --save --setopt=ol8_developer_UEKR6.includepkgs='wireguard-tools*'
# dnf install wireguard-tools

Red Hat Enterprise Linux 8

Метод 1 (предварительно собранный модуль из ELRepo):

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm https://www.elrepo.org/elrepo-release-8.el8.elrepo.noarch.rpm
sudo yum install kmod-wireguard wireguard-tools

Метод 2 (DKMS для нестандартных ядер):

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms
sudo yum copr enable jdoss/wireguard
sudo yum install wireguard-dkms wireguard-tools

CentOS 8

Метод 1 (встроенный модуль в kernel-plus):

sudo yum install yum-utils epel-release
sudo yum-config-manager --setopt=centosplus.includepkgs="kernel-plus, kernel-plus-*" --setopt=centosplus.enabled=1 --save
sudo sed -e 's/^DEFAULTKERNEL=kernel-core$/DEFAULTKERNEL=kernel-plus-core/' -i /etc/sysconfig/kernel
sudo yum install kernel-plus wireguard-tools
sudo reboot

Метод 2 (предварительно собранный модуль из ELRepo):

sudo yum install elrepo-release epel-release
sudo yum install kmod-wireguard wireguard-tools

Метод 3 (DKMS):

sudo yum install epel-release
sudo yum config-manager --set-enabled PowerTools
sudo yum copr enable jdoss/wireguard
sudo yum install wireguard-dkms wireguard-tools

Oracle Linux 7 (UEK6)

# yum install oraclelinux-developer-release-el7
# yum-config-manager --disable ol7_developer
# yum-config-manager --enable ol7_developer_UEKR6
# yum-config-manager --save --setopt=ol7_developer_UEKR6.includepkgs='wireguard-tools*'
# yum install wireguard-tools

Red Hat Enterprise Linux 7

Метод 1 (предварительно собранный модуль из ELRepo):

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm https://www.elrepo.org/elrepo-release-7.el7.elrepo.noarch.rpm
sudo yum install kmod-wireguard wireguard-tools

Метод 2 (DKMS):

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo curl -o /etc/yum.repos.d/jdoss-wireguard-epel-7.repo https://copr.fedorainfracloud.org/coprs/jdoss/wireguard/repo/epel-7/jdoss-wireguard-epel-7.repo
sudo yum install wireguard-dkms wireguard-tools

CentOS 7

Метод 1 (kernel-plus):

sudo yum install yum-utils epel-release
sudo yum-config-manager --setopt=centosplus.includepkgs=kernel-plus --enablerepo=centosplus --save
sudo sed -e 's/^DEFAULTKERNEL=kernel$/DEFAULTKERNEL=kernel-plus/' -i /etc/sysconfig/kernel
sudo yum install kernel-plus wireguard-tools
sudo reboot

Метод 2 (ELRepo):

sudo yum install epel-release elrepo-release
sudo yum install yum-plugin-elrepo
sudo yum install kmod-wireguard wireguard-tools

Метод 3 (DKMS):

sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo curl -o /etc/yum.repos.d/jdoss-wireguard-epel-7.repo https://copr.fedorainfracloud.org/coprs/jdoss/wireguard/repo/epel-7/jdoss-wireguard-epel-7.repo
sudo yum install wireguard-dkms wireguard-tools

Другие дистрибутивы

Void Linux

xbps-install -S wireguard-tools wireguard-dkms

Adélie Linux

apk add wireguard-tools wireguard-module

Source Mage

cast wireguard-tools

Buildroot

В конфигурации Buildroot добавьте:

BR2_PACKAGE_WIREGUARD_LINUX_COMPAT=y
BR2_PACKAGE_WIREGUARD_TOOLS=y

EdgeOS

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

sudo dpkg -i wireguard-{type}-{version}.deb

AstLinux

В конфигурации AstLinux добавьте:

BR2_PACKAGE_WIREGUARD_TOOLS=y
BR2_PACKAGE_WIREGUARD=y

Milis Linux

# mps kur wireguard-tools wireguard-linux-compat

Дальнейшие шаги

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

Если вашего дистрибутива нет в списке выше, вы можете легко скомпилировать WireGuard из исходного кода — это довольно простая процедура.