Ansible Role: Cloudflare WARP Native

Ansible роль для установки и настройки Cloudflare WARP через wgcf и WireGuard. Настраивает сетевой интерфейс и проверяет handshake подключение. Поддерживает два состояния: present и absent.

🇬🇧 English version

Требования

• Ansible >= 2.14
• Целевые системы: Debian 11/12, Ubuntu 20.04/22.04/24.04

Переменные роли

Основные переменные

Переменная	По умолчанию	Описание
warp_native_state	present	Состояние установки WARP (present/absent)
warp_native_modify_resolv	false	Изменять ли /etc/resolv.conf
warp_native_temp_nameservers	["1.1.1.1", "8.8.8.8"]	Временные DNS серверы во время настройки

Настройки wgcf

Переменная	По умолчанию	Описание
warp_native_wgcf_version	latest	Версия wgcf для установки
warp_native_wgcf_install_path	/usr/local/bin/wgcf	Путь установки бинарного файла wgcf

Настройки WireGuard

Переменная	По умолчанию	Описание
warp_native_conf_dir	/etc/wireguard	Директория конфигурации WireGuard
warp_native_conf_name	warp.conf	Имя файла конфигурации WireGuard (также определяет имя интерфейса)
warp_native_enable	true	Включить службу WireGuard при загрузке
warp_native_keepalive	25	Интервал keepalive для WireGuard
warp_native_table_off	true	Отключить таблицу маршрутизации WireGuard

Примечание: Переменная warp_native_conf_name определяет как имя файла конфигурации, так и имя WireGuard интерфейса. Например, warp.conf создает интерфейс warp, а custom-vpn.conf создает интерфейс custom-vpn.

Настройки проверки

Переменная	По умолчанию	Описание
warp_native_check_retries	10	Количество попыток проверки соединения
warp_native_check_delay	1	Задержка между попытками (секунды)

Настройки очистки

Переменная	По умолчанию	Описание
warp_native_purge_all	false	Удалить все файлы WARP при деинсталляции
warp_native_remove_wireguard_pkg	false	Удалить пакет WireGuard при деинсталляции
warp_native_cleanup_dns_backup	false	Очистить файлы резервных копий DNS

Установка

ansible-galaxy install themelbine.warp_native

Пример использования

Базовый playbook

- hosts: warp_servers
  become: yes
  roles:
    - themelbine.warp_native

Групповые переменные

Создайте групповые переменные в group_vars/warp_servers.yml:

# Установить WARP
warp_native_state: present

# Опционально: Изменить настройки DNS
warp_native_modify_resolv: true
warp_native_temp_nameservers:
  - "1.1.1.1"
  - "8.8.8.8"

# Опционально: Пользовательские настройки WireGuard
warp_native_keepalive: 30
warp_native_conf_name: "company-warp.conf"  # Создаст интерфейс 'company-warp'

Для удаления установите warp_native_state: absent в групповых переменных.

Лицензия

MIT

Информация об авторе

Эта роль была создана Melbine.