Compare commits
6 Commits
main
..
b9284f280f
| Author | SHA1 | Date | |
|---|---|---|---|
 Sergey Antropoff
|
b9284f280f | ||
|
Sergey Antropoff
|
b83b69d309 | ||
|
Sergey Antropoff
|
4242093ca1 | ||
|
Sergey Antropoff
|
e3d3103dc2 | ||
|
Sergey Antropoff
|
63b21d5df6 | ||
|
Sergey Antropoff
|
0aec9e6e54 |
@@ -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"
|
||||
@echo " make uninstall LIMIT=vps-de EXTRA_VARS='hysteria2_uninstall_remove_local_output=true'"
|
||||
@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, без install/update)
|
||||
uninstall: ## Удалить Hysteria2 с VPS
|
||||
@echo "$(YELLOW)Будет выполнено удаление Hysteria2$(NC) $(if $(LIMIT),на $(LIMIT),на всех серверах)"
|
||||
@read -p "Продолжить? [y/N] " c; [[ "$$c" =~ ^[Yy]$$ ]] || exit 1
|
||||
$(ANSIBLE) playbook-uninstall.yml --tags uninstall $(ANSIBLE_OPTS)
|
||||
|
||||
@@ -1,16 +1,16 @@
|
||||
# Hysteria2 Ansible — ветка **main**
|
||||
# Hysteria2 Ansible — ветка **Salamander**
|
||||
|
||||
> **Ветка:** `main`
|
||||
> **Режим:** **masquerade** — маскировка под HTTPS-сайт nginx
|
||||
> **Альтернатива:** [`salamander`](https://git.antropoff.ru/DevOpsTools/hysteria2/src/branch/salamander) — обфускация Salamander для агрессивного DPI
|
||||
> **Ветка:** `salamander`
|
||||
> **Режим:** **Salamander obfs** — запутывание пакетов для обхода 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,25 +39,16 @@ Ansible-роль для установки [Hysteria 2](https://v2.hysteria.netw
|
||||
```bash
|
||||
git clone https://git.antropoff.ru/DevOpsTools/hysteria2.git
|
||||
cd hysteria2
|
||||
git checkout main
|
||||
|
||||
# macOS: установить Ansible (если ещё нет)
|
||||
brew install ansible
|
||||
git checkout salamander
|
||||
|
||||
make init
|
||||
# отредактировать:
|
||||
# inventory/hosts.yml
|
||||
# group_vars/all.yml
|
||||
# group_vars/hysteria2_servers/vault.yml
|
||||
# group_vars/hysteria2_servers/vars.yml (проброс vault → роль)
|
||||
# отредактировать inventory/hosts.yml, group_vars/all.yml, vault
|
||||
|
||||
make vault-encrypt
|
||||
make ping
|
||||
make install # → output/index.html откроется в браузере
|
||||
```
|
||||
|
||||
После `make init` создаются локальные файлы из `.example` (не коммитятся). Пароль vault хранится в `.vault_pass`.
|
||||
|
||||
---
|
||||
|
||||
## Makefile
|
||||
@@ -66,33 +56,25 @@ make install # → output/index.html откроется в браузере
|
||||
| Команда | Описание |
|
||||
|---|---|
|
||||
| `make help` | Справка |
|
||||
| `make init` | Создать конфиги из `.example` и `.vault_pass` |
|
||||
| `make check` | Проверить синтаксис playbook |
|
||||
| `make init` | Создать конфиги из `.example` |
|
||||
| `make ping` | Проверить SSH к VPS |
|
||||
| `make status` | `systemctl status hysteria-server` |
|
||||
| `make install` | Установка masquerade + экспорт URL/QR/HTML |
|
||||
| `make update` | Обновить бинарник и конфиг; экспорт только для новых/изменённых пользователей |
|
||||
| `make export` | Только экспорт (URL, QR, HTML) без изменений на сервере |
|
||||
| `make uninstall` | Полное удаление с VPS + `output/<server>/` + пересборка `output/index.html` |
|
||||
| `make vault-init` | Создать `.vault_pass`, включить `vault_password_file` в `ansible.cfg` |
|
||||
| `make vault-encrypt` | Зашифровать `vault.yml` |
|
||||
| `make vault-edit` | Редактировать vault (редактор **nano**, см. `EDITOR` в Makefile) |
|
||||
| `make vault-view` | Показать расшифрованный vault |
|
||||
| `make install` | Установка Salamander + экспорт URL/QR/HTML |
|
||||
| `make update` | Обновить бинарник, конфиг, перевыпустить экспорт |
|
||||
| `make export` | Только экспорт (URL, QR, HTML) |
|
||||
| `make uninstall` | Удалить Hysteria2 с VPS |
|
||||
| `make vault-encrypt` | Зашифровать vault |
|
||||
| `make vault-edit` | Редактировать vault |
|
||||
|
||||
```bash
|
||||
make install LIMIT=vps-de
|
||||
make install LIMIT=vps-nl # только новый сервер — старые не трогаются
|
||||
make update LIMIT=vps-nl
|
||||
make export
|
||||
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 uninstall LIMIT=vps-de EXTRA_VARS='hysteria2_uninstall_remove_local_output=true'
|
||||
make install EXTRA_VARS='hysteria2_open_browser=false'
|
||||
make update EXTRA_VARS='hysteria2_wait_for_acme=false'
|
||||
```
|
||||
|
||||
`LIMIT` — имя хоста из `inventory/hosts.yml` (например `vps-de`).
|
||||
|
||||
---
|
||||
|
||||
## Inventory
|
||||
@@ -107,7 +89,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 +125,7 @@ vault_ssh_passwords:
|
||||
|
||||
---
|
||||
|
||||
## Как работает masquerade в этом проекте
|
||||
## Как работает Salamander в этом проекте
|
||||
|
||||
### Сервер (`/etc/hysteria/config.yaml`)
|
||||
|
||||
@@ -151,7 +133,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 +144,36 @@ auth:
|
||||
my: "..."
|
||||
friend: "..."
|
||||
|
||||
masquerade:
|
||||
type: file
|
||||
file:
|
||||
dir: /var/www/masq
|
||||
listenHTTP: :80
|
||||
listenHTTPS: :443
|
||||
forceHTTPS: true
|
||||
obfs:
|
||||
type: salamander
|
||||
salamander:
|
||||
password: "общий_obfs_пароль_сервера"
|
||||
```
|
||||
|
||||
### Сайт-заглушка
|
||||
|
||||
В `/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 (рекомендуется):**
|
||||
|
||||
@@ -206,7 +186,6 @@ 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:**
|
||||
@@ -216,89 +195,28 @@ hysteria2_user_passwords:
|
||||
friend: "custom-password"
|
||||
```
|
||||
|
||||
3. **Автогенерация** — Ansible `password` lookup, если пароль не задан ни в inventory/vault, ни в `output/<server>/server-info.yml`.
|
||||
3. **Автогенерация** — Ansible `password` lookup (длина `hysteria2_password_length`), если пароль не задан.
|
||||
|
||||
При `make update` / `make export`:
|
||||
- **существующие** пользователи сохраняют пароли из `server-info.yml` (и URL/QR, если домен/порт не менялись);
|
||||
- **новые** получают автогенерацию и полный экспорт;
|
||||
- **удалённые** из inventory убираются из конфига Hysteria2 и из `output/<server>/`.
|
||||
При `make update` пароли подтягиваются из `output/<server>/server-info.yml`, если не указаны в vault/inventory.
|
||||
|
||||
Принудительно перевыпустить URL/QR для всех: `hysteria2_force_export: true` (в `group_vars/all.yml` или `EXTRA_VARS`).
|
||||
### Salamander obfs (один на сервер)
|
||||
|
||||
```bash
|
||||
make install EXTRA_VARS='hysteria2_force_export=true'
|
||||
make update LIMIT=vps-de EXTRA_VARS='hysteria2_force_export=true'
|
||||
1. **Vault (рекомендуется):**
|
||||
|
||||
```yaml
|
||||
vault_hysteria2_obfs_passwords:
|
||||
vps-de: "cry_me_a_r1ver_salamander_obfs"
|
||||
```
|
||||
|
||||
### Добавить второй VPS
|
||||
Подключается через `group_vars/hysteria2_servers/vars.yml`:
|
||||
|
||||
После `make install` на первом сервере можно добавить ещё один хост в `inventory/hosts.yml`.
|
||||
|
||||
**Без `LIMIT`** `make install` пройдёт по **всем** серверам из inventory. На уже установленном пароли и файлы URL/QR **не перегенерируются** (берутся из `output/<server>/server-info.yml`), если вы не меняли его `hysteria2_users`, домен или порт.
|
||||
|
||||
Чтобы **не трогать** уже работающий VPS и экспорт:
|
||||
|
||||
```bash
|
||||
make install LIMIT=новый-сервер
|
||||
```yaml
|
||||
```
|
||||
|
||||
`LIMIT` — имя нового хоста из inventory (например `vps-nl`).
|
||||
2. **Авто:** Ansible `password` lookup (`hysteria2_obfs_password_length`) при первой установке
|
||||
3. **При update:** загружается из `output/<server>/server-info.yml`
|
||||
|
||||
### Добавить / удалить пользователя
|
||||
|
||||
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` удаляется.
|
||||
> **Важно:** obfs-пароль на сервере и клиенте должен **совпадать**. При `make update` без vault пароль сохраняется из предыдущего экспорта.
|
||||
|
||||
---
|
||||
|
||||
@@ -308,11 +226,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 +239,12 @@ make install LIMIT=новый-сервер
|
||||
|
||||
## Firewall
|
||||
|
||||
По умолчанию открываются:
|
||||
По умолчанию открываются только порты Hysteria2:
|
||||
|
||||
- **80/tcp** — ACME HTTP + masquerade HTTP
|
||||
- **443/tcp** — HTTPS masquerade
|
||||
- **443/udp** — Hysteria2
|
||||
- **443/tcp**
|
||||
- **443/udp**
|
||||
|
||||
**Порт 80 не используется** — в отличие от ветки `main`.
|
||||
|
||||
---
|
||||
|
||||
@@ -335,19 +254,20 @@ make install LIMIT=новый-сервер
|
||||
output/
|
||||
├── index.html ← все серверы (открывается в браузере)
|
||||
├── vps-de/
|
||||
│ ├── index.html ← страница сервера
|
||||
│ ├── my.url
|
||||
│ ├── index.html ← страница сервера + obfs-пароль
|
||||
│ ├── 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,43 +293,38 @@ 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 (`vars.yml` + vault) |
|
||||
| `hysteria2_password_length` | group | Длина автогенерируемого пароля (40) |
|
||||
| `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_mode` | defaults | `salamander` (информативно) |
|
||||
| `hysteria2_domain` | host | Домен для TLS/SNI/ACME |
|
||||
| `hysteria2_users` | host | VPN-пользователи |
|
||||
| `hysteria2_acme_email` | group | Email Let's Encrypt |
|
||||
| `hysteria2_user_passwords` | host/vault | Свои пароли VPN |
|
||||
| `hysteria2_obfs_password` | host/vault | Пароль Salamander (или авто) |
|
||||
| `hysteria2_obfs_password_length` | group | Длина автопароля obfs (32) |
|
||||
| `hysteria2_output_dir` | group | Папка экспорта (по умолчанию `./output`) |
|
||||
| `hysteria2_listen_port` | group | Порт (443) |
|
||||
| `hysteria2_generate_qr_png` | group | PNG QR через `qrencode` |
|
||||
| `hysteria2_wait_for_acme` | group | Пауза при первом ACME (install) |
|
||||
| `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_hysteria2_user_passwords` | vault | VPN-пароли по серверам |
|
||||
|
||||
Полный список defaults: `roles/hysteria2/defaults/main.yml`, `defaults/uninstall.yml`.
|
||||
| `hysteria2_uninstall_remove_local_output` | extra-vars | Удалить `output/<server>/` при uninstall |
|
||||
| `vault_hysteria2_obfs_passwords` | vault | obfs-пароли по серверам |
|
||||
|
||||
---
|
||||
|
||||
## Безопасность
|
||||
|
||||
- `output/` содержит пароли и URL — **не коммитить** (в `.gitignore`)
|
||||
- `output/` содержит пароли, obfs-ключи и URL — **не коммитить** (в `.gitignore`)
|
||||
- `inventory/hosts.yml`, `vault.yml`, `.vault_pass` — не коммитить
|
||||
- После `make init` выполните `make vault-encrypt`
|
||||
- Salamander **не делает** вас невидимым: IP VPS и UDP-поток всё ещё можно анализировать
|
||||
|
||||
---
|
||||
|
||||
## Требования
|
||||
|
||||
- **Control node:** macOS или Linux с Ansible **2.14+** (`brew install ansible` на Mac)
|
||||
- **VPS:** Debian/Ubuntu с sudo
|
||||
- Домен с A-записью на IP сервера
|
||||
- Порты **80/tcp** и **443/tcp+udp** доступны с интернета (ветка `main`)
|
||||
- Для авто-открытия браузера: macOS (`open`) или Linux (`xdg-open`)
|
||||
- Ansible 2.14+
|
||||
- Debian/Ubuntu VPS с sudo
|
||||
- Домен с A-записью на IP (для ACME TLS)
|
||||
- Клиент Hysteria2 с поддержкой Salamander (Shadowrocket, NekoBox, Hiddify и др.)
|
||||
- Для авто-открытия браузера: macOS или Linux с `xdg-open`
|
||||
|
||||
---
|
||||
|
||||
@@ -417,29 +332,14 @@ ASCII QR — `hysteria share --qr` → `user.qr.txt`.
|
||||
|
||||
```
|
||||
roles/hysteria2/
|
||||
├── defaults/
|
||||
│ ├── main.yml ← основные переменные
|
||||
│ └── uninstall.yml ← переменные удаления
|
||||
├── files/
|
||||
│ └── install_server.sh ← официальный скрипт (синхронизация с get.hy2.sh)
|
||||
├── tasks/
|
||||
│ ├── main.yml ← порядок задач и теги
|
||||
│ ├── 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 ← инкрементальный экспорт
|
||||
│ ├── obfs.yml ← генерация/загрузка obfs-пароля
|
||||
│ ├── configure.yml ← Salamander, без masquerade
|
||||
│ ├── export.yml ← URL, QR, HTML сервера
|
||||
│ ├── export_global.yml ← общий output/index.html
|
||||
│ ├── share_user.yml
|
||||
│ ├── reuse_export_user.yml
|
||||
│ └── uninstall.yml
|
||||
│ └── export_global.yml ← общий output/index.html
|
||||
└── templates/
|
||||
├── config.yaml.j2 ← acme http + masquerade file
|
||||
├── client.yaml.j2
|
||||
├── masq/index.html.j2
|
||||
├── config.yaml.j2 ← acme tls + obfs salamander
|
||||
├── client.yaml.j2 ← клиент с obfs
|
||||
└── export/ ← HTML-каталоги
|
||||
```
|
||||
|
||||
@@ -449,15 +349,15 @@ roles/hysteria2/
|
||||
|
||||
```bash
|
||||
git fetch origin
|
||||
git checkout main # masquerade + nginx (эта ветка)
|
||||
git checkout salamander # Salamander obfs
|
||||
git checkout main # masquerade + nginx
|
||||
git checkout salamander # Salamander obfs (эта ветка)
|
||||
```
|
||||
|
||||
Конфиги на **уже установленном** сервере **не меняются** при переключении ветки в git.
|
||||
Чтобы применить другой режим на VPS:
|
||||
|
||||
```bash
|
||||
git checkout salamander # или main
|
||||
git checkout main # или salamander
|
||||
make install # перекатит конфиг сервера
|
||||
# или
|
||||
make update
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -3,4 +3,5 @@
|
||||
# Файл group_vars/hysteria2_servers/vault.yml должен быть зашифрован (make vault-encrypt).
|
||||
|
||||
# Проброс VPN-паролей из vault в переменные роли (опционально)
|
||||
hysteria2_user_passwords: "{{ vault_hysteria2_user_passwords[inventory_hostname] | default({}) }}"
|
||||
|
||||
# Опционально: фиксированный пароль Salamander obfs для сервера
|
||||
|
||||
@@ -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!!"
|
||||
|
||||
+2
-23
@@ -2,27 +2,6 @@
|
||||
- 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
|
||||
|
||||
@@ -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,30 +32,17 @@ 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 для всех пользователей (иначе — только новые/изменённые)
|
||||
hysteria2_force_export: false
|
||||
|
||||
# --- uninstall (см. также defaults/uninstall.yml) ---
|
||||
hysteria2_system_user: hysteria
|
||||
hysteria2_uninstall_remove_masq: true
|
||||
hysteria2_uninstall_rebuild_global_index: true
|
||||
hysteria2_uninstall_ufw_rules:
|
||||
- 80/tcp
|
||||
- 443/tcp
|
||||
- 443/udp
|
||||
# --- uninstall ---
|
||||
hysteria2_uninstall_remove_config: true
|
||||
hysteria2_uninstall_remove_local_output: false
|
||||
|
||||
@@ -1,12 +0,0 @@
|
||||
---
|
||||
# Системный пользователь 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
|
||||
@@ -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:
|
||||
|
||||
@@ -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
|
||||
- 443/tcp
|
||||
- 443/udp
|
||||
- "{{ hysteria2_listen_port }}/tcp"
|
||||
- "{{ hysteria2_listen_port }}/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
|
||||
|
||||
@@ -11,28 +11,16 @@
|
||||
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
|
||||
- hysteria2_users_for_export | default([]) | length > 0
|
||||
when: hysteria2_generate_qr_png | bool
|
||||
|
||||
- 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
|
||||
- name: Build client share data for each user
|
||||
ansible.builtin.include_tasks: share_user.yml
|
||||
loop: "{{ hysteria2_users_for_export | default([]) }}"
|
||||
loop: "{{ hysteria2_resolved_users }}"
|
||||
loop_control:
|
||||
loop_var: hysteria2_current_user
|
||||
label: "{{ hysteria2_current_user.name }}"
|
||||
@@ -43,8 +31,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,13 +55,12 @@
|
||||
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
|
||||
|
||||
- name: Show export location
|
||||
ansible.builtin.debug:
|
||||
msg: >-
|
||||
Экспорт: {{ hysteria2_users_for_export | default([]) | length }} пользователь(ей) обновлено,
|
||||
{{ hysteria2_users_for_reuse | default([]) | length }} без изменений,
|
||||
{{ _hysteria2_removed_users | default([]) | length }} удалено.
|
||||
Каталог: {{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/
|
||||
Клиентские URL, QR и index.html сохранены в
|
||||
{{ hysteria2_output_dir }}/{{ hysteria2_output_name }}/
|
||||
|
||||
@@ -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
|
||||
@@ -54,13 +56,6 @@
|
||||
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"
|
||||
@@ -92,6 +87,6 @@
|
||||
|
||||
- name: Skip global index when no servers exported
|
||||
ansible.builtin.debug:
|
||||
msg: "Глобальный {{ hysteria2_output_dir }}/index.html удалён — нет server-info.yml в output/"
|
||||
msg: "Глобальный index.html не создан — нет server-info.yml в {{ hysteria2_output_dir }}/"
|
||||
when: hysteria2_global_servers | default([]) | length == 0
|
||||
become: false
|
||||
|
||||
@@ -1,84 +0,0 @@
|
||||
---
|
||||
- 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
|
||||
@@ -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]
|
||||
|
||||
@@ -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
|
||||
@@ -1,4 +0,0 @@
|
||||
---
|
||||
- name: Register reused export data for HTML page
|
||||
ansible.builtin.set_fact:
|
||||
hysteria2_export_users: "{{ hysteria2_export_users | default([]) + [hysteria2_reuse_user] }}"
|
||||
@@ -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 }}
|
||||
|
||||
@@ -14,19 +14,10 @@
|
||||
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:
|
||||
@@ -45,7 +36,6 @@
|
||||
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:
|
||||
@@ -55,55 +45,20 @@
|
||||
delegate_to: localhost
|
||||
become: false
|
||||
run_once: true
|
||||
when:
|
||||
- _hysteria2_script_fetch_ok | bool
|
||||
- >-
|
||||
when: >-
|
||||
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
|
||||
- name: Report install script sync result
|
||||
ansible.builtin.debug:
|
||||
msg: >-
|
||||
Пропуск синхронизации с {{ hysteria2_install_script_url }}:
|
||||
{{ _hysteria2_remote_script.msg | default('сеть недоступна') }}.
|
||||
Используется локальный roles/hysteria2/files/{{ hysteria2_install_script_name }}.
|
||||
{{
|
||||
'Официальный install_server.sh обновлён в roles/hysteria2/files/'
|
||||
if (_hysteria2_script_updated.changed | default(false))
|
||||
else 'Локальный install_server.sh актуален (совпадает с ' ~ hysteria2_install_script_url ~ ')'
|
||||
}}
|
||||
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))
|
||||
|
||||
@@ -1,137 +1,40 @@
|
||||
---
|
||||
- name: Stop and disable hysteria-server before removal
|
||||
- name: Stop and disable hysteria-server
|
||||
ansible.builtin.systemd:
|
||||
name: "{{ hysteria2_service_name }}"
|
||||
enabled: false
|
||||
state: stopped
|
||||
failed_when: false
|
||||
|
||||
- name: Copy Hysteria2 install script to server
|
||||
ansible.builtin.copy:
|
||||
src: "{{ hysteria2_install_script_name }}"
|
||||
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"
|
||||
- name: Remove Hysteria2 via official script
|
||||
ansible.builtin.shell:
|
||||
cmd: bash <(curl -fsSL https://get.hy2.sh/) --remove
|
||||
executable: /bin/bash
|
||||
register: _hysteria2_remove
|
||||
changed_when: _hysteria2_remove.rc == 0
|
||||
failed_when: false
|
||||
|
||||
- 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
|
||||
- name: Remove Hysteria2 configuration directory
|
||||
ansible.builtin.file:
|
||||
path: "{{ item }}"
|
||||
state: absent
|
||||
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 | 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 }}"
|
||||
path: "{{ hysteria2_config_path | dirname }}"
|
||||
state: absent
|
||||
when: hysteria2_uninstall_remove_config | bool
|
||||
|
||||
- name: Reload systemd after uninstall
|
||||
ansible.builtin.systemd:
|
||||
daemon_reload: true
|
||||
|
||||
- name: Remove local output directory for this server
|
||||
- name: Show uninstall result
|
||||
ansible.builtin.debug:
|
||||
msg: >-
|
||||
Hysteria2 (Salamander) удалён с {{ 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
|
||||
|
||||
- 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 %}
|
||||
when: hysteria2_uninstall_remove_local_output | bool
|
||||
|
||||
@@ -10,16 +10,6 @@
|
||||
- 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:
|
||||
@@ -30,9 +20,8 @@
|
||||
delegate_to: localhost
|
||||
become: false
|
||||
|
||||
- name: Parse saved export metadata
|
||||
- name: Parse saved passwords into lookup dict
|
||||
ansible.builtin.set_fact:
|
||||
_hysteria2_saved_server_info: "{{ _hysteria2_saved_info_raw.content | b64decode | from_yaml }}"
|
||||
_hysteria2_saved_passwords: >-
|
||||
{{
|
||||
dict(
|
||||
@@ -44,14 +33,12 @@
|
||||
)
|
||||
)
|
||||
}}
|
||||
delegate_to: localhost
|
||||
become: false
|
||||
tags:
|
||||
- install
|
||||
- update
|
||||
- export
|
||||
|
||||
- name: Resolve user list with passwords from inventory, vault and previous export
|
||||
- name: Resolve user list with optional fixed passwords
|
||||
ansible.builtin.set_fact:
|
||||
hysteria2_resolved_users: "{{ hysteria2_resolved_users | default([]) + [ _entry ] }}"
|
||||
vars:
|
||||
@@ -59,26 +46,8 @@
|
||||
_password: >-
|
||||
{{
|
||||
(
|
||||
item.password
|
||||
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)
|
||||
item.password if item is mapping
|
||||
) | default('', true)
|
||||
}}
|
||||
_entry:
|
||||
name: "{{ _username }}"
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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 }}
|
||||
|
||||
@@ -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:
|
||||
type: file
|
||||
file:
|
||||
dir: {{ hysteria2_masq_dir }}
|
||||
listenHTTP: :80
|
||||
listenHTTPS: :{{ hysteria2_listen_port }}
|
||||
forceHTTPS: true
|
||||
obfs:
|
||||
type: salamander
|
||||
salamander:
|
||||
password: "{{ hysteria2_obfs_password }}"
|
||||
|
||||
@@ -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>
|
||||
<p>Общий каталог VPN-подключений</p>
|
||||
<h1>Hysteria2 · Salamander</h1>
|
||||
<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>
|
||||
|
||||
@@ -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 %}
|
||||
|
||||
@@ -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>
|
||||
Reference in New Issue
Block a user