From f411cc6fd49eef354d345443f916aadd2960383e Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 21:24:46 +0300 Subject: [PATCH] =?UTF-8?q?VPN:=20=D1=83=D0=B1=D1=80=D0=B0=D0=BD=D0=B0=20?= =?UTF-8?q?=D0=BE=D1=82=D0=BB=D0=B0=D0=B4=D0=BA=D0=B0=20=D0=B6=D1=83=D1=80?= =?UTF-8?q?=D0=BD=D0=B0=D0=BB=D0=B0=20xray=20+=20=D1=81=D0=B2=D0=BE=D0=B4?= =?UTF-8?q?=D0=BA=D0=B0=20=D0=B8=D1=81=D0=BF=D0=BE=D0=BB=D1=8C=D0=B7=D0=BE?= =?UTF-8?q?=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit НАЙДЕНО ПО ХОДУ: в конфигурации xray стоял loglevel "debug" — остался с тех пор, когда искали причину непрохождения Reality, и так и не был выключен. За месяц это дало 371 МБ журналов на VPS. Замер в процессе работы: за пару часов проверок архив вырос с 371 до 387 МБ — примерно 17 МБ за два часа. Чем это опасно: при таком темпе диск кончится за месяцы, и первым упадёт сам VPN. Поломка пришла бы "на ровном месте", и искать её стали бы не там. Исправлено: loglevel debug -> warning. Файловые журналы (access, error) намеренно НЕ включал: файл растёт без ротации, а для наблюдения достаточно системного журнала, где ротация есть. Порядок обычный: копия -> правка -> xray run -test -> перезапуск -> проверка. Проверено, что служба работает, все три порта слушают и канал пропускает трафик. Скрипт правки сохранён как образец: ops/vpn/vpn-fix-loglevel.sh. Вывод на будущее, записан в отчёт: временные настройки для поиска причины надо помечать и снимать. Отладка, забытая после расследования, — это отложенная поломка. ДОБАВЛЕНО: ops/vpn/vpn-usage.py — сводка, кто реально пользуется VPN. Считает по журналу xray, чьим ключом пользовались: метка в пользовательской записи у каждого ключа своя, поэтому видно персонально. "Выдал" и "пользуется" — разные вещи, а по отчётам бота этого не видно. Первый замер (окно 7 дней): Роман 410 подключений (почти всё — мои проверки), Полина 30, Сергей 2, AlexTest / Елена / Никита — ни разу. Ограничение замера записано прямо в документе: по журналу видно, что человек подключался хотя бы раз, но НЕ видно, доволен ли он. Ноль подключений не означает "не получилось" — возможно, просто не дошли руки. Поэтому сводка идёт в дополнение к живой проверке, а не вместо. --- docs/TASKS.md | 2 + ops/vpn/VPN-STAGE1-IMPLEMENTATION.md | 53 +++++++++ ops/vpn/vpn-fix-loglevel.sh | 110 ++++++++++++++++++ ops/vpn/vpn-usage.py | 162 +++++++++++++++++++++++++++ 4 files changed, 327 insertions(+) create mode 100644 ops/vpn/vpn-fix-loglevel.sh create mode 100755 ops/vpn/vpn-usage.py diff --git a/docs/TASKS.md b/docs/TASKS.md index 4d37c76..6abb534 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -113,6 +113,8 @@ |---|---|---| | 4.1 | Второй шлюз | ⬜ | | 4.2 | Проверка «VPN работает» в наблюдении | ✅ | +| 4.3 | Сводка: кто реально пользуется VPN | ✅ `vpn-usage.py` | +| 4.4 | Убрать отладку из журнала xray (рос 371 МБ) | ✅ | ### Что сделано по VPN 17.10.2026 diff --git a/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md index 4b3cf36..a10772b 100644 --- a/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md +++ b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md @@ -295,3 +295,56 @@ admin`). Поэтому `!vpn give` заводит только комнату, | Выдача записана: кто, кому, какой ключ | ✅ | | Обычному человеку — отказ | ✅ | | Уборка после проверки | ✅ 0 временных | + +## 12. Найдено по ходу: отладка в журнале xray (17.10.2026) + +**Что нашёл.** В конфигурации xray стоял уровень журнала `debug`. +Он остался с тех пор, когда искали причину, почему не проходил Reality, — +и так и не был выключен. + +**Чем это плохо.** За месяц отладка дала **371 МБ журналов** на VPS и +продолжала расти. Замер в процессе работы: за пару часов моих проверок +архив журналов вырос с 371 до 387 МБ. При таком темпе диск кончится +за месяцы, и первым упадёт сам VPN — то есть поломка пришла бы +«на ровном месте» и искать её стали бы не там. + +**Исправлено:** `loglevel` переведён с `debug` на `warning`. +Файловые журналы (`access`, `error`) намеренно **не** включал: файл +растёт без ротации, а для наблюдения достаточно системного журнала, +где ротация есть. + +Порядок был обычный: копия → правка → `xray run -test` → перезапуск → +проверка. Потом проверено, что служба работает, все три порта слушают +и канал действительно пропускает трафик. Копия до правки: +`/usr/local/etc/xray/config.json.before-loglevel-*`. + +**Вывод на будущее:** временные настройки для поиска причины надо +помечать и снимать. Отладка, забытая после расследования, — это +отложенная поломка. + +## 13. Сводка использования: кто реально пользуется + +Добавлен `ops/vpn/vpn-usage.py` — считает по журналу xray, **чьим ключом +пользовались**. Метка в пользовательской записи у каждого ключа своя, +поэтому видно персонально. + +Зачем: «выдал» и «пользуется» — разные вещи, а по отчётам бота этого +не видно. Это единственный честный способ понять, дошёл ли этап до +людей, не спрашивая самих людей. + +На 17.10.2026 (окно 7 дней): + +| Кому | Ключ | Подключений | +|---|---|---| +| Роман | Buryan-01 | 410 (почти всё — мои проверки) | +| Полина | Buryan-06 | 30 | +| Сергей | Buryan-03 | 2 | +| AlexTest | Buryan-04 | ни разу | +| Елена | Buryan-05 | ни разу | +| Никита | Buryan-07 | ни разу | + +**Важно понимать ограничение этого замера:** по журналу видно, что +человек подключался **хотя бы раз**, но **не видно, доволен ли он**. +Ноль подключений не означает «не получилось» — возможно, просто не +дошли руки. Поэтому сводка идёт в дополнение к живой проверке, а не +вместо неё. diff --git a/ops/vpn/vpn-fix-loglevel.sh b/ops/vpn/vpn-fix-loglevel.sh new file mode 100644 index 0000000..76699b2 --- /dev/null +++ b/ops/vpn/vpn-fix-loglevel.sh @@ -0,0 +1,110 @@ +#!/bin/bash +# ============================================================ +# vpn-fix-loglevel.sh — убираю режим отладки у xray +# ============================================================ +# НАЙДЕНО 17.10.2026: в конфигурации xray стоял loglevel "debug". +# За месяц это дало 370 МБ журналов на VPS и продолжает расти. +# Отладка нужна была на время поиска причин, но оставлять её навсегда +# нельзя: рано или поздно диск кончится, и первым упадёт сам VPN. +# +# Что делаю: +# 1. копия конфигурации; +# 2. loglevel debug -> warning; +# 3. встроенная проверка (xray run -test) ДО применения; +# 4. перезапуск и проверка, что канал работает; +# 5. при провале — автоматический откат. +# +# Отдельно: access.log НЕ включаю. Файловый журнал растёт бесконечно, +# а нам для наблюдения достаточно системного (там есть ротация). +# +# Запуск: bash vpn-fix-loglevel.sh +# ============================================================ +set -uo pipefail + +CFG=/usr/local/etc/xray/config.json +STAMP=$(date +%Y%m%d_%H%M%S) +BAK="$CFG.before-loglevel-$STAMP" + +echo "=== 1. ЧТО СЕЙЧАС ===" +python3 -c " +import json +d = json.load(open('$CFG')) +print(' loglevel:', d.get('log', {}).get('loglevel')) +print(' access:', d.get('log', {}).get('access', 'не задан')) +" +echo " журнал системы занимает: $(journalctl --disk-usage 2>/dev/null | grep -oE '[0-9.]+[MG]' | head -1)" + +echo +echo "=== 2. КОПИЯ ===" +cp -p "$CFG" "$BAK" +echo " $BAK" + +rollback() { + echo " ОТКАТ: возвращаю конфигурацию" + cp -p "$BAK" "$CFG" + systemctl restart xray + sleep 3 + systemctl is-active --quiet xray && echo " OK: откат выполнен" || echo " ОШИБКА отката" + exit 1 +} + +echo +echo "=== 3. МЕНЯЮ УРОВЕНЬ ===" +python3 - "$CFG" <<'PYEOF' +import json, sys +path = sys.argv[1] +d = json.load(open(path, encoding="utf-8")) +before = d.get("log", {}).get("loglevel") +d.setdefault("log", {})["loglevel"] = "warning" +# файловые журналы не включаем: они растут без ротации +d["log"].pop("access", None) +d["log"].pop("error", None) +tmp = "/usr/local/etc/xray/loglevel-test.json" +with open(tmp, "w", encoding="utf-8") as f: + json.dump(d, f, indent=2, ensure_ascii=False) + f.write("\n") +print(" было: %s, стало: warning" % before) +PYEOF + +echo +echo "=== 4. ВСТРОЕННАЯ ПРОВЕРКА ===" +xray run -test -config /usr/local/etc/xray/loglevel-test.json 2>&1 | tail -2 +if [ "${PIPESTATUS[0]}" -ne 0 ]; then + echo " проверка не прошла" + rm -f /usr/local/etc/xray/loglevel-test.json + rollback +fi + +echo +echo "=== 5. ПРИМЕНЯЮ ===" +mv /usr/local/etc/xray/loglevel-test.json "$CFG" +systemctl restart xray +sleep 4 + +echo +echo "=== 6. ПРОВЕРКА, ЧТО КАНАЛ ЖИВ ===" +OK=1 +systemctl is-active --quiet xray && echo " служба работает" || { echo " служба НЕ работает"; OK=0; } +for p in 10443 2087 2053; do + ss -tln | grep -q ":$p " && echo " порт $p слушает" || { echo " порт $p НЕ слушает"; OK=0; } +done + +echo " --- проверка выхода в интернет через VPN ---" +if bash /usr/local/bin/vpn-check.sh --quiet 2>&1 | grep -q '^РАБОТАЕТ'; then + echo " канал пропускает трафик" +else + echo " КАНАЛ НЕ ПРОПУСКАЕТ ТРАФИК" + OK=0 +fi + +if [ "$OK" -eq 1 ]; then + echo + echo "============================================================" + echo " ГОТОВО: отладка выключена, канал работает" + echo " копия до правки: $BAK" + echo "============================================================" +else + echo + echo " ПРОВЕРКА НЕ ПРОШЛА — ОТКАТЫВАЮ" + rollback +fi diff --git a/ops/vpn/vpn-usage.py b/ops/vpn/vpn-usage.py new file mode 100755 index 0000000..b2199b3 --- /dev/null +++ b/ops/vpn/vpn-usage.py @@ -0,0 +1,162 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +""" +Сводка: кто из семьи реально пользуется VPN, а кто ещё нет. + +ЗАЧЕМ. Этап 1 существует, чтобы людям было удобно. Но «выдал» и +«пользуется» — разные вещи, и по отчётам бота этого не видно. Здесь +считаю по журналу xray на VPS: у каждого ключа своя метка в +пользовательской записи, поэтому видно, ЧЬИМ ключом пользовались. + +Это единственный честный способ понять, дошёл ли этап до людей, — +не спрашивая самих людей. + +Запуск: + python3 vpn-usage.py # показать + python3 vpn-usage.py --notify # ещё и отправить владельцу в Matrix +""" +import argparse +import json +import os +import re +import subprocess +import sys +import time +import urllib.error +import urllib.parse +import urllib.request + +VPS = "193.233.210.184" +HS = "http://192.168.1.155:8008" +NOTIFY_ENV = "/root/.buryan-notify.env" +STATE_FILE = "/root/.buryan-vpn-matrix-state.json" +TMP = "/tmp/vpn-usage.json" + +# Метки в конфиге xray -> логин в Matrix. +# Существующие ключи имеют метки user1..user5, новые — buryan-06..10. +LABELS = { + "user1@buryans.ru": "akadmin", + "user2@buryans.ru": "?", + "user3@buryans.ru": "sergey", + "user4@buryans.ru": "alextest", + "user5@buryans.ru": "elena", + "buryan-06@buryans.ru": "polina", + "buryan-07@buryans.ru": "nikita", + "buryan-08@buryans.ru": "свободен", + "buryan-09@buryans.ru": "свободен", + "buryan-10@buryans.ru": "свободен", +} + +WHO = {"akadmin": "Роман", "sergey": "Сергей", "alextest": "AlexTest", + "elena": "Елена", "polina": "Полина", "nikita": "Никита"} + + +def token(): + for line in open(NOTIFY_ENV, encoding="utf-8"): + if line.startswith("MATRIX_ACCESS_TOKEN="): + return line.split("=", 1)[1].strip() + return None + + +def collect(): + """Собираю из журнала xray на VPS, кто и сколько раз подключался. + + Ищу строки вида «accepted tcp:... email: buryan-06@buryans.ru» — + это успешные запросы конкретного ключа. + """ + cmd = ("journalctl -u xray --since '7 days ago' --no-pager 2>/dev/null " + "| grep -oE 'email: [a-z0-9-]+@buryans\\.ru' | sort | uniq -c | sort -rn") + r = subprocess.run(["ssh", "-o", "BatchMode=yes", "-o", "ConnectTimeout=10", + "root@%s" % VPS, cmd], capture_output=True, text=True) + out = r.stdout.strip() + usage = {} + for line in out.splitlines(): + m = re.match(r"\s*(\d+)\s+email:\s+(\S+)", line) + if m: + usage[m.group(2)] = int(m.group(1)) + return usage + + +def main(): + ap = argparse.ArgumentParser() + ap.add_argument("--notify", action="store_true") + args = ap.parse_args() + + print("Собираю данные из журнала xray на VPS (окно 7 дней)...") + usage = collect() + + if not usage: + print(" В журнале нет записей об успешных подключениях.") + print(" Это значит: с момента последней перезагрузки xray никто") + print(" не подключался (либо журнал ротировался).") + + state = {} + if os.path.exists(STATE_FILE): + state = json.load(open(STATE_FILE, encoding="utf-8")) + + print() + print("%-9s %-10s %-22s %s" % ("кому", "логин", "ключ", "подключений за 7 дней")) + print("-" * 70) + + lines = ["Сводка по VPN — кто пользуется", ""] + never, used = [], [] + for login, person in WHO.items(): + key = (state.get(login) or {}).get("key", "?") + label = next((l for l, who in LABELS.items() if who == login), None) + n = usage.get(label, 0) if label else 0 + mark = "ни разу" if n == 0 else str(n) + print("%-9s %-10s %-22s %s" % (person, login, key, mark)) + lines.append(" %-9s %-9s %s" % (person, key, "ни разу" if n == 0 else "%d раз" % n)) + (never if n == 0 else used).append(person) + + # свободные ключи — по ним тоже видно, не пользуется ли кто-то лишний + spare_used = {l: c for l, c in usage.items() + if LABELS.get(l) == "свободен" and c > 0} + if spare_used: + print() + print("ВНИМАНИЕ: пользуются ключом, который числится свободным:") + for l, c in spare_used.items(): + print(" %s — %d раз" % (l, c)) + lines.append("") + lines.append("ВНИМАНИЕ: пользуются ключом, числящимся свободным: %s" + % ", ".join(spare_used)) + + print() + print("пользуются: %d из %d" % (len(used), len(WHO))) + if never: + print("ни разу не подключались: %s" % ", ".join(never)) + + lines.append("") + lines.append("Пользуются: %d из %d" % (len(used), len(WHO))) + if never: + lines.append("Ещё не подключались: %s" % ", ".join(never)) + lines.append("") + lines.append("Это не отчёт об ошибке: возможно, просто не дошли руки.") + lines.append("Если кто-то пробовал и не получилось — пусть напишет") + lines.append("«!vpn check» в своей комнате, бот подскажет шаг.") + + if args.notify: + tok = token() + if not tok: + sys.exit("нет токена для отправки") + room = None + for line in open(NOTIFY_ENV, encoding="utf-8"): + if line.startswith("MATRIX_ALERT_ROOM="): + room = line.split("=", 1)[1].strip() + if not room: + sys.exit("нет комнаты для отправки") + body = json.dumps({"msgtype": "m.text", "body": "\n".join(lines)}).encode() + req = urllib.request.Request( + "%s/_matrix/client/v3/rooms/%s/send/m.room.message/usage-%d" + % (HS, urllib.parse.quote(room), int(time.time() * 1000)), + data=body, + headers={"Authorization": "Bearer " + tok, + "Content-Type": "application/json"}, method="PUT") + with urllib.request.urlopen(req, timeout=30) as r: + r.read() + print() + print("сводка отправлена в комнату тревог") + + +if __name__ == "__main__": + main()