From a0789a845690eceaadcc7aad3ab77a2ca786ffc8 Mon Sep 17 00:00:00 2001
From: itdoginfo <koalav42@gmail.com>
Date: Tue, 22 Jan 2019 19:20:11 +0300
Subject: [PATCH] create README

---
 README.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 53 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 86fa607..4f0cd6f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,53 @@
-# ansible-openwrt-hirkn
-Automation settings OpenWRT router to bypass RKN
+# Описание
+Playbook для Ansible, автоматизирующий настройку обхода блокировок РКН через Wireguard на роутере с OpenWRT
+
+Для взаимодействия c OpenWRT используется модуль [gekmihesg/ansible-openwrt](https://github.com/gekmihesg/ansible-openwrt)
+
+Списки берутся с [antifilter.download](https://antifilter.download/)
+
+Бонусом устанавливается и настраивается DNSCrypt
+
+# Использование
+
+Установить модуль gekmihesg/ansible-openwrt
+
+``` ansible-galaxy install gekmihesg.openwrt ```
+
+Скачать playbook и темплейты в /etc/ansible
+
+```
+cd /etc/ansible
+git clone https://github.com/itdoginfo/ansible-openwrt-hirkn
+```
+
+Добавить роутер в файл hosts в группу openwrt
+```
+[openwrt]
+192.168.1.1
+```
+
+Подставить переменные в **hirkn.yml**
+```
+  vars:
+    ansible_template_dir: /etc/ansible/templates/
+    wg_server_address: wg_server_ip/url
+    wg_private_key: privatekey-client
+    wg_public_key: publickey-client
+    wg_listen_port: 51820
+    wg_client_port: 51820
+    wg_client_address: 192.168.100.3/24
+```
+
+Обязательно нужно задать:
+**wg_server_address** - ip/url wireguard сервера
+
+**wg_private_key**, **wg_public_key** - ключи для "клиента"
+
+Остальное можно менять, в зависимости от того как настроен wireguard сервер
+
+Запуск playbook
+```
+ansible-playbook playbooks/hirkn.yml
+```
+
+После выполнения playbook роутер сразу начнёт выполнять обход блокировок через Wireguard сервер.