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

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

Makefile

@@ -48,7 +48,7 @@ help: ## Показать справку
 	@echo "    make install"
 	@echo "    make install LIMIT=vps-de"
 	@echo "    make update LIMIT=vps-nl"
-	@echo "    make uninstall LIMIT=vps-de EXTRA_VARS='hysteria2_uninstall_remove_local_output=true'"
+	@echo "    make uninstall LIMIT=vps-de"
 	@echo ""
 
 init: ## Создать inventory, group_vars и .vault_pass из примеров
@@ -85,7 +85,7 @@ update: check ## Обновить бинарник, перекатить кон
 export: check ## Только перевыпустить URL и QR (без изменений на сервере)
 	$(ANSIBLE) playbook.yml --tags export $(ANSIBLE_OPTS)
 
-uninstall: ## Удалить Hysteria2 с VPS
+uninstall: ## Полностью удалить Hysteria2 с VPS (только uninstall, без install/update)
 	@echo "$(YELLOW)Будет выполнено удаление Hysteria2$(NC) $(if $(LIMIT),на $(LIMIT),на всех серверах)"
 	@read -p "Продолжить? [y/N] " c; [[ "$$c" =~ ^[Yy]$$ ]] || exit 1
 	$(ANSIBLE) playbook-uninstall.yml --tags uninstall $(ANSIBLE_OPTS)

README.md

@@ -42,14 +42,23 @@ git clone https://git.antropoff.ru/DevOpsTools/hysteria2.git
 cd hysteria2
 git checkout main
 
+# macOS: установить Ansible (если ещё нет)
+brew install ansible
+
 make init
-# отредактировать inventory/hosts.yml, group_vars/all.yml, vault
+# отредактировать:
+#   inventory/hosts.yml
+#   group_vars/all.yml
+#   group_vars/hysteria2_servers/vault.yml
+#   group_vars/hysteria2_servers/vars.yml  (проброс vault → роль)
 
 make vault-encrypt
 make ping
 make install    # → output/index.html откроется в браузере
 ```
 
+После `make init` создаются локальные файлы из `.example` (не коммитятся). Пароль vault хранится в `.vault_pass`.
+
 ---
 
 ## Makefile
@@ -57,25 +66,33 @@ make install    # → output/index.html откроется в браузере
 | Команда | Описание |
 |---|---|
 | `make help` | Справка |
-| `make init` | Создать конфиги из `.example` |
+| `make init` | Создать конфиги из `.example` и `.vault_pass` |
+| `make check` | Проверить синтаксис playbook |
 | `make ping` | Проверить SSH к VPS |
 | `make status` | `systemctl status hysteria-server` |
 | `make install` | Установка masquerade + экспорт URL/QR/HTML |
-| `make update` | Обновить бинарник, конфиг, перевыпустить экспорт |
+| `make update` | Обновить бинарник и конфиг; экспорт только для новых/изменённых пользователей |
-| `make export` | Только экспорт (URL, QR, HTML) |
+| `make export` | Только экспорт (URL, QR, HTML) без изменений на сервере |
-| `make uninstall` | Удалить Hysteria2 с VPS |
+| `make uninstall` | Полное удаление с VPS + `output/<server>/` + пересборка `output/index.html` |
-| `make vault-encrypt` | Зашифровать vault |
+| `make vault-init` | Создать `.vault_pass`, включить `vault_password_file` в `ansible.cfg` |
-| `make vault-edit` | Редактировать vault |
+| `make vault-encrypt` | Зашифровать `vault.yml` |
+| `make vault-edit` | Редактировать vault (редактор **nano**, см. `EDITOR` в Makefile) |
+| `make vault-view` | Показать расшифрованный vault |
 
 ```bash
 make install LIMIT=vps-de
+make install LIMIT=vps-nl                    # только новый сервер — старые не трогаются
 make update LIMIT=vps-nl
 make export
-make uninstall LIMIT=vps-de EXTRA_VARS='hysteria2_uninstall_remove_local_output=true'
+make uninstall LIMIT=vps-de
+make update EXTRA_VARS='hysteria2_force_export=true'   # перевыпустить URL/QR для всех
+make install EXTRA_VARS='hysteria2_force_export=true'  # то же при install
 make install EXTRA_VARS='hysteria2_open_browser=false'
 make update EXTRA_VARS='hysteria2_wait_for_acme=false'
 ```
 
+`LIMIT` — имя хоста из `inventory/hosts.yml` (например `vps-de`).
+
 ---
 
 ## Inventory
@@ -189,6 +206,7 @@ vault_hysteria2_user_passwords:
 Подключается через `group_vars/hysteria2_servers/vars.yml`:
 
 ```yaml
+hysteria2_user_passwords: "{{ vault_hysteria2_user_passwords[inventory_hostname] | default({}) }}"
 ```
 
 2. **Per-host в inventory:**
@@ -198,9 +216,89 @@ hysteria2_user_passwords:
   friend: "custom-password"
 ```
 
-3. **Автогенерация** — Ansible `password` lookup (длина `hysteria2_password_length`), если пароль не задан.
+3. **Автогенерация** — Ansible `password` lookup, если пароль не задан ни в inventory/vault, ни в `output/<server>/server-info.yml`.
 
-При `make update` пароли подтягиваются из `output/<server>/server-info.yml`, если не указаны в vault/inventory.
+При `make update` / `make export`:
+- **существующие** пользователи сохраняют пароли из `server-info.yml` (и URL/QR, если домен/порт не менялись);
+- **новые** получают автогенерацию и полный экспорт;
+- **удалённые** из inventory убираются из конфига Hysteria2 и из `output/<server>/`.
+
+Принудительно перевыпустить URL/QR для всех: `hysteria2_force_export: true` (в `group_vars/all.yml` или `EXTRA_VARS`).
+
+```bash
+make install EXTRA_VARS='hysteria2_force_export=true'
+make update LIMIT=vps-de EXTRA_VARS='hysteria2_force_export=true'
+```
+
+### Добавить второй VPS
+
+После `make install` на первом сервере можно добавить ещё один хост в `inventory/hosts.yml`.
+
+**Без `LIMIT`** `make install` пройдёт по **всем** серверам из inventory. На уже установленном пароли и файлы URL/QR **не перегенерируются** (берутся из `output/<server>/server-info.yml`), если вы не меняли его `hysteria2_users`, домен или порт.
+
+Чтобы **не трогать** уже работающий VPS и экспорт:
+
+```bash
+make install LIMIT=новый-сервер
+```
+
+`LIMIT` — имя нового хоста из inventory (например `vps-nl`).
+
+### Добавить / удалить пользователя
+
+1. Отредактируйте `hysteria2_users` в `inventory/hosts.yml` (добавьте имя или уберите).
+2. Запустите `make update LIMIT=<хост>`.
+
+Пароли существующих клиентов **не меняются** (берутся из `output/<server>/server-info.yml`).  
+Новому пользователю генерируется пароль и создаются URL/QR.  
+Удалённый пользователь пропадает из `/etc/hysteria/config.yaml` и из папки `output/<server>/`.
+
+---
+
+## Установка бинарника Hysteria2
+
+Официальный скрипт `install_server.sh` хранится в `roles/hysteria2/files/`.
+
+Перед `make install` / `make update` на **control node** (ваш Mac):
+
+1. Скачивается копия с https://get.hy2.sh/
+2. Сравнивается SHA256 с локальным файлом в роли
+3. При отличии — локальная копия обновляется
+4. Скрипт копируется на VPS и запускается оттуда (без `curl | bash` на сервере)
+
+---
+
+## `make update` — что меняется
+
+| Компонент | Поведение |
+|---|---|
+| Бинарник `hysteria` | Обновляется (`install_server.sh --force`) |
+| `/etc/hysteria/config.yaml` | Перекатывается под текущий inventory |
+| Пароли VPN | Сохраняются для существующих пользователей |
+| URL / QR | Только для новых, изменённых или при `hysteria2_force_export=true` |
+| `apt upgrade` | **Не** выполняется (отключено в Makefile) |
+| Ожидание ACME | **Не** выполняется (`hysteria2_wait_for_acme=false`) |
+
+---
+
+## `make uninstall` — полная очистка
+
+На **VPS** (официальный `install_server.sh --remove` + дочистка Ansible):
+
+- бинарник `/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;
+- пакеты `curl`, `micro`, `qrencode`.
+
+На **control node**:
+
+- удаляется `output/<имя_сервера>/`;
+- пересобирается общий `output/index.html` (сервер убирается из списка; при `LIMIT=...` тоже);
+- если серверов не осталось — `output/index.html` удаляется.
 
 ---
 
@@ -278,13 +376,22 @@ ASCII QR — `hysteria share --qr` → `user.qr.txt`.
 | `hysteria2_domain` | host | Домен с A-записью на IP |
 | `hysteria2_users` | host | Список имён VPN-пользователей |
 | `hysteria2_acme_email` | group | Email для Let's Encrypt |
-| `hysteria2_user_passwords` | host/vault | Свои пароли VPN |
+| `hysteria2_user_passwords` | host/vault | Фиксированные пароли VPN (`vars.yml` + vault) |
-| `hysteria2_output_dir` | group | Папка экспорта (по умолчанию `./output`) |
+| `hysteria2_password_length` | group | Длина автогенерируемого пароля (40) |
-| `hysteria2_output_name` | host | Имя подпапки (по умолчанию `inventory_hostname`) |
+| `hysteria2_force_export` | group | Перегенерировать URL/QR для всех (`false` по умолчанию) |
+| `hysteria2_output_dir` | group | Папка экспорта (`./output`) |
+| `hysteria2_output_name` | host | Подпапка экспорта (`inventory_hostname`) |
 | `hysteria2_listen_port` | group | Порт Hysteria2 (443) |
+| `hysteria2_upgrade_system` | group | `apt upgrade` перед install (`true`) |
+| `hysteria2_configure_firewall` | group | Открыть порты в ufw (`true`) |
 | `hysteria2_generate_qr_png` | group | PNG QR через `qrencode` |
+| `hysteria2_wait_for_acme` | group | Пауза при первом ACME (install) |
 | `hysteria2_open_browser` | group | Открыть `output/index.html` после экспорта |
-| `hysteria2_uninstall_remove_local_output` | extra-vars | Удалить `output/<server>/` при uninstall |
+| `hysteria2_uninstall_rebuild_global_index` | group | Пересобрать `output/index.html` после uninstall (`true`) |
+| `vault_ssh_passwords` | vault | SSH-пароли root по имени хоста |
+| `vault_hysteria2_user_passwords` | vault | VPN-пароли по серверам |
+
+Полный список defaults: `roles/hysteria2/defaults/main.yml`, `defaults/uninstall.yml`.
 
 ---
 
@@ -298,10 +405,11 @@ ASCII QR — `hysteria share --qr` → `user.qr.txt`.
 
 ## Требования
 
-- Ansible 2.14+
+- **Control node:** macOS или Linux с Ansible **2.14+** (`brew install ansible` на Mac)
-- Debian/Ubuntu VPS с sudo
+- **VPS:** Debian/Ubuntu с sudo
 - Домен с A-записью на IP сервера
-- Для авто-открытия браузера: macOS или Linux с `xdg-open`
+- Порты **80/tcp** и **443/tcp+udp** доступны с интернета (ветка `main`)
+- Для авто-открытия браузера: macOS (`open`) или Linux (`xdg-open`)
 
 ---
 
@@ -309,11 +417,25 @@ ASCII QR — `hysteria share --qr` → `user.qr.txt`.
 
 ```
 roles/hysteria2/
+├── defaults/
+│   ├── main.yml              ← основные переменные
+│   └── uninstall.yml         ← переменные удаления
+├── files/
+│   └── install_server.sh     ← официальный скрипт (синхронизация с get.hy2.sh)
 ├── tasks/
-│   ├── install.yml       ← пакеты, hysteria, qrencode
+│   ├── main.yml              ← порядок задач и теги
-│   ├── configure.yml     ← masquerade + ACME + firewall
+│   ├── validate.yml
+│   ├── users.yml             ← пароли (inventory / vault / server-info.yml)
+│   ├── sync_install_script.yml
+│   ├── install.yml           ← пакеты, бинарник
+│   ├── configure.yml         ← masquerade + ACME + ufw
+│   ├── update.yml            ← обновление бинарника
+│   ├── export_prepare.yml    ← инкрементальный экспорт
 │   ├── export.yml            ← URL, QR, HTML сервера
-│   └── export_global.yml ← общий output/index.html
+│   ├── export_global.yml     ← общий output/index.html
+│   ├── share_user.yml
+│   ├── reuse_export_user.yml
+│   └── uninstall.yml
 └── templates/
     ├── config.yaml.j2        ← acme http + masquerade file
     ├── client.yaml.j2

group_vars/hysteria2_servers/vars.yml.example

@@ -3,3 +3,4 @@
 # Файл group_vars/hysteria2_servers/vault.yml должен быть зашифрован (make vault-encrypt).
 
 # Проброс VPN-паролей из vault в переменные роли (опционально)
+hysteria2_user_passwords: "{{ vault_hysteria2_user_passwords[inventory_hostname] | default({}) }}"

playbook-uninstall.yml

@@ -2,6 +2,27 @@
 - name: Uninstall Hysteria2 servers
   hosts: hysteria2_servers
   gather_facts: false
-  roles:
-    - role: hysteria2
   tags: [uninstall]
+  tasks:
+    - name: Run Hysteria2 uninstall tasks only
+      ansible.builtin.include_role:
+        name: hysteria2
+        tasks_from: uninstall.yml
+
+- name: Rebuild global output index after uninstall
+  hosts: hysteria2_servers
+  gather_facts: false
+  tags: [uninstall]
+  tasks:
+    - name: Regenerate output/index.html without removed server
+      block:
+        - name: Run global export tasks
+          ansible.builtin.include_role:
+            name: hysteria2
+            tasks_from: export_global.yml
+      vars:
+        hysteria2_open_browser: false
+      run_once: true
+      delegate_to: localhost
+      become: false
+      when: hysteria2_uninstall_rebuild_global_index | default(true) | bool

playbook.yml

@@ -9,6 +9,7 @@
   hosts: localhost
   connection: local
   gather_facts: true
+  become: false
   tags: [install, update, export]
   tasks:
     - name: Generate global index.html and open in browser

roles/hysteria2/defaults/main.yml

@@ -20,6 +20,12 @@ hysteria2_masq_dir: /var/www/masq
 hysteria2_config_path: /etc/hysteria/config.yaml
 hysteria2_service_name: hysteria-server
 
+# Официальный install_server.sh: хранится в roles/hysteria2/files/, синхронизируется с get.hy2.sh
+hysteria2_install_script_url: "https://get.hy2.sh/"
+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 }}"
@@ -36,7 +42,14 @@ hysteria2_wait_for_acme: true
 # Открыть output/index.html в браузере после install/update/export
 hysteria2_open_browser: true
 
-# --- uninstall ---
+# Перегенерировать URL/QR для всех пользователей (иначе — только новые/изменённые)
-hysteria2_uninstall_remove_config: true
+hysteria2_force_export: false
+
+# --- uninstall (см. также defaults/uninstall.yml) ---
+hysteria2_system_user: hysteria
 hysteria2_uninstall_remove_masq: true
-hysteria2_uninstall_remove_local_output: false
+hysteria2_uninstall_rebuild_global_index: true
+hysteria2_uninstall_ufw_rules:
+  - 80/tcp
+  - 443/tcp
+  - 443/udp

roles/hysteria2/defaults/uninstall.yml

@@ -0,0 +1,12 @@
+---
+# Системный пользователь Hysteria (создаётся install_server.sh)
+hysteria2_system_user: hysteria
+
+# --- uninstall ---
+# install_server.sh --remove: бинарник + systemd; остальное — задачи uninstall.yml
+hysteria2_uninstall_remove_masq: true
+hysteria2_uninstall_rebuild_global_index: true
+hysteria2_uninstall_ufw_rules:
+  - 80/tcp
+  - 443/tcp
+  - 443/udp

roles/hysteria2/tasks/export.yml

@@ -11,16 +11,28 @@
   ansible.builtin.set_fact:
     hysteria2_export_users: []
 
+- name: Prepare incremental export (remove deleted users, split new vs existing)
+  ansible.builtin.import_tasks: export_prepare.yml
+
 - name: Install qrencode on server for PNG QR export
   ansible.builtin.apt:
     name: qrencode
     state: present
     update_cache: false
-  when: hysteria2_generate_qr_png | bool
+  when:
+    - hysteria2_generate_qr_png | bool
+    - hysteria2_users_for_export | default([]) | length > 0
 
-- name: Build client share data for each user
+- name: Reuse existing export data for unchanged users
+  ansible.builtin.include_tasks: reuse_export_user.yml
+  loop: "{{ hysteria2_users_for_reuse | default([]) }}"
+  loop_control:
+    loop_var: hysteria2_reuse_user
+    label: "{{ hysteria2_reuse_user.name }}"
+
+- name: Build client share data for new or changed users
   ansible.builtin.include_tasks: share_user.yml
-  loop: "{{ hysteria2_resolved_users }}"
+  loop: "{{ hysteria2_users_for_export | default([]) }}"
   loop_control:
     loop_var: hysteria2_current_user
     label: "{{ hysteria2_current_user.name }}"
@@ -52,12 +64,14 @@
     dest: "{{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/index.html"
     mode: "0644"
   vars:
-    generated_at: "{{ ansible_date_time.date }} {{ ansible_date_time.time }}"
+    generated_at: "{{ now(utc=false, fmt='%Y-%m-%d %H:%M:%S') }}"
   delegate_to: localhost
   become: false
 
 - name: Show export location
   ansible.builtin.debug:
     msg: >-
-      Клиентские URL, QR и index.html сохранены в
+      Экспорт: {{ hysteria2_users_for_export | default([]) | length }} пользователь(ей) обновлено,
-      {{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/
+      {{ hysteria2_users_for_reuse | default([]) | length }} без изменений,
+      {{ _hysteria2_removed_users | default([]) | length }} удалено.
+      Каталог: {{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/

roles/hysteria2/tasks/export_global.yml

@@ -49,18 +49,25 @@
     dest: "{{ hysteria2_output_dir }}/index.html"
     mode: "0644"
   vars:
-    generated_at: "{{ ansible_date_time.date }} {{ ansible_date_time.time }}"
+    generated_at: "{{ now(utc=false, fmt='%Y-%m-%d %H:%M:%S') }}"
     total_users: "{{ hysteria2_global_servers | map(attribute='users') | map('length') | sum }}"
   when: hysteria2_global_servers | default([]) | length > 0
   become: false
 
+- name: Remove global HTML index when no servers remain
+  ansible.builtin.file:
+    path: "{{ hysteria2_output_dir }}/index.html"
+    state: absent
+  when: hysteria2_global_servers | default([]) | length == 0
+  become: false
+
 - name: Open global index in default browser (macOS)
   ansible.builtin.command:
     cmd: open "{{ hysteria2_output_dir }}/index.html"
   when:
     - hysteria2_open_browser | bool
     - hysteria2_global_servers | default([]) | length > 0
-    - ansible_system == 'Darwin'
+    - ansible_facts['system'] == 'Darwin'
   changed_when: false
   become: false
 
@@ -70,7 +77,7 @@
   when:
     - hysteria2_open_browser | bool
     - hysteria2_global_servers | default([]) | length > 0
-    - ansible_system == 'Linux'
+    - ansible_facts['system'] == 'Linux'
   changed_when: false
   become: false
   failed_when: false
@@ -85,6 +92,6 @@
 
 - name: Skip global index when no servers exported
   ansible.builtin.debug:
-    msg: "Глобальный index.html не создан — нет server-info.yml в {{ hysteria2_output_dir }}/"
+    msg: "Глобальный {{ hysteria2_output_dir }}/index.html удалён — нет server-info.yml в output/"
   when: hysteria2_global_servers | default([]) | length == 0
   become: false

roles/hysteria2/tasks/export_prepare.yml

@@ -0,0 +1,84 @@
+---
+- name: Determine removed users from previous export
+  ansible.builtin.set_fact:
+    _hysteria2_removed_users: >-
+      {{
+        (_hysteria2_saved_server_info.users | default([]) | map(attribute='name') | list)
+        | difference(hysteria2_resolved_users | map(attribute='name') | list)
+      }}
+  delegate_to: localhost
+  become: false
+
+- name: Build list of export files to remove for deleted users
+  ansible.builtin.set_fact:
+    _hysteria2_removed_user_files: >-
+      {{
+        _hysteria2_removed_user_files | default([]) + [
+          hysteria2_output_dir ~ '/' ~ hysteria2_output_name ~ '/' ~ item.0 ~ item.1
+        ]
+      }}
+  loop: "{{ _hysteria2_removed_users | default([]) | product(_hysteria2_user_export_suffixes) | list }}"
+  vars:
+    _hysteria2_user_export_suffixes:
+      - ".url"
+      - ".txt"
+      - ".qr.txt"
+      - ".png"
+  when: _hysteria2_removed_users | default([]) | length > 0
+  delegate_to: localhost
+  become: false
+
+- name: Remove export files for deleted users
+  ansible.builtin.file:
+    path: "{{ item }}"
+    state: absent
+  loop: "{{ _hysteria2_removed_user_files | default([]) }}"
+  delegate_to: localhost
+  become: false
+  when: _hysteria2_removed_user_files | default([]) | length > 0
+
+- name: Check local URL files for resolved users
+  ansible.builtin.stat:
+    path: "{{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/{{ item.name }}.url"
+  loop: "{{ hysteria2_resolved_users }}"
+  register: _hysteria2_url_file_stats
+  delegate_to: localhost
+  become: false
+
+- name: Split users into full export and reuse existing export data
+  ansible.builtin.set_fact:
+    hysteria2_users_for_export: "{{ hysteria2_users_for_export | default([]) + ([item] if _needs_export else []) }}"
+    hysteria2_users_for_reuse: "{{ hysteria2_users_for_reuse | default([]) + ([_reuse_entry] if not _needs_export else []) }}"
+  loop: "{{ hysteria2_resolved_users }}"
+  loop_control:
+    label: "{{ item.name }}"
+  vars:
+    _saved_user: >-
+      {{
+        (_hysteria2_saved_server_info.users | default([])
+        | selectattr('name', 'equalto', item.name)
+        | list | first) | default({}, true)
+      }}
+    _url_stat: >-
+      {{
+        ((_hysteria2_url_file_stats.results
+        | selectattr('item.name', 'equalto', item.name)
+        | list | first).stat) | default({}, true)
+      }}
+    _needs_export: >-
+      {{
+        hysteria2_force_export | bool
+        or (_saved_user | length == 0)
+        or (item.password != (_saved_user.password | default('')))
+        or (hysteria2_domain != (_hysteria2_saved_server_info.domain | default('')))
+        or ((hysteria2_listen_port | string) != (_hysteria2_saved_server_info.port | default('') | string))
+        or ((hysteria2_obfs_password | default('')) != (_hysteria2_saved_server_info.obfs_password | default('')))
+        or not (_url_stat.exists | default(false))
+      }}
+    _reuse_entry:
+      name: "{{ item.name }}"
+      password: "{{ item.password }}"
+      url: "{{ _saved_user.url }}"
+      has_png: "{{ _saved_user.has_png | default(false) | bool }}"
+  delegate_to: localhost
+  become: false

roles/hysteria2/tasks/install.yml

@@ -23,11 +23,18 @@
         + (['qrencode'] if hysteria2_generate_qr_png | bool else [])
       }}
 
+- name: Sync official Hysteria2 install script on control node
+  ansible.builtin.import_tasks: sync_install_script.yml
+
+- name: Copy Hysteria2 install script to server
+  ansible.builtin.copy:
+    src: "{{ hysteria2_install_script_name }}"
+    dest: "{{ hysteria2_install_script_remote_path }}"
+    mode: "0755"
+
 - name: Install Hysteria2 via official script
-  ansible.builtin.shell:
+  ansible.builtin.command:
-    cmd: bash <(curl -fsSL https://get.hy2.sh/)
+    cmd: "{{ hysteria2_install_script_remote_path }}"
-    executable: /bin/bash
-  args:
     creates: /usr/local/bin/hysteria
   register: _hysteria2_install
 

roles/hysteria2/tasks/reuse_export_user.yml

@@ -0,0 +1,4 @@
+---
+- name: Register reused export data for HTML page
+  ansible.builtin.set_fact:
+    hysteria2_export_users: "{{ hysteria2_export_users | default([]) + [hysteria2_reuse_user] }}"

roles/hysteria2/tasks/sync_install_script.yml

@@ -0,0 +1,109 @@
+---
+- name: Ensure staging directory for install script sync
+  ansible.builtin.file:
+    path: "{{ hysteria2_install_script_staging_dir }}"
+    state: directory
+    mode: "0700"
+  delegate_to: localhost
+  become: false
+  run_once: true
+
+- name: Fetch official install script for version check
+  ansible.builtin.get_url:
+    url: "{{ hysteria2_install_script_url }}"
+    dest: "{{ hysteria2_install_script_staging_dir }}/{{ hysteria2_install_script_name }}.remote"
+    mode: "0644"
+    force: true
+    timeout: 30
+  delegate_to: localhost
+  become: false
+  run_once: true
+  register: _hysteria2_remote_script
+  failed_when: false
+
+- name: Record install script fetch result
+  ansible.builtin.set_fact:
+    _hysteria2_script_fetch_ok: "{{ not (_hysteria2_remote_script.failed | default(false)) }}"
+  delegate_to: localhost
+  become: false
+  run_once: true
+
+- name: Stat local install script in role files
+  ansible.builtin.stat:
+    path: "{{ role_path }}/files/{{ hysteria2_install_script_name }}"
+    checksum_algorithm: sha256
+  delegate_to: localhost
+  become: false
+  run_once: true
+  register: _hysteria2_local_script
+
+- name: Stat remote install script from official server
+  ansible.builtin.stat:
+    path: "{{ hysteria2_install_script_staging_dir }}/{{ hysteria2_install_script_name }}.remote"
+    checksum_algorithm: sha256
+  delegate_to: localhost
+  become: false
+  run_once: true
+  register: _hysteria2_remote_script_stat
+  when: _hysteria2_script_fetch_ok | bool
+
+- name: Update bundled install script when official version is newer
+  ansible.builtin.copy:
+    src: "{{ hysteria2_install_script_staging_dir }}/{{ hysteria2_install_script_name }}.remote"
+    dest: "{{ role_path }}/files/{{ hysteria2_install_script_name }}"
+    mode: "0755"
+  delegate_to: localhost
+  become: false
+  run_once: true
+  when:
+    - _hysteria2_script_fetch_ok | bool
+    - >-
+      not _hysteria2_local_script.stat.exists
+      or _hysteria2_local_script.stat.checksum
+         != _hysteria2_remote_script_stat.stat.checksum
+  register: _hysteria2_script_updated
+
+- name: Fail when bundled install script is missing and official fetch failed
+  ansible.builtin.fail:
+    msg: >-
+      Не удалось скачать {{ hysteria2_install_script_url }}
+      ({{ _hysteria2_remote_script.msg | default('сеть недоступна') }})
+      и локальный roles/hysteria2/files/{{ hysteria2_install_script_name }} отсутствует.
+  delegate_to: localhost
+  become: false
+  run_once: true
+  when:
+    - not _hysteria2_script_fetch_ok | bool
+    - not _hysteria2_local_script.stat.exists
+
+- name: Report install script sync skipped due to network error
+  ansible.builtin.debug:
+    msg: >-
+      Пропуск синхронизации с {{ hysteria2_install_script_url }}:
+      {{ _hysteria2_remote_script.msg | default('сеть недоступна') }}.
+      Используется локальный roles/hysteria2/files/{{ hysteria2_install_script_name }}.
+  delegate_to: localhost
+  become: false
+  run_once: true
+  when: not _hysteria2_script_fetch_ok | bool
+
+- name: Report install script updated from official server
+  ansible.builtin.debug:
+    msg: Официальный install_server.sh обновлён в roles/hysteria2/files/
+  delegate_to: localhost
+  become: false
+  run_once: true
+  when:
+    - _hysteria2_script_fetch_ok | bool
+    - _hysteria2_script_updated.changed | default(false)
+
+- name: Report install script already up to date
+  ansible.builtin.debug:
+    msg: >-
+      Локальный install_server.sh актуален (совпадает с {{ hysteria2_install_script_url }}).
+  delegate_to: localhost
+  become: false
+  run_once: true
+  when:
+    - _hysteria2_script_fetch_ok | bool
+    - not (_hysteria2_script_updated.changed | default(false))

roles/hysteria2/tasks/uninstall.yml

@@ -1,46 +1,137 @@
 ---
-- name: Stop and disable hysteria-server
+- name: Stop and disable hysteria-server before removal
   ansible.builtin.systemd:
     name: "{{ hysteria2_service_name }}"
     enabled: false
     state: stopped
   failed_when: false
 
-- name: Remove Hysteria2 via official script
+- name: Copy Hysteria2 install script to server
-  ansible.builtin.shell:
+  ansible.builtin.copy:
-    cmd: bash <(curl -fsSL https://get.hy2.sh/) --remove
+    src: "{{ hysteria2_install_script_name }}"
-    executable: /bin/bash
+    dest: "{{ hysteria2_install_script_remote_path }}"
+    mode: "0755"
+
+- name: Remove Hysteria2 binary and systemd units via official script
+  ansible.builtin.command:
+    cmd: "{{ hysteria2_install_script_remote_path }} --remove"
   register: _hysteria2_remove
+  changed_when: _hysteria2_remove.rc == 0
   failed_when: false
 
-- name: Remove Hysteria2 configuration directory
+- name: Show official script removal output
+  ansible.builtin.debug:
+    msg: "{{ _hysteria2_remove.stdout_lines | default(['install_server.sh --remove: no output']) }}"
+  when: _hysteria2_remove.stdout_lines is defined
+
+- name: Remove Hysteria2 configuration and ACME data
   ansible.builtin.file:
-    path: "{{ hysteria2_config_path | dirname }}"
+    path: "{{ item }}"
     state: absent
-  when: hysteria2_uninstall_remove_config | bool
+  loop:
+    - "{{ 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 | bool
+  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
+    state: absent
+  failed_when: false
+
+- name: Find enabled hysteria-server@ systemd symlinks
+  ansible.builtin.find:
+    paths: /etc/systemd/system/multi-user.target.wants
+    patterns: hysteria-server@*.service
+    file_type: file
+  register: _hysteria2_systemd_instance_wants
+  failed_when: false
+
+- name: Remove enabled hysteria-server@ systemd symlinks
+  ansible.builtin.file:
+    path: "{{ item.path }}"
+    state: absent
+  loop: "{{ _hysteria2_systemd_instance_wants.files | default([]) }}"
+  failed_when: false
+
+- name: Remove Hysteria system user and home directory
+  ansible.builtin.user:
+    name: "{{ hysteria2_system_user | default('hysteria') }}"
+    state: absent
+    remove: true
+  failed_when: false
+
+- name: Find temporary Hysteria client configs on server
+  ansible.builtin.find:
+    paths: /tmp
+    patterns: hysteria-client-*.yaml
+    file_type: file
+  register: _hysteria2_tmp_client_configs
+  failed_when: false
+
+- name: Remove temporary Hysteria client configs on server
+  ansible.builtin.file:
+    path: "{{ item.path }}"
+    state: absent
+  loop: "{{ _hysteria2_tmp_client_configs.files | default([]) }}"
+  failed_when: false
+
+- name: Check if ufw is available and active
+  ansible.builtin.command: ufw status
+  register: _hysteria2_ufw_status
+  changed_when: false
+  failed_when: false
+
+- name: Remove firewall rules added during install
+  ansible.builtin.command: "ufw delete allow {{ item }}"
+  loop: "{{ hysteria2_uninstall_ufw_rules }}"
+  register: _hysteria2_ufw_delete
+  changed_when: >-
+    _hysteria2_ufw_delete.rc == 0
+    and 'Could not delete' not in (_hysteria2_ufw_delete.stdout | default(''))
+    and 'Could not find' not in (_hysteria2_ufw_delete.stderr | default(''))
+  failed_when: false
+  when: "'active' in (_hysteria2_ufw_status.stdout | default(''))"
+
+- name: Remove packages installed for Hysteria2
+  ansible.builtin.apt:
+    name: "{{ _hysteria2_apt_packages }}"
+    state: absent
+    purge: true
+    autoremove: true
+  vars:
+    _hysteria2_apt_packages: >-
+      {{
+        ['curl', 'micro']
+        + (['qrencode'] if hysteria2_generate_qr_png | default(true) | bool else [])
+      }}
+
+- name: Remove copied install script from server
+  ansible.builtin.file:
+    path: "{{ hysteria2_install_script_remote_path }}"
+    state: absent
 
 - name: Reload systemd after uninstall
   ansible.builtin.systemd:
     daemon_reload: true
 
-- name: Show uninstall result
+- name: Remove local output directory for this server
-  ansible.builtin.debug:
-    msg: >-
-      Hysteria2 удалён с {{ inventory_hostname }}.
-      {% if not hysteria2_uninstall_remove_local_output | bool %}
-      Локальные URL/QR в {{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/ сохранены.
-      {% endif %}
-
-- name: Remove local exported client files
   ansible.builtin.file:
     path: "{{ hysteria2_output_dir }}/{{ hysteria2_output_name }}"
     state: absent
   delegate_to: localhost
   become: false
-  when: hysteria2_uninstall_remove_local_output | bool
+
+- name: Show uninstall result
+  ansible.builtin.debug:
+    msg: >-
+      Hysteria2 полностью удалён с {{ inventory_hostname }}.
+      Локальная папка {{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/ удалена.
+      {% if hysteria2_uninstall_rebuild_global_index | default(true) | bool %}
+      {{ hysteria2_output_dir }}/index.html будет пересобран без этого сервера.
+      {% endif %}

roles/hysteria2/tasks/update.yml

@@ -1,8 +1,16 @@
 ---
+- name: Sync official Hysteria2 install script on control node
+  ansible.builtin.import_tasks: sync_install_script.yml
+
+- name: Copy Hysteria2 install script to server
+  ansible.builtin.copy:
+    src: "{{ hysteria2_install_script_name }}"
+    dest: "{{ hysteria2_install_script_remote_path }}"
+    mode: "0755"
+
 - name: Update Hysteria2 binary via official script
-  ansible.builtin.shell:
+  ansible.builtin.command:
-    cmd: bash <(curl -fsSL https://get.hy2.sh/)
+    cmd: "{{ hysteria2_install_script_remote_path }} --force"
-    executable: /bin/bash
   register: _hysteria2_update
   notify: Restart hysteria-server
 

roles/hysteria2/tasks/users.yml

@@ -10,6 +10,16 @@
     - update
     - export
 
+- name: Initialize empty saved export metadata
+  ansible.builtin.set_fact:
+    _hysteria2_saved_passwords: {}
+    _hysteria2_saved_server_info: {}
+  when: not _hysteria2_saved_info.stat.exists
+  tags:
+    - install
+    - update
+    - export
+
 - name: Load saved user passwords from local export
   when: _hysteria2_saved_info.stat.exists
   block:
@@ -20,8 +30,9 @@
       delegate_to: localhost
       become: false
 
-    - name: Parse saved passwords into lookup dict
+    - name: Parse saved export metadata
       ansible.builtin.set_fact:
+        _hysteria2_saved_server_info: "{{ _hysteria2_saved_info_raw.content | b64decode | from_yaml }}"
         _hysteria2_saved_passwords: >-
           {{
             dict(
@@ -33,12 +44,14 @@
                 )
             )
           }}
+      delegate_to: localhost
+      become: false
   tags:
     - install
     - update
     - export
 
-- name: Resolve user list with optional fixed passwords
+- name: Resolve user list with passwords from inventory, vault and previous export
   ansible.builtin.set_fact:
     hysteria2_resolved_users: "{{ hysteria2_resolved_users | default([]) + [ _entry ] }}"
   vars:
@@ -46,8 +59,26 @@
     _password: >-
       {{
         (
-          item.password if item is mapping
+          item.password
-        ) | default('', true)
+          if item is mapping and (item.password | default('') | length > 0)
+          else none
+        )
+        | default(
+            hysteria2_user_passwords[_username]
+            if (
+              hysteria2_user_passwords is defined
+              and (hysteria2_user_passwords[_username] | default('') | length > 0)
+            )
+            else none,
+            true
+          )
+        | default(
+            _hysteria2_saved_passwords[_username]
+            if (_hysteria2_saved_passwords[_username] | default('') | length > 0)
+            else none,
+            true
+          )
+        | default('', true)
       }}
     _entry:
       name: "{{ _username }}"