fix: пропускать sync install_server.sh при сетевой ошибке

Если get.hy2.sh недоступен (таймаут без VPN), используется локальная
копия в roles/hysteria2/files/; падение только если её нет.

README.md

@@ -1,16 +1,16 @@
-# Hysteria2 Ansible — ветка **main**
+# Hysteria2 Ansible — ветка **Salamander**
 
-> **Ветка:** `main`  
+> **Ветка:** `salamander`  
-> **Режим:** **masquerade** — маскировка под HTTPS-сайт nginx  
+> **Режим:** **Salamander obfs** — запутывание пакетов для обхода DPI  
-> **Альтернатива:** [`salamander`](https://git.antropoff.ru/DevOpsTools/hysteria2/src/branch/salamander) — обфускация Salamander для агрессивного DPI
+> **Основная ветка:** [`main`](https://git.antropoff.ru/DevOpsTools/hysteria2/src/branch/main) — masquerade под HTTPS-сайт nginx
 
-Ansible-роль для установки [Hysteria 2](https://v2.hysteria.network/) на Debian/Ubuntu VPS: Let's Encrypt, masquerade под nginx, несколько пользователей, экспорт URL/QR и HTML-каталог.
+Ansible-роль для установки [Hysteria 2](https://v2.hysteria.network/) на Debian/Ubuntu VPS с **Salamander obfs** — когда masquerade под «обычный сайт» недостаточен.
 
 ---
 
 ## Выбор ветки: `main` или `salamander`
 
-| | **`main` (эта ветка)** | **`salamander`** |
+| | **`main`** | **`salamander` (эта ветка)** |
 |---|---|---|
 | Маскировка | HTTPS-сайт nginx + Let's Encrypt | **Salamander obfs** — пакеты выглядят как шум |
 | Порт 80/tcp | **Нужен** (ACME HTTP + masquerade) | **Не нужен** |
@@ -20,19 +20,18 @@ Ansible-роль для установки [Hysteria 2](https://v2.hysteria.netw
 | URI клиента | `hysteria2://user:pass@domain:443` | + `obfs=salamander&obfs-password=...` |
 | Лучше когда | Нужен «легитимный» сайт в браузере | Агрессивный DPI, блокировка QUIC fingerprint |
 
-### Когда выбирать `main`
-
-- нужен **нормальный HTTPS-сайт** при открытии домена в браузере;
-- достаточно маскировки под nginx;
-- хотите **минимум параметров** в URI клиента;
-- провайдер не «палит» Hysteria/QUIC внутри TLS.
-
 ### Когда выбирать `salamander`
 
 - masquerade из `main` **блокируют** или распознают по fingerprint;
-- не нужен фейковый сайт;
+- не нужен фейковый сайт в браузере;
 - готовы хранить **дополнительный** obfs-пароль.
 
+### Когда выбирать `main`
+
+- нужен **нормальный HTTPS-сайт** при открытии домена;
+- достаточно маскировки под nginx;
+- хотите **минимум параметров** в URI клиента.
+
 ---
 
 ## Быстрый старт
@@ -40,7 +39,7 @@ Ansible-роль для установки [Hysteria 2](https://v2.hysteria.netw
 ```bash
 git clone https://git.antropoff.ru/DevOpsTools/hysteria2.git
 cd hysteria2
-git checkout main
+git checkout salamander
 
 # macOS: установить Ansible (если ещё нет)
 brew install ansible
@@ -70,7 +69,7 @@ make install    # → output/index.html откроется в браузере
 | `make check` | Проверить синтаксис playbook |
 | `make ping` | Проверить SSH к VPS |
 | `make status` | `systemctl status hysteria-server` |
-| `make install` | Установка masquerade + экспорт URL/QR/HTML |
+| `make install` | Установка Salamander + экспорт URL/QR/HTML |
 | `make update` | Обновить бинарник и конфиг; экспорт только для новых/изменённых пользователей |
 | `make export` | Только экспорт (URL, QR, HTML) без изменений на сервере |
 | `make uninstall` | Полное удаление с VPS + `output/<server>/` + пересборка `output/index.html` |
@@ -107,7 +106,7 @@ all:
           ansible_port: 2222              # SSH-порт (если не 22)
           ansible_user: root
           ansible_password: "{{ vault_ssh_passwords['vps-de'] }}"
-          hysteria2_domain: vpn-de.example.com
+          hysteria2_domain: vpn-de.example.com   # для TLS/SNI и ACME
           hysteria2_users:
             - my
             - friend
@@ -143,7 +142,7 @@ vault_ssh_passwords:
 
 ---
 
-## Как работает masquerade в этом проекте
+## Как работает Salamander в этом проекте
 
 ### Сервер (`/etc/hysteria/config.yaml`)
 
@@ -151,7 +150,7 @@ vault_ssh_passwords:
 listen: 0.0.0.0:443
 
 acme:
-  type: http
+  type: tls                    # сертификат без порта 80
   domains:
     - vpn-de.example.com
   email: admin@example.com
@@ -162,38 +161,36 @@ auth:
     my: "..."
     friend: "..."
 
-masquerade:
+obfs:
-  type: file
+  type: salamander
-  file:
+  salamander:
-    dir: /var/www/masq
+    password: "общий_obfs_пароль_сервера"
-  listenHTTP: :80
-  listenHTTPS: :443
-  forceHTTPS: true
 ```
 
-### Сайт-заглушка
-
-В `/var/www/masq/index.html` — официальная страница **Welcome to nginx!**  
-При открытии домена в браузере — валидный HTTPS-сайт с Let's Encrypt.
-
 ### Клиент (генерируется автоматически)
 
 ```yaml
 server: vpn-de.example.com:443
 auth: my:password
+obfs:
+  type: salamander
+  salamander:
+    password: общий_obfs_пароль_сервера
 ```
 
 ### URI (пример)
 
 ```
-hysteria2://my:password@vpn-de.example.com:443#my
+hysteria2://my:password@vpn-de.example.com:443?obfs=salamander&obfs-password=OBFS_PASS#my
 ```
 
-Роль вызывает `hysteria share` — URI и QR формируются автоматически.
+Роль вызывает `hysteria share` — URI и QR уже содержат параметры Salamander.
 
 ---
 
-## Пароли VPN-пользователей
+## Пароли
+
+### VPN-пользователи (`userpass`)
 
 1. **Vault (рекомендуется):**
 
@@ -219,11 +216,31 @@ hysteria2_user_passwords:
 3. **Автогенерация** — Ansible `password` lookup, если пароль не задан ни в inventory/vault, ни в `output/<server>/server-info.yml`.
 
 При `make update` / `make export`:
-- **существующие** пользователи сохраняют пароли из `server-info.yml` (и URL/QR, если домен/порт не менялись);
+- **существующие** пользователи сохраняют пароли из `server-info.yml` (и URL/QR, если домен/порт/obfs не менялись);
 - **новые** получают автогенерацию и полный экспорт;
 - **удалённые** из inventory убираются из конфига Hysteria2 и из `output/<server>/`.
 
-Принудительно перевыпустить URL/QR для всех: `hysteria2_force_export: true` (в `group_vars/all.yml` или `EXTRA_VARS`).
+### Salamander obfs (один на сервер)
+
+1. **Vault (рекомендуется):**
+
+```yaml
+vault_hysteria2_obfs_passwords:
+  vps-de: "cry_me_a_r1ver_salamander_obfs"
+```
+
+Подключается через `group_vars/hysteria2_servers/vars.yml`:
+
+```yaml
+hysteria2_obfs_password: "{{ vault_hysteria2_obfs_passwords[inventory_hostname] | default('') }}"
+```
+
+2. **Авто:** Ansible `password` lookup (`hysteria2_obfs_password_length`) при первой установке  
+3. **При update/export:** загружается из `output/<server>/server-info.yml` (как VPN-пароли)
+
+> **Важно:** obfs-пароль на сервере и клиенте должен **совпадать**. При `make update` без vault пароль сохраняется из предыдущего экспорта.
+
+Принудительно перевыпустить URL/QR для всех VPN-пользователей: `hysteria2_force_export: true`.
 
 ```bash
 make install EXTRA_VARS='hysteria2_force_export=true'
@@ -246,12 +263,12 @@ make install LIMIT=новый-сервер
 
 ### Добавить / удалить пользователя
 
-1. Отредактируйте `hysteria2_users` в `inventory/hosts.yml` (добавьте имя или уберите).
+1. Отредактируйте `hysteria2_users` в `inventory/hosts.yml`.
 2. Запустите `make update LIMIT=<хост>`.
 
-Пароли существующих клиентов **не меняются** (берутся из `output/<server>/server-info.yml`).  
+Пароли и obfs существующих клиентов **не меняются** (из `server-info.yml`).  
-Новому пользователю генерируется пароль и создаются URL/QR.  
+Новому пользователю генерируется пароль и создаются URL/QR с параметрами Salamander.  
-Удалённый пользователь пропадает из `/etc/hysteria/config.yaml` и из папки `output/<server>/`.
+Удалённый пользователь пропадает из конфига и из `output/<server>/`.
 
 ---
 
@@ -259,12 +276,12 @@ make install LIMIT=новый-сервер
 
 Официальный скрипт `install_server.sh` хранится в `roles/hysteria2/files/`.
 
-Перед `make install` / `make update` на **control node** (ваш Mac):
+Перед `make install` / `make update` на **control node**:
 
 1. Скачивается копия с https://get.hy2.sh/
 2. Сравнивается SHA256 с локальным файлом в роли
 3. При отличии — локальная копия обновляется
-4. Скрипт копируется на VPS и запускается оттуда (без `curl | bash` на сервере)
+4. Скрипт копируется на VPS и запускается оттуда
 
 ---
 
@@ -273,11 +290,11 @@ make install LIMIT=новый-сервер
 | Компонент | Поведение |
 |---|---|
 | Бинарник `hysteria` | Обновляется (`install_server.sh --force`) |
-| `/etc/hysteria/config.yaml` | Перекатывается под текущий inventory |
+| `/etc/hysteria/config.yaml` | Перекатывается (auth + obfs) |
-| Пароли VPN | Сохраняются для существующих пользователей |
+| Пароли VPN / obfs | Сохраняются для существующей конфигурации |
 | URL / QR | Только для новых, изменённых или при `hysteria2_force_export=true` |
-| `apt upgrade` | **Не** выполняется (отключено в Makefile) |
+| `apt upgrade` | **Не** выполняется |
-| Ожидание ACME | **Не** выполняется (`hysteria2_wait_for_acme=false`) |
+| Ожидание ACME | **Не** выполняется |
 
 ---
 
@@ -288,10 +305,9 @@ make install LIMIT=новый-сервер
 - бинарник `/usr/local/bin/hysteria` и unit-файлы systemd;
 - `/etc/hysteria/` (конфиг и ACME);
 - `/var/lib/hysteria` и пользователь `hysteria`;
-- `/var/www/masq` (сайт-заглушка, ветка **main**);
 - symlink'и `multi-user.target.wants/hysteria-server*`;
 - временные `/tmp/hysteria-client-*.yaml`;
-- правила ufw, добавленные при install;
+- правила ufw: `443/tcp`, `443/udp` (порт из `hysteria2_listen_port`);
 - пакеты `curl`, `micro`, `qrencode`.
 
 На **control node**:
@@ -308,11 +324,11 @@ make install LIMIT=новый-сервер
 
 При блоке `acme:` в конфиге встроенный ACME-клиент Hysteria2 сам получает и **продлевает** сертификат Let's Encrypt (срок ~90 дней). Повторный `make install` или certbot для продления **не нужны** — процесс `hysteria-server` делает это сам.
 
-**Условия для авто-продления (ветка `main`):**
+**Условия для авто-продления (ветка `salamander`):**
 
 - сервер **запущен** и доступен из интернета;
 - домен указывает на IP VPS;
-- порты **80/tcp** и **443/tcp** открыты (ACME HTTP challenge + masquerade);
+- порт **443/tcp** открыт (ACME TLS-ALPN challenge);
 - конфиг `acme` не удалён.
 
 Проверка логов: `journalctl -u hysteria-server -f`
@@ -321,11 +337,12 @@ make install LIMIT=новый-сервер
 
 ## Firewall
 
-По умолчанию открываются:
+По умолчанию открываются только порты Hysteria2:
 
-- **80/tcp** — ACME HTTP + masquerade HTTP
+- **443/tcp**
-- **443/tcp** — HTTPS masquerade
+- **443/udp**
-- **443/udp** — Hysteria2
+
+**Порт 80 не используется** — в отличие от ветки `main`.
 
 ---
 
@@ -335,19 +352,20 @@ make install LIMIT=новый-сервер
 output/
 ├── index.html                 ← все серверы (открывается в браузере)
 ├── vps-de/
-│   ├── index.html             ← страница сервера
+│   ├── index.html             ← страница сервера + obfs-пароль
-│   ├── my.url
+│   ├── my.url                 ← URI с obfs=salamander
 │   ├── my.png                 ← QR PNG
 │   ├── my.qr.txt             ← QR ASCII
 │   ├── my.txt
-│   └── server-info.yml
+│   └── server-info.yml        ← mode, obfs_password, users
 └── vps-nl/
     └── ...
 ```
 
 HTML-страницы показывают:
 
-- пароль и URL каждого пользователя с **кнопкой копирования**;
+- режим **Salamander** и **obfs-password** с кнопкой копирования;
+- пароль и URL каждого пользователя;
 - QR-коды;
 - ссылки на файлы и страницы серверов.
 
@@ -373,33 +391,37 @@ ASCII QR — `hysteria share --qr` → `user.qr.txt`.
 
 | Переменная | Где | Описание |
 |---|---|---|
-| `hysteria2_domain` | host | Домен с A-записью на IP |
+| `hysteria2_mode` | defaults | `salamander` (информативно) |
-| `hysteria2_users` | host | Список имён VPN-пользователей |
+| `hysteria2_domain` | host | Домен для TLS/SNI/ACME |
-| `hysteria2_acme_email` | group | Email для Let's Encrypt |
+| `hysteria2_users` | host | VPN-пользователи |
-| `hysteria2_user_passwords` | host/vault | Фиксированные пароли VPN (`vars.yml` + vault) |
+| `hysteria2_acme_email` | group | Email Let's Encrypt |
-| `hysteria2_password_length` | group | Длина автогенерируемого пароля (40) |
+| `hysteria2_user_passwords` | host/vault | Фиксированные пароли VPN |
-| `hysteria2_force_export` | group | Перегенерировать URL/QR для всех (`false` по умолчанию) |
+| `hysteria2_password_length` | group | Длина автопароля VPN (40) |
+| `hysteria2_force_export` | group | Перегенерировать URL/QR для всех (`false`) |
+| `hysteria2_obfs_password` | host/vault | Пароль Salamander (или авто) |
+| `hysteria2_obfs_password_length` | group | Длина автопароля obfs (32) |
 | `hysteria2_output_dir` | group | Папка экспорта (`./output`) |
-| `hysteria2_output_name` | host | Подпапка экспорта (`inventory_hostname`) |
+| `hysteria2_listen_port` | group | Порт (443) |
-| `hysteria2_listen_port` | group | Порт Hysteria2 (443) |
+| `hysteria2_upgrade_system` | group | `apt upgrade` перед install |
-| `hysteria2_upgrade_system` | group | `apt upgrade` перед install (`true`) |
+| `hysteria2_configure_firewall` | group | Открыть порты в ufw |
-| `hysteria2_configure_firewall` | group | Открыть порты в ufw (`true`) |
 | `hysteria2_generate_qr_png` | group | PNG QR через `qrencode` |
-| `hysteria2_wait_for_acme` | group | Пауза при первом ACME (install) |
+| `hysteria2_wait_for_acme` | group | Пауза при первом ACME |
 | `hysteria2_open_browser` | group | Открыть `output/index.html` после экспорта |
 | `hysteria2_uninstall_rebuild_global_index` | group | Пересобрать `output/index.html` после uninstall (`true`) |
-| `vault_ssh_passwords` | vault | SSH-пароли root по имени хоста |
+| `vault_ssh_passwords` | vault | SSH-пароли root |
 | `vault_hysteria2_user_passwords` | vault | VPN-пароли по серверам |
+| `vault_hysteria2_obfs_passwords` | vault | obfs-пароли по серверам |
 
-Полный список defaults: `roles/hysteria2/defaults/main.yml`, `defaults/uninstall.yml`.
+Полный список: `roles/hysteria2/defaults/main.yml`, `defaults/uninstall.yml`.
 
 ---
 
 ## Безопасность
 
-- `output/` содержит пароли и URL — **не коммитить** (в `.gitignore`)
+- `output/` содержит пароли, obfs-ключи и URL — **не коммитить** (в `.gitignore`)
 - `inventory/hosts.yml`, `vault.yml`, `.vault_pass` — не коммитить
 - После `make init` выполните `make vault-encrypt`
+- Salamander **не делает** вас невидимым: IP VPS и UDP-поток всё ещё можно анализировать
 
 ---
 
@@ -407,8 +429,9 @@ ASCII QR — `hysteria share --qr` → `user.qr.txt`.
 
 - **Control node:** macOS или Linux с Ansible **2.14+** (`brew install ansible` на Mac)
 - **VPS:** Debian/Ubuntu с sudo
-- Домен с A-записью на IP сервера
+- Домен с A-записью на IP (для ACME TLS)
-- Порты **80/tcp** и **443/tcp+udp** доступны с интернета (ветка `main`)
+- Порт **443/tcp+udp** доступен с интернета
+- Клиент Hysteria2 с поддержкой Salamander (Shadowrocket, NekoBox, Hiddify и др.)
 - Для авто-открытия браузера: macOS (`open`) или Linux (`xdg-open`)
 
 ---
@@ -418,29 +441,29 @@ ASCII QR — `hysteria share --qr` → `user.qr.txt`.
 ```
 roles/hysteria2/
 ├── defaults/
-│   ├── main.yml              ← основные переменные
+│   ├── main.yml
-│   └── uninstall.yml         ← переменные удаления
+│   └── uninstall.yml
 ├── files/
-│   └── install_server.sh     ← официальный скрипт (синхронизация с get.hy2.sh)
+│   └── install_server.sh
 ├── tasks/
-│   ├── main.yml              ← порядок задач и теги
+│   ├── main.yml
 │   ├── validate.yml
-│   ├── users.yml             ← пароли (inventory / vault / server-info.yml)
+│   ├── users.yml
+│   ├── obfs.yml              ← пароль Salamander obfs
 │   ├── sync_install_script.yml
-│   ├── install.yml           ← пакеты, бинарник
+│   ├── install.yml
-│   ├── configure.yml         ← masquerade + ACME + ufw
+│   ├── configure.yml         ← Salamander, без masquerade
-│   ├── update.yml            ← обновление бинарника
+│   ├── update.yml
-│   ├── export_prepare.yml    ← инкрементальный экспорт
+│   ├── export_prepare.yml
-│   ├── export.yml            ← URL, QR, HTML сервера
+│   ├── export.yml
-│   ├── export_global.yml     ← общий output/index.html
+│   ├── export_global.yml
 │   ├── share_user.yml
 │   ├── reuse_export_user.yml
 │   └── uninstall.yml
 └── templates/
-    ├── config.yaml.j2        ← acme http + masquerade file
+    ├── config.yaml.j2        ← acme tls + obfs salamander
     ├── client.yaml.j2
-    ├── masq/index.html.j2
+    └── export/
-    └── export/               ← HTML-каталоги
 ```
 
 ---
@@ -449,15 +472,15 @@ roles/hysteria2/
 
 ```bash
 git fetch origin
-git checkout main        # masquerade + nginx (эта ветка)
+git checkout main        # masquerade + nginx
-git checkout salamander  # Salamander obfs
+git checkout salamander  # Salamander obfs (эта ветка)
 ```
 
 Конфиги на **уже установленном** сервере **не меняются** при переключении ветки в git.  
 Чтобы применить другой режим на VPS:
 
 ```bash
-git checkout salamander   # или main
+git checkout main         # или salamander
 make install              # перекатит конфиг сервера
 # или
 make update

group_vars/all.yml.example

@@ -17,8 +17,11 @@ hysteria2_output_dir: "{{ playbook_dir }}/output"
 # Открывать output/index.html в браузере после install/update/export
 # hysteria2_open_browser: true
 
-# Порт Hysteria2
+# Порт Hysteria2 (Salamander — достаточно открыть только его, 80/tcp не нужен)
 hysteria2_listen_port: 443
 
-# Открывать порты в ufw (80/tcp, 443/tcp, 443/udp)
+# Открывать порты в ufw ({{ hysteria2_listen_port }}/tcp и /udp)
 hysteria2_configure_firewall: true
+
+# Длина пароля Salamander obfs
+# hysteria2_obfs_password_length: 32

group_vars/hysteria2_servers/vars.yml.example

@@ -4,3 +4,6 @@
 
 # Проброс VPN-паролей из vault в переменные роли (опционально)
 hysteria2_user_passwords: "{{ vault_hysteria2_user_passwords[inventory_hostname] | default({}) }}"
+
+# Опционально: фиксированный пароль Salamander obfs для сервера
+# hysteria2_obfs_password: "{{ vault_hysteria2_obfs_passwords[inventory_hostname] | default('') }}"

group_vars/hysteria2_servers/vault.yml.example

@@ -14,5 +14,8 @@ vault_ssh_passwords:
 # vault_hysteria2_user_passwords:
 #   vps-de:
 #     friend: "Aingae0Okit1eek4eeZahFohVei4akee"
-#   vps-nl:
+
-#     alice: "CustomAlicePassword40chars................"
+# Опционально: пароль Salamander obfs (один на сервер)
+# vault_hysteria2_obfs_passwords:
+#   vps-de: "cry_me_a_r1ver_salamander_obfs_pass"
+#   vps-nl: "another_obfs_password_32chars!!"

roles/hysteria2/defaults/main.yml

@@ -1,5 +1,8 @@
 ---
-# Домен сервера (A-запись → IP VPS). Задаётся per-host в inventory.
+# Режим развёртывания (ветка salamander)
+hysteria2_mode: salamander
+
+# Домен сервера (A-запись → IP VPS). Используется для TLS/SNI и ACME.
 hysteria2_domain: ""
 
 # Email для ACME / Let's Encrypt
@@ -9,14 +12,17 @@ hysteria2_acme_email: ""
 hysteria2_users: []
 
 # Опционально: фиксированные пароли { username: password }
-# Пустое значение или отсутствие ключа — автогенерация на control node (Ansible password lookup)
+
+# Пароль обфускации Salamander (общий для сервера).
+# Пусто — автогенерация на control node (Ansible password lookup) или загрузка из output/<server>/server-info.yml
+hysteria2_obfs_password: ""
 
 hysteria2_password_length: 40
+hysteria2_obfs_password_length: 32
 hysteria2_listen_port: 443
 hysteria2_upgrade_system: true
 hysteria2_configure_firewall: true
 
-hysteria2_masq_dir: /var/www/masq
 hysteria2_config_path: /etc/hysteria/config.yaml
 hysteria2_service_name: hysteria-server
 
@@ -26,20 +32,15 @@ hysteria2_install_script_name: install_server.sh
 hysteria2_install_script_staging_dir: "{{ playbook_dir }}/.cache/hysteria2"
 hysteria2_install_script_remote_path: /tmp/hysteria2-install_server.sh
 
-# Локальный каталог для экспорта URL и QR (на control node)
 hysteria2_output_dir: "{{ playbook_dir }}/output"
 hysteria2_output_name: "{{ inventory_hostname }}"
 
-# Генерировать PNG QR-коды через qrencode (apt на VPS, fetch на control node)
 hysteria2_generate_qr_png: true
 hysteria2_qr_png_size: 6
 hysteria2_qr_png_margin: 2
 hysteria2_qr_png_error_correction: M
 
-# Ждать ACME при первом запуске (отключите при update: make update)
 hysteria2_wait_for_acme: true
-
-# Открыть output/index.html в браузере после install/update/export
 hysteria2_open_browser: true
 
 # Перегенерировать URL/QR для всех пользователей (иначе — только новые/изменённые)
@@ -47,9 +48,8 @@ hysteria2_force_export: false
 
 # --- uninstall (см. также defaults/uninstall.yml) ---
 hysteria2_system_user: hysteria
-hysteria2_uninstall_remove_masq: true
+hysteria2_uninstall_remove_masq: false
 hysteria2_uninstall_rebuild_global_index: true
 hysteria2_uninstall_ufw_rules:
-  - 80/tcp
+  - "{{ hysteria2_listen_port }}/tcp"
-  - 443/tcp
+  - "{{ hysteria2_listen_port }}/udp"
-  - 443/udp

roles/hysteria2/defaults/uninstall.yml

@@ -2,11 +2,10 @@
 # Системный пользователь Hysteria (создаётся install_server.sh)
 hysteria2_system_user: hysteria
 
-# --- uninstall ---
+# --- uninstall (Salamander: без masq, порты listen_port/tcp+udp) ---
 # install_server.sh --remove: бинарник + systemd; остальное — задачи uninstall.yml
-hysteria2_uninstall_remove_masq: true
+hysteria2_uninstall_remove_masq: false
 hysteria2_uninstall_rebuild_global_index: true
 hysteria2_uninstall_ufw_rules:
-  - 80/tcp
+  - "{{ hysteria2_listen_port }}/tcp"
-  - 443/tcp
+  - "{{ hysteria2_listen_port }}/udp"
-  - 443/udp

roles/hysteria2/meta/main.yml

@@ -2,7 +2,7 @@
 galaxy_info:
   role_name: hysteria2
   author: inecs
-  description: Install Hysteria2 VPN server with masquerade site and export client URLs with QR codes
+  description: Install Hysteria2 VPN server with Salamander obfs and export client URLs with QR codes
   license: MIT
   min_ansible_version: "2.14"
   platforms:

roles/hysteria2/tasks/configure.yml

@@ -1,24 +1,11 @@
 ---
-- name: Create masquerade web directory
-  ansible.builtin.file:
-    path: "{{ hysteria2_masq_dir }}"
-    state: directory
-    mode: "0755"
-
-- name: Deploy masquerade index.html
-  ansible.builtin.template:
-    src: masq/index.html.j2
-    dest: "{{ hysteria2_masq_dir }}/index.html"
-    mode: "0644"
-  notify: Restart hysteria-server
-
 - name: Remove default Hysteria config if present
   ansible.builtin.file:
     path: "{{ hysteria2_config_path }}"
     state: absent
   when: not ansible_check_mode
 
-- name: Deploy Hysteria2 server config
+- name: Deploy Hysteria2 Salamander server config
   ansible.builtin.template:
     src: config.yaml.j2
     dest: "{{ hysteria2_config_path }}"
@@ -42,12 +29,11 @@
   failed_when: false
   when: hysteria2_configure_firewall | bool
 
-- name: Allow HTTP and HTTPS in ufw
+- name: Allow Hysteria2 port in ufw (Salamander — только {{ hysteria2_listen_port }})
   ansible.builtin.command: "ufw allow {{ item }}"
   loop:
-    - 80/tcp
+    - "{{ hysteria2_listen_port }}/tcp"
-    - 443/tcp
+    - "{{ hysteria2_listen_port }}/udp"
-    - 443/udp
   register: _hysteria2_ufw_allow
   changed_when: "'Skipping' not in (_hysteria2_ufw_allow.stdout | default(''))"
   failed_when: false
@@ -55,10 +41,10 @@
     - hysteria2_configure_firewall | bool
     - "'active' in (_hysteria2_ufw_status.stdout | default(''))"
 
-- name: Wait for ACME certificate (first start may take several minutes)
+- name: Wait for ACME TLS certificate (first start may take several minutes)
   ansible.builtin.pause:
     seconds: 30
-    prompt: "Ожидание получения ACME-сертификата для {{ hysteria2_domain }}..."
+    prompt: "Ожидание получения ACME TLS-сертификата для {{ hysteria2_domain }}..."
   when: hysteria2_wait_for_acme | default(true) | bool
 
 - name: Verify hysteria-server is running

roles/hysteria2/tasks/export.yml

@@ -43,8 +43,10 @@
     mode: "0600"
     content: |
       server: {{ hysteria2_output_name }}
+      mode: salamander
       domain: {{ hysteria2_domain }}
       port: {{ hysteria2_listen_port }}
+      obfs_password: "{{ hysteria2_obfs_password }}"
       users:
       {% for user in hysteria2_export_users %}
         - name: {{ user.name }}
@@ -65,6 +67,7 @@
     mode: "0644"
   vars:
     generated_at: "{{ now(utc=false, fmt='%Y-%m-%d %H:%M:%S') }}"
+    hysteria2_obfs_password: "{{ hysteria2_obfs_password }}"
   delegate_to: localhost
   become: false
 

roles/hysteria2/tasks/export_global.yml

@@ -33,6 +33,8 @@
       name: "{{ _info.server }}"
       domain: "{{ _info.domain }}"
       port: "{{ _info.port }}"
+      mode: "{{ _info.mode | default('salamander') }}"
+      obfs_password: "{{ _info.obfs_password | default('') }}"
       dir: "{{ item.item.path | dirname | basename }}"
       users: "{{ _info.users }}"
   become: false

roles/hysteria2/tasks/main.yml

@@ -7,6 +7,10 @@
   ansible.builtin.import_tasks: users.yml
   tags: [install, update, export]
 
+- name: Resolve Salamander obfs password
+  ansible.builtin.import_tasks: obfs.yml
+  tags: [install, update, export]
+
 - name: Install packages and Hysteria2 binary
   ansible.builtin.import_tasks: install.yml
   tags: [install]

roles/hysteria2/tasks/obfs.yml

@@ -0,0 +1,58 @@
+---
+- name: Check for saved Salamander password from previous install
+  ansible.builtin.stat:
+    path: "{{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/server-info.yml"
+  register: _hysteria2_saved_info
+  delegate_to: localhost
+  become: false
+  tags:
+    - install
+    - update
+    - export
+
+- name: Load saved Salamander obfs password
+  when: _hysteria2_saved_info.stat.exists
+  block:
+    - name: Read server-info.yml for obfs password
+      ansible.builtin.slurp:
+        path: "{{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/server-info.yml"
+      register: _hysteria2_saved_info_raw
+      delegate_to: localhost
+      become: false
+
+    - name: Parse saved obfs password
+      ansible.builtin.set_fact:
+        _hysteria2_saved_obfs_password: "{{ (_hysteria2_saved_info_raw.content | b64decode | from_yaml).obfs_password | default('') }}"
+      delegate_to: localhost
+      become: false
+  tags:
+    - install
+    - update
+    - export
+
+- name: Resolve Salamander obfs password
+  ansible.builtin.set_fact:
+    hysteria2_obfs_password: >-
+      {{
+        hysteria2_obfs_password
+        | default(_hysteria2_saved_obfs_password | default(''), true)
+      }}
+  tags:
+    - install
+    - update
+    - export
+
+- name: Generate Salamander obfs password
+  ansible.builtin.set_fact:
+    hysteria2_obfs_password: >-
+      {{
+        lookup(
+          'password',
+          '/dev/null chars=ascii_letters,digits length=' ~ (hysteria2_obfs_password_length | string)
+        )
+      }}
+  when: hysteria2_obfs_password | length == 0
+  tags:
+    - install
+    - update
+    - export

roles/hysteria2/tasks/share_user.yml

@@ -34,6 +34,8 @@
       Domain: {{ hysteria2_domain }}:{{ hysteria2_listen_port }}
       User: {{ hysteria2_current_user.name }}
       Password: {{ hysteria2_current_user.password }}
+      Mode: salamander
+      Obfs password: {{ hysteria2_obfs_password }}
 
       URL:
       {{ _hysteria2_client_url }}

roles/hysteria2/tasks/uninstall.yml

@@ -32,12 +32,6 @@
     - "{{ hysteria2_config_path | dirname }}"
     - "/var/lib/{{ hysteria2_system_user | default('hysteria') }}"
 
-- name: Remove masquerade web directory
-  ansible.builtin.file:
-    path: "{{ hysteria2_masq_dir }}"
-    state: absent
-  when: hysteria2_uninstall_remove_masq | default(true) | bool
-
 - name: Remove enabled hysteria-server systemd symlink
   ansible.builtin.file:
     path: /etc/systemd/system/multi-user.target.wants/hysteria-server.service
@@ -130,7 +124,7 @@
 - name: Show uninstall result
   ansible.builtin.debug:
     msg: >-
-      Hysteria2 полностью удалён с {{ inventory_hostname }}.
+      Hysteria2 (Salamander) полностью удалён с {{ inventory_hostname }}.
       Локальная папка {{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/ удалена.
       {% if hysteria2_uninstall_rebuild_global_index | default(true) | bool %}
       {{ hysteria2_output_dir }}/index.html будет пересобран без этого сервера.

roles/hysteria2/tasks/validate.yml

@@ -7,7 +7,7 @@
       - hysteria2_users | length > 0
     fail_msg: |
       Задайте для каждого хоста:
-        hysteria2_domain — домен с A-записью на IP сервера
+        hysteria2_domain — домен с A-записью на IP сервера (используется для TLS/SNI)
         hysteria2_users — список имён пользователей, например [my, friend]
       И в group_vars/all.yml:
         hysteria2_acme_email — email для Let's Encrypt

roles/hysteria2/templates/client.yaml.j2

@@ -1,3 +1,8 @@
 server: {{ hysteria2_domain }}:{{ hysteria2_listen_port }}
 
 auth: {{ hysteria2_current_user.name }}:{{ hysteria2_current_user.password }}
+
+obfs:
+  type: salamander
+  salamander:
+    password: {{ hysteria2_obfs_password }}

roles/hysteria2/templates/config.yaml.j2

@@ -1,7 +1,7 @@
 listen: 0.0.0.0:{{ hysteria2_listen_port }}
 
 acme:
-  type: http
+  type: tls
   domains:
     - {{ hysteria2_domain }}
   email: {{ hysteria2_acme_email }}
@@ -13,10 +13,7 @@ auth:
     {{ user.name }}: "{{ user.password }}"
 {% endfor %}
 
-masquerade:
+obfs:
-  type: file
+  type: salamander
-  file:
+  salamander:
-    dir: {{ hysteria2_masq_dir }}
+    password: "{{ hysteria2_obfs_password }}"
-  listenHTTP: :80
-  listenHTTPS: :{{ hysteria2_listen_port }}
-  forceHTTPS: true

roles/hysteria2/templates/export/global-index.html.j2

@@ -160,6 +160,17 @@
       font-weight: 600;
     }
     .server-link:hover { background: var(--accent-soft); border-color: var(--accent); }
+    .badge-salamander {
+      display: inline-block;
+      margin-top: 0.35rem;
+      padding: 0.2rem 0.6rem;
+      border-radius: 999px;
+      font-size: 0.72rem;
+      font-weight: 700;
+      background: var(--accent-soft-2);
+      color: var(--accent-2);
+    }
+    .server-obfs { margin-top: 0.75rem; width: 100%; }
     .users-grid {
       display: grid;
       grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
@@ -286,8 +297,8 @@
 </head>
 <body>
   <header class="hero">
-    <h1>Hysteria2</h1>
+    <h1>Hysteria2 · Salamander</h1>
-    <p>Общий каталог VPN-подключений</p>
+    <p>Общий каталог VPN-подключений с обфускацией Salamander</p>
     <div class="stats">
       <div class="stat"><span>{{ hysteria2_global_servers | length }}</span> серверов</div>
       <div class="stat"><span>{{ total_users }}</span> пользователей</div>
@@ -307,6 +318,18 @@
         <div>
           <h2>{{ server.name | e }}</h2>
           <p class="domain">{{ server.domain | e }}:{{ server.port }}</p>
+          <span class="badge-salamander">Salamander</span>
+{% if server.obfs_password | default('') | length > 0 %}
+          <div class="field server-obfs">
+            <label for="obfs-{{ server.dir | e }}">Пароль обфускации</label>
+            <div class="input-row">
+              <input type="text" id="obfs-{{ server.dir | e }}" value="{{ server.obfs_password | e }}" readonly>
+              <button type="button" class="btn-copy" onclick="copyField('obfs-{{ server.dir | e }}', this)" title="Копировать obfs-password" aria-label="Копировать obfs-password">
+                <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+              </button>
+            </div>
+          </div>
+{% endif %}
         </div>
         <a class="server-link" href="{{ server.dir | e }}/index.html">Страница сервера →</a>
       </div>

roles/hysteria2/templates/export/index.html.j2

@@ -75,6 +75,15 @@
       font-size: 0.8rem;
       font-weight: 600;
     }
+    .badge-salamander {
+      margin-left: 0.35rem;
+      background: rgba(163, 113, 247, 0.18);
+      color: #a371f7;
+    }
+    .server-obfs {
+      margin-top: 1.25rem;
+      max-width: 100%;
+    }
     .user-card {
       background: var(--bg-card);
       border: 1px solid var(--border);
@@ -235,6 +244,17 @@
         Домен: <strong>{{ hysteria2_domain }}:{{ hysteria2_listen_port }}</strong>
       </p>
       <span class="badge">{{ hysteria2_export_users | length }} {{ 'пользователь' if hysteria2_export_users | length == 1 else 'пользователей' }}</span>
+      <span class="badge badge-salamander">Salamander</span>
+
+      <div class="field server-obfs">
+        <label for="obfs-server">Пароль обфускации (Salamander)</label>
+        <div class="input-row">
+          <input type="text" id="obfs-server" value="{{ hysteria2_obfs_password | e }}" readonly>
+          <button type="button" class="btn-copy" onclick="copyField('obfs-server', this)" title="Копировать obfs-password" aria-label="Копировать obfs-password">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>
+          </button>
+        </div>
+      </div>
     </header>
 
 {% for user in hysteria2_export_users %}

roles/hysteria2/templates/masq/index.html.j2

@@ -1,27 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-<title>Welcome to nginx!</title>
-<style>
-html { color-scheme: light dark; }
-body { width: 35em; margin: 0 auto;
-font-family: Tahoma, Verdana, Arial, sans-serif; }
-</style>
-</head>
-<body>
-<h1>Welcome to nginx!</h1>
-<p>If you see this page, nginx is successfully installed and working.
-Further configuration is required for the web server, reverse proxy, 
-API gateway, load balancer, content cache, or other features.</p>
-
-<p>For online documentation and support please refer to
-<a href="https://nginx.org/">nginx.org</a>.<br/>
-To engage with the community please visit
-<a href="https://community.nginx.org/">community.nginx.org</a>.<br/>
-For enterprise grade support, professional services, additional 
-security features and capabilities please refer to
-<a href="https://f5.com/nginx">f5.com/nginx</a>.</p>
-
-<p><em>Thank you for using nginx.</em></p>
-</body>
-</html>