Автофайлы: в помощь автовладельцу » Программы » Настройка сети » WireGuard на Mac: установка и импорт файла CONF

WireGuard на Mac: установка и импорт файла CONF

Автор: Алексей Воронов

Для WireGuard на Mac установите официальный клиент из App Store, импортируйте персональный файл .conf и включите созданный туннель. Текущая карточка приложения требует macOS 12 или новее. После включения проверьте обмен с сервером и нужный маршрут: активный переключатель ещё не означает, что сервер ответил.

Практический помощник

Как AllowedIPs меняет маршрут

Показаны примеры назначения профиля, а не готовые параметры вашего сервера.

Рабочая сеть через WireGuard

Если AllowedIPs содержит лишь рабочую подсеть, интернет может идти обычным путём. Проверяйте внутренний ресурс, а не обязательную смену внешнего IP.

Частная сетьТуннель, если сеть указана
Публичный IPv4Обычный маршрут
Публичный IPv6Обычный маршрут

Поясняющая схема; реальный маршрут проверьте на нужном устройстве.

Официальный клиент и готовая конфигурация

На странице установки WireGuard для macOS указан App Store. Поиск случайного DMG для обычной установки не нужен. В карточке проверьте разработчика WireGuard и совместимость вашей системы. Для macOS 10.13 эта инструкция не подтверждает наличие подходящего поддерживаемого выпуска.

До запуска получите у владельца сервера файл .conf для вашего Mac. Клиент можно установить бесплатно, но он не создаёт сервер и не выдаёт подключение к чьей-либо сети. В профиле обычно уже заполнены ключи, адреса и маршруты. Генерировать новые ключи вместо выданных без согласования с сервером не нужно.

Домашний компьютер, монитор и клавиатура
Подключение системного клиента относится к компьютеру, а не к отдельному монитору. Фотоиллюстрация, не снимок конкретного устройства.

Импортируйте CONF и разрешите VPN

  1. Установите WireGuard из официальной карточки и откройте приложение.
  2. Выберите добавление туннеля из файла и укажите выданный .conf. Если предоставлен архив поддерживаемых конфигураций, приложение также умеет импортировать архивы.
  3. Посмотрите имя добавленного туннеля и параметры, не публикуя PrivateKey. Если профиль предназначен для другого устройства, получите отдельный.
  4. Включите туннель и подтвердите запрос macOS на добавление VPN-конфигурации.
  5. Откройте нужный ресурс, затем посмотрите, появился ли обмен с сервером. Проверьте доступ и после отключения.

Не используйте один и тот же приватный ключ одновременно на Mac и телефоне. Сервер связывает peer с ключом; когда два устройства выступают одной стороной, адрес доставки может переключаться между ними. Для второго устройства нужен отдельный профиль, созданный на сервере.

Какие поля влияют на подключение

Чтение профиля WireGuard
ПолеСмыслЧего не делать
Interface / PrivateKeyЗакрытый ключ этого устройстваНе отправлять его в публичный чат
Interface / AddressАдрес Mac внутри туннеляНе подставлять внешний IP домашнего Wi-Fi
Interface / DNSDNS-резолвер для конфигурации туннеляНе менять произвольно при доступе к внутренним именам
Peer / PublicKeyОткрытый ключ удалённой стороныНе путать с приватным ключом Mac
Peer / EndpointАдрес и UDP-порт сервераНе выбирать случайный порт ради попытки подключения
Peer / AllowedIPsСети, направляемые к этому peerНе считать их списком разрешённых сайтов

Для полного маршрута IPv4 используется 0.0.0.0/0, для IPv6 — ::/0. Профиль с конкретной подсетью, например 10.20.0.0/16, может открывать только частную сеть. Это пример синтаксиса, не значения для вставки в ваш файл. Сервер должен быть настроен на соответствующий трафик: одни строки AllowedIPs не создают интернет-выход.

Handshake, передача данных и проверка маршрута

Handshake — обмен, при котором стороны подтверждают возможность зашифрованной связи. После обращения к ресурсу посмотрите время последнего handshake и счётчики передачи, если они отображаются в вашей версии клиента. Рост входящих и исходящих данных полезнее одного статуса «активен». Отсутствие обмена в полном простое не обязательно является неисправностью.

Для интернет-туннеля сравните внешний IP до и после включения. Для рабочей подсети откройте её внутренний ресурс. При частном маршруте прежний внешний IP ожидаем: остальной интернет может идти напрямую. Проверьте отдельно IPv4 и IPv6, если ваш сценарий требует полного охвата обеих сетей.

Как различить ошибки
НаблюдениеЧто проверять
Нет handshake после запросаПравильность Endpoint, доступность UDP в сети, соответствие ключей на сервере
Handshake есть, ресурс не открываетсяAllowedIPs, серверную маршрутизацию и права доступа к целевой сети
IP-адрес ресурса работает, имя нетDNS из профиля и доступность нужного резолвера
После перехода на другую сеть связь пропалаПереподключить тот же туннель и повторить запрос
Пропало только входящее соединение после простояУсловия NAT;PersistentKeepalive нужен не каждому профилю

Не исправляйте все поля одновременно

Если соединение пропадает после простоя за NAT, в WireGuard существует PersistentKeepalive. В официальном руководстве 25 секунд приведены как полезный интервал для многих таких сетей, но включать его каждому пользователю не требуется. Он поддерживает состояние NAT и не исправляет неверный ключ, закрытый UDP-порт или отсутствующий маршрут.

Сначала сохраните исходный профиль и зафиксируйте симптом. Сравните тот же туннель в другой сети. Меняйте параметр только когда понимаете, какую гипотезу проверяете. Если изменён PublicKey или Address, понадобится согласованная настройка сервера; это не оформление профиля.

Подключение телефона и второго компьютера

Для телефона используйте инструкцию WireGuard на iPhone и отдельный профиль. На Windows импорт похож по смыслу, но отличается интерфейс: смотрите настройку WireGuard для Windows.

Готовый WireGuard на Mac — это не просто установленное приложение. Нужны персональная конфигурация, ответ удалённого peer и маршрут к вашей цели. Полный интернет-туннель и доступ к одной частной подсети оценивайте разными проверками.