mirror of
https://github.com/itdoginfo/ansible-openwrt-hirkn.git
synced 2025-12-10 17:14:29 +05:00
Added role
This commit is contained in:
itdoginfo
160
README-old.md
Normal file
160
README-old.md
Normal file
@@ -0,0 +1,160 @@
|
||||
# Описание
|
||||
Shell скрипт и playbook для Ansible. Автоматизируют настройку роутера на OpenWrt для роутинга по доменам и спискам IP-адресов.
|
||||
|
||||
Полное описание происходящего: [Статья на хабре](https://habr.com/ru/articles/767464/)
|
||||
|
||||
[Копия в моём блоге](https://itdog.info/tochechnyj-obhod-blokirovok-po-domenam-na-routere-s-openwrt/)
|
||||
|
||||
## Скрипт для установки
|
||||
Запуск без скачивания
|
||||
```
|
||||
sh <(wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-install.sh)
|
||||
```
|
||||
|
||||
Подробности описаны в статье указаной выше.
|
||||
|
||||
## Ansible
|
||||
Для взаимодействия c OpenWRT используется модуль [gekmihesg/ansible-openwrt](https://github.com/gekmihesg/ansible-openwrt)
|
||||
|
||||
Домены берутся из [отсюда](https://github.com/itdoginfo/allow-domains). Списки IP-адресов берутся с [antifilter.download](https://antifilter.download/)
|
||||
|
||||
Тестировалось с
|
||||
- Ansible 2.10.8
|
||||
|
||||
- OpenWrt 21.02.7
|
||||
- OpenWrt 22.03.5
|
||||
- OpenWrt 23.05.2
|
||||
|
||||
### Выбор туннеля
|
||||
- Wireguard настраивается автоматически через переменные
|
||||
- OpenVPN устанавливается пакет, настраивается роутинг и зона. Само подключение (скопировать конфиг и перезапустить openvpn) нужно [настроить вручную](https://itdog.info/nastrojka-klienta-openvpn-na-openwrt/)
|
||||
- Sing-box устанавливает пакет, настраивается роутинг и зона. Также кладётся темплейт в `/etc/sing-box/config.json`. Нужно настроить `config.json` и сделать `service sing-box restart`
|
||||
Не работает под 21ой версией. Поэтому при его выборе playbook выдаст ошибку.
|
||||
Для 22ой версии нужно установить пакет вручную.
|
||||
- tun2socks настраивается только роутинг и зона. Всё остальное нужно настроить вручную
|
||||
|
||||
Для **tunnel** четыре возможных значения:
|
||||
- wg
|
||||
- openvpn
|
||||
- singbox
|
||||
- tun2socks
|
||||
|
||||
В случае использования WG обязательно нужно задать:
|
||||
|
||||
**wg_server_address** - ip/url wireguard сервера
|
||||
|
||||
**wg_private_key**, **wg_public_key** - ключи для "клиента"
|
||||
|
||||
**wg_client_address** - адрес роутера в wg сети
|
||||
|
||||
Если ваш wg сервер использует preshared_key, то раскомментируйте **wg_preshared_key** и задайте ключ
|
||||
|
||||
Остальное можно менять, в зависимости от того, как настроен wireguard сервер
|
||||
|
||||
**wg_access** и **wg_access_network** для доступа к роутеру через WG. Переменная wg_access_network должна иметь значение подсети, например 192.168.10.0/24.
|
||||
|
||||
### Шифрование DNS
|
||||
Если ваш провайдер не подменяет DNS-запросы, ничего устанавливать не нужно.
|
||||
|
||||
Для **dns_encrypt** три возможных значения:
|
||||
- dnscrypt
|
||||
- stubby
|
||||
- false/закомментировано - пропуск, ничего не устанавливается и не настраивается
|
||||
|
||||
### Выбор страны
|
||||
Для **county** три [возможных значения](https://github.com/itdoginfo/allow-domains):
|
||||
- russia-inside
|
||||
- russia-outside
|
||||
- ukraine
|
||||
|
||||
###
|
||||
|
||||
### Списки IP-адресов и домены
|
||||
Переменные **list_** обозначают, какие списки нужно установить. true - установить, false - не устанавливать и удалить, если уже есть
|
||||
|
||||
Я советую использовать только домены
|
||||
```
|
||||
list_domains: true
|
||||
```
|
||||
Если вам требуются списки IP-адресов, они также поддерживаются.
|
||||
|
||||
При использовании **list_domains** нужен пакет dnsmasq-full.
|
||||
|
||||
Для 23.05 dnsmasq-full устанавливается автоматически.
|
||||
|
||||
Для OpenWrt 22.03 версия dnsmasq-full должна быть => 2.87, её нет в официальном репозитории, но можно установить из dev репозитория. Если это условие не выполнено, плейбук завершится с ошибкой.
|
||||
|
||||
[Инструкция для OpenWrt 22.03](https://t.me/itdoginf/12)
|
||||
|
||||
[Инструкция для OpenWrt 21.02](https://t.me/itdoginfo/8)
|
||||
|
||||
### Использование
|
||||
|
||||
Установить модуль gekmihesg/ansible-openwrt
|
||||
|
||||
```
|
||||
ansible-galaxy install gekmihesg.openwrt
|
||||
```
|
||||
|
||||
Скачать playbook и темплейты в /etc/ansible
|
||||
|
||||
```
|
||||
cd /etc/ansible
|
||||
git clone https://github.com/itdoginfo/domain-routing-openwrt
|
||||
mv domain-routing-openwrt/* .
|
||||
rm -rf domain-routing-openwrt README.md
|
||||
```
|
||||
|
||||
Добавить роутер в файл hosts в группу openwrt
|
||||
```
|
||||
[openwrt]
|
||||
192.168.1.1
|
||||
```
|
||||
|
||||
Подставить переменные в **hivpn.yml**
|
||||
|
||||
Для работы Ansible c OpenWrt необходимо, чтоб было выполнено одно из условий:
|
||||
- Отсутствие пароля для root (не рекомендуется)
|
||||
- Настроен доступ через публичный SSH-ключ в [конфиге dropbear](https://openwrt.org/docs/guide-user/security/dropbear.public-key.auth)
|
||||
|
||||
Запуск playbook
|
||||
```
|
||||
ansible-playbook playbooks/hivpn.yml --limit 192.168.1.1
|
||||
```
|
||||
|
||||
После выполнения playbook роутер сразу начнёт роутить необходмые домены в туннель/прокси.
|
||||
|
||||
Если у вас были ошибки и они исправились при повторном запуске playbook, но при этом роутинг не заработал, сделайте рестарт сети и скрипта:
|
||||
```
|
||||
service network restart
|
||||
service getdomains start
|
||||
```
|
||||
|
||||
# Скрипт для проверки конфигурации
|
||||
|
||||
Написан для OpenWrt 23.05 и 22.03. На 21.02 работает только половина проверок.
|
||||
|
||||
[x] - не обязательно означает, что эта часть не работает. Но это повод для ручной проверки.
|
||||
|
||||
Есть функционал сохранения вывода скрипта, конфигурации сети и firewall в файл. Все чувствительные переменные при этом затираются.
|
||||
|
||||
### Запуск
|
||||
```
|
||||
wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-check.sh | sh
|
||||
```
|
||||
|
||||
### Запустить с проверкой на подмену DNS
|
||||
```
|
||||
wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-check.sh | sh -s dns
|
||||
```
|
||||
|
||||
### Запустить с созданием dump
|
||||
```
|
||||
wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-check.sh | sh -s dump
|
||||
```
|
||||
|
||||
Поиск ошибок вручную: https://habr.com/ru/post/702388/
|
||||
|
||||
---
|
||||
|
||||
[Telegram-канал с обновлениями](https://t.me/+lW1HmBO_Fa00M2Iy)
|
||||
200
README.md
200
README.md
@@ -1,160 +1,104 @@
|
||||
# Описание
|
||||
Shell скрипт и playbook для Ansible. Автоматизируют настройку роутера на OpenWrt для роутинга по доменам и спискам IP-адресов.
|
||||
Domain routing OpenWrt
|
||||
=========
|
||||
|
||||
Полное описание происходящего: [Статья на хабре](https://habr.com/ru/articles/767464/)
|
||||
Configuring domain routing on Openwrt router.
|
||||
|
||||
[Копия в моём блоге](https://itdog.info/tochechnyj-obhod-blokirovok-po-domenam-na-routere-s-openwrt/)
|
||||
|
||||
## Скрипт для установки
|
||||
Запуск без скачивания
|
||||
Role Variables
|
||||
--------------
|
||||
|
||||
Lists
|
||||
```
|
||||
sh <(wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-install.sh)
|
||||
country: russia-inside|russia-outside|ukraine
|
||||
list_domains: true|falase
|
||||
|
||||
list_subnet: false|true
|
||||
list_ip: false|true
|
||||
list_community: false|true
|
||||
```
|
||||
|
||||
Подробности описаны в статье указаной выше.
|
||||
|
||||
## Ansible
|
||||
Для взаимодействия c OpenWRT используется модуль [gekmihesg/ansible-openwrt](https://github.com/gekmihesg/ansible-openwrt)
|
||||
|
||||
Домены берутся из [отсюда](https://github.com/itdoginfo/allow-domains). Списки IP-адресов берутся с [antifilter.download](https://antifilter.download/)
|
||||
|
||||
Тестировалось с
|
||||
- Ansible 2.10.8
|
||||
|
||||
- OpenWrt 21.02.7
|
||||
- OpenWrt 22.03.5
|
||||
- OpenWrt 23.05.2
|
||||
|
||||
### Выбор туннеля
|
||||
- Wireguard настраивается автоматически через переменные
|
||||
- OpenVPN устанавливается пакет, настраивается роутинг и зона. Само подключение (скопировать конфиг и перезапустить openvpn) нужно [настроить вручную](https://itdog.info/nastrojka-klienta-openvpn-na-openwrt/)
|
||||
- Sing-box устанавливает пакет, настраивается роутинг и зона. Также кладётся темплейт в `/etc/sing-box/config.json`. Нужно настроить `config.json` и сделать `service sing-box restart`
|
||||
Не работает под 21ой версией. Поэтому при его выборе playbook выдаст ошибку.
|
||||
Для 22ой версии нужно установить пакет вручную.
|
||||
- tun2socks настраивается только роутинг и зона. Всё остальное нужно настроить вручную
|
||||
|
||||
Для **tunnel** четыре возможных значения:
|
||||
- wg
|
||||
- openvpn
|
||||
- singbox
|
||||
- tun2socks
|
||||
|
||||
В случае использования WG обязательно нужно задать:
|
||||
|
||||
**wg_server_address** - ip/url wireguard сервера
|
||||
|
||||
**wg_private_key**, **wg_public_key** - ключи для "клиента"
|
||||
|
||||
**wg_client_address** - адрес роутера в wg сети
|
||||
|
||||
Если ваш wg сервер использует preshared_key, то раскомментируйте **wg_preshared_key** и задайте ключ
|
||||
|
||||
Остальное можно менять, в зависимости от того, как настроен wireguard сервер
|
||||
|
||||
**wg_access** и **wg_access_network** для доступа к роутеру через WG. Переменная wg_access_network должна иметь значение подсети, например 192.168.10.0/24.
|
||||
|
||||
### Шифрование DNS
|
||||
Если ваш провайдер не подменяет DNS-запросы, ничего устанавливать не нужно.
|
||||
|
||||
Для **dns_encrypt** три возможных значения:
|
||||
- dnscrypt
|
||||
- stubby
|
||||
- false/закомментировано - пропуск, ничего не устанавливается и не настраивается
|
||||
|
||||
### Выбор страны
|
||||
Для **county** три [возможных значения](https://github.com/itdoginfo/allow-domains):
|
||||
- russia-inside
|
||||
- russia-outside
|
||||
- ukraine
|
||||
|
||||
###
|
||||
|
||||
### Списки IP-адресов и домены
|
||||
Переменные **list_** обозначают, какие списки нужно установить. true - установить, false - не устанавливать и удалить, если уже есть
|
||||
|
||||
Я советую использовать только домены
|
||||
Tunnel
|
||||
```
|
||||
list_domains: true
|
||||
```
|
||||
Если вам требуются списки IP-адресов, они также поддерживаются.
|
||||
|
||||
При использовании **list_domains** нужен пакет dnsmasq-full.
|
||||
|
||||
Для 23.05 dnsmasq-full устанавливается автоматически.
|
||||
|
||||
Для OpenWrt 22.03 версия dnsmasq-full должна быть => 2.87, её нет в официальном репозитории, но можно установить из dev репозитория. Если это условие не выполнено, плейбук завершится с ошибкой.
|
||||
|
||||
[Инструкция для OpenWrt 22.03](https://t.me/itdoginf/12)
|
||||
|
||||
[Инструкция для OpenWrt 21.02](https://t.me/itdoginfo/8)
|
||||
|
||||
### Использование
|
||||
|
||||
Установить модуль gekmihesg/ansible-openwrt
|
||||
|
||||
```
|
||||
ansible-galaxy install gekmihesg.openwrt
|
||||
tunnel: wg|openvpn|singbox|tun2socks
|
||||
```
|
||||
|
||||
Скачать playbook и темплейты в /etc/ansible
|
||||
|
||||
DoH or DoT
|
||||
```
|
||||
cd /etc/ansible
|
||||
git clone https://github.com/itdoginfo/domain-routing-openwrt
|
||||
mv domain-routing-openwrt/* .
|
||||
rm -rf domain-routing-openwrt README.md
|
||||
dns_encrypt: false|dnscrypt|stubby
|
||||
```
|
||||
|
||||
Добавить роутер в файл hosts в группу openwrt
|
||||
Nano package
|
||||
```
|
||||
[openwrt]
|
||||
192.168.1.1
|
||||
nano: true|false
|
||||
```
|
||||
|
||||
Подставить переменные в **hivpn.yml**
|
||||
|
||||
Для работы Ansible c OpenWrt необходимо, чтоб было выполнено одно из условий:
|
||||
- Отсутствие пароля для root (не рекомендуется)
|
||||
- Настроен доступ через публичный SSH-ключ в [конфиге dropbear](https://openwrt.org/docs/guide-user/security/dropbear.public-key.auth)
|
||||
|
||||
Запуск playbook
|
||||
Acces from wg network to router
|
||||
```
|
||||
ansible-playbook playbooks/hivpn.yml --limit 192.168.1.1
|
||||
wg_access: false|true
|
||||
```
|
||||
|
||||
После выполнения playbook роутер сразу начнёт роутить необходмые домены в туннель/прокси.
|
||||
|
||||
Если у вас были ошибки и они исправились при повторном запуске playbook, но при этом роутинг не заработал, сделайте рестарт сети и скрипта:
|
||||
If wireguard is used:
|
||||
```
|
||||
service network restart
|
||||
service getdomains start
|
||||
wg_server_address: wg-server-host
|
||||
wg_private_key: privatekey-client
|
||||
wg_public_key: publickey-client
|
||||
#wg_preshared_key: presharedkey-client
|
||||
wg_client_port: 51820
|
||||
wg_client_address: ip-client
|
||||
wg_access_network: wg-network
|
||||
```
|
||||
|
||||
# Скрипт для проверки конфигурации
|
||||
Dependencies
|
||||
------------
|
||||
|
||||
Написан для OpenWrt 23.05 и 22.03. На 21.02 работает только половина проверок.
|
||||
[gekmihesg.openwrt](https://github.com/gekmihesg/ansible-openwrt)
|
||||
|
||||
[x] - не обязательно означает, что эта часть не работает. Но это повод для ручной проверки.
|
||||
|
||||
Есть функционал сохранения вывода скрипта, конфигурации сети и firewall в файл. Все чувствительные переменные при этом затираются.
|
||||
Example Playbook
|
||||
----------------
|
||||
|
||||
### Запуск
|
||||
The inventory file must contain the group `[openwrt]` where your router will be located.
|
||||
|
||||
|
||||
Wireguard, only domains, stubby, Russia, acces from wg network, host 192.168.1.1
|
||||
```
|
||||
wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-check.sh | sh
|
||||
- hosts: 192.168.1.1
|
||||
remote_user: root
|
||||
|
||||
roles:
|
||||
- domain-routing-openwrt
|
||||
|
||||
vars:
|
||||
tunnel: wg
|
||||
dns_encrypt: stubby
|
||||
country: russia-inside
|
||||
wg_access: true
|
||||
|
||||
wg_server_address: wg-server-host
|
||||
wg_private_key: privatekey-client
|
||||
wg_public_key: publickey-client
|
||||
wg_preshared_key: presharedkey-client
|
||||
wg_listen_port: 51820
|
||||
wg_client_port: 51820
|
||||
wg_client_address: ip-client
|
||||
wg_access_network: wg-network
|
||||
```
|
||||
|
||||
### Запустить с проверкой на подмену DNS
|
||||
Sing-box, stubby, Russia
|
||||
```
|
||||
wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-check.sh | sh -s dns
|
||||
- hosts: 192.168.1.1
|
||||
remote_user: root
|
||||
|
||||
roles:
|
||||
- domain-routing-openwrt
|
||||
|
||||
vars:
|
||||
tunnel: singbox
|
||||
dns_encrypt: stubby
|
||||
country: russia-inside
|
||||
```
|
||||
|
||||
### Запустить с созданием dump
|
||||
```
|
||||
wget -O - https://raw.githubusercontent.com/itdoginfo/domain-routing-openwrt/master/getdomains-check.sh | sh -s dump
|
||||
```
|
||||
License
|
||||
-------
|
||||
|
||||
Поиск ошибок вручную: https://habr.com/ru/post/702388/
|
||||
|
||||
---
|
||||
|
||||
[Telegram-канал с обновлениями](https://t.me/+lW1HmBO_Fa00M2Iy)
|
||||
GNU General Public License v3.0
|
||||
12
defaults/main.yml
Normal file
12
defaults/main.yml
Normal file
@@ -0,0 +1,12 @@
|
||||
---
|
||||
list_domains: true
|
||||
list_subnet: false
|
||||
list_ip: false
|
||||
list_community: false
|
||||
tunnel: wg
|
||||
dns_encrypt: false
|
||||
country: russia-inside
|
||||
nano: true
|
||||
wg_access: false
|
||||
|
||||
wg_listen_port: 51820
|
||||
26
handlers/main.yml
Normal file
26
handlers/main.yml
Normal file
@@ -0,0 +1,26 @@
|
||||
---
|
||||
- name: Restart network
|
||||
service:
|
||||
name: network
|
||||
state: restarted
|
||||
|
||||
- name: Restart firewall
|
||||
service:
|
||||
name: firewall
|
||||
state: restarted
|
||||
|
||||
- name: Run getdomains script
|
||||
service:
|
||||
name: getdomains
|
||||
state: restarted
|
||||
|
||||
- name: Restart dnscrypt-proxy
|
||||
service:
|
||||
name: dnscrypt-proxy
|
||||
state: restarted
|
||||
enabled: yes
|
||||
|
||||
- name: Restart dnsmasq
|
||||
service:
|
||||
name: dnsmasq
|
||||
state: restarted
|
||||
22
meta/main.yml
Normal file
22
meta/main.yml
Normal file
@@ -0,0 +1,22 @@
|
||||
---
|
||||
galaxy_info:
|
||||
role_name: domain_routing_openwrt
|
||||
namespace: itdoginfo
|
||||
author: itdog
|
||||
description: Configuring domain routing on Openwrt router
|
||||
issue_tracker_url: https://github.com/itdoginfo/domain-routing-openwrt/issues
|
||||
license: GPL-3.0
|
||||
min_ansible_version: 2.10.8
|
||||
platforms:
|
||||
- name: OpenWrt
|
||||
galaxy_tags:
|
||||
- openwrt
|
||||
- dnsmasq
|
||||
- ipset
|
||||
- wireguard
|
||||
- sing-box
|
||||
- openvpn
|
||||
- bypass
|
||||
- routing
|
||||
dependencies:
|
||||
- role: gekmihesg.openwrt
|
||||
@@ -1,34 +1,5 @@
|
||||
---
|
||||
|
||||
- hosts: openwrt
|
||||
|
||||
remote_user: root
|
||||
|
||||
roles:
|
||||
- gekmihesg.openwrt
|
||||
|
||||
vars:
|
||||
ansible_template_dir: /etc/ansible/templates/
|
||||
list_domains: true
|
||||
list_subnet: false
|
||||
list_ip: false
|
||||
list_community: false
|
||||
tunnel: wg
|
||||
dns_encrypt: false
|
||||
country: russia-inside
|
||||
nano: true
|
||||
wg_access: false
|
||||
|
||||
wg_server_address: wg-server-host
|
||||
wg_private_key: privatekey-client
|
||||
wg_public_key: publickey-client
|
||||
#wg_preshared_key: presharedkey-client
|
||||
wg_listen_port: 51820
|
||||
wg_client_port: 51820
|
||||
wg_client_address: ip-client
|
||||
wg_access_network: wg-network
|
||||
|
||||
tasks:
|
||||
# Dnsmasq version check
|
||||
|
||||
- name: Get dnsmasq version
|
||||
@@ -96,7 +67,7 @@
|
||||
|
||||
- name: getdomains script copy
|
||||
template:
|
||||
src: "{{ ansible_template_dir }}openwrt-getdomains.j2"
|
||||
src: "openwrt-getdomains.j2"
|
||||
dest: "/etc/init.d/getdomains"
|
||||
mode: a+x
|
||||
trim_blocks: false
|
||||
@@ -133,7 +104,7 @@
|
||||
|
||||
- name: Route for vpn table
|
||||
template:
|
||||
src: "{{ ansible_template_dir }}openwrt-30-vpnroute.j2"
|
||||
src: "openwrt-30-vpnroute.j2"
|
||||
dest: "/etc/hotplug.d/iface/30-vpnroute"
|
||||
mode: 0644
|
||||
|
||||
@@ -265,7 +236,7 @@
|
||||
|
||||
- name: template for sing-box.json
|
||||
template:
|
||||
src: "{{ ansible_template_dir }}sing-box-json.j2"
|
||||
src: "sing-box-json.j2"
|
||||
dest: "/etc/sing-box/config.json"
|
||||
mode: 0644
|
||||
when: tunnel == "singbox"
|
||||
@@ -273,7 +244,7 @@
|
||||
|
||||
- name: template for config/sing-box
|
||||
template:
|
||||
src: "{{ ansible_template_dir }}config-sing-box.j2"
|
||||
src: "config-sing-box.j2"
|
||||
dest: "/etc/config/sing-box"
|
||||
mode: 0600
|
||||
when: tunnel == "singbox"
|
||||
@@ -675,7 +646,7 @@
|
||||
- Restart dnsmasq
|
||||
when: dns_encrypt == "stubby"
|
||||
|
||||
# Commit and handlers
|
||||
# Commit
|
||||
|
||||
- name: uci commit firewall
|
||||
uci:
|
||||
@@ -689,31 +660,4 @@
|
||||
command: commit
|
||||
config: network
|
||||
notify:
|
||||
- Restart network
|
||||
|
||||
handlers:
|
||||
- name: Restart network
|
||||
service:
|
||||
name: network
|
||||
state: restarted
|
||||
|
||||
- name: Restart firewall
|
||||
service:
|
||||
name: firewall
|
||||
state: restarted
|
||||
|
||||
- name: Run getdomains script
|
||||
service:
|
||||
name: getdomains
|
||||
state: restarted
|
||||
|
||||
- name: Restart dnscrypt-proxy
|
||||
service:
|
||||
name: dnscrypt-proxy
|
||||
state: restarted
|
||||
enabled: yes
|
||||
|
||||
- name: Restart dnsmasq
|
||||
service:
|
||||
name: dnsmasq
|
||||
state: restarted
|
||||
- Restart network
|
||||
2
tests/inventory
Normal file
2
tests/inventory
Normal file
@@ -0,0 +1,2 @@
|
||||
[openwrt]
|
||||
192.168.56.23
|
||||
6
tests/test.yml
Normal file
6
tests/test.yml
Normal file
@@ -0,0 +1,6 @@
|
||||
---
|
||||
- hosts: openwrt
|
||||
remote_user: root
|
||||
|
||||
roles:
|
||||
- domain_routing_openwrt
|
||||
Reference in New Issue
Block a user