RU

Приложения

Развертывание VPN WireGuard на своём сервере

Установка WireGuard на Debian или Ubuntu, добавление клиентов Windows, macOS, Linux и мобильных устройств, настройка маршрутизации и брандмауэра, а затем ограничение SSH только через VPN.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как превратить ваш сервер в шлюз WireGuard. Ваши устройства подключаются к нему через зашифрованный туннель. После этого они могут обращаться к частным службам сервера и, при желании, выходить в Интернет с его IP-адресом.

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

Заказать сервер

Это руководство подходит для серверов, которыми вы управляете самостоятельно:

Предварительные требования

  • Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
  • Доступ по SSH под пользователем с правами sudo
  • Публичный IPv4-адрес сервера, обозначаемый здесь как IP_ВАШЕГО_СЕРВЕРА
  • Клиентское устройство: Windows, macOS, Linux, Android или iOS

Схема адресации и порты

В руководстве используются следующие значения. Выберите другой диапазон, если 10.8.0.0/24 уже используется в одной из ваших сетей.

Элемент Значение
Интерфейс VPN wg0
Сеть VPN 10.8.0.0/24
Адрес сервера в VPN 10.8.0.1
Первый клиент 10.8.0.2
Порт для входящих соединений 51820/udp

В этом руководстве через туннель маршрутизируется IPv4. Конфигурация клиента также блокирует IPv6, чтобы трафик не обходил VPN.

Шаг 1: установите WireGuard

WireGuard встроен в ядро Linux соответствующих систем. Официальные пакеты дистрибутива содержат утилиты wg и wg-quick. Откройте оболочку root и установите их:

Терминал
sudo -i
apt update
apt install -y wireguard iptables qrencode

Если не указано иное, команды для сервера выполняются в этой оболочке root.

Шаг 2: включите маршрутизацию IPv4

Сервер должен уметь передавать пакеты клиентов в Интернет:

Терминал
cat > /etc/sysctl.d/99-wireguard.conf <<EOF
net.ipv4.ip_forward = 1
EOF
sysctl -p /etc/sysctl.d/99-wireguard.conf

Команда должна вывести net.ipv4.ip_forward = 1.

Шаг 3: сгенерируйте ключи сервера

Терминал
cd /etc/wireguard
umask 077
wg genkey | tee server.key | wg pubkey > server.pub
IFACE=$(ip -4 route show default | awk '{print $5; exit}')
echo "$IFACE"

Последняя команда выводит публичный сетевой интерфейс, например eth0 или ens18. Если она ничего не выводит, у сервера нет маршрута IPv4 по умолчанию: исправьте это, прежде чем продолжать. Не закрывайте эту оболочку, так как переменная IFACE понадобится на следующем шаге.

Шаг 4: создайте конфигурацию сервера

Терминал
cat > /etc/wireguard/wg0.conf <<EOF
[Interface]
Address = 10.8.0.1/24
ListenPort = 51820
PrivateKey = $(cat /etc/wireguard/server.key)

PostUp = iptables -t nat -A POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PostUp = iptables -I FORWARD -i %i -o $IFACE -j ACCEPT
PostUp = iptables -I FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
PreDown = iptables -t nat -D POSTROUTING -s 10.8.0.0/24 -o $IFACE -j MASQUERADE
PreDown = iptables -D FORWARD -i %i -o $IFACE -j ACCEPT
PreDown = iptables -D FORWARD -i $IFACE -o %i -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
EOF
chmod 600 /etc/wireguard/wg0.conf

Строки PostUp выполняются при запуске туннеля, а строки PreDown — при его остановке. Они скрывают адреса клиентов за адресом сервера и разрешают их трафику проходить через машину. %i заменяется именем интерфейса, здесь wg0. Эти правила помещаются в начало цепочки FORWARD, поэтому они действуют и тогда, когда UFW или Docker по умолчанию блокируют транзит.

Шаг 5: откройте брандмауэр

Если UFW активен, разрешите порт WireGuard:

Терминал
ufw allow 51820/udp
ufw status

Шаг 6: запустите VPN

Терминал
systemctl enable --now wg-quick@wg0
systemctl status wg-quick@wg0 --no-pager
wg show
ss -lun | grep 51820

wg show должна показать интерфейс wg0, его публичный ключ и порт 51820. Служба будет автоматически запускаться вместе с сервером.

Шаг 7: добавьте клиента

Выберите имя и свободный адрес в VPN. Для каждого нового клиента меняйте эти два значения:

Терминал
cd /etc/wireguard
umask 077
mkdir -p clients
CLIENT=laptop
CLIENT_IP=10.8.0.2
wg genkey | tee clients/$CLIENT.key | wg pubkey > clients/$CLIENT.pub
wg genpsk > clients/$CLIENT.psk

cat >> wg0.conf <<EOF

[Peer]
# $CLIENT
PublicKey = $(cat clients/$CLIENT.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
AllowedIPs = $CLIENT_IP/32
EOF

systemctl reload wg-quick@wg0

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

Затем создайте файл для устройства:

Терминал
cat > clients/$CLIENT.conf <<EOF
[Interface]
PrivateKey = $(cat clients/$CLIENT.key)
Address = $CLIENT_IP/32
DNS = 1.1.1.1, 9.9.9.9

[Peer]
PublicKey = $(cat server.pub)
PresharedKey = $(cat clients/$CLIENT.psk)
Endpoint = IP_ВАШЕГО_СЕРВЕРА:51820
AllowedIPs = 0.0.0.0/0, ::/0
PersistentKeepalive = 25
EOF

PersistentKeepalive = 25 поддерживает туннель открытым, когда устройство находится за домашним роутером или в сети с NAT.

Шаг 8: подключите устройство

Установите приложение со страницы WireGuard, затем импортируйте конфигурацию.

Android и iOS

Выведите QR-код в терминале и отсканируйте его в приложении через добавление туннеля:

Терминал
qrencode -t ansiutf8 < clients/$CLIENT.conf

Windows и macOS

Выведите файл:

Терминал
cat clients/$CLIENT.conf

Скопируйте его содержимое в файл laptop.conf на вашем компьютере, затем импортируйте его в приложение через Import tunnel(s) from file. После этого включите туннель.

Linux

Установите wireguard на компьютер и скопируйте конфигурацию в /etc/wireguard/wg0.conf:

Терминал
sudo apt install -y wireguard
sudo nano /etc/wireguard/wg0.conf
sudo chmod 600 /etc/wireguard/wg0.conf
sudo wg-quick up wg0

Чтобы остановить туннель, выполните sudo wg-quick down wg0.

Удалите секреты с сервера

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

Терминал
shred -u clients/$CLIENT.key clients/$CLIENT.psk clients/$CLIENT.conf

Проверка работы

На сервере для клиента должна появиться строка latest handshake, а счётчики transfer должны расти:

Терминал
wg show

На клиенте Linux или macOS проверьте туннель, а затем адрес выхода:

Терминал
ping -c 3 10.8.0.1
curl -4 https://ifconfig.me

ping должен получать ответы, а curl — выводить IP_ВАШЕГО_СЕРВЕРА. В Windows выполните ping 10.8.0.1, а затем посмотрите свой публичный IP-адрес в браузере.

Выбор трафика, идущего через туннель

Параметр AllowedIPs на стороне клиента определяет, какой трафик отправляется в VPN:

Задача AllowedIPs на стороне клиента
Весь трафик идёт через сервер 0.0.0.0/0, ::/0
Только сеть VPN 10.8.0.0/24
VPN и частная сеть сервера 10.8.0.0/24, 192.168.50.0/24

При ::/0 трафик IPv6 попадает в туннель, но не выходит из него, поскольку в этом руководстве маршрутизируется только IPv4. Приложения тогда переключаются на IPv4, и утечки за пределы VPN не происходит.

Чтобы получить доступ к частной сети, подключённой к серверу, добавьте также строки PostUp и PreDown для этого интерфейса по образцу шага 4, а затем перезапустите туннель.

На стороне сервера AllowedIPs указывает адреса, которые разрешено использовать каждому клиенту. Оставляйте по одному адресу /32 на клиента. Чтобы получить доступ к сети, расположенной за клиентом, добавьте её в эту строку, например AllowedIPs = 10.8.0.3/32, 192.168.1.0/24. Сам этот клиент должен разрешать маршрутизацию в свою сеть.

Обмен данными между клиентами

В зависимости от политики цепочки FORWARD клиенты могут либо видеть друг друга, либо нет. Чтобы зафиксировать это поведение, добавьте одну из этих пар строк в раздел [Interface] файла /etc/wireguard/wg0.conf.

Чтобы разрешить обмен:

Конфигурация
PostUp = iptables -I FORWARD -i %i -o %i -j ACCEPT
PreDown = iptables -D FORWARD -i %i -o %i -j ACCEPT

Чтобы запретить его:

Конфигурация
PostUp = iptables -I FORWARD -i %i -o %i -j DROP
PreDown = iptables -D FORWARD -i %i -o %i -j DROP

Изменения в разделе [Interface] требуют перезапуска, который ненадолго прерывает работу VPN:

Терминал
systemctl restart wg-quick@wg0

Ограничение SSH только через VPN

Убедившись, что VPN работает, вы можете закрыть SSH на публичном адресе. Этот раздел предполагает, что UFW активен и по умолчанию отклоняет входящие соединения; это можно подтвердить командой ufw status verbose. Если вы используете другой порт, замените 22.

Разрешите SSH из VPN:

Терминал
ufw allow in on wg0 to any port 22 proto tcp

С клиента, подключённого к VPN, откройте новую сессию:

Терминал
ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@10.8.0.1

Если подключение работает, удалите публичное правило и проверьте результат:

Терминал
ufw status numbered
ufw delete allow 22/tcp
ufw status verbose

Если ваше правило называется иначе, например OpenSSH, выполните ufw delete allow OpenSSH. Его также можно удалить по номеру: ufw delete НОМЕР.

Отзыв клиента

Удалите блок [Peer] этого устройства в /etc/wireguard/wg0.conf, затем перезагрузите конфигурацию:

Терминал
nano /etc/wireguard/wg0.conf
systemctl reload wg-quick@wg0
wg show

Клиент больше не должен отображаться. Удалите также /etc/wireguard/clients/laptop.pub. Если закрытый ключ сервера был раскрыт, сгенерируйте новый и заново передайте конфигурацию всем клиентам.

Обновление

Утилиты обновляются через APT, а модуль WireGuard — вместе с ядром:

Терминал
apt update
apt upgrade -y
wg --version

Перезагрузите сервер после обновления ядра. VPN запустится автоматически, но предусмотрите другой способ доступа, если SSH доступен только через него.

Резервное копирование и восстановление

Каталог /etc/wireguard содержит ключи и список клиентов:

Терминал
tar -czf /root/wireguard-$(date +%F).tar.gz -C /etc wireguard sysctl.d/99-wireguard.conf
chmod 600 /root/wireguard-$(date +%F).tar.gz

Этот архив содержит закрытые ключи: храните его в зашифрованном виде за пределами сервера.

Чтобы восстановить архив на сервере, где установлены пакеты, подставьте вместо ГГГГ-ММ-ДД его дату:

Терминал
tar -xzf /root/wireguard-ГГГГ-ММ-ДД.tar.gz -C /etc
sysctl -p /etc/sysctl.d/99-wireguard.conf
systemctl enable --now wg-quick@wg0

Если имя публичного интерфейса изменилось, исправьте его в строках PostUp и PreDown до запуска.

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

В wg show нет latest handshake

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

Терминал
apt install -y tcpdump
tcpdump -ni any udp port 51820
  • Пакеты не приходят: проверьте Endpoint, правило UFW и сеть клиента. Если всё в порядке, обратитесь в поддержку из личного кабинета, чтобы выяснить, не применяется ли фильтрация выше по маршруту.
  • Пакеты приходят, но ответа нет: ключи не совпадают. Сравните PublicKey на стороне клиента с server.pub, а ключ в блоке [Peer] — с ключом клиента.

Туннель поднят, но Интернет не работает

По порядку проверьте маршрутизацию, NAT и транзит:

Терминал
sysctl net.ipv4.ip_forward
ip -4 route show default
iptables -t nat -S POSTROUTING
iptables -S FORWARD

Интерфейс в правилах должен совпадать с интерфейсом маршрута по умолчанию. Если он отличается, исправьте wg0.conf и выполните systemctl restart wg-quick@wg0.

VPN работает, но доменные имена не разрешаются

Выполните ping 1.1.1.1 с клиента. Если проверка проходит, проблема в DNS: проверьте строку DNS у клиента или укажите другой резолвер.

resolvconf: command not found на клиенте Linux

wg-quick нужна эта утилита, чтобы применить строку DNS. Установите openresolv или удалите эту строку, если вы маршрутизируете только сеть VPN.

iptables: command not found

Пакет отсутствует, чаще всего при минимальной установке Debian. Установите его и перезапустите службу:

Терминал
apt install -y iptables
systemctl restart wg-quick@wg0

Ядро не может создать интерфейс. Так бывает, когда система работает в контейнере, а хост не поддерживает WireGuard. Проверьте модуль командой modprobe wireguard.

modprobe: FATAL: Module wireguard not found

Часто ядро было обновлено без перезагрузки. Сравните uname -r с содержимым /lib/modules и перезагрузите сервер.

Key is not the correct length or format

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

Интерфейс wg0 уже существует

Сообщение содержит already exists: интерфейс был запущен вне systemd. Остановите его и перезапустите службу:

Терминал
wg-quick down wg0
systemctl restart wg-quick@wg0

Некоторые сайты не открываются или передача данных зависает

Вероятно, размер пакетов слишком велик для сети, через которую они проходят. Добавьте MTU = 1380 в раздел [Interface] клиента и заново включите туннель. Если проблема не исчезнет, попробуйте 1280.

На клиенте Linux отключён IPv6. Удалите ::/0 из AllowedIPs.

Ссылки