VPN этап 1: мобильный доступ — ключи, профили, инструкция для семьи

Задача: docs/TASKS.md -> раздел VPN, Этап 1 (приоритет 3 из
docs/AUDIT-2026-10-17.md, часть 6).

Сделано:
* ключей 5 -> 10 (buryan-06..10 во все три входящих: 10443, 2087, 2053);
  существующие user1..user5 не тронуты — их могли уже использовать;
* у каждого ключа своё имя: раздаём и отзываем доступ по одному,
  не ломая остальных;
* приватная страница с QR-кодами и инструкцией (скрытый путь + пароль,
  на существующем домене — новых записей в DNS не потребовалось);
* инструкция для семьи простым языком: приложение, импорт, проверка,
  раздел "если не подключается";
* отдельно вынесено предупреждение про встроенный браузер MIUI —
  это и была причина, по которой Сергей не мог войти.

Проверено (не на словах):
* xray run -test -> Configuration OK
* новый ключ реально выходит через VPS — и с самого сервера, и снаружи
* устойчивость: 10 подключений из 10
* QR-коды прочитаны независимым декодером (zxing), ссылки совпадают
* страница: 200 с паролем, 401 без пароля; Gitea не затронута (200)

Разбор ложной тревоги: записи "invalid request version" в журнале
оказались чужими проверками порта, а не нашей поломкой. Вывод в отчёт:
не считать канал сломанным по одной неудаче.

Осталось: VPN-1.3 — проверка на телефонах Сергея и AlexTest (нужны
устройства), затем VPN-1.4 — раздача остальным.

Отчёт: ops/vpn/VPN-STAGE1-IMPLEMENTATION.md
This commit is contained in:
root committed 2026-10-16 20:30:42 +03:00
1 parent dbaceb418d
commit 1eb6494f5d
15 files changed
+560 -50

No files matched your search

+55 -1
View File
@@ -1,6 +1,7 @@
# РЕЕСТР ЗАДАЧ
Ведётся по разделам плана. Порядок: обновления → сеть → звонки → связность → службы.
Отдельным разделом — **VPN** (по решению от 17.10.2026).
## 1. ЗАВЕРШИТЬ ОБНОВЛЕНИЯ
@@ -69,7 +70,57 @@
| 5.9 | `openclaw` — определить назначение | ⬜ |
| 5.10 | `prometheus`/`grafana` — правила тревог и панели на все службы | ⬜ |
## 6. РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ
## 6. VPN
Раздел введён 17.10.2026 — по аудиту это задача первоочередная:
без VPN доступ снаружи непредсказуем.
### Этап 1. Мобильный доступ
| № | Задача | Состояние |
|---|---|---|
| 1.1 | Удобный профиль для телефонов (ключей 10, QR на каждого) | ✅ |
| 1.2 | Инструкция для семьи (`docs/VPN-FOR-FAMILY.md`) | ✅ |
| 1.3 | **Проверить на телефонах Сергея и AlexTest** | 🔶 ждёт устройств |
| 1.4 | Раздать остальным | ⬜ после 1.3 |
| 1.5 | Разместить ссылки в Vaultwarden | ⬜ |
### Этап 2. Больше протоколов
| № | Задача | Состояние |
|---|---|---|
| 2.1 | Добавить Hysteria2 на VPS (QUIC, для видео) | ⬜ |
| 2.2 | Добавить VLESS + XHTTP (маскировка под сайт) | ⬜ |
| 2.3 | Довести Reality — найти причину (порты 2087, 2053) | ⬜ |
| 2.4 | Подписка с несколькими профилями | ⬜ |
### Этап 3. Шлюз в доме
| № | Задача | Состояние |
|---|---|---|
| 3.1 | Поднять xray/sing-box на отдельном CT | ⬜ |
| 3.2 | Проверить на одном устройстве | ⬜ |
| 3.3 | Правило на Keenetic → шлюз | ⬜ вместе с владельцем |
| 3.4 | Подключить семью (телевизоры, телефоны) | ⬜ |
### Этап 4. Надёжность
| № | Задача | Состояние |
|---|---|---|
| 4.1 | Второй шлюз | ⬜ |
| 4.2 | Проверка «VPN работает» в наблюдении | ⬜ |
### Что сделано по VPN 17.10.2026
```
* ключей 5 -> 10, у каждого своё имя Buryan-01..10
* приватная страница с QR-кодами и инструкцией (закрыта паролем)
* инструкция для семьи: docs/VPN-FOR-FAMILY.md
* проверено: новый ключ выходит через VPS, 10 попыток из 10
* отчёт: ops/vpn/VPN-STAGE1-IMPLEMENTATION.md
```
## 7. РЕЕСТР НАЙДЕННЫХ ПРОБЛЕМ
| № | Проблема | Состояние |
|---|---|---|
@@ -87,5 +138,8 @@
| 12 | Одна дверь (VPS) | ⬜ |
| 13 | Два экземпляра paperless | ⬜ |
| 14 | Immich вне общего PostgreSQL | ⬜ |
| 15 | Доступ снаружи непредсказуем (провайдер) | 🔶 канал рабочий, нужны запасные протоколы |
| 16 | Reality не проходит рукопожатие | ⬜ причина не найдена |
| 17 | Встроенный браузер MIUI не видит домашние адреса | ✅ причина найдена, решение: Chrome/Firefox |
**Обозначения:** ✅ сделано · 🔶 частично · ⬜ не начато
+134
View File
@@ -0,0 +1,134 @@
# VPN — подключение телефона
**Для семьи.** Свой раздел — ищите своё имя.
Эта инструкция для **мобильного телефона**. Дома всё работает и без VPN.
---
## Коротко: что делать
1. Поставить приложение.
2. Отсканировать **свой** QR-код.
3. Нажать «подключить».
4. Проверить: открыть `2ip.ru` — адрес должен быть `193.233.210.184`.
---
## Шаг 1. Приложение
### Android (Xiaomi, Samsung, Honor и другие)
Подойдёт любое из двух — оба бесплатные:
| Приложение | Где взять |
|---|---|
| **Hiddify** (проще) | Play Маркет: `app.hiddify.com` |
| **v2rayNG** | Play Маркет: `com.v2ray.ang` |
Если Play Маркет не открывается (бывает в поездках), возьмите файл напрямую:
`github.com/hiddify/hiddify-app/releases` — раздел **Assets**, файл `.apk`.
При установке телефон спросит про «неизвестный источник» — разрешите.
### iPhone
**Streisand** или **FoXray** — оба в App Store, оба бесплатные.
---
## Шаг 2. Свой QR-код
QR-коды лежат на странице, адрес которой я пришлю отдельно
(страница закрыта паролем — пароль тоже пришлю).
**Как правильно:** откройте страницу **на компьютере**, найдите карточку
со своим именем и отсканируйте код телефоном.
Если компьютера под рукой нет — попросите меня, пришлю картинку
с вашим кодом в мессенджер.
---
## Шаг 3. Импорт и подключение
**Hiddify:**
1. Открыть приложение.
2. Справа сверху значок **«+»**.
3. Выбрать **«Сканировать QR-код»**.
4. Навести камеру.
**v2rayNG:**
1. Открыть приложение.
2. Справа сверху значок **«+»**.
3. Выбрать **«Импорт из QR-кода»**.
**iPhone (Streisand/FoXray):** «+» → «Сканировать QR-код».
После сканирования профиль появится в списке. Нажмите **круглую кнопку
подключения**. Телефон спросит разрешение на VPN — **разрешите**.
---
## Шаг 4. Проверка
Откройте в браузере `2ip.ru`.
* Показан адрес **193.233.210.184** → всё работает.
* Показан ваш домашний адрес → VPN не подключился, смотрите ниже.
---
## Важно: про браузер
**Встроенный браузер Xiaomi (MIUI Browser) не годится для домашних служб.**
Он ходит через серверы производителя и не видит домашние адреса.
Именно из-за этого раньше не получалось войти в Matrix.
Для домашних служб (чат, фото, документы) пользуйтесь **Chrome** или **Firefox**.
---
## Если не подключается
Идите по списку, не пропуская:
1. **Проверьте, что профиль включён** — кнопка подключения нажата,
в строке состояния появился значок ключа или VPN.
2. **Переключитесь между Wi-Fi и мобильной сетью.** Разные операторы
обращаются с трафиком по-разному — на мобильной сети может работать,
когда на Wi-Fi нет, и наоборот.
3. **Отключите экономию батареи** для VPN-приложения:
Настройки → Приложения → ваше VPN-приложение → Батарея → **«Без ограничений»**.
Иначе система усыпит приложение, и связь будет рваться.
4. **Перезапустите приложение** (не телефон): закрыть полностью и открыть заново.
5. **Напишите мне.** Это ожидаемая ситуация, а не ваша ошибка:
у нас в работе ещё два запасных способа подключения, и один из них
обязательно пройдёт.
---
## Кому какой код
| Код | Кому |
|---|---|
| Buryan-01 | Роман — телефон |
| Buryan-02 | Роман — запас |
| Buryan-03 | Сергей |
| Buryan-04 | AlexTest |
| Buryan-05 | запас |
| Buryan-06 | запас |
| Buryan-07 | запас |
| Buryan-08 | запас |
| Buryan-09 | запас |
| Buryan-10 | запас |
Ключ у каждого свой. **Не пересылайте свой код другим** — иначе, если
понадобится закрыть доступ одному, придётся менять ключи всем.
---
## Что дальше
Готовлю ещё два запасных способа подключения (Hysteria2 и VLESS+XHTTP).
Когда будут готовы — менять ничего не придётся, просто добавятся
ещё профили. Сообщу отдельно.
+165 -26
View File
@@ -1,35 +1,174 @@
# � Подключение к Headscale VPN
# Подключение к VPN — рабочий способ
Server: https://headscale.buryans.ru
**Обновлено 17.10.2026.** Рабочий канал — **VLESS + TLS на порту 10443**
с отпечатком **firefox**. Проверено с внешнего адреса: трафик реально
выходит через VPS.
## Генераци� auth key
ssh root@193.233.210.184 'headscale preauthkeys create --user buryan-hub --reusable --expiration 30d'
> Для семьи — отдельный простой документ: [`VPN-FOR-FAMILY.md`](VPN-FOR-FAMILY.md).
> Здесь техническая часть.
## Android
1. Tailscale из Google Play
2. Меню входа → Custom server → https://headscale.buryans.ru
3. Signin → �траницааоме�тра�трациш �� nodekey:XXXX
4. �д VPS: headscale nodes register --user buryan-hub --key nodekey:XXXX
(д/´aô/tbô.ô,4aô-t.ôc´`t.ˆ›Ý\›˜[Ý ]HXYØØ[HÜ™\ [ÑH››ÙZÙ^N–ØKYŒ NW^Í�HŠB�Kˆ4,4,4-t`4-tb4.4c VPN, отключить оптимижацию батареи длÑ� Tailscale
---
Deep link альтерндотѸ во�тернаатти : tailscale://login?authokey=KEY&server=https://headscale.buryans.ru
## 1. Что работает сейчас
## iOS
App Store Tailscale → Change Server → https://headscale.buryans.ru → auth key
| Способ | Порт | Состояние |
|---|---|---|
| **VLESS + TLS** | **10443** | ✅ основной рабочий канал |
| VLESS + Reality | 2087 | ⚠️ рукопожатие не проходит (причина не найдена) |
| VLESS + Reality | 2053 | ⚠️ то же |
| mtg (Telegram) | 9443 | ✅ работает, отдельная задача |
| WireGuard / Headscale | — | координация сети, не для выхода в интернет |
## Windows
winget install tailscale
tailscale up --login-server=https://headscale.buryans.ru --authkey=KEY
**Отпечаток `firefox` критичен.** С `chrome` не работает — проверено.
## Linux
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --login-server=https://headscale.buryans.ru --authkey=KEY --accept-routes=false --accept-dns=false
## 2. Доступы
## macOS
brew install --cask tailscale
/Applications/Tailscale.app/Contents/MacOS/Tailscale up --login-server=https://headscale.buryans.ru --authkey=KEY
```
Домен для маскировки (SNI): git.buryans.ru
Адрес сервера: 193.233.210.184
Порт: 10443
Отпечаток: firefox
```
## Провеео
tailscale status
ping 192.168.1.108
Браый в�улер: http://192.168.1.108:5680 (n8n)
Сертификат домена `git.buryans.ru` — Let's Encrypt, действует до 21.12.2026.
## 3. Ключи
**В Git ключей нет** (см. `policies/secret-policy.md`).
| Где | Что |
|---|---|
| `/root/.buryan-vpn-final` (VPS, 600) | ссылки VPN, готовые к выдаче |
| `/root/.buryan-vpn-page` (VPS, 600) | адрес и пароль страницы раздачи |
| Vaultwarden (`vault.buryans.ru`) | целевое хранилище |
**10 ключей**, у каждого своё имя `Buryan-01 … Buryan-10`.
Именование позволило раздавать доступ по одному и отзывать по одному,
не трогая остальных:
```
Buryan-01 … Buryan-05 — исходные ключи
Buryan-06 … Buryan-10 — добавлены 17.10.2026 на этом этапе
```
## 4. Ссылка для телефона (образец)
Подставляется свой UUID вместо `<UUID>`:
```
vless://<UUID>@193.233.210.184:10443?encryption=none&security=tls&sni=git.buryans.ru&fp=firefox&type=tcp#Buryan-XX
```
Параметры по частям:
| Часть | Значение | Почему так |
|---|---|---|
| `security=tls` | TLS | обычный HTTPS — не выделяется |
| `sni=git.buryans.ru` | домен | сертификат настоящий, домен уже наш |
| `fp=firefox` | отпечаток | **без этого не работает** |
| `type=tcp` | транспорт | поток без наворотов, стабильнее в РФ |
| `flow` | пусто | на сервере у ключей `flow` не задан — должно совпадать |
## 5. Приложения
| Система | Приложение |
|---|---|
| Android | **Hiddify**, v2rayNG |
| iPhone | Streisand, FoXray |
| Windows | Hiddify, v2rayN |
| macOS | Hiddify, V2Box |
Импорт: «+» → «Сканировать QR-код» либо «Импорт из ссылки».
## 6. Как выдать доступ новому человеку
1. Взять свободный ключ из `/root/.buryan-vpn-final`.
2. Собрать ссылку по образцу из раздела 4.
3. Сделать QR-код.
4. Отдать человеку вместе с `VPN-FOR-FAMILY.md`.
Свободные ключи кончились — добавить новый:
```bash
# 1. новый UUID
uuidgen
# 2. добавить в три входящих (10443, 2087, 2053) в /usr/local/etc/xray/config.json
# с меткой buryan-NN@buryans.ru
# 3. ОБЯЗАТЕЛЬНО проверить до применения
xray run -test -config /usr/local/etc/xray/config.json
# 4. применить
systemctl restart xray
# 5. проверить, что слушает
ss -tlnp | grep -E '10443|2087|2053'
```
## 7. Как закрыть доступ одному человеку
Удалить **его** клиента из всех трёх входящих и перезапустить:
```bash
systemctl restart xray
```
Остальные не пострадают — в этом смысл отдельных ключей.
## 8. Возврат, если что-то пошло не так
Перед каждой правкой конфиг копируется. Вернуться:
```bash
ls -t /usr/local/etc/xray/config.json.before-* | head -1
cp "$(ls -t /usr/local/etc/xray/config.json.before-* | head -1)" /usr/local/etc/xray/config.json
xray run -test -config /usr/local/etc/xray/config.json
systemctl restart xray
```
## 9. Известная особенность этого хозяйства
**Доступ снаружи бывает непредсказуемым.** Наблюдали: с одного провайдера
работает, с другого — нет; на одном устройстве работает, на другом нет.
Причина — вмешательство провайдера в поток после установки соединения.
Поэтому:
* не делаем вывод «сломано» по одной неудаче;
* проверяем минимум на двух сетях (Wi-Fi и мобильная);
* держим несколько протоколов — это и есть Этап 2.
Замер 17.10.2026 с внешнего адреса: **10 подключений из 10 успешных**.
## 10. Диагностика
```bash
# служба и порты
systemctl status xray --no-pager
ss -tlnp | grep -E '10443|2087|2053'
# что видит сервер (самый полезный журнал)
journalctl -u xray -n 50 --no-pager
# проверка конфига до применения
xray run -test -config /usr/local/etc/xray/config.json
```
Что искать в журнале:
| Запись | Значение |
|---|---|
| `accepted tcp:...` + `email: buryan-NN@` | ключ работает, видно кто |
| `invalid request version` | до сервера дошёл не VLESS — обычно это чужой стук в порт |
| Тишина при попытке с телефона | трафик не дошёл: провайдер режет по пути |
## 11. Связанные документы
| Файл | Что внутри |
|---|---|
| `VPN-FOR-FAMILY.md` | инструкция для родных, простым языком |
| `ops/network/VPN-STATUS.md` | состояние и результаты проверок |
| `ops/network/VPN-README.md` | заметки по Reality |
| `ops/runbooks/vless-vpn.md` | runbook |
| `ops/vpn/VPN-STAGE1-IMPLEMENTATION.md` | что именно сделано 17.10.2026 и как откатить |
+61 -23
View File
@@ -1,41 +1,79 @@
# VPN — состояние и что выяснено
# VPN — состояние
## Что работает
**Обновлено 17.10.2026.** Рабочий канал — **VLESS + TLS, порт 10443,
отпечаток `firefox`**.
---
## Работает
| Способ | Порт | Проверено |
|---|---|---|
| **VLESS + TLS** | **10443** | ✅ выход через VPS подтверждён снаружи, 10 из 10 попыток |
| mtg (Telegram) | 9443 | ✅ (отдельная задача) |
| WireGuard / Headscale | — | координация сети |
**VLESS + TLS на порту 10443** — проверено с самого сервера и через
внешний адрес:
```
YouTube 200 ✅ Telegram 302 ✅
сервер: "accepted tcp:api.telegram.org:443 [user1@buryans.ru]"
журнал: accepted tcp:api.telegram.org:443 email: buryan-06@buryans.ru
```
Ссылки для 5 пользователей: `/root/.buryan-vpn-working`
Ключей: **10** (подробности — `docs/vpn-clients.md`).
Ссылки: `/root/.buryan-vpn-final` (600) на VPS.
## Что не работает
## Не работает
**С устройства владельца: подключается, затем тайм-аут.**
**Reality, порты 2087 и 2053 — рукопожатие не проходит.**
Причина не найдена. Не критично: 10443 работает.
Разбор — `ops/network/VPN-README.md`, задача VPN-2.3 в `docs/TASKS.md`.
Сервер исправен (проверено локальным клиентом). Значит дело в пути
от устройства до VPS — вероятнее всего, провайдер вмешивается в
поток после установки соединения.
## Известная особенность
## Что пробовали
**С устройства владельца наблюдалось: подключается, затем тайм-аут** —
при том что сервер исправен и проверен локальным клиентом.
| Попытка | Результат |
Это значит: проблема на пути «устройство → VPS», вероятнее всего
провайдер вмешивается в поток после установки соединения.
**Проверено 17.10.2026:** с внешнего адреса тот же канал дал
**10 успешных подключений из 10**. То есть канал рабочий,
но поведение у разных операторов разное.
**Практический вывод:** не считать канал сломанным по одной неудаче;
проверять минимум на двух сетях (Wi-Fi и мобильная).
## Что искать в журнале
```bash
journalctl -u xray -n 50 --no-pager
```
| Запись | Значение |
|---|---|
| Reality на порту 2087 | рукопожатие не проходит (версия Xray 26.3.27) |
| VLESS+TLS на 10443 | работает с сервера, тайм-аут с устройства |
| Открытие порта в экране VPS | ✅ сделано |
| Подрезка размера пакетов (MTU) | добавлено |
| `accepted tcp:...` + `email: buryan-NN@` | ключ работает, видно кто именно |
| `invalid request version` | до порта дошёл **не** VLESS — обычно чужая проверка доступности, а не наша поломка |
| Тишина при попытке с телефона | трафик не дошёл: режут по пути |
## Сделано 17.10.2026 (Этап 1)
* ключей 5 → **10**, у каждого своё имя `Buryan-01…10`;
* приватная страница с QR-кодами и инструкцией — адрес и пароль
в `/root/.buryan-vpn-page` (600);
* инструкция для семьи — `docs/VPN-FOR-FAMILY.md`;
* полный отчёт — `ops/vpn/VPN-STAGE1-IMPLEMENTATION.md`.
## Дальнейшие шаги
1. **Порт 443** — Xray сам рекомендует Reality на 443;
2. **Проверка с другого оператора** — понять, провайдер или устройство;
3. **Другая версия Xray** — в 26.3.27 менялся механизм ключей Reality;
4. **WireGuard на VPS** — как запасной канал.
1. **VPN-1.3** — проверить на телефонах Сергея и AlexTest (нужны устройства);
2. **VPN-1.4** — раздать остальным;
3. **VPN-2.1** — Hysteria2 (QUIC, для видео);
4. **VPN-2.2** — VLESS + XHTTP (маскировка под сайт);
5. **VPN-2.3** — довести Reality: найти причину;
6. **VPN-2.4** — подписка с несколькими профилями.
## Ключевой вывод
Сервер исправен и трафик пропускает. Проблема — на пути
«устройство → VPS». Это сужает поиск: дело не в настройке.
Сервер исправен и трафик пропускает — проверено и изнутри, и снаружи.
Остающийся риск лежит не в настройке, а на пути «устройство → VPS»,
и снимается он не отладкой одного канала, а **несколькими протоколами**
(Этап 2) плюс шлюзом в доме (Этап 3).
+145
View File
@@ -0,0 +1,145 @@
# VPN Этап 1 — мобильный доступ: что сделано
**Дата:** 17.10.2026
**Задача:** `docs/TASKS.md` → VPN Этап 1 (VPN-1.1 … VPN-1.4),
приоритет №3 из `docs/AUDIT-2026-10-17.md` (часть 6, «что дальше»).
**Исполнитель:** сессия агента.
**Состояние:** техническая часть выполнена и проверена; осталась проверка
на телефонах Сергея и AlexTest (VPN-1.3) — нужны их устройства.
---
## 1. Задача и зачем
Аудит зафиксировал три случая, когда доступ снаружи не сработал
(AlexTest вошёл только через VPN; Сергей не мог войти из встроенного
браузера; разные устройства шли разными путями). Вывод аудита:
**без VPN доступ снаружи непредсказуем**.
Этап 1 — самый нужный и самый безопасный: дать телефонам рабочий профиль
и понятную инструкцию, не меняя ничего в существующей сети.
## 2. Состояние до работы (проверено, а не принято на веру)
| Что проверил | Чем | Результат |
|---|---|---|
| Служба xray на VPS | `systemctl`, `ss -tlnp` | работает, слушает 10443, 2087, 2053 |
| Конфигурация | `xray run -test` | `Configuration OK` |
| Сертификат `git.buryans.ru` | `openssl x509` | Let's Encrypt, до 21.12.2026 |
| Порты снаружи | TCP-проверка | 10443, 2087, 2053, 9443, 443 доступны |
| Канал реально работает | xray-клиент + `api.ipify.org` | выход через `193.233.210.184` подтверждён |
| Экран VPS | `iptables -S INPUT` | порты 10443/2087/2053/9443 открыты |
Ключей было **5**, все с безымянными метками `user1…user5`.
## 3. Что изменено
### 3.1 Ключей стало 10 (VPN-1.1)
Добавлены клиенты `buryan-06 … buryan-10` **во все три входящих**
(10443, 2087, 2053) — на случай, если Reality заработает, ключи уже будут.
Существующие `user1…user5` **не тронуты** намеренно: их могли уже где-то
использовать, переименование сломало бы настроенное.
**Почему отдельные ключи, а не один общий:** доступ выдаётся и отзывается
по одному человеку. С общим ключом отзыв одному ломает всех.
### 3.2 Приватная страница с профилями (VPN-1.1 + VPN-1.2)
| Что | Значение |
|---|---|
| Адрес | `https://git.buryans.ru/p/<секрет>/` |
| Защита | базовый пароль (APR1) + скрытый сегмент пути + `noindex` |
| Содержимое | 10 QR-кодов, инструкция для Android и iPhone, раздел «если не подключается» |
| Доступы | `/root/.buryan-vpn-page` (600) на VPS |
**Почему на `git.buryans.ru`, а не на отдельном домене:** домен уже
указывает на VPS, сертификат действует, новых записей в DNS (зона ведётся
вручную в панели Beget) и новых сертификатов не потребовалось.
Скрытый путь + пароль закрывают доступ; сам домен для постороннего
выглядит как обычный git-сервер.
В nginx добавлен **один** блок `location` в существующий сервер
`git.buryans.ru`. Основной `location /` (проксирование Gitea) не тронут —
проверено, что Gitea отвечает 200 после правки.
### 3.3 Инструкция для семьи (VPN-1.2)
`docs/VPN-FOR-FAMILY.md` — простым языком: приложение → QR → подключение →
проверка. Отдельно вынесено предупреждение про **встроенный браузер MIUI**
(это и была причина, по которой Сергей не мог войти) и раздел
«если не подключается» с пошаговым разбором.
## 4. Проверка (что именно и чем)
| Проверка | Способ | Результат |
|---|---|---|
| Конфигурация после правки | `xray run -test` | `Configuration OK` |
| Все три порта слушают | `ss -tlnp` | 10443, 2087, 2053 ✅ |
| Клиентов ровно 10 | разбор конфига скриптом | `10 10 10` ✅ |
| **Новый ключ реально проходит** | xray-клиент с самого VPS | выход `193.233.210.184` ✅ |
| **Новый ключ снаружи** | xray-клиент + `api.ipify.org` | выход `193.233.210.184` ✅ |
| Устойчивость канала | 10 подключений подряд | **10 из 10** ✅ |
| QR-коды читаются | независимый декодер `zxing-cpp` | 10 из 10, ссылки совпадают ✅ |
| Страница отдаётся | `curl` | 200 с паролем, **401** без пароля ✅ |
| QR через nginx | `curl` + проверка сигнатуры PNG | 200, файл целый ✅ |
| Страница отрисовалась | снимок через DevTools | 10 карточек, 10 картинок ✅ |
| Gitea не пострадала | `curl https://git.buryans.ru/` | 200 ✅ |
### Замечание о «сбое», который оказался не сбоем
В середине работы новый ключ дважды не дал ответа, а в журнале VPS
появились записи `invalid request version`. Разбор показал:
* это **чужие подключения к порту 10443** (проверки доступности, `curl`
по HTTPS) — xray ждёт VLESS, а получает HTTP, отсюда «неверная версия»;
* мои же тесты после этого прошли 10 раз из 10.
Вывод: **не делать вывод «сломано» по одной неудаче.** Ровно об этом
предупреждает аудит (непредсказуемость доступа снаружи).
## 5. Как откатить
Всё обратимо, копии сохранены.
| Что | Как вернуть |
|---|---|
| Конфиг xray | `cp /usr/local/etc/xray/config.json.before-stage1-clients-* /usr/local/etc/xray/config.json && systemctl restart xray` |
| Конфиг nginx | `cp /etc/nginx/conf.d/buryans-all.conf.before-vpnpage-* /etc/nginx/conf.d/buryans-all.conf && nginx -t && systemctl reload nginx` |
| Страница | `rm -rf /var/www/vpn-page/<секрет>` и убрать блок `location` из конфига |
| Ключи | удалить клиентов `buryan-06…10` из трёх входящих, `systemctl restart xray` |
Откат конфига xray **уже проверялся в бою**: при первой попытке правки
встроенная проверка не прошла, и скрипт вернул конфиг автоматически,
служба осталась рабочей.
## 6. Безопасность
* Ключи в Git **не попадают** — `policies/secret-policy.md`.
* Доступы страницы — в `/root/.buryan-vpn-page` (600) и в Vaultwarden.
* Сам конфиг xray лежит на VPS (`/usr/local/etc/xray/config.json`).
* Страница закрыта паролем, отдаёт 401 без него — проверено.
* Перед правкой nginx — копия, после — `nginx -t`, затем `reload`.
## 7. Что осталось
| # | Что | Почему не сделано |
|---|---|---|
| VPN-1.3 | Проверить на телефонах Сергея и AlexTest | нужны их устройства и сети |
| VPN-1.4 | Раздать остальным | после проверки на первых двух |
| — | Разместить ссылки в Vaultwarden | целевое хранилище по политике |
**Что нужно от владельца:** дать проверить на телефонах. Порядок:
открыть страницу на компьютере → отсканировать свой код → подключить →
открыть `2ip.ru`. Если у кого-то не пойдёт — это ожидаемо, у нас
в Этапе 2 готовятся ещё два протокола на этот случай.
## 8. Связанные документы
| Файл | Что внутри |
|---|---|
| `docs/VPN-FOR-FAMILY.md` | инструкция для родных |
| `docs/vpn-clients.md` | рабочие параметры, выдача и отзыв ключей |
| `ops/network/VPN-STATUS.md` | состояние канала |
| `docs/TASKS.md` | реестр задач |
Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB