Развертывание VPN WireGuard на своём сервере
Установка WireGuard на Debian или Ubuntu, добавление клиентов Windows, macOS, Linux и мобильных устройств, настройка маршрутизации и брандмауэра, а затем ограничение SSH только через VPN.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как превратить ваш сервер в шлюз 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 51820wg 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
EOFPersistentKeepalive = 25 поддерживает туннель открытым, когда устройство находится за домашним роутером или в сети с NAT.
Шаг 8: подключите устройство
Установите приложение со страницы WireGuard, затем импортируйте конфигурацию.
Android и iOS
Выведите QR-код в терминале и отсканируйте его в приложении через добавление туннеля:
qrencode -t ansiutf8 < clients/$CLIENT.confWindows и 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.meping должен получать ответы, а 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@wg0RTNETLINK answers: Operation not supported
Ядро не может создать интерфейс. Так бывает, когда система работает в контейнере, а хост не поддерживает 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.
RTNETLINK answers: Permission denied при ::/0
На клиенте Linux отключён IPv6. Удалите ::/0 из AllowedIPs.