VPN: убрана отладка журнала xray + сводка использования

НАЙДЕНО ПО ХОДУ: в конфигурации 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 / Елена / Никита — ни разу.

Ограничение замера записано прямо в документе: по журналу видно, что
человек подключался хотя бы раз, но НЕ видно, доволен ли он. Ноль
подключений не означает "не получилось" — возможно, просто не дошли
руки. Поэтому сводка идёт в дополнение к живой проверке, а не вместо.
This commit is contained in:
root committed 2026-10-16 21:24:46 +03:00
1 parent eb04c58dee
commit f411cc6fd4
4 files changed
+327

No files matched your search

+2
View File
@@ -113,6 +113,8 @@
|---|---|---|
| 4.1 | Второй шлюз | ⬜ |
| 4.2 | Проверка «VPN работает» в наблюдении | ✅ |
| 4.3 | Сводка: кто реально пользуется VPN | ✅ `vpn-usage.py` |
| 4.4 | Убрать отладку из журнала xray (рос 371 МБ) | ✅ |
### Что сделано по VPN 17.10.2026
+53
View File
@@ -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 | ни разу |
**Важно понимать ограничение этого замера:** по журналу видно, что
человек подключался **хотя бы раз**, но **не видно, доволен ли он**.
Ноль подключений не означает «не получилось» — возможно, просто не
дошли руки. Поэтому сводка идёт в дополнение к живой проверке, а не
вместо неё.
+110
View File
@@ -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
+162
View File
@@ -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()