diff --git a/docs/TASKS.md b/docs/TASKS.md index 7542e25..cac1ede 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -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 | **Обозначения:** ✅ сделано · 🔶 частично · ⬜ не начато diff --git a/docs/VPN-FOR-FAMILY.md b/docs/VPN-FOR-FAMILY.md new file mode 100644 index 0000000..9c0ee9a --- /dev/null +++ b/docs/VPN-FOR-FAMILY.md @@ -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). +Когда будут готовы — менять ничего не придётся, просто добавятся +ещё профили. Сообщу отдельно. diff --git a/docs/vpn-clients.md b/docs/vpn-clients.md index 6844344..2fc314f 100644 --- a/docs/vpn-clients.md +++ b/docs/vpn-clients.md @@ -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 вместо ``: + +``` +vless://@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 и как откатить | diff --git a/ops/network/VPN-STATUS.md b/ops/network/VPN-STATUS.md index 33ffa57..2dfb74d 100644 --- a/ops/network/VPN-STATUS.md +++ b/ops/network/VPN-STATUS.md @@ -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). diff --git a/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md new file mode 100644 index 0000000..72db142 --- /dev/null +++ b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md @@ -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` | реестр задач | diff --git a/ops/vpn/qr/Buryan-01.png b/ops/vpn/qr/Buryan-01.png new file mode 100644 index 0000000..dcb2e2a Binary files /dev/null and b/ops/vpn/qr/Buryan-01.png differ diff --git a/ops/vpn/qr/Buryan-02.png b/ops/vpn/qr/Buryan-02.png new file mode 100644 index 0000000..53c6b88 Binary files /dev/null and b/ops/vpn/qr/Buryan-02.png differ diff --git a/ops/vpn/qr/Buryan-03.png b/ops/vpn/qr/Buryan-03.png new file mode 100644 index 0000000..a519c9e Binary files /dev/null and b/ops/vpn/qr/Buryan-03.png differ diff --git a/ops/vpn/qr/Buryan-04.png b/ops/vpn/qr/Buryan-04.png new file mode 100644 index 0000000..27795c1 Binary files /dev/null and b/ops/vpn/qr/Buryan-04.png differ diff --git a/ops/vpn/qr/Buryan-05.png b/ops/vpn/qr/Buryan-05.png new file mode 100644 index 0000000..8f8c95a Binary files /dev/null and b/ops/vpn/qr/Buryan-05.png differ diff --git a/ops/vpn/qr/Buryan-06.png b/ops/vpn/qr/Buryan-06.png new file mode 100644 index 0000000..0320d1e Binary files /dev/null and b/ops/vpn/qr/Buryan-06.png differ diff --git a/ops/vpn/qr/Buryan-07.png b/ops/vpn/qr/Buryan-07.png new file mode 100644 index 0000000..9527aa1 Binary files /dev/null and b/ops/vpn/qr/Buryan-07.png differ diff --git a/ops/vpn/qr/Buryan-08.png b/ops/vpn/qr/Buryan-08.png new file mode 100644 index 0000000..f4f9797 Binary files /dev/null and b/ops/vpn/qr/Buryan-08.png differ diff --git a/ops/vpn/qr/Buryan-09.png b/ops/vpn/qr/Buryan-09.png new file mode 100644 index 0000000..c44b2d0 Binary files /dev/null and b/ops/vpn/qr/Buryan-09.png differ diff --git a/ops/vpn/qr/Buryan-10.png b/ops/vpn/qr/Buryan-10.png new file mode 100644 index 0000000..39e3304 Binary files /dev/null and b/ops/vpn/qr/Buryan-10.png differ